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:
422con{success: false, message: {campo: [mensajes]}}. - Falta configuración o Meta rechaza el mensaje: HTTP 200 con
success: falsey el detalle enmessage.
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.