Enviar WhatsApp

Envía un mensaje de WhatsApp. Soporta texto, imagen, video, audio y documentos

post/whatsapp/send

Authorizations

apikeystringheaderrequired

Body

application/json

instance_idstringrequired

ID de instancia de WhatsApp

numberstringrequired

Número de teléfono destino

messagestringrequired

Message content or media URL

typestring

Tipo de mensaje: text|image|video|audio|document (por defecto: text)

country_codestring

Código de país (por defecto: 52)

datestring

Fecha de programación para envío diferido

namestring

Nombre del contacto

captionstring

Texto descriptivo del medio

read_confirmationarray<any>

Configuración de confirmación de lectura

Response

200Operación exitosa

successboolean

messagestring

Mensaje de estado

statusinteger

codestring

Código de respuesta

creditnumber

Créditos consumidos

referencestring

ID de referencia del mensaje

idinteger

ID del mensaje (solo cuando show_id=1)

400Error de validación. Códigos posibles: `wa_400` (parámetros inválidos), `wa_401` (instancia no encontrada).

successboolean

Siempre `false` para respuestas de error

messagestring

Descripción del error en español

statusinteger

Código HTTP de la respuesta

codestring

Código de error estructurado (`{dominio}_{número}`). Identifica de forma única la causa del error para manejo programático.

401No autorizado — API Key no provista, inválida o expirada

successboolean

Siempre `false`

messagestring

Descripción del error de autenticación en español

statusinteger

Código HTTP

codestring

Código de error de autenticación (`auth_01`, `auth_05`, `auth_06`, `auth_07`, `auth_99`)

403Prohibido — La dirección IP no está autorizada para acceder (IP whitelist)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error: `auth_04` (IP no autorizada en whitelist)

429Demasiadas peticiones — Límite de rate limit excedido (100 mensajes/segundo producción, 100/día sandbox)

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error de rate limit

500Error interno del servidor

successboolean

Siempre `false`

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error interno

request_idstring· uuid

Identificador único de la petición. Inclúyelo al contactar a soporte.