Crear un playbook
Añade un playbook: una situación que tu equipo maneja de una manera determinada y los pasos que sigue el agente de IA en ella. Un playbook nuevo está desactivado, a menos que enabled sea true.
/v1/playbooks settings:write Cuerpo
id string Id del playbook (pb_...). Omítelo para añadir uno. Si el espacio de trabajo aún no tiene un id, se añade el playbook con ese id, por lo que un reintento nunca crea dos.
name string · min length: 1· max length: 120 Necesario para añadir un playbook.
when string · max length: 300 La situación que abarca, en palabras sencillas.
steps array of string · max items: 20 Lo que hace el agente, en orden. Conserva tal cual las menciones con tokens como @[custom.plan-lookup].
enabled boolean Solo los playbooks habilitados llegan al agente. Un playbook nuevo está desactivado, a menos que esto sea true.
conditions any Qué debe cumplir una conversación para que el agente la vea: { all: [...] } de { field, op, values, not? }. Campos: channel (email, chat, slack; chat es el widget y el centro de ayuda), priority, tag (ids de etiquetas), property ({ field: "property", key, op, values }, las propiedades del cliente; solo clientes verificados), customerGroup (ids de grupos de clientes). Las condiciones de un mismo campo amplían el alcance; las de campos distintos lo restringen; not excluye. Null lo aplica a todas las conversaciones; si se omite, conserva lo que ya tiene.