WAOtomatisInstall

Summary

Sends a WhatsApp message from a chosen WAOtomatis session to a phone number. It supports text, media, template, interactive, reaction, location, contacts and carousel messages, and returns the API's response.

Inputs

• Session (required) — Connected WhatsApp number to send from. Pick it from a searchable list or enter a session ID. The node errors if none is selected.
• To (required) — Recipient phone number as E.164 digits, with no '+' or spaces.
• Message Type (required) — One of text, image, video, audio, document, sticker, template, interactive, reaction, location, contacts or carousel. It determines which other fields appear.
• Text (required) — Message body. Used when the type is text.
• Media Source / Media URL / Media ID (required) — For image, video, audio, document and sticker. Reference either a public URL or a media ID from a previous Media → Upload.
• Caption — Sent for image, video and document messages only.
• File Name — Document name shown to the recipient. Documents only.
• Send as Voice Note — Delivers audio as a push-to-talk voice note.
• Template Name / Language Code / Components (JSON) — For template messages. Name and language code are required. Components is an optional JSON array of header, body and button parameters.
• Interactive fields — Interactive Type selects reply buttons, list, CTA URL, flow, product or product list. Each type has its own body, header and footer text and its own fields. Reply buttons need at least one button, and lists need at least one section with a row. Product types need a Catalog ID, and a product list also needs Product Sections JSON. Flows take Flow CTA plus optional ID, token, action, mode and payload.
• Reaction fields — For the reaction type: the wamid of the target message, and an emoji. An empty emoji clears an existing reaction.
• Location fields — Latitude and longitude are required. Name and address are optional.
• Contacts (JSON) — Required array of WhatsApp contact cards. Each card needs name.formatted_name.
• Carousel fields — Template Name, Language Code and Cards (JSON) are required. Body Params (JSON) is optional.
• Options — Reply To (quotes a message by wamid), Idempotency Key (sent as an Idempotency-Key header so retries are de-duplicated), and Link Preview (text messages only).

Output shape

One output item per input item, containing the JSON response from the WAOtomatis API after it accepts the message (POST /v1/sessions/{id}/messages).

The exact response fields are defined by the API and aren't visible in the source. Invalid JSON in any JSON field throws an error. With Continue On Fail enabled, a failed item returns {error: message} instead. API errors include the error code and message.

Examples

Example 1: Send an order confirmation image with a caption

Message Type=Image, Media Source=By URL, Media URL=https://example.com/order.jpg, Caption='Your order is confirmed', To={{$json.phone}}

Example 2: Offer quick-reply choices

Message Type=Interactive, Interactive Type=Reply Buttons, Body Text='Need help?', Buttons: yes/Yes and no/No

Example 3: Send a template safely on retry

Message Type=Template, Template Name=order_update, Language Code=en_US, Options → Idempotency Key={{$json.orderId}}

Links

• n8n community nodes installation guide