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 Audio

AI-generated

Summary

Send an audio message to a WhatsApp recipient through the selected Kapso phone number, using a Meta media ID or a public URL. Optionally send the audio as a voice note and include reply context or callback data.

Inputs

  • Phone Number Name or ID — Select a connected Kapso WhatsApp number or provide its ID.
  • Recipient Phone (required) — Recipient number in Meta format: 8–15 digits, without a plus sign or spaces.
  • Media Source — Choose a Meta media ID (default) or a public link.
  • Media ID (required) — Required when Media Source is Media ID; use an ID returned by Upload Media or a Kapso Trigger media attachment.
  • Public URL (required) — Required when Media Source is Public Link; provide an HTTP or HTTPS URL for the media file.
  • Send As Voice Note — When enabled, sends the audio as a WhatsApp push-to-talk voice message. Defaults to false.
  • Reply To Message ID — Optional WAMID of the message to reply to.
  • Callback Data — Optional metadata, up to 512 characters, returned in message status webhooks and not shown to recipients.

Output shape

A single item containing the Kapso API response for the send request.

The response fields depend on the API response. The operation sends a WhatsApp audio message; the voice-note setting changes its audio presentation.

Examples

Example 1: Send an uploaded audio file

Select a connected phone number, enter the recipient’s digits-only phone number, choose Media ID, provide the uploaded media ID, and leave Send As Voice Note disabled.

Example 2: Send audio as a voice note

Select Public Link and provide an HTTP or HTTPS URL for the audio, then enable Send As Voice Note.

Links

Discussion