AutomiQ for WhatsApp (n8n community node)

Send and receive WhatsApp messages in n8n through the AutomiQ Gateway, which uses the official WhatsApp Cloud API.

One credential, no HTTP Request nodes, no Code nodes, no secrets pasted into workflows:

• AutomiQ for WhatsApp: send text, media and template messages, and mark messages as read. Works as a tool for n8n AI Agents.
• AutomiQ for WhatsApp Trigger: receives messages and delivery statuses, verifies every delivery inside the node, and outputs one clean item per message.

n8n is a fair-code licensed workflow automation platform.

WhatsApp is a trademark of Meta Platforms, Inc. AutomiQ is not affiliated with, endorsed by or sponsored by Meta.

Installation · Credentials · Operations · Trigger · Errors · Compatibility · Resources · Version history

Installation

You need an AutomiQ account with a connected WhatsApp number. Get started at www.automiq.fi.

n8n (self-hosted or Cloud, where community nodes are allowed):

1. Go to Settings > Community Nodes.
2. Select Install and enter @automiq/n8n-nodes-automiq.
3. Confirm and install.

See the n8n community nodes installation guide for details.

Manual install (self-hosted): run npm install @automiq/n8n-nodes-automiq in your n8n custom nodes folder (usually ~/.n8n/custom) and restart n8n.

Credentials

Create one AutomiQ API credential. Both nodes use it.

When you save the credential, n8n tests the API key against AutomiQ. A wrong or revoked key shows "Invalid or revoked AutomiQ API key".

Recommended: in the credential, set Allowed HTTP Request Domains to www.automiq.fi, so this key can never be sent to another site from an HTTP Request node.

Operations

All operations are under Resource: Message. Pick the Sender Phone Number from the list. It shows the numbers connected to your AutomiQ account.

Send Text

Free-form messages can only be sent within 24 hours after the customer last wrote to you. Outside that window, use Send Template.

Send Media

Send Template

Templates are the only way to start a conversation, or to write to someone after the 24-hour window.

Mark as Read

Use with AI Agents

The node can be used as a tool by n8n AI Agents. A common setup: AutomiQ for WhatsApp Trigger > Mark as Read with typing indicator > AI Agent > Send Text with Recipient {{ $json.from }}.

Trigger

Setup

1. Add AutomiQ for WhatsApp Trigger to a workflow and select your AutomiQ API credential, with the Webhook Secret filled in.
2. Copy the trigger's Production URL.
3. In the AutomiQ portal, open Webhook, paste the URL and save.
4. Activate the workflow.

Why the URL is set by hand: AutomiQ has one webhook URL per account, and it can only be changed in the portal after a recent sign-in. There is deliberately no API to change it, because anyone who could change it could redirect every incoming message.

Security

Every delivery is verified inside the node, before your workflow runs:

• The x-automiq-signature header must be the HMAC-SHA256 of the timestamp and the exact raw body, signed with your webhook secret.
• The x-automiq-timestamp must be within 5 minutes, which blocks replayed deliveries.
• Anything else gets 401 and does not start the workflow.

You do not need Header Auth, a Code node or the crypto module setting on self-hosted n8n.

Events

Use Messages for reply bots. Statuses have no sender (from), so an expression like {{ $json.from }} is empty for them.

Output

One item per message or status. Each item also includes raw with Meta's original object, so no field is ever lost.

Message:

{
  "event": "message",
  "message_id": "wamid.HBgM...",
  "from": "16505551234",
  "from_user_id": "US.123456",
  "name": "Jessica",
  "type": "text",
  "timestamp": 1792772499,
  "text": "Hello!",
  "phone_number_id": "1352140101310633",
  "display_phone_number": "358468045157",
  "waba_id": "1994442441262596",
  "raw": { "...": "Meta's original message" }
}

Depending on the message type, it also has media_id, mime_type, caption and filename (media), reply_id (button and list replies), latitude and longitude (location), emoji (reactions) and reply_to_message_id (when the customer replied to a message).

Status: event: "status", message_id, status, recipient_id, recipient_user_id, timestamp, errors (for failed messages), plus the same number fields and raw.

Options

Debugging with real messages

Use the portal's Test webhook URL to see real WhatsApp messages in a test run, without touching your live workflow.

While a test URL is set, every delivery to your production URL is also sent to the test URL, with the same body, signature and token. The two go out in parallel, so a slow test URL never holds up production. The test URL:

• stops receiving copies 1 hour after it was last set. Keep for 1 more hour restarts the hour.
• needs a sign-in from the last 10 minutes to set or extend. Removing it does not.
• receives nothing when no production URL is set.

Option A: n8n Cloud or any public n8n

1. Open the workflow and copy the trigger's Test URL (it contains /webhook-test/).
2. In the AutomiQ portal, open Webhook and paste it as the Test webhook URL.
3. In n8n, select Execute workflow, then send a WhatsApp message to your number within about 2 minutes.

n8n catches one request per listen. Other copies get 404 and are logged as failed test deliveries, which do not count in the portal's health figures.

Option B: local n8n

1. Expose n8n over https, for example with cloudflared tunnel --url http://localhost:5678.
2. Use https://<your-tunnel>/webhook/<id>/webhook as the Test webhook URL, with the workflow active.

Quick tunnel addresses change every time you start one.

Before you test:

• A test run executes the whole workflow, so your replies are sent twice: once by production and once by the test run. Deactivate the nodes that send messages in the editor (select the node and press D) and do not save.
• Do not use public request bins such as webhook.site. Anyone with the link can see the message content and the x-automiq-token header.
• Remove the test URL when you are done.

Errors

The nodes translate the most common errors into plain messages. The original WhatsApp text and code are always shown in the details.

Compatibility

• Tested with n8n 2.44.6.
• Requires an n8n version that supports community nodes.
• No runtime dependencies.

Resources

• AutomiQ and the AutomiQ portal
• n8n community nodes documentation
• WhatsApp Cloud API: send messages
• WhatsApp message templates
• Changelog

Version history

0.2.1: README: debugging with the portal's Test webhook URL.

0.2.0: first full release.

• AutomiQ API credential with a live key test and clear messages for invalid keys and suspended accounts.
• AutomiQ for WhatsApp: Send Text, Send Media, Send Template (with a list of approved templates) and Mark as Read (with an optional typing indicator). Usable as an AI Agent tool.
• AutomiQ for WhatsApp Trigger: in-node signature and timestamp verification, one clean item per message or status, and options for duplicates, portal pings and the raw payload.
• Plain-language errors for the most common gateway and WhatsApp errors.

0.1.x: placeholder releases used to set up publishing.

License

MIT