curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-document/{extension} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"document": "https://ejemplo.com/archivo.pdf",
"fileName": "Mi documento"
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensajes
Enviar documento
Envía documentos (PDF, DOC, XLS, etc.) por WhatsApp
POST
/
send-document
/
{extension}
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-document/{extension} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"document": "https://ejemplo.com/archivo.pdf",
"fileName": "Mi documento"
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Conceptos
Método para enviar documentos. La extensión del archivo debe indicarse en el path de la URL (p. ej.:/send-document/pdf). Puedes enviarlos mediante URL o mediante Base64.
Al enviarlo en Base64 es obligatorio incluir el prefijo con el tipo de documento, por ejemplo:
data:application/pdf;base64,.Los límites de tamaño y los formatos admitidos siguen las políticas de WhatsApp. Consulta la documentación oficial de WhatsApp para más detalles.
Autorizaciones
Secret Key generada en el panel de Seguridad de Omni Z-API
Parámetros de ruta
Extensión del archivo (p. ej.: pdf, docx, xlsx)
Ejemplo:
"pdf"
Cuerpo
application/json
Teléfono del destinatario (código de país + prefijo + número)
Ejemplo:
"5511999999999"
URL del documento o datos en Base64
Nombre del archivo
Descripción del documento
ID de un mensaje existente al que se quiere responder
Retardo en segundos antes del envío (1-15)
Rango requerido:
1 <= x <= 15