Saltar al contenido
Facturador

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:

  • 422 si falta un campo, la opción no está habilitada, no hay número conectado o se superó el límite (success: false, message).
  • 500 si 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.