curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "image",
"media_data": "https://example.com/product-catalog.jpg",
"content": "Check out our latest catalog!"
}'
curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "document",
"media_data": "https://example.com/invoice.pdf",
"file_name": "invoice_2026.pdf",
"content": "Your invoice for this month"
}'
const response = await fetch(
'https://api.contactship.ai/v1/waba/send-media',
{
method: 'POST',
headers: {
'x-api-key': 'your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
channel_id: 'chn_abc123',
contact_id: 'c1d2e3f4-a5b6-7890-cdef-123456789012',
media_type: 'image',
media_data: 'https://example.com/product-catalog.jpg',
content: 'Check out our latest catalog!',
}),
}
);
const result = await response.json();
console.log(`Media URL: ${result.data.media_url}`);
import requests
response = requests.post(
'https://api.contactship.ai/v1/waba/send-media',
headers={'x-api-key': 'your-api-key'},
json={
'channel_id': 'chn_abc123',
'contact_id': 'c1d2e3f4-a5b6-7890-cdef-123456789012',
'media_type': 'image',
'media_data': 'https://example.com/product-catalog.jpg',
'content': 'Check out our latest catalog!',
},
)
print(response.json())
{
"success": true,
"message": "Media enviado y guardado",
"data": {
"message_id": "msg-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"provider_id": "wamid.HBgNMTIxMjM0NTY3ODkwFQIAERgSM...",
"media_url": "https://example.com/product-catalog.jpg",
"thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}
WhatsApp (WABA)
Send WhatsApp Media
Send an image, video, audio, or document via WhatsApp Business API
POST
/
v1
/
waba
/
send-media
curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "image",
"media_data": "https://example.com/product-catalog.jpg",
"content": "Check out our latest catalog!"
}'
curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "document",
"media_data": "https://example.com/invoice.pdf",
"file_name": "invoice_2026.pdf",
"content": "Your invoice for this month"
}'
const response = await fetch(
'https://api.contactship.ai/v1/waba/send-media',
{
method: 'POST',
headers: {
'x-api-key': 'your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
channel_id: 'chn_abc123',
contact_id: 'c1d2e3f4-a5b6-7890-cdef-123456789012',
media_type: 'image',
media_data: 'https://example.com/product-catalog.jpg',
content: 'Check out our latest catalog!',
}),
}
);
const result = await response.json();
console.log(`Media URL: ${result.data.media_url}`);
import requests
response = requests.post(
'https://api.contactship.ai/v1/waba/send-media',
headers={'x-api-key': 'your-api-key'},
json={
'channel_id': 'chn_abc123',
'contact_id': 'c1d2e3f4-a5b6-7890-cdef-123456789012',
'media_type': 'image',
'media_data': 'https://example.com/product-catalog.jpg',
'content': 'Check out our latest catalog!',
},
)
print(response.json())
{
"success": true,
"message": "Media enviado y guardado",
"data": {
"message_id": "msg-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"provider_id": "wamid.HBgNMTIxMjM0NTY3ODkwFQIAERgSM...",
"media_url": "https://example.com/product-catalog.jpg",
"thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}
Sends a media message (image, video, audio, or document) to a contact through a WABA channel. You can provide a public URL or a base64-encoded file.
Headers
string
requerido
Your API key for authentication.
Body
string
requerido
UUID of the WABA channel to send from.
string
requerido
UUID of the contact to message.
string
requerido
Type of media to send. Possible values:
image, video, audio, document.string
requerido
Either a publicly accessible URL (e.g.
https://example.com/image.jpg) or a base64-encoded string of the file. If base64, the file is uploaded to storage automatically.string
Optional caption for the media (text displayed below the file).
string
Original filename for document types (e.g.
invoice.pdf). Defaults to a generated name based on media type.string
UUID of an existing thread. If provided,
channel_id and contact_id are inferred automatically.boolean
predeterminado:"true"
Whether to save the message in the conversation thread. Defaults to
true.Response
boolean
true if the media was sent successfully.object
Error Codes
400 Bad Request— Missing required fields, invalid channel type, or invalid media data, or Meta rejected the request (messagecarries the reason Meta gave, for example an expired channel token or a re-engagement window that closed)401 Unauthorized— Invalid or missing API key404 Not Found— Contact not found429 Too Many Requests— Meta rate limit; retry after a pause500 Internal Server Error— Upload or server-side failure502 Bad Gateway— Meta API unavailable; safe to retry
Code Examples
curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "image",
"media_data": "https://example.com/product-catalog.jpg",
"content": "Check out our latest catalog!"
}'
curl -X POST "https://api.contactship.ai/v1/waba/send-media" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_abc123",
"contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
"media_type": "document",
"media_data": "https://example.com/invoice.pdf",
"file_name": "invoice_2026.pdf",
"content": "Your invoice for this month"
}'
const response = await fetch(
'https://api.contactship.ai/v1/waba/send-media',
{
method: 'POST',
headers: {
'x-api-key': 'your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
channel_id: 'chn_abc123',
contact_id: 'c1d2e3f4-a5b6-7890-cdef-123456789012',
media_type: 'image',
media_data: 'https://example.com/product-catalog.jpg',
content: 'Check out our latest catalog!',
}),
}
);
const result = await response.json();
console.log(`Media URL: ${result.data.media_url}`);
import requests
response = requests.post(
'https://api.contactship.ai/v1/waba/send-media',
headers={'x-api-key': 'your-api-key'},
json={
'channel_id': 'chn_abc123',
'contact_id': 'c1d2e3f4-a5b6-7890-cdef-123456789012',
'media_type': 'image',
'media_data': 'https://example.com/product-catalog.jpg',
'content': 'Check out our latest catalog!',
},
)
print(response.json())
{
"success": true,
"message": "Media enviado y guardado",
"data": {
"message_id": "msg-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"provider_id": "wamid.HBgNMTIxMjM0NTY3ODkwFQIAERgSM...",
"media_url": "https://example.com/product-catalog.jpg",
"thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}