CanWeChat
Docs

Something’s wrong

Quick fixes when the widget, Slack, Discord, Telegram, or webhooks misbehave.

Chat bubble missing on the site

Check that the install script is on the page and that data-site matches the public key from Install in CanWeChat.

Hard-refresh the page. If you locked allowed domains in Settings, the hostname in the browser address bar must match (including www).

If your trial ended and billing isn’t active, the widget stays hidden until the plan is active again.

Site key blocked / wrong domain

In Settings → Allowed domains, add the exact site visitors use (example.com and www.example.com are different).

If the list is empty, any site can load the widget. Once you add even one domain, everything else is blocked — including localhost unless you add it.

Slack isn’t getting messages

On Integrations, make sure Slack is the active destination and shows as connected.

Confirm the CanWeChat bot is in the channel. For private channels, invite it with /invite @CanWeChat.

Reply in the thread Slack created — not as a new message at the top of the channel.

If you see attachment names but no files, open Connect, copy the latest JSON template, paste it into Slack’s App Manifest, save, then reinstall the app to your workspace.

Discord /reply isn’t working

On General Information (not Installation), set Interactions Endpoint URL to https://canwechat.dev/api/v1/integrations/discord/interactions and Save so Discord verifies it. Connect in CanWeChat first with the matching public key.

Invite via Installation → Discord Provided Link with Guild Install scopes applications.commands + bot (not the old OAuth2 URL Generator alone).

Use /reply inside the visitor’s thread. Normal Discord messages don’t reach the website visitor.

If /reply never appears, disconnect Discord in CanWeChat and Connect again so the command is registered. Restart the Discord app if the command list looks stale.

Give the bot View Channels, Send Messages, Send Messages in Threads, Attach Files, Create Public Threads, and Use Application Commands on that channel.

Telegram replies aren’t connecting

Reply to any CanWeChat bot message for that visitor (use Telegram’s Reply). A standalone message in the chat won’t map back to the visitor.

If you rotated the BotFather token, paste the new token in Integrations → Telegram and save again.

Confirm the bot is in the chat/group and the chat ID is exact (group IDs often start with -).

Webhook errors on your server

If you built a custom webhook receiver, verify the signature using the raw request body and your webhook secret, and reject old timestamps.

After rotating the secret in CanWeChat, update your server before expecting new events to succeed.