Qyvo

Les segments sont des filtres d'audience enregistrés — une définition de règles JSON qui se résout en un ensemble de contacts à la demande. Utiles comme cibles de broadcasts et comme triggers pour des séquences/flows.

Outil	Annotation	Objectif
`list_segments`	`IsReadOnly`, `IsIdempotent`	Pagination avec compteurs en cache
`get_segment`	`IsReadOnly`, `IsIdempotent`	Récupère + compteur rafraîchi
`create_segment`	`IsDestructive(false)`	Nouveau segment depuis des règles
`update_segment`	`IsDestructive(false)`, `IsIdempotent`	Renomme, redéfinit les règles
`delete_segment`	`IsDestructive`	Supprime (contacts intacts)

`list_segments`

List segments (saved audience filters) for the workspace, with their cached contact counts.

Renvoie {data: Segment[], meta: {…}}. Les compteurs sont en cache et peuvent être en retard de quelques minutes par rapport à la réalité — appelez get_segment pour un compteur à jour.

`get_segment`

Get one segment with its full rule definition and refreshed contact count.

Entrée	Type
`id`	UUID

Déclenche un rafraîchissement du compteur, puis renvoie le segment plus le contacts_count à jour.

`create_segment`

Create a new segment from a rule definition. The contact count is computed immediately.

Entrée	Type	Notes
`name`	string	requis
`description`	string	optionnel
`rules`	object	requis — forme JSON

L'objet rules suit le DSL de segment utilisé par le tableau de bord : un arbre de conditions avec des combinateurs and/or et des prédicats sur tags, last_message_at, created_at, metadata.*, etc. La manière la plus rapide d'écrire des règles est le constructeur de segments du tableau de bord, puis d'appeler get_segment pour copier le JSON résultant.

`update_segment`

Update a segment's name, description, or rules. Refreshes the contact count after rules changes.

`delete_segment`

Permanently delete a segment. Does not delete the contacts it referenced.