Documentation
Connecting WhatsApp numbers to your bots.
Neuron supports two WhatsApp integration methods: the official WhatsApp Cloud API (via Meta Business) and Baileys direct connection (pairs with any WhatsApp number via QR code). Each has different setup requirements and capabilities.
The official integration through Meta. Requires a Meta Business account, a verified WhatsApp Business phone number, and a permanent access token. Go to Settings > Channels, create a "meta" type channel, and enter your Phone Number ID and Access Token.
Create a Meta Business app
Go to developers.facebook.com, create an app, and add the WhatsApp product.
Get your credentials
Copy your Phone Number ID and generate a permanent access token from the WhatsApp > API Setup page.
Configure the webhook
In your Meta app's WhatsApp webhook settings, set the callback URL to your Neuron instance: https://neuron-api.letschop.io/api/v1/whatsapp/webhook. Use the verify token from your environment variables.
Create the channel
In Neuron, go to Settings > Channels, create a new Meta channel, and enter your credentials.
Pairs with any WhatsApp number using a QR code — no Meta Business account needed. Create a "baileys" type channel, start the session, and scan the QR code with your WhatsApp mobile app.
Baileys connections use an unofficial WhatsApp protocol. They may be less stable than the official Cloud API and could be affected by WhatsApp policy changes.
After creating a channel, assign a bot to it. Go to the channel's detail page and click "Assign Bot". Only one bot can be active per channel at a time. Messages received on that channel will be routed to the assigned bot.
For Baileys channels, you can start, stop, and check session status. The Sessions page shows all active sessions. If a session disconnects (e.g., phone goes offline), you may need to re-scan the QR code.