Saltar al contenido principal

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.

El endpoint POST /conversation/actions ejecuta un grupo de hasta 10 acciones sobre una sola conversación, en el orden que las envías. En vez de hacer N requests para etiquetar, dejar una nota y ejecutar el AI, los encadenas en un solo request.

​
Las 11 acciones

Cada elemento del array actions lleva un campo type. Casi todas espejan un endpoint individual de la API; send_quick_reply_or_template es la excepción: envía la quick reply si la ventana de 24h está abierta, o la plantilla si está cerrada — el modo lo decide el servidor en tiempo de ejecución.
  • send_message — envía un mensaje (texto, media, quick reply o plantilla).
  • send_quick_reply_or_template — quick reply o plantilla, según la ventana.
  • assign_label — asigna una etiqueta a la conversación.
  • remove_label — quita una etiqueta de la conversación.
  • assign_mailbox — mueve la conversación a un buzón.
  • context_note — deja una nota interna.
  • mark_resolved — marca la conversación como resuelta.
  • mark_pending — marca la conversación como pendiente.
  • run_ai — ejecuta el empleado AI sobre la conversación.
  • ai_assistance — genera una respuesta sugerida con el AI.
  • assign_ai_employee — asigna un empleado AI a la conversación.
Un grupo admite hasta 10 acciones, de las cuales como máximo 3 pueden disparar al AI. Excederlo falla con BATCH_LIMIT_EXCEEDED.

​
Cómo se ejecuta

1

Validación síncrona

La API valida el request. Si el preflight lo rechaza (ej. el AI no tiene tokens), responde un 4xx síncrono y ninguna acción se ejecuta.
2

202 Accepted

Si pasa la validación, responde 202 de inmediato; el grupo corre en background.
3

Ejecución en orden

Las acciones se ejecutan una por una, en el orden enviado.
El 202 confirma que el grupo fue aceptado, no que cada acción tuvo éxito. El resultado por acción no viaja en la respuesta — consúltalo en el estado de la conversación o en el activity log del negocio.

​
Stop on error

stop_on_error controla qué pasa cuando una acción falla durante la ejecución:
ValorComportamiento
true (default)La primera falla corta las acciones siguientes.
falseEl grupo ejecuta todas las acciones, ignorando fallos intermedios.

​
Ejemplo

Etiquetar, dejar una nota y ejecutar el AI, sin cortar ante fallos: 
{
  "conversation": { "phone": "+5215512345678" },
  "stop_on_error": false,
  "actions": [
    { "type": "assign_label", "tags": [{ "name": "VIP" }] },
    { "type": "context_note", "note": "Cliente pidió cotización." },
    { "type": "run_ai", "ai_employee": { "name": "Agente Ventas" } }
  ]
}
Si el preflight rechaza el grupo, la respuesta es un 4xx síncrono y ninguna acción se ejecuta. Ver Errores.