Channel troubleshooting
Use this page when a channel connects but behavior is wrong.
Command ladder
Run these in order first:
bashmayros status mayros gateway status mayros logs --follow mayros doctor mayros channels status --probe
Healthy baseline:
Runtime: runningRPC probe: ok- Channel probe shows connected/ready
WhatsApp failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| Connected but no DM replies | mayros pairing list whatsapp | Approve sender or switch DM policy/allowlist. |
| Group messages ignored | Check requireMention + mention patterns in config | Mention the bot or relax mention policy for that group. |
| Random disconnect/relogin loops | mayros channels status --probe + logs | Re-login and verify credentials directory is healthy. |
Full troubleshooting: /channels/whatsapp#troubleshooting-quick
Telegram
Telegram failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
/start but no usable reply flow | mayros pairing list telegram | Approve pairing or change DM policy. |
| Bot online but group stays silent | Verify mention requirement and bot privacy mode | Disable privacy mode for group visibility or mention bot. |
| Send failures with network errors | Inspect logs for Telegram API call failures | Fix DNS/IPv6/proxy routing to api.telegram.org. |
| Upgraded and allowlist blocks you | mayros security audit and config allowlists | Run mayros doctor --fix or replace @username with numeric sender IDs. |
Full troubleshooting: /channels/telegram#troubleshooting
Discord
Discord failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| Bot online but no guild replies | mayros channels status --probe | Allow guild/channel and verify message content intent. |
| Group messages ignored | Check logs for mention gating drops | Mention bot or set guild/channel requireMention: false. |
| DM replies missing | mayros pairing list discord | Approve DM pairing or adjust DM policy. |
Full troubleshooting: /channels/discord#troubleshooting
Slack
Slack failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| Socket mode connected but no responses | mayros channels status --probe | Verify app token + bot token and required scopes. |
| DMs blocked | mayros pairing list slack | Approve pairing or relax DM policy. |
| Channel message ignored | Check groupPolicy and channel allowlist | Allow the channel or switch policy to open. |
Full troubleshooting: /channels/slack#troubleshooting
iMessage and BlueBubbles
iMessage and BlueBubbles failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| No inbound events | Verify webhook/server reachability and app permissions | Fix webhook URL or BlueBubbles server state. |
| Can send but no receive on macOS | Check macOS privacy permissions for Messages automation | Re-grant TCC permissions and restart channel process. |
| DM sender blocked | mayros pairing list imessage or mayros pairing list bluebubbles | Approve pairing or update allowlist. |
Full troubleshooting:
- /channels/imessage#troubleshooting-macos-privacy-and-security-tcc
- /channels/bluebubbles#troubleshooting
Signal
Signal failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| Daemon reachable but bot silent | mayros channels status --probe | Verify signal-cli daemon URL/account and receive mode. |
| DM blocked | mayros pairing list signal | Approve sender or adjust DM policy. |
| Group replies do not trigger | Check group allowlist and mention patterns | Add sender/group or loosen gating. |
Full troubleshooting: /channels/signal#troubleshooting
Matrix
Matrix failure signatures
| Symptom | Fastest check | Fix |
|---|---|---|
| Logged in but ignores room messages | mayros channels status --probe | Check groupPolicy and room allowlist. |
| DMs do not process | mayros pairing list matrix | Approve sender or adjust DM policy. |
| Encrypted rooms fail | Verify crypto module and encryption settings | Enable encryption support and rejoin/sync room. |
Full troubleshooting: /channels/matrix#troubleshooting