Plain
The Plain integration lets Helios agents query and mutate your Plain workspace through its GraphQL API, and run agents automatically when customer threads are created.
What your agents can do
Plain exposes a GraphQL API, not REST. Helios agents don't pick from a preset list of actions — they run GraphQL queries and mutations against Plain's full schema, with your API key injected server-side, so anything the Plain API can express, an agent can do in your workspace.
- Triage incoming support threads
- Draft or post replies to customers
- Label and assign threads
- Pull thread history for reporting
- Escalate a thread to another tool
Authentication
| Method | Type | Description |
|---|---|---|
| API key | API Key | Server-to-server authentication with a Plain key |
See Integration authentication for how credentials are stored and injected.
API key
- In Plain, create a machine user for Helios.
- Generate the machine user's API key.
- Paste the key into Helios and save.
Plain's API is served from its UK region endpoint.
Triggers
Plain is one of only three integrations that emit event triggers into Helios, so a Workflow can run an agent automatically when a customer conversation starts.
| Event | Description |
|---|---|
thread.thread_created | A customer starts a new thread |
thread.chat_received | A new chat message arrives from a customer |
These events have no filter fields today.
Plain requires manual webhook configuration: after connecting, paste the webhook URL Helios shows you into Plain's settings so events reach Helios. Inbound webhooks are verified with HMAC-SHA256 signatures. See Triggers for how to attach these to a Workflow.
Last updated on
Slack
The Slack integration lets Helios agents search and call the entire Slack API to post messages, manage channels, work with files and canvases, and run automatically on new messages.
Notion
The Notion integration lets Helios agents search the Notion API and call any endpoint to create pages, update database entries, query data, search content, and comment.