Ricky logorickyDocs

Crear un workflow

POST
/workflows

Crea un workflow de conversación como draft; no ejecuta nada hasta que lo actives. Ricky revisa el flujo con las reglas del editor de workflows y que sus canales, miembros y agentes sean de la organización.

Permiso: workflows:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

Crea un workflow de conversación como draft. Activarlo es otra llamada.

name*string

Nombre visible.

Longitud1 <= length <= 80
definition*

Reacciona a una conversación con mensajes, preguntas, esperas y asignaciones.

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Una automatización que Ricky ejecuta para la organización.

curl -X POST 'https://getricky.ai/api/v1/workflows' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "name": "Fuera de horario",  "definition": {    "trigger": "conversation_opened",    "channel_ids": [      "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f"    ],    "condition": {      "kind": "outside_business_hours",      "business_hours": {        "start": "09:00",        "end": "18:00",        "timezone": "America/Panama",        "weekdays": [          1,          2,          3,          4,          5        ]      }    },    "flow": {      "entry": "bienvenida",      "steps": [        {          "id": "bienvenida",          "kind": "send_message",          "text": "Hola, gracias por escribir a Casa Nativa. Abrimos de lunes a viernes de 9:00 a 18:00.",          "next": "motivo"        },        {          "id": "motivo",          "kind": "ask_question",          "text": "¿En qué te ayudamos?",          "answer_key": "motivo",          "choices": [            {              "id": "pedido",              "label": "Mi pedido",              "next": "asesor"            },            {              "id": "otro",              "label": "Otra consulta",              "next": "agente"            }          ],          "timeout_seconds": 3600,          "on_timeout": "agente",          "on_invalid": "agente",          "next": "agente"        },        {          "id": "asesor",          "kind": "assign_user",          "user_id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",          "next": null        },        {          "id": "agente",          "kind": "assign_agent",          "agent_id": "7e8f9a0b-1c2d-4e3f-a4b5-c6d7e8f9a0b1",          "next": null        }      ]    }  }}'
{  "data": {    "id": "a3b4c5d6-e7f8-4a9b-8c0d-2e3f4a5b6c7d",    "name": "Fuera de horario",    "status": "active",    "type": "conversation",    "definition": {      "trigger": "conversation_opened",      "channel_ids": [        "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f"      ],      "condition": {        "kind": "outside_business_hours",        "business_hours": {          "start": "09:00",          "end": "18:00",          "timezone": "America/Panama",          "weekdays": [            1,            2,            3,            4,            5          ]        }      },      "flow": {        "entry": "bienvenida",        "steps": [          {            "id": "bienvenida",            "kind": "send_message",            "text": "Hola, gracias por escribir a Casa Nativa. Abrimos de lunes a viernes de 9:00 a 18:00.",            "next": "motivo"          },          {            "id": "motivo",            "kind": "ask_question",            "text": "¿En qué te ayudamos?",            "answer_key": "motivo",            "choices": [              {                "id": "pedido",                "label": "Mi pedido",                "next": "asesor"              },              {                "id": "otro",                "label": "Otra consulta",                "next": "agente"              }            ],            "timeout_seconds": 3600,            "on_timeout": "agente",            "on_invalid": "agente",            "next": "agente"          },          {            "id": "asesor",            "kind": "assign_user",            "user_id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",            "next": null          },          {            "id": "agente",            "kind": "assign_agent",            "agent_id": "7e8f9a0b-1c2d-4e3f-a4b5-c6d7e8f9a0b1",            "next": null          }        ]      }    },    "updated_at": "2026-10-14T15:30:00.000Z"  }}