Las cuatro formas de enviar un mensaje y cuál aplica según la ventana de 24h.
La API ofrece cuatro formas de enviar un mensaje de WhatsApp en nombre de tu
negocio. Cuál puedes usar depende del estado de la
ventana de 24h de la conversación.
Acepta un reply_to_uuid opcional para citar un mensaje previo. Responde
201 con message_uuid y wamid.
Imagen, video, audio o documento — mismo endpoint que texto
(POST /conversation/messages/text), pasando un file_uuid en vez de —o
junto a— body como caption.
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \ -H "Authorization: Bearer sk_1to1_tu_api_key" \ -H "Content-Type: application/json" \ -d '{ "conversation": { "phone": "+5215512345678" }, "file_uuid": "7b8a...", "body": "Aquí está tu comprobante 📄" }'
El file_uuid debe ser de un archivo ya subido y confirmado, del mismo
negocio. El tipo de mensaje (imagen, video, audio, documento) se deduce
automáticamente del archivo. Ver el flujo de /files en la Referencia de
API.
body (caption) no es compatible con archivos de audio. WhatsApp no
soporta captions en audio — combinarlos retorna INVALID_REQUEST (400).
Una respuesta preconfigurada en el dashboard, vía
POST /conversation/messages/quick-reply. Se identifica por uno de
quick_reply_uuid o quick_reply.name (XOR estricto — mandar ambos
devuelve 400 INVALID_REQUEST).
Una quick reply puede emitir varios mensajes, por eso la respuesta es un
array messages con un message_uuid, wamid y subtype por cada uno.
Una plantilla aprobada por Meta, vía POST /conversation/messages/template.
Es el único modo que funciona con la ventana cerrada — ver
Plantillas para el detalle.
