Enviar WhatsApp
Envía un mensaje de WhatsApp con los parámetros en el query string. Recomendamos usar la versión POST para no exponer tu API Key en la URL.
get
/whatsapp/sendParámetros de consulta
instance_idstringrequerido
ID de la instancia de WhatsApp desde la cual se envía el mensaje
numberstringrequerido
Número de teléfono destino
messagestringrequerido
Contenido del mensaje o URL del archivo multimedia
typestring
Tipo de mensaje:
text, image, video, audio o document (por defecto: text)country_codestring
Código de país (por defecto: 52)
datestring
Fecha de programación para envío diferido
captionstring
Texto descriptivo del medio
Respuesta
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 (
whatsapp_04 instancia no definida, whatsapp_05 type inválido, whatsapp_06 mensaje no definido, whatsapp_07 número no definido, whatsapp_22 país inválido, whatsapp_23 número con formato incorrecto, whatsapp_24 fecha pasada, whatsapp_28/whatsapp_38 texto/caption de más de 1000 caracteres, whatsapp_29 formato de fecha, whatsapp_35 país no soportado, whatsapp_37 URL multimedia inválida). Si tu integración aún requiere el comportamiento anterior, envía el header X-Api-Http-Semantics: 0 y la respuesta llegará con HTTP 200 y el error en el cuerpo.successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.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
Campo legado en el cuerpo. Es el status HTTP de transporte; para autenticación coincide con el status real (401). Usa el status HTTP y el code, no este campo.
codestring
Código de error de autenticación (auth_01, auth_03, auth_05)
402Saldo insuficiente para completar el envío (
code: sms_07, contrato de compatibilidad).successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.
403Prohibido: La dirección IP no está autorizada para acceder (IP whitelist)
successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Campo legado en el cuerpo. Puede NO coincidir con el status HTTP real: para auth_06 y auth_07 este campo vale 401 (valor histórico congelado) mientras el status HTTP de transporte es 403. Usa el status HTTP y el code, no este campo.
codestring
Código de error: auth_04 (IP no autorizada), auth_06 (cuenta deshabilitada), auth_07 (admin inválido)
404La instancia de WhatsApp indicada no existe o está inactiva (
code: whatsapp_08).successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.
429Demasiadas peticiones. Límite propio de este endpoint contra envíos masivos por WhatsApp: máximo 1 envío cada 60 segundos (no aplica aquí el límite general de 100 mensajes/segundo del resto de la API). Al excederlo, la cuenta queda bloqueada 2 minutos con un cuerpo de error distinto al resto de la API (sin
success ni code). Usa SMS para volumen.errorbooleanrequerido
Siempre true
messagestringrequerido
Descripción del error
rate-limitedstringrequerido
Duración del bloqueo activo
reasonstringrequerido
Motivo del throttle
500Error interno del servidor. Códigos posibles:
whatsapp_30/whatsapp_31/whatsapp_32 (resolución de servidor / confirmación de lectura / URLs de WhatsApp), whatsapp_36 (generación del mensaje), sms_12 (créditos), err_03 (inesperado).successboolean
Siempre false
messagestring
Descripción del error
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (p.ej. 200 o 401 según el endpoint) y NO coincide con el status HTTP real (500). Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error interno (p.ej. server_01, o auth_99 en un error interno de autenticación)
request_idstring· uuid
Identificador único de la petición. Inclúyelo al contactar a soporte.
502La línea o proveedor de WhatsApp no está disponible aguas abajo (
code: whatsapp_20). Reintenta con backoff.successboolean
Siempre false para respuestas de error
messagestring
Descripción del error en español
statusinteger
Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el
code, no este campo.codestring
Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.