> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wednesdayai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Channel Troubleshooting

# Channel troubleshooting

Use this page when a channel connects but behavior is wrong.

## Command ladder

Run these in order first:

```bash theme={"dark"}
wednesdayai status
wednesdayai gateway status
wednesdayai logs --follow
wednesdayai doctor
wednesdayai channels status --probe
```

Healthy baseline:

* `Runtime: running`
* `RPC probe: ok`
* Channel probe shows connected/ready

## WhatsApp

### WhatsApp failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| Connected but no DM replies | `wednesdayai 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 | `wednesdayai channels status --probe` + logs | Re-login and verify credentials directory is healthy. |

Full troubleshooting: [/channels/whatsapp#troubleshooting](https://docs.wednesdayai.dev/next/admin/channels/whatsapp.md#troubleshooting)

## Telegram

### Telegram failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| `/start` but no usable reply flow | `wednesdayai 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. |
| Repeated `getUpdates` network retries | Channels UI Telegram account card + `wednesdayai logs --follow` | Fix DNS/IPv6/proxy routing to `api.telegram.org`; recovery backoff is automatic. |
| `deleteWebhook failed` at startup | `wednesdayai logs --follow` for `succeeded after N attempts` | A success line means cleanup recovered. Otherwise troubleshoot routing for transport errors or fix the reported Telegram API error. |
| Telegram account state is `conflicted` | Channels UI `mode`/`state`/`owner` + account config | Ensure each enabled account resolves to a distinct bot token and only one gateway owns each token. |
| Webhook account rejects or times out | Channels UI webhook receipt, pending updates, and logs | Verify public `webhookUrl`, secret token, reverse proxy, listener path, and endpoint response time. |
| Send failures with network errors | Inspect logs for Telegram API call failures | Fix Bot API egress, proxy, or flood-wait handling; check delivery retry fields in Channels UI. |
| Upgraded and allowlist blocks you | `wednesdayai security audit` and config allowlists | Run `wednesdayai doctor --fix` or replace `@username` with numeric sender IDs. |

Full troubleshooting: [/channels/telegram#troubleshooting](https://docs.wednesdayai.dev/next/admin/channels/telegram.md#troubleshooting)

## Discord

### Discord failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| Bot online but no guild replies | `wednesdayai 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 | `wednesdayai pairing list discord` | Approve DM pairing or adjust DM policy. |

Full troubleshooting: [/channels/discord#troubleshooting](https://docs.wednesdayai.dev/next/admin/channels/discord.md#troubleshooting)

## Slack

### Slack failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| Socket mode connected but no responses | `wednesdayai channels status --probe` | Verify app token + bot token and required scopes. |
| DMs blocked | `wednesdayai 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](https://docs.wednesdayai.dev/next/admin/channels/slack.md#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 | `wednesdayai pairing list imessage` or `wednesdayai pairing list bluebubbles` | Approve pairing or update allowlist. |

Full troubleshooting:

* [/channels/imessage#troubleshooting-macos-privacy-and-security-tcc](https://docs.wednesdayai.dev/next/admin/channels/imessage.md#troubleshooting-macos-privacy-and-security-tcc)
* [/channels/bluebubbles#troubleshooting](https://docs.wednesdayai.dev/next/admin/channels/bluebubbles.md#troubleshooting)

## Signal

### Signal failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| Daemon reachable but bot silent | `wednesdayai channels status --probe` | Verify `signal-cli` daemon URL/account and receive mode. |
| DM blocked | `wednesdayai 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](https://docs.wednesdayai.dev/next/admin/channels/signal.md#troubleshooting)

## Matrix

### Matrix failure signatures

| Symptom | Fastest check | Fix |
| - | - | - |
| Logged in but ignores room messages | `wednesdayai channels status --probe` | Check `groupPolicy` and room allowlist. |
| DMs do not process | `wednesdayai 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](https://docs.wednesdayai.dev/next/admin/channels/matrix.md#troubleshooting)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.