Qyvo

Les séquences sont des campagnes multi-étapes étalées dans le temps (« welcome 7-day », « winback 30-day »). Elles s'exécutent comme un graphe : nœuds (envois de templates, délais, branches), arêtes, et un seul nœud d'entrée.

Outil	Annotation	Objectif
`list_sequences`	`IsReadOnly`, `IsIdempotent`	Filtrer par statut
`get_sequence`	`IsReadOnly`, `IsIdempotent`	Graphe + sessions actives
`create_sequence`	`IsDestructive(false)`	Nouvelle séquence (créée en brouillon)
`trigger_sequence`	`IsDestructive(false)`	Inscrire un contact dans une séquence publiée

`list_sequences`

List message sequences. Filter by status (draft or published).

`get_sequence`

Get sequence details with graph nodes, edges, trigger settings, and active session count.

Entrée	Type
`id`	UUID

`create_sequence`

Create a new message sequence. Created as draft.

Entrée	Type	Notes
`name`	string	requis
`graph`	object	`{nodes: [...], edges: [...]}` — la même forme qu'utilise l'éditeur de séquence du tableau de bord

Chemin le plus rapide vers un graphe valide : construisez-le dans le tableau de bord, appelez get_sequence, copiez le JSON, modifiez, puis create_sequence à nouveau avec le résultat.

Une nouvelle séquence est en draft — utilisez publier dans le tableau de bord avant de la déclencher. Il n'y a pas d'outil MCP publish_sequence aujourd'hui ; c'est intentionnel, pour garder les actions destructrices de mise en production dans la piste d'audit du tableau de bord.

`trigger_sequence`

Trigger a published sequence for a specific contact.

Entrée	Type	Notes
`sequence_id`	UUID	doit être publiée
`contact_id`	UUID	l'un des deux
`phone`	string	l'un des deux (crée le contact automatiquement)
`context`	object	passé aux nœuds en tant que `{{context.*}}`

Renvoie {id, status: "started"} ou {status: "already_running"} pour l'idempotence.