Enviar quick reply (multi-message)
Envía un quick reply configurado en el business. Un QR puede contener múltiples acciones (text, files, audio, buttons) y cada una emite un mensaje independiente a Meta — por eso la respuesta es un array con los mensajes que se generaron en orden.
Referencia al quick reply — dos formas (provee exactamente una):
quick_reply_uuid: el UUID canónico. Obtén el catálogo desdeGET /quick-replies.quick_reply: { name }: identificación por el string que el agente ve en el dashboard. Único por business case-insensitive ignorando espacios en extremos (UNIQUE (business_id, LOWER(TRIM(name)))). El match es case-insensitive (“prueba” resuelve “Prueba”).QUICK_REPLY_AMBIGUOUSqueda como defense-in-depth si un hotfix afloja el unique index.
Partial success:
Si alguna de las acciones del QR falla (por ejemplo, Meta rechaza uno de los adjuntos), las otras aún se intentan. La respuesta incluye solo los mensajes que se enviaron con éxito. Si ninguno se envía, la respuesta es SEND_FAILED (502). Los mensajes fallidos quedan en audit_integration_logs + broadcast de realtime con status=failed.
Guards aplicados:
- Ventana 24h — obligatoria. Si está cerrada, usa
/conversation/messages/templateprimero para reabrirla. - Wallet general — NO aplica (paridad con el envío manual del dashboard).
- Wallet visión — aplica si el QR incluye una acción
filesoaudio(el AI podría necesitarla al procesar respuestas del cliente).
Documentation Index
Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt
Use this file to discover all available pages before exploring further.
Autorizaciones
API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_...
Parámetros de ruta
Slug del business, case-insensitive. Debe coincidir con el business del token.
"acme"
Cuerpo
- Option 1
- Option 2
Identificador de la conversación — al menos UNO de los tres campos debe venir. Orden de resolución: uuid > whatsapp_user_id > phone. El lookup filtra por el business del token (defense in depth cross-tenant).
UUID del quick reply configurado en el business. Se resuelve contra quick_replies con tenant-scope del token.
Respuesta
QR enviado. messages[] incluye uno o más mensajes según las acciones del QR.
Array de mensajes emitidos por el QR (en orden). Un QR con 1 sola acción produce 1 item; con múltiples acciones (text + files + buttons) produce N items.