Start an n8n workflow from a WhatsApp message

Use the Whatsable trigger to start an n8n workflow when a contact writes to your WhatsApp number.

The Whatsable trigger starts an n8n workflow when a contact sends a message to your WhatsApp number. In the n8n node list it appears as On new Incoming message event. Its node name is Incoming/outgoing WhatsApp message Trigger.

This page is the how-to guide. For every field the trigger sends, see n8n node fields. For the whole setup, from the API key to the first workflow, see the n8n overview.

When to use it

Reply fast

Answer a first message with a template, an AI reply, or a routing step.

Save every lead

Write each new contact and message into a sheet, a CRM, or a database.

Alert your team

Post to Slack or send an email when a message contains a word such as "refund".

Read ad leads

Read the Click-to-WhatsApp data (referral) of a new lead and label it by ad.

Set up the trigger

Add the trigger node

Click + in an empty workflow, search for Whatsable, open the Triggers list, and choose On new Incoming message event. A workflow starts from its trigger, so you do not need another one.

Copy the Production URL

Open Webhook URLs at the top of the node, select Production URL, and copy it. You paste it into the credential in the next step.

Create the credential

  1. In Credential to connect with, click + Create new credential.
  2. Choose the Whatsable credential for the trigger.
  3. Paste your WhatsAble API key into API Key.
  4. Paste the Production URL into Production URL.
  5. Give the credential a clear name, for example "WhatsAble Production", and click Save.

When you save, n8n checks your API key and registers the Production URL with WhatsAble. The trigger then appears under Settings → Webhooks in WhatsAble.

Treat the API key like a password. Never share it publicly or commit it to version control.

Choose when n8n answers

WhatsAble trigger node settings with HTTP Method POST and Respond Immediately
The trigger settings: HTTP method and when n8n responds

Leave HTTP Method on POST, the only option. For Respond, choose:

OptionBehavior
Immediatelyn8n answers as soon as the message arrives. Best for most workflows.
When Last Node Finishesn8n answers after the whole workflow has run.

Test, then activate

Click Execute step and send a WhatsApp message to your number from your own phone. n8n shows the message in the node output. Then save the workflow and turn Active on, so the Production URL receives live messages.

WhatsAble transcribes an incoming audio message to text automatically and puts the text in the payload. You can treat a voice note like a text message.

What the trigger gives you

Each run receives one JSON payload for one message. These are the fields you map most often. The other fields are in n8n node fields.

FieldMeaning
phone_numberThe contact's number. It can arrive as a number rather than a string.
recipient_nameThe contact's name in WhatsAble.
last_message_of_userThe text of the message that started the run.
message_typeThe kind of message: text, audio, image, or document.
attachment_urlA public URL of the attached file, or empty.
labelsThe labels on the conversation, separated by commas.
referralClick-to-WhatsApp ad data. Present only on a lead that came from an ad.

Example: save a lead and reply

Trigger

Add the Whatsable trigger.

Save the lead

Add a Google Sheets, Airtable or CRM node. Map phone_number, recipient_name and last_message_of_user to its columns.

Reply

Add a Whatsable node with Send WhatsApp Message. Map Recipient Phone Number from phone_number. Use Send Message Template, because a template also works when the contact wrote more than 24 hours ago.

When your workflow also sends messages, add an If node on incoming_message or send_by so that a message you send never starts the same workflow again.

Troubleshooting

On this page