This repository provides a Discord bot that syncs forum posts with Zendesk tickets. It's written as an internal tool for us at Sourcegraph as Zendesk removed official channel support for Discord.
You'll need to set the following environment variables, either in your command line or in a .env file:
The site on which you'll be hosting the Zendesk channel server and Discord bot (e.g. SITE=https://somesubdomain.sourcegraph.com).
A passphrase used to sign JWTs and webhooks requests.
In an ideal world, this would be optional, but for security reasons it is required.
The unique identifier of an OAuth client created under Apps and integrations > APIs > Zendesk API > OAuth Clients. Note that this is not a user authenticated interaction, so no redirect URL is required when creating this OAuth client.
Without this environment variable, messages will only be pulled from Discord approximately every two minutes.
(Ignore this if this is a first setup) Note that if you enable this after having created some integration accounts, you'll have to edit and save them for this to kick in.
URL to a Qdrant database.
OpenAI key for embeddings.
Set DEPLOY_SUBDOMAIN to a Zendesk subdomain, for example sourcegraph, and DEPLOY_AUTHORIZATION set to a valid Zendesk Authorization header value.
Then you can run pnpm run zendesk:deploy however many times you like to redeploy the app from scratch. Do this when modifying requirements.json or if you want manifest changes to percolate faster.
Run pnpm run zendesk:package (with all your desired environment variables set) and upload the zendesk-installer.zip to Apps and integrations > Zendesk Support apps > Private Apps.
This application lets Zendesk know about our Discord to Zendesk bridge server, specified in SITE.
Now, go to Apps and integrations > Channel apps > [name of the app you registered] > Accounts > Add Account
Go to the Discord developers page and create a new application. Get the token for your bot user under the Bot tab.
Note: Under Privileged Gateway Intents, ensure Server Members Intent and Message Content Intent are enabled.
Go to your Discord settings, then Advanced, and enable Developer Mode. Find your forum channel of choice, right click, and click Copy Channel ID.
docker pull qdrant/qdrant
docker run -p 6333:6333 \
-v ~/.drant-data:/qdrant/storage \
qdrant/qdrant
# (Re)deploy Zendesk app
pnpm run zendesk:deploy# Build Docker image
docker build -t zendesk-discord-integration .
# If you're on an M1 / M2 mac
docker buildx build --platform linux/amd64 -t zendesk-discord-integration .
# Tag the image
docker tag zendesk-discord-integration us-central1-docker.pkg.dev/cody-embeddings-discord-bot/zendesk-discord-integration/zendesk-discord-integration
# Push the image
docker push us-central1-docker.pkg.dev/cody-embeddings-discord-bot/zendesk-discord-integration/zendesk-discord-integrationApache-2.0