Skip to main content
Un mensaje con archivo y texto llega al cliente como un solo mensaje de WhatsApp: el archivo arriba y tu texto debajo, como pie del archivo. Se usa, por ejemplo, para enviar una póliza en PDF con un saludo o una credencial en imagen con instrucciones.

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 reciben to 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 responden 200 con el identificador del mensaje en messages[0].id.
Guarda messages[0].id para relacionar el envío con tu registro interno.

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.