Mensajería unificada
WhatsUY abstrae el envío de mensajes a través de Baileys, Meta Cloud API y Messenger con un único contrato.
Enviar mensaje de texto
curl --location --request POST 'https://path-api-test.whatsuy.com/chats/send' \
--header 'Authorization: Bearer <jwt>' \
--header 'Content-Type: application/json' \
--data-raw '{
"reference": 12345,
"chatId": "59891234567@s.whatsapp.net",
"message": {
"type": "text",
"text": "Hola! Gracias por escribirnos."
}
}'
Tipos de mensaje soportados
| Tipo | Descripción |
|---|---|
text | Texto plano. |
image / video / audio / document | Multimedia (URL o buffer). |
location | Latitud/longitud. |
contact | vCard. |
reaction | Reacción a un mensaje. |
template | Plantilla de Meta (requiere template aprobado). |
list | Lista interactiva con secciones y opciones. |
buttons | Botones de respuesta rápida. |
sticker | Sticker. |
Mensajería masiva (broadcast)
curl --location --request POST 'https://path-api-test.whatsuy.com/chats/broadcast' \
--header 'Authorization: Bearer <jwt>' \
--data-raw '{
"reference": 12345,
"recipients": ["59891111111@s.whatsapp.net", "59892222222@s.whatsapp.net"],
"message": { "type": "text", "text": "Promo!" }
}'
Listar chats
GET /chats/list?reference=12345&limit=50&offset=0
Devuelve lista paginada de chats con último mensaje, unread count y metadata.
Mensajes de un chat
GET /chats/messages?reference=12345&chatId=<chatId>&limit=50&before=<unix_ts>
Detalle completo de tipos, formatos y restricciones por proveedor en
api-documentation/05-mensajeria-unificada.mdx.