Channel Troubleshooting

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.

Telegram Issues

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

"Conflict: terminated by other getUpdates request"

Another process is polling with the same bot token. Stop any other bots or scripts using this token.

Discord Issues

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

"Used disallowed intents"

Enable the required Privileged Gateway Intents in the Discord Developer Portal under your application's Bot settings.

WhatsApp Issues

QR code expired

QR codes expire after about 60 seconds. Run the pairing command again:

argent channels add 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

Signal Issues

signal-cli not found

Ensure signal-cli is installed and in your PATH:

which signal-cli
signal-cli --version

"No such account" error

The phone number in your config must match the account linked in signal-cli. Verify with:

signal-cli -a +1YOUR_NUMBER receive

iMessage Issues

"Permission denied" reading Messages database

Grant Full Disk Access to your terminal or the node process. See the iMessage setup guide.

Messages not detected

Check the polling interval. The default is 5 seconds. For faster detection, reduce pollInterval in your config.

Common Across All Channels

Gateway not running

Most channel issues stem from the gateway not running:

argent gateway status
argent gateway start

Configuration syntax errors

Validate your config file:

argent config validate