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 Buttons

AI-generated

Summary

Send an interactive WhatsApp message containing up to three quick-reply buttons to a specified recipient using a connected Kapso WhatsApp phone number.

Inputs

  • Phone Number Name or ID — Select the connected Kapso WhatsApp number (phoneNumberId) to send the message from; can be chosen from a list or specified by expression.
  • Recipient Phone (required) — Recipient's phone number in Meta format (8-15 digits, no plus or spaces).
  • Header Type — Optional interactive message header type: none, text, image, video, or document.
  • Header Media Source — If header is image, video, or document, specify if media is a public HTTPS URL or a media ID in Kapso.
  • Header Media URL — Public HTTPS URL for the header media (required if header media source is 'link').
  • Header Media ID — Media ID for the header media, usually returned by media upload or trigger (required if media source is 'id').
  • Header Document Filename — Optional filename to display to recipient for document headers.
  • Header Text — Optional header text above the message body (max 60 characters) for text headers.
  • Body Text (required) — Main message body text for the interactive message (max 1024 characters).
  • Buttons (required) — One to three quick-reply buttons. Each button requires a developer-defined button ID (returned in webhooks when tapped) and a button title label (max 20 characters).
  • Footer Text — Optional footer text below the interactive content (max 60 characters).
  • Message Send Options — Optional message settings including Reply To Message ID for quoting and opaque callback data for webhook correlation, not shown to recipients.

Output shape

a single response object containing the sent message details from Kapso API

The operation returns the API response object representing the message sent. Up to three buttons can be included. Header is optional and accepts various media types or text. Reply context and callback data are supported except for certain send operations noted.

Links

Discussion