Qué puedes enviar
Todos los endpoints usan la ruta
/whatsapp/{phoneNumberId}/.
El texto es opcional y tiene un máximo de 1,024 caracteres. Si no lo envías, el cliente recibe solo el archivo.
Los mensajes de audio no admiten texto. Si necesitas enviar audio y texto, mándalos como mensajes separados.
Antes de enviar
1
Configura tu API key
Envía
x-ib-api-key en cada solicitud. Consulta Autenticación.2
Verifica la ventana de 24 horas
Los mensajes con archivo y texto solo se entregan si el cliente te escribió en las últimas 24 horas. Para iniciar una conversación o escribir fuera de esa ventana, usa una plantilla aprobada con archivo en el header.
3
Publica el archivo en una URL pública
El archivo debe estar disponible en una URL HTTPS accesible sin autenticación ni cookies. No se aceptan archivos en base64 ni cargas directas en esta solicitud.
4
Elige el endpoint según el tipo de archivo
Usa
/document, /image o /video según la tabla anterior.Estructura del body
Los tres endpoints recibento y la URL del archivo, pero la estructura cambia según el tipo. Revisa la guía del endpoint antes de armar el body.
to es el teléfono del destinatario en formato E.164, solo dígitos y sin +.
Ejemplos
Respuesta
Los tres endpoints responden200 con el identificador del mensaje en messages[0].id.
Errores frecuentes
Enviar documento
PDF, Word, Excel, PowerPoint o TXT con texto.
Enviar imagen
Imagen JPEG o PNG con texto.
Enviar video
Video MP4 o 3GP con texto.

