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

# Channel Troubleshooting

> Common issues and fixes for ArgentOS channel connections.

## General Debugging

### Check Channel Status

```bash theme={null}
argent channels list
```

This shows all configured channels and their connection status (connected, disconnected, error).

### View Gateway Logs

```bash theme={null}
argent gateway logs --follow
```

Channel errors appear in the gateway log stream with the channel name prefix.

## Platform-Specific Issues

<AccordionGroup>
  <Accordion title="Telegram: Bot not responding">
    * Verify the token is correct: `argent channels test telegram`
    * Check that polling is active in the gateway logs
    * Ensure `allowedUsers` is empty (allows all) or includes your user ID
    * If using webhooks, verify the URL is publicly accessible via HTTPS
  </Accordion>

  <Accordion title="Telegram: &#x22;Conflict: terminated by other getUpdates request&#x22;">
    Another process is polling with the same bot token. Stop any other bots or scripts using this token.
  </Accordion>

  <Accordion title="Discord: Bot is online but not responding">
    * Verify **Message Content Intent** is enabled in the Developer Portal
    * Ensure the bot has been invited to the channel with correct permissions
    * Check that `allowedGuilds` is empty or includes your server ID
  </Accordion>

  <Accordion title="Discord: &#x22;Used disallowed intents&#x22;">
    Enable the required Privileged Gateway Intents in the Discord Developer Portal under your application's Bot settings.
  </Accordion>

  <Accordion title="WhatsApp: QR code expired">
    QR codes expire after about 60 seconds. Run the pairing command again:

    ```bash theme={null}
    argent channels add whatsapp
    ```
  </Accordion>

  <Accordion title="WhatsApp: Connection drops frequently">
    WhatsApp Web sessions can be unstable. Check:

    * Your phone has a stable internet connection
    * Multi-device is enabled in WhatsApp settings
    * The session directory has write permissions
  </Accordion>

  <Accordion title="Signal: signal-cli not found">
    Ensure signal-cli is installed and in your PATH:

    ```bash theme={null}
    which signal-cli
    signal-cli --version
    ```
  </Accordion>

  <Accordion title="Signal: &#x22;No such account&#x22; error">
    The phone number in your config must match the account linked in signal-cli. Verify with:

    ```bash theme={null}
    signal-cli -a +1YOUR_NUMBER receive
    ```
  </Accordion>

  <Accordion title="iMessage: &#x22;Permission denied&#x22; reading Messages database">
    Grant Full Disk Access to your terminal or the node process. See the [iMessage setup guide](/channels/imessage).
  </Accordion>

  <Accordion title="iMessage: Messages not detected">
    Check the polling interval. The default is 5 seconds. For faster detection, reduce `pollInterval` in your config.
  </Accordion>
</AccordionGroup>

## Common Across All Channels

<AccordionGroup>
  <Accordion title="Gateway not running">
    Most channel issues stem from the gateway not running:

    ```bash theme={null}
    argent gateway status
    argent gateway start
    ```
  </Accordion>

  <Accordion title="Configuration syntax errors">
    Validate your config file:

    ```bash theme={null}
    argent config validate
    ```
  </Accordion>
</AccordionGroup>