n8n

In this article, we will guide you through how to use the Dust node in n8n to automatically trigger your Dust Agents from any other application.

1. Install the Dust community node in your n8n environment

In your n8n interface, open your Settings

Then in the sidebar click on Community nodes, then Install a community node

In the npm package name, enter: n8n-nodes-dust

Create a new scenario on n8n and choose what event should trigger your Dust Agents.

Your Dust node should now be installed

2. Trigger your node

A common example of a trigger for a Dust Agent to run it on a schedule:

We will not detail the trigger part here, as it could be anything you wish. We will detail in the next steps the possibilities of the Dust node.

3. Add your Dust node action

• To do so, search for Dust among nodes on the right side of the screen

Then pick the action you want, for now choices are:

• Talk to an agent
• Upload a document

You will need to create Dust credentials:

For that you need your Dust Workspace ID, API key and region. Only admins can generate API keys.

• Once your connection is created, fill in all the necessary fields

• Agent: Pick the agent you want to talk to from the list. Only Company and Shared agents will be available (you won't find Personal agents)
• The message to send to the Agent: this is the message to send to the agent
• Timezone: this is the timezone in which you want to operate, you can choose from the list (eg: Europe/Paris or America/Los_Angeles)
• username: put the name to be displayed in the conversation. eg: Daily summary Zap
• email: This one is optional, put an email if needed.

4. Run and Publish your workflow

You’re all set! You can use Dust's reply to continue your workflow.

Want to contribute?

We're open source, don't hesitate to create a pull request here if you want to add anything to the node: https://github.com/dust-tt/dust-n8n-node