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 sends a message to an unassigned chat | Message content, chat link, organization name |
| New chat created | A visitor starts a brand-new conversation | First message content, chat link, organization name |
| New ticket created | A new ticket is created | Ticket number, priority (if set), link to tickets |
Connecting Your Discord Server
Navigate to Discord Integration Settings
Go to Settings > 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
- 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 will appear in the settings. Use the Notification channel dropdown to choose which text channel should receive notifications.
Configure Notification Events
Toggle the notification events you want to receive:
- New visitor message — alerts when visitors send messages
- New chat created — alerts when new conversations start
- New ticket created — 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 using the checkboxes. Changes are saved automatically.
Removing the Integration
To disconnect your Discord server:
- Go to Settings > Discord Integration
- Click "Remove integration" at the bottom of the settings card
- 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
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