Enviar PDF por WhatsApp (QR)
POST /api/qrapi/send-message
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Envía un comprobante PDF por WhatsApp desde el número conectado por QR en la configuración de la empresa; opcionalmente envía además un texto con un enlace.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
number |
string | Sí | Número destino con código de país, sin + (p. ej. 51987654321). |
file |
string | Sí | PDF: URL pública o contenido en base64. |
filename |
string | Sí | Nombre del archivo que verá el destinatario. |
message |
string | Sí | Texto que acompaña al PDF. |
link |
string | No | Enlace para un segundo mensaje: <message>: puede revisarlo en el siguiente enlace <link>. |
Reglas:
- Requiere la opción de mensajes por QR habilitada y un número conectado.
- Hay un límite de mensajes según el plan de la empresa.
Errores:
422si falta un campo, la opción no está habilitada, no hay número conectado o se superó el límite (success: false,message).500si el proveedor de WhatsApp no pudo enviar.
Cuerpo
Content-Type: application/json
{
"number": "51987654321",
"file": "https://empresa.dominio/print/document/a1b2c3d4-e5f6-4789-abcd-ef0123456789/a4",
"filename": "F001-245.pdf",
"message": "Hola, te enviamos tu comprobante F001-245",
"link": "https://empresa.dominio/print/document/a1b2c3d4-e5f6-4789-abcd-ef0123456789/a4"
}
Respuestas
200 — Enviado
{
"success": true,
"data": {
"key": {
"id": "3EB0A1B2C3D4"
},
"status": "PENDING"
},
"media_sent": true,
"link_sent": true
}
422 — No habilitado
{
"success": false,
"message": "La opción de enviar mensajes no está habilitada"
}
500 — Falló el envío
{
"success": false,
"message": "No se pudo enviar el comprobante por WhatsApp."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.