Skip to main content
POST
/
v1
/
messages
/
audio
Send audio (voice/PTT supported)
curl --request POST \
  --url https://api.keebai.com/v1/messages/audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "+5491155555555",
  "phone_number_id": "100000000000001",
  "link": "<string>",
  "media_id": "<string>",
  "voice": true,
  "meta_data": {}
}
'
{
  "message_id": "<string>",
  "status": "sent",
  "sent_at": "<string>"
}

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Body

application/json
to
string
required
Example:

"+5491155555555"

phone_number_id
string
required

WhatsApp Business phone_number_id (numeric identifier issued by Meta for the sending number).

Example:

"100000000000001"

media_id
string
voice
boolean

Send as voice (PTT) audio message.

meta_data
object

Free-form metadata persisted with the message. Returned on webhooks for correlation.

Response

202 - application/json
message_id
string
required

Meta message_id (wamid.*) of the sent WhatsApp message.

status
string
required
Example:

"sent"

sent_at
string
required

ISO-8601 timestamp of the dispatch.