Kapso API icon

Kapso API

Send WhatsApp messages, templates, flows, media, contacts, broadcasts, and inbox records through Kapso. Choose a resource, then follow each operation setup hints.

Message → Send and Wait for Response

AI-generated

Summary

Send a WhatsApp text message via Kapso and then pause the workflow until the recipient interacts by opening an approval link sent within the message.

Inputs

  • Phone Number Name or ID — Select the connected Kapso WhatsApp number to send the message from, either from the loaded list or by specifying an ID via expression.
  • Recipient Phone (required) — The recipient's phone number in Meta format (8 to 15 digits, no + or spaces).
  • Message (required) — The plain text message to send before waiting for approval, up to 4096 characters not including appended approval links and attribution.
  • Message Send Options — Optional settings such as 'Reply To Message ID' to thread the message or 'Callback Data' for opaque webhook metadata.
  • Approval Options — Configure whether the recipient can only approve or both approve and decline, and customize button labels for approval actions.
  • Delivery Mode — Choose how approval links are delivered: as text links (works with single or double approval) or as a single tappable CTA URL button (single approval only, within WhatsApp 24-hour session window).
  • Options — Optional wait timeout settings to limit how long the workflow waits for recipient approval before resuming without a response, and whether to append an n8n attribution message.

Output shape

a single data item containing the response from Kapso which includes message send confirmation and approval interaction status upon recipient's action or timeout.

The operation sends a message then pauses workflow execution until the recipient clicks an approval or decline link or until the optional timeout expires. The output includes details of the send operation and approval result. Delivery mode restrictions apply: double approval requires text links; the CTA button mode allows only one approval action within the messaging session window.

Examples

Example 1: Send a message that asks the recipient to approve a request, then waits for their interaction before proceeding.

Specify phoneNumberId, recipient phone number, message text, set approvalOptions to single or double, choose delivery mode as textLinks or CTA button, and optionally set a wait timeout.

Links

Discussion