Integrate WhatsApp with n8n

Step by step

1. 1

   Create the instance and get the keys

   In the ZapZap API dashboard, provision a number and copy the instance's x-api-key and x-api-secret. Also keep the base URL https://api.zapzapapi.com. These three items are what n8n will use to authenticate.

2. 2

   Build the sending workflow in n8n

   In Workflows, click Add workflow, then the + button on the canvas. Add a trigger (for example Manual Trigger to test, or Schedule Trigger for routines) and connect an HTTP Request node to it.

3. 3

   Configure the HTTP Request node to send a message

   In HTTP Request, set Method to POST and the URL to ZapZap API's sending endpoint (check the exact path at https://api.zapzapapi.com/llms.txt). Under Send Headers, turn it on and add x-api-key and x-api-secret with the instance values. Under Send Body, use JSON with the recipient's number and the text. Click Execute step to run the test.

4. 4

   Create the Webhook node to receive messages

   In a new flow, add the Webhook node as the trigger. Copy the Production URL it generates and register that address as the webhook URL of your instance in ZapZap API. That way, every event (incoming message, delivery status) lands straight in n8n.

5. 5

   Activate and handle the events

   Turn on the workflow's Active toggle so the Webhook goes into production. After the Webhook node, add nodes such as IF, Set or another HTTP Request to react: reply automatically, write to a database or notify the team. Close the flow with a Respond to Webhook node if you need to return 200 quickly.

// ILLUSTRATIVE example of the HTTP Request node in n8n (POST)
// Exact fields and path: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
  x-api-key: YOUR_API_KEY
  x-api-secret: YOUR_API_SECRET
  Content-Type: application/json
Body:
{
  "number": "5511999999999",
  "text": "Hello! Your appointment is confirmed."
}