---
title: "Community and social channels"
url: "/help/buuk/community-channels"
updated: "2026-10-25T16:58:19.085Z"
---
# Community and social channels

Support starts all over the social web. These connectors gather those mentions into the same draft pipeline as tickets and email — each one files drafts or suggestions, and none of them publishes.

## Discord

Discord is the most hands-on: you create a small bot yourself, invite it to your server, and give Buuk the token. Budget ten minutes the first time.

### What to have ready in Discord

1. **Create an application in the Developer Portal**
   Sign in at developer.discord.com and press **New Application**. Name it Buuk and create it.

2. **Create the bot and copy its token**
   Open the app’s **Bot** tab and press **Add Bot** (or **Reset Token** if one exists). Copy the token now — Discord shows it exactly once and treats it like a password.

3. **Enable the Message Content Intent**
   Still on the Bot tab, scroll to **Privileged Gateway Intents** and switch on **Message Content Intent**. Without it the bot receives messages without their text, and imported threads come through empty. Press Save.

4. **Invite the bot to your server**
   Open the **OAuth2 → URL Generator** tab, tick **bot** under scopes, and tick **View Channels**, **Send Messages** and **Read Message History** under permissions. Copy the generated URL, open it in a browser, pick your server, and press **Authorize**.

5. **Copy the server and channel IDs**
   In Discord turn on
   
   . Right-click your server’s icon and choose
   
   ; right-click each support channel and choose
   
   . IDs are long numbers like
   
   .

### Connect in Buuk

1. **Paste the bot token**
   On the Discord card, paste the token you copied. Once Buuk can reach the bot it lists the channels of the server the bot is in.

2. **Pick the server and support channels**
   Choose the server from the picker and tick only the channels that carry support conversations. You can also leave this empty and finish all scoping in Manage after connecting.

3. **Continue to sign in**
   Pressing
   
   opens Discord’s authorization page. Choose your server and press
   
   . Back in Buuk the card flips to connected and messages from the chosen channels import on the next sync.

> [!TIP]
> The bot needs to stay in the server. If message reads come back empty, re-check the Message Content Intent and confirm the bot still has View Channels on the chosen channels.

## Microsoft Teams

Connect with an Azure OAuth app granted `ChannelMessage.Read.All`, or paste a Graph access token when the platform app is not configured. Team IDs are optional — leave them blank and Buuk imports from the teams you belong to, or list specific team IDs to narrow it.

### Step by step

1. **Connect with a work account**
   Press Connect and pick the work or school account whose Teams carry support conversations. Microsoft may need an admin to approve reading channel messages — if the screen says approval is required, use the “Sign in to my organization” link and ask your administrator, pasting the link from the screen.

2. **Optional: narrow with team IDs**
   Once connected,
   
   accepts comma-separated team IDs. Find them in the Teams web client URL or via a Graph query — or skip this and Buuk reads the teams your account belongs to.

## WhatsApp Business

Not an OAuth provider: enter the phone number ID from Meta Business Settings and a system-user access token with messaging permission. Your WhatsApp Business account ID is optional and mainly matters when sorting out template or number issues. Customer messages on the number become draft material.

### Step by step

1. **Get the phone number ID**
   Open
   
   and copy the
   
   . The number must already be on the WhatsApp Business Platform.

2. **Create a system user and its token**
   Go to
   
   , add a system user (for example “Buuk”) with administrator permission, then press
   
   . Grant
   
   (and
   
   if you plan label/template work). Copy the token — depending on your app type it is permanent or 60-day.

3. **Connect in Buuk**
   Paste the phone number ID and token into the card and press Connect. Buuk verifies the credentials against Meta immediately, so wrong values fail on the spot.
   
   Optionally add the
   
   — only needed when troubleshooting number or template issues.

## Facebook, Instagram, and X

**Facebook **reads posts on your Page and Messenger threads. **Instagram **reads comments on your professional account. **X (Twitter) **reads mentions of your handle. All three sync incrementally — each run picks up from the last one.

### Step by step — Facebook or Instagram

1. **Use the Facebook admin account**
   These connectors need the Meta account that administers your Facebook Page. For Instagram, the professional account must already be linked to a Page you manage (check under **Meta Business Settings → Accounts**).

2. **Approve Facebook’s prompt**
   Pressing Connect opens Facebook’s **Continue as <you>** dialog, then the permission screen lists reading Page posts and engaging with messages, and (for Instagram) basic account data. Press **Done**. If Facebook asks which Pages to share, select the support Page.

3. **Pick the Page in Buuk**
   After connecting,
   
   lets you choose which Facebook Page Buuk imports from — leave it blank to use the first Page (or auto-detect the Instagram link).

### Step by step — X (Twitter)

1. **Approve X’s prompt**
   X shows the permissions Buuk asks for — reading mentions and your handle, never posting. Sign in with the account the mentions flow into and press
   
   .

- Facebook and Instagram both take an optional Facebook Page: leave it blank to use the first connected Page (or auto-detect the Instagram link), or pick a specific one under Manage after connecting. Instagram needs the professional account already linked to a Page you manage.
- These three are OAuth-only. They cannot connect with a pasted token, so the catalog hides them unless the platform OAuth app is configured on your deployment.

## Plan

Each connection uses an integration slot: Starter includes GitHub plus one support source, and Growth connects the full catalog — see [Plans and billing](./plans-and-billing).

## Troubleshooting

**Discord sync fails on a missing bot token**

Reading messages needs a bot token. Paste one per workspace in the connect form, or your host must set the deployment-wide one — with neither, sync refuses instead of importing nothing.

**Instagram imports nothing**

The Facebook Page behind the professional account must be one you manage, and Buuk has to resolve the account from that link. Check the link in Meta Business Settings, then reconnect.

## Related

- Desk-based sources: [More support desks](./support-desks).
- Real-time team chat: [Slack](./slack).
- Email sources: [Email inboxes](./email-inboxes).
- Where channel drafts land: [Suggested updates](./suggested-updates).