Saltar al contenido principal
POST
/
v1
/
waba
/
send
curl -X POST "https://api.contactship.ai/v1/waba/send" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "chn_abc123",
    "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "content": "Hello! How can I help you today?"
  }'

{
  "success": true,
  "message": "Mensaje WABA enviado",
  "data": {
    "message_id": "msg-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "provider_id": "wamid.HBgNMTIxMjM0NTY3ODkwFQIAERgSM...",
    "thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "status": "sent"
  }
}
Sends a plain text message to a contact through a configured WhatsApp Business channel. Automatically creates or reuses an existing conversation thread.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication. Found in your dashboard under API settings.

​
Body

​
channel_id
string
requerido
UUID of the WABA channel to send from. Find your channel IDs in your dashboard under Channels.
​
contact_id
string
requerido
UUID of the contact to message. The contact must have a valid WhatsApp number (wa_id or phone_number).
​
content
string
requerido
The text content of the message.
​
thread_id
string
UUID of an existing conversation thread. If provided, channel_id and contact_id are inferred from the thread automatically.

​
Response

​
success
boolean
true if the message was sent successfully.
​
message
string
Human-readable status description.
​
data
object

​
Error Codes

  • 400 Bad Request — Missing required fields or channel is not WABA type
  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Channel or contact not found
  • 500 Internal Server Error — Server-side or Meta API error

​
Code Examples

curl -X POST "https://api.contactship.ai/v1/waba/send" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "chn_abc123",
    "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
    "content": "Hello! How can I help you today?"
  }'

{
  "success": true,
  "message": "Mensaje WABA enviado",
  "data": {
    "message_id": "msg-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "provider_id": "wamid.HBgNMTIxMjM0NTY3ODkwFQIAERgSM...",
    "thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "status": "sent"
  }
}