What Discord integration does (and what it doesn't)
The Yaplet Discord integration is a notification system, not a two-way messaging channel. When events happen in Yaplet — a new chat starts, a visitor sends a message, or a ticket is created — a formatted embed is posted to a Discord channel of your choice. Agents click the link in the embed to open the conversation in the Yaplet dashboard and reply there.
There is no Slack integration. Discord is the only team notification platform Yaplet connects to.
Agents cannot reply to customers directly from Discord — all replies happen in the Yaplet inbox or mobile app.
Connect Discord to Yaplet
- Go to Settings → Connections → Discord integration.
- Click Connect Discord. You're redirected to Discord's OAuth2 authorization page.
- Select the Discord server you want to connect. You must have Manage Server permission on that server.
- Click Authorize. The Yaplet bot is added to your server with permission to send messages and embeds. This is the server Yaplet connects: only a server where you approved the bot on Discord's authorize screen can be connected.
- Back in Yaplet, your server's name appears next to a Disconnect button. Open the Channel dropdown (Select a Discord channel) and pick the text channel where alerts will be posted. Voice channels, categories, and forum channels are not listed, and only channels of the connected server can be chosen.
Configure which events trigger notifications
Three notification events are available, all enabled by default. Each has its own switch under the channel dropdown — toggle them independently. There is no Save button: every change is saved as soon as you make it.
| Event | Triggers when |
|---|---|
| New visitor message | A visitor sends a message to a conversation that is waiting for a reply — whether or not an agent is already assigned to it. Only what the visitor writes is posted: lines from the AI bot, workflows and the system never are |
| New chat | A visitor starts a brand-new conversation |
| New ticket | A new ticket is created on any of your boards |
Each notification embed includes the relevant content (message text, ticket number) and a direct link to open it in your Yaplet dashboard. Phone conversations are the one exception: an AI voice call never produces a Discord notification, because a call would post one embed for every spoken turn.
Tips for a clean setup
- Create a dedicated channel like
#yaplet-alertsso notifications don't flood general chat. - Disable New visitor message if your team already receives push notifications on mobile — this event fires for every message a visitor writes in a conversation that is waiting for a reply, assigned or not, and can be noisy.
Switch to another server or disconnect
A workspace has one connected Discord server. To move to another, click Switch server at the top of the page and go through Connect Discord again — the new server replaces the old one.
To stop the notifications altogether:
- Go to Settings → Connections → Discord integration.
- Click Disconnect next to the server's name.
- Notifications stop immediately. The Yaplet bot remains in your server (you can kick it from Discord if needed).
Troubleshooting
- Notifications not appearing: Verify a channel is selected and the relevant events are switched on. Check that the Yaplet bot still has permission to post in the selected channel.
- Channel not in dropdown: Only text channels appear. If you just created the channel, refresh the settings page.
- Authorization failed: You need Manage Server permission. Ask a server admin if you don't have it.
- "Discord did not confirm the server.": Discord's answer did not name a server you approved the bot for, or its one-time code had expired. Click Connect Discord again, pick the server and click Authorize on Discord's screen.
- "We could not confirm this Discord connection. Please connect again.": Yaplet accepts the return from Discord only in the browser tab where you clicked Connect Discord. Click it again and finish in that same tab.
- "This channel does not belong to the connected server.": The channel you picked is not a text channel of the connected server (for example, it was just deleted). Refresh the settings page and pick one from the list.
What's next
For a full overview of all the channels you can connect, see Tour of the inbox.