W-apiInstall

Summary

Sends a WhatsApp quick-reply button message through a W-api instance by POSTing to /buttons/sendButtons/{instanceName}. Runs once per input item and returns the API response.

Inputs

• instanceName (required) — Name of the W-api instance used to send the message; becomes part of the request URL.
• number (required) — Recipient number with country code and area code, no + or spaces. Sent as to.
• text (required) — Main message text shown above the buttons.
• footer — Optional footer text. Sent as an empty string if left blank.
• buttonsJson (required) — JSON array of buttons, e.g. [{"id":"opcao1","text":"Opção 1"}]. It is parsed before sending. Invalid JSON throws an error naming the field.
• sendOptions — Optional collection merged into the request body: delay (ms), quotedMessageId, quotedFromMe, quotedText, mentionAll, mentionNumbers, previewLink. Empty or null values are dropped.

Output shape

One output item per input item, with json set to the W-api response body for the send request.

The node's credentials (baseUrl and apiKey) supply the host and apikey header. If 'Continue on Fail' is enabled, a failed item returns {error: message} instead of stopping the workflow. The response fields depend on the W-api server and are not defined in the node.

Examples

Example 1: Send a yes/no confirmation prompt to a customer after an order is placed.

instanceName=minha-loja, number=5521999999999, text='Confirmar pedido?', buttonsJson=[{"id":"sim","text":"Sim"},{"id":"nao","text":"Não"}], footer='Atendimento 24h'

Links

• n8n community nodes installation guide