Saltar al contenido
Facturador

Enviar mensaje por WhatsApp Cloud API

POST /api/whatsapp-cloud/send-message

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Envía un texto o un documento por la API oficial de WhatsApp (Meta) con el número y token configurados por la empresa.

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
send_type string Sí text o document.
phone_number numeric Sí Número destino sin código de país.
prefix_number string No Código de país (por defecto 51).
message string Sí si send_type = text Texto del mensaje.
document.link string Sí si send_type = document URL pública del documento.
document.filename string Sí si send_type = document Nombre del archivo.
document.caption string No Texto que acompaña al documento.

Reglas:

  • La empresa debe tener configurados el identificador del número y el token de acceso de WhatsApp Cloud.

Errores:

  • Validación: 422 con {success: false, message: {campo: [mensajes]}}.
  • Falta configuración o Meta rechaza el mensaje: HTTP 200 con success: false y el detalle en message.

Cuerpo

Content-Type: application/json

{
  "send_type": "document",
  "phone_number": "987654321",
  "prefix_number": "51",
  "message": "Hola, te enviamos tu comprobante",
  "document": {
    "link": "https://empresa.dominio/print/document/a1b2c3d4-e5f6-4789-abcd-ef0123456789/a4",
    "filename": "F001-245.pdf",
    "caption": "Comprobante F001-245"
  }
}

Respuestas

200 — Enviado

{
  "success": true,
  "message": "Mensaje enviado correctamente."
}

200 — Sin configuración

{
  "success": false,
  "message": "No tiene registrado correctamente el token de acceso"
}

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.