Skip to main content

​
General Debugging

​
Check Channel Status

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

​
View Gateway Logs

argent gateway logs --follow
Channel errors appear in the gateway log stream with the channel name prefix.

​
Platform-Specific Issues

  • 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
Another process is polling with the same bot token. Stop any other bots or scripts using this token.
  • 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
Enable the required Privileged Gateway Intents in the Discord Developer Portal under your application’s Bot settings.
QR codes expire after about 60 seconds. Run the pairing command again:
argent channels add whatsapp
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
Ensure signal-cli is installed and in your PATH:
which signal-cli
signal-cli --version
The phone number in your config must match the account linked in signal-cli. Verify with:
signal-cli -a +1YOUR_NUMBER receive
Grant Full Disk Access to your terminal or the node process. See the iMessage setup guide.
Check the polling interval. The default is 5 seconds. For faster detection, reduce pollInterval in your config.

​
Common Across All Channels

Most channel issues stem from the gateway not running:
argent gateway status
argent gateway start
Validate your config file:
argent config validate