Skip to main content
We're working with select design partners on the experience of bringing your agent into Plain. In this period, bring your own agent is free to use.If you would like to be a design partner, please get in touch at help@plain.com
An agent you build and connect to Plain is an External Agent. External Agents are available on the Frontier plan, and each discussion or thread assignment uses 15 credits. See How credits work. To build an agent in Plain, at a high level you have to:
1

Create a machine user

Go to Settings → Machine users & API Keys and click Add machine user.Set the type to External Agent for any agent you build. Leave the default type for integrations that only call the API.
  • Name is only visible to your team, for example “Billing agent”
  • Public name is what customers see when the agent replies, for example “Acme Support”
  • The avatar is shown to you internally and, if your agent interacts with customers, publicly as well.
Create one machine user per agent.
2

Create an API key

Click Add API key and grant the permissions the agent needs. Each page in this section lists the permissions for its calls. A mutation without the right permission returns an error that names the missing one.Plain shows the key once, so you should copy it when it is created.A machine user can hold more than one key, so you can rotate without downtime.Read more on GraphQL authentication
3

Set up webhooks

Go to Settings → Webhooks and click Add webhook target. Point it at an HTTPS endpoint you control and subscribe to the events you need. You can update these later as you build your agent.Read more on working with webhooks.

​
Building your agent

With the above basic steps, you can now build your agent. Agents can do anything in Plain. You should pick where you want to start based on the use case for your agent.

Assisting your team

Make your agent available to your team directly within Plain to chat and assist them.

Doing support autonomously

Let your agent handle threads autonomously end to end.