Outils MCP — Flows
Quatre outils pour les flows conversationnels à état (abandon de panier, menus en cours de conversation, triage du service client).
Les flows sont des réponses conversationnelles à état avec des timeouts en minutes (30 par défaut). À utiliser pour l'abandon de panier, les menus de réponses rapides en cours de conversation et le triage. Distincts des Séquences (drips multi-jours).
| Outil | Annotation | Objectif |
|---|---|---|
list_flows |
IsReadOnly, IsIdempotent |
Filtrer par statut |
get_flow |
IsReadOnly, IsIdempotent |
Graphe + sessions |
create_flow |
IsDestructive(false) |
Nouveau flow (brouillon) — nécessite un template d'entrée avec des boutons quick reply |
trigger_flow |
IsDestructive(false) |
Inscrire un contact dans un flow publié |
list_flows
List automation flows. Filter by status (draft or published).
get_flow
Get flow details with graph, trigger template, active sessions.
| Entrée | Type |
|---|---|
id |
UUID |
create_flow
Create a new flow. Requires trigger template with quick reply buttons. Created as draft.
| Entrée | Type | Notes |
|---|---|---|
name |
string | requis |
entry_template_id |
UUID | le template qui ouvre la conversation — doit avoir des boutons QUICK_REPLY |
graph |
object | {nodes, edges} |
settings.session_ttl_minutes |
integer | 30 par défaut |
Comme les séquences, les flows sont en draft jusqu'à leur publication dans le tableau de bord.
trigger_flow
Trigger a published flow for a specific contact.
| Entrée | Type | Notes |
|---|---|---|
flow_id |
UUID | doit être publié |
contact_id |
UUID | l'un des deux |
phone |
string | l'un des deux |
context |
object | optionnel |
Renvoie {id, status: "started"} ou {status: "already_running"}.