Saltar al contenido principal

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

TipoDescripción
textTexto plano.
image / video / audio / documentMultimedia (URL o buffer).
locationLatitud/longitud.
contactvCard.
reactionReacción a un mensaje.
templatePlantilla de Meta (requiere template aprobado).
listLista interactiva con secciones y opciones.
buttonsBotones de respuesta rápida.
stickerSticker.

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.