Skip to main content
Use this page when a channel connects but behavior is wrong.

​
Command ladder

Run these in order first: 
fluffbuzz status
fluffbuzz gateway status
fluffbuzz logs --follow
fluffbuzz doctor
fluffbuzz channels status --probe
Healthy baseline:
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable, or admin-capable
  • Channel probe shows transport connected and, where supported, works or audit ok

​
WhatsApp

​
WhatsApp failure signatures

SymptomFastest checkFix
Connected but no DM repliesfluffbuzz pairing list whatsappApprove sender or switch DM policy/allowlist.
Group messages ignoredCheck requireMention + mention patterns in configMention the bot or relax mention policy for that group.
Random disconnect/relogin loopsfluffbuzz channels status --probe + logsRe-login and verify credentials directory is healthy.
Full troubleshooting: WhatsApp troubleshooting

​
Telegram

​
Telegram failure signatures

SymptomFastest checkFix
/start but no usable reply flowfluffbuzz pairing list telegramApprove pairing or change DM policy.
Bot online but group stays silentVerify mention requirement and bot privacy modeDisable privacy mode for group visibility or mention bot.
Send failures with network errorsInspect logs for Telegram API call failuresFix DNS/IPv6/proxy routing to api.telegram.org.
Polling stalls or reconnects slowlyfluffbuzz logs --follow for polling diagnosticsUpgrade; if restarts are false positives, tune pollingStallThresholdMs. Persistent stalls still point to proxy/DNS/IPv6.
setMyCommands rejected at startupInspect logs for BOT_COMMANDS_TOO_MUCHReduce plugin/skill/custom Telegram commands or disable native menus.
Upgraded and allowlist blocks youfluffbuzz security audit and config allowlistsRun fluffbuzz doctor --fix or replace @username with numeric sender IDs.
Full troubleshooting: Telegram troubleshooting

​
Discord

​
Discord failure signatures

SymptomFastest checkFix
Bot online but no guild repliesfluffbuzz channels status --probeAllow guild/channel and verify message content intent.
Group messages ignoredCheck logs for mention gating dropsMention bot or set guild/channel requireMention: false.
DM replies missingfluffbuzz pairing list discordApprove DM pairing or adjust DM policy.
Full troubleshooting: Discord troubleshooting

​
Slack

​
Slack failure signatures

SymptomFastest checkFix
Socket mode connected but no responsesfluffbuzz channels status --probeVerify app token + bot token and required scopes; watch for botTokenStatus / appTokenStatus = configured_unavailable on SecretRef-backed setups.
DMs blockedfluffbuzz pairing list slackApprove pairing or relax DM policy.
Channel message ignoredCheck groupPolicy and channel allowlistAllow the channel or switch policy to open.
Full troubleshooting: Slack troubleshooting

​
iMessage and BlueBubbles

​
iMessage and BlueBubbles failure signatures

SymptomFastest checkFix
No inbound eventsVerify webhook/server reachability and app permissionsFix webhook URL or BlueBubbles server state.
Can send but no receive on macOSCheck macOS privacy permissions for Messages automationRe-grant TCC permissions and restart channel process.
DM sender blockedfluffbuzz pairing list imessage or fluffbuzz pairing list bluebubblesApprove pairing or update allowlist.
Full troubleshooting:

​
Signal

​
Signal failure signatures

SymptomFastest checkFix
Daemon reachable but bot silentfluffbuzz channels status --probeVerify signal-cli daemon URL/account and receive mode.
DM blockedfluffbuzz pairing list signalApprove sender or adjust DM policy.
Group replies do not triggerCheck group allowlist and mention patternsAdd sender/group or loosen gating.
Full troubleshooting: Signal troubleshooting

​
QQ Bot

​
QQ Bot failure signatures

SymptomFastest checkFix
Bot replies “gone to Mars”Verify appId and clientSecret in configSet credentials or restart the gateway.
No inbound messagesfluffbuzz channels status --probeVerify credentials on the QQ Open Platform.
Voice not transcribedCheck STT provider configConfigure channels.qqbot.stt or tools.media.audio.
Proactive messages not arrivingCheck QQ platform interaction requirementsQQ may block bot-initiated messages without recent interaction.
Full troubleshooting: QQ Bot troubleshooting

​
Matrix

​
Matrix failure signatures

SymptomFastest checkFix
Logged in but ignores room messagesfluffbuzz channels status --probeCheck groupPolicy, room allowlist, and mention gating.
DMs do not processfluffbuzz pairing list matrixApprove sender or adjust DM policy.
Encrypted rooms failfluffbuzz matrix verify statusRe-verify the device, then check fluffbuzz matrix verify backup status.
Backup restore is pending/brokenfluffbuzz matrix verify backup statusRun fluffbuzz matrix verify backup restore or rerun with a recovery key.
Cross-signing/bootstrap looks wrongfluffbuzz matrix verify bootstrapRepair secret storage, cross-signing, and backup state in one pass.
Full setup and config: Matrix