Send WhatsApp 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"
  }
}

POST

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

Mostrar Response data

string

Internal UUID of the message record.

string

WhatsApp message ID returned by Meta.

string

Public URL where the media file is stored.

string

UUID of the conversation thread.

Error Codes

400 Bad Request — Missing required fields, invalid channel type, or invalid media data
401 Unauthorized — Invalid or missing API key
404 Not Found — Contact not found
500 Internal Server Error — Upload or Meta API failure

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"
  }
}

Documentación API

Voz

WhatsApp (WABA)

Canales y Conversaciones

Organización

Agentes

Contactos

Etiquetas

Llamadas

Números de Teléfono

Headers

Body

Response

Error Codes

Code Examples

​Headers

​Body

​Response

​Error Codes

​Code Examples

Headers

Body

Response

Error Codes

Code Examples