Discord Integration
Connect a Discord server to receive real-time Yaplet notifications for new chats, visitor messages, and tickets directly in a Discord channel.
What is the Discord Integration?
The Discord integration sends automatic notifications to a Discord channel whenever key events happen in your Yaplet workspace. Instead of constantly checking the dashboard, your team gets instant alerts in Discord when a visitor starts a new chat, sends a message, or creates a ticket.
Key Benefits
Instant Alerts
Get notified in Discord the moment a new chat, message, or ticket arrives — no need to keep the dashboard open.
Clickable Links
Every notification includes a direct link to the relevant conversation or ticket in your Yaplet dashboard.
Granular Control
Choose exactly which events trigger notifications and which Discord channel receives them.
Rich Embeds
Notifications appear as clean, formatted Discord embeds with context like organization name and message content.
Notification Events
The integration supports three notification types. Each can be enabled or disabled independently:
| Event | When it triggers | What it includes |
|---|---|---|
| New visitor message | A visitor writes in a chat that is waiting for your team — only what the visitor writes; bot, workflow and system lines never post | Message content, chat link, organization name |
| New chat | A visitor starts a brand-new conversation | First message content, chat link, organization name |
| New ticket | A new ticket is created on one of your boards | Ticket number, priority (if set), link to tickets |
Connecting Your Discord Server
Navigate to Discord Integration Settings
Go to Settings → Connections → Discord integration in your Yaplet dashboard.
Click "Connect Discord"
Click the "Connect Discord" button to start the OAuth2 authorization flow. You will be redirected to Discord.
Authorize the Yaplet Bot
In the Discord authorization dialog:
- Select the Discord server you want to connect — Yaplet connects the server where you approve the bot on this screen
- Confirm the permissions (the bot needs permission to send messages and embed links)
- Click Authorize
Select a Notification Channel
After authorization, you'll be redirected back to Yaplet. Your connected server appears in the settings, next to a Disconnect button. Use the Channel dropdown (Select a Discord channel) to choose which text channel of that server should receive notifications.
Configure Notification Events
Toggle the notification events you want to receive:
- New visitor message — alerts when a visitor writes to your team (bot, workflow and system lines never post)
- New chat — alerts when new conversations start
- New ticket — alerts when tickets are created
All three are enabled by default.
#yaplet-notifications to keep alerts organized and prevent them from getting lost in general conversation.Managing the Integration
Changing the Notification Channel
You can switch the notification channel at any time from the Discord Integration settings page. Select a different channel from the dropdown and the change takes effect immediately.
Toggling Notification Events
Enable or disable individual notification types with the switches. There is no Save button: every change is saved automatically.
Switching to Another Server
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.
Removing the Integration
To disconnect your Discord server:
- Go to Settings → Connections → Discord integration
- Click Disconnect next to the server's name
- Notifications will stop immediately
Troubleshooting
Notifications not appearing in Discord:
- Verify a notification channel is selected in the settings
- Check that the relevant notification events are enabled
- Ensure the Yaplet bot still has permission to post in the selected channel
- If the bot was removed from the server, you'll need to reconnect the integration
Authorization failed:
- Make sure you have Manage Server permission on the Discord server you're trying to connect
- Try the connection again — Discord may have experienced a temporary issue
"Discord did not confirm the server." appears:
- Yaplet asks Discord which server you approved the bot on, and Discord did not confirm one. Start again with Connect Discord, select your server and finish Discord's authorize screen with Authorize.
"We could not confirm this Discord connection. Please connect again." appears:
- You came back to Yaplet in a way it didn't start — for example in a different browser tab or window than the one where you clicked Connect Discord, or through an old or shared link. Click Connect Discord again and complete the whole flow in that same tab.
Channel not listed in dropdown:
- Only text channels are shown. Voice channels, categories, and forum channels are not supported.
- If you recently created the channel, refresh the settings page
"This channel does not belong to the connected server." appears:
- Only channels of the connected server can receive notifications. Refresh the settings page and pick the channel from the dropdown. To send notifications to a channel on a different Discord server, connect that server with Connect Discord.