WaLink
Dashboard
Active Sessions
0 sessionsNo devices connected
Add your first WhatsApp device to start sending and receiving messages through the NexWa gateway.
WhatsApp CRM
Read and reply to your WhatsApp conversations directly.
API Reference & Integration Guide
Learn how to send all message types and integrate deeply with automation tools like n8n.
Connecting your WhatsApp to n8n
NexWa forwards all received WhatsApp messages directly to your n8n workflow. Follow this step-by-step guide to receive, process, and send messages back.
Set Up the Trigger in n8n
Create a new workflow in n8n, add a Webhook node, set its Method to POST, and copy the Production or Test Webhook URL.
Configure Webhook in NexWa
Go to the NexWa Dashboard, open your session's settings (gear icon), paste your n8n Webhook URL, and save. Click Test Webhook to verify the connection.
How to Reply Back (Send Message)
Crucial Concept: Do NOT use "Respond to Webhook" node
Using n8n's Respond to Webhook node only replies to the NexWa server's HTTP call (e.g. returning 200 OK). It **does not** send a message back to the WhatsApp user.
To send a message, you must add a new **HTTP Request** node in your workflow that POSTs a payload back to NexWa.
Add an HTTP Request node after your trigger node and configure it as follows:
- Method: POST
- URL:
http://<your-NexWa-ip>:3000/api/messages/send - Send Body: True (Content-Type: JSON)
- Body Parameters: Select JSON format and copy the schema below:
{
"sessionId": "{{ $json.body.sessionId }}",
"to": "{{ $json.body.from }}",
"type": "text",
"text": "Hello! I received your message: '{{ $json.body.content }}'"
}
💡 Tip: The "to" field automatically handles both standard numbers and modern privacy-focused @lid JIDs (like 148898328911992@lid) received in the webhook!
AI Chatbot Workflow
Ready to importA pre-built n8n workflow that connects NexWa to OpenAI. Handles text, voice notes (transcribed + AI voice reply), images (GPT-4o vision) and PDF documents — all with per-user memory.
In n8n: File → Import from file → select the downloaded JSON → add your OpenAI credentials → update NexWa URL in HTTP nodes.
Ready-to-use n8n Workflows
Download and import these pre-built workflows directly into your n8n instance. All workflows are built specifically for NexWa's webhook format.
AI Chatbot — Text, Voice, Images & PDFs
Handles all 4 message types · OpenAI GPT-4o · Per-user memory
Full AI chatbot powered by OpenAI. Voice messages are transcribed, analyzed, and replied to with a voice note. Images are described by GPT-4o vision. PDFs are extracted and summarized. All conversations keep per-user memory across sessions.
📖 How to import into n8n
- Download the JSON file above
- Open n8n → click "Workflows" in the sidebar
- Click "Add workflow" → "Import from file"
- Select the downloaded
nexwa-ai-chatbot.json - Add your OpenAI API credential to all OpenAI nodes
- Update the NexWa URL in the HTTP Request nodes from
http://localhost:3000to your actual NexWa address - Activate the workflow and set this webhook URL in your NexWa session:
https://your-n8n/webhook/NexWa-ai
Send Text Message
Send a plain-text message to an individual or group.
{
"sessionId": "my-session",
"to": "1234567890", // Or JID (e.g. "1234567890@s.whatsapp.net", "148898328911992@lid")
"type": "text",
"text": "Hello, this is a test from NexWa!"
}
Send Image
Send an image by providing a public HTTP/S link or a Base64 string.
{
"sessionId": "my-session",
"to": "1234567890",
"type": "image",
"url": "https://example.com/photo.jpg",
"caption": "Check out this image!"
}
{
"sessionId": "my-session",
"to": "1234567890",
"type": "image",
"base64": "data:image/jpeg;base64,/9j/4AAQSkZJRg...", // Data-URI or raw base64
"caption": "Sent as base64 string!"
}
Send Video & Audio
Send MP4 videos, MP3 audio, or push-to-talk voice notes using public URLs or Base64.
{
"sessionId": "my-session",
"to": "1234567890",
"type": "video",
"url": "https://example.com/clip.mp4",
"caption": "Video attachment caption"
}
{
"sessionId": "my-session",
"to": "1234567890",
"type": "audio",
"url": "https://example.com/audio.mp3",
"voiceNote": true // Set to true to deliver as a blue microphone voice note
}
Send Documents & Locations
Send PDF reports, Excel tables, and location coordinates directly.
{
"sessionId": "my-session",
"to": "1234567890",
"type": "document",
"url": "https://example.com/invoice.pdf",
"filename": "invoice_may.pdf",
"mimetype": "application/pdf"
}
{
"sessionId": "my-session",
"to": "1234567890",
"type": "location",
"latitude": 37.7749,
"longitude": -122.4194
}