Integration · Updated
Discord webhook integration for usedocs
Many developer tools run support and community in Discord. The Discord webhook brings questions the docs could not answer into the channel your team already watches.
TL;DR
Short answer
usedocs can post handoffs and new leads to a Discord channel through a Discord webhook. Create a webhook in Discord, paste it into Integrations, and test with a question your docs do not cover.
Overview
When the usedocs assistant cannot answer from your docs, it hands the conversation to your team, and when someone leaves contact details, it captures a lead. With a Discord webhook connected, both post to your channel with the question and a link to the conversation. Each handed off question also joins the gap list, where usedocs drafts the article that would have answered it. If your community asks questions directly in Discord, import those conversations or a CSV of them so the repeats become ranked gaps too.
What this integration does
Handoff alerts
The question and a link to the conversation, posted to your channel.
Lead alerts
New leads from the widget, for follow up.
Simple setup
A channel webhook URL; no bot to host.
Feeds the gap list
Handed off questions become gaps with drafted articles.
Setup
Create a webhook in Discord In the channel settings, open Integrations, create a webhook, and copy its URL.
Paste it into usedocs In the dashboard, open Integrations, find Discord under Alerts, and paste the URL.
Test it Ask the assistant something your docs do not cover and check the channel.
Limits and plan notes
- Alerts cover handoffs and new leads; edits and drafts wait in the dashboard's review queue.
- Webhook URLs are secrets: rotate them if one leaks and update usedocs.
- Delivery is queued, so expect seconds, not milliseconds.
- Discord rate limits can delay bursts of alerts.
Not for you if
Skip this if you want a Discord bot that answers in your server; this integration only alerts your team. Customers get answers on your help center and widget.
FAQ
What does the Discord webhook post?
Handoffs and new leads, with the question and a conversation link.
Do I need to host a bot?
No. A channel webhook URL is enough.
Can Discord questions become docs?
Yes. Import those conversations as tickets or a CSV, and usedocs ranks the repeats into gaps with drafts.
Can I turn alerts off without deleting the webhook?
Yes. Turn the integration off in Integrations to keep the saved URL.
Is the webhook URL secret?
Yes. Anyone with it can post to the channel; rotate it in Discord if it leaks.