W-apiInstall

Summary

Sends a WhatsApp carousel message of swipeable cards (each with title, body, image and buttons) to a number through a W-api instance. Posts to /buttons/sendCarousel/{instanceName} once per input item.

Inputs

• instanceName (required) — Name of the W-api instance used to send the message; it is part of the request URL.
• number (required) — Recipient number with country code and area code, no + or spaces (e.g. 5521999999999). Sent as to.
• cardsJson (required) — JSON array of carousel cards, e.g. [{"title":"Produto","body":"Descrição","imageUrl":"https://...","buttons":[{"id":"comprar","text":"Comprar"}]}]. Parsed before sending; invalid JSON throws an error naming the field. An already-parsed expression value is passed through as is.
• footer — Optional footer text sent with the carousel.
• sendOptions — Optional collection merged into the request body (empty values are dropped): delay (ms), quotedMessageId, quotedFromMe, quotedText, mentionAll, mentionNumbers, previewLink.

Output shape

One output item per input item, whose json is the W-api response body for the send request.

The source also reads a text parameter for this operation, but the UI shows no such field, so it is sent as an empty string. If 'Continue On Fail' is enabled, a failed item returns {error: message}; otherwise the node throws. Auth uses the wapiApi credential's baseUrl and apiKey.

Examples

Example 1: Send a product showcase to a customer

instanceName=minha-loja, number=5521999999999, cardsJson with two product cards each having imageUrl and a 'Comprar' button, footer='Atendimento 24h'.

Example 2: Send a carousel as a reply with a delay

Set cardsJson from an expression, and in Opcoes de Envio set quotedMessageId and delay=2000.

Links

• n8n community nodes installation guide