API, webhooks and bots
Post and read messages from your own software, get webhooks for new messages and calls, and let other tools post into a channel.
On the Business plan, Admins can connect Discuss to your own software in Settings > API.
API keys
Make a key and give it a name. Your software sends it with each request to list channels, read messages and post messages. A key shows once; keep it safe, and delete it to stop it working.
Webhooks
Add an address and pick events. Discuss sends a short message there when something happens:
| Event | When |
|---|---|
message.posted | a new message in a channel (direct messages carry no text) |
channel.created | a new channel |
call.ended | a call ends, with who was in it and how long |
guest.joined | a guest joins a channel |
Failed deliveries are tried again for a while.
Incoming webhooks (bots)
Give a channel its own incoming address: another tool - your website form, a monitor, an automation service - posts to it and the message appears in the channel under the bot name you choose.