Outils MCP — Broadcasts
Cinq outils pour planifier, modifier, inspecter et supprimer des broadcasts de templates.
Les broadcasts sont des campagnes de templates envoyées à plusieurs contacts à la fois. Utilisez le tableau de bord pour l'éditeur complet — ces outils couvrent la création, le monitoring et le nettoyage par programmation.
| Outil | Annotation | Objectif |
|---|---|---|
list_broadcasts |
IsReadOnly, IsIdempotent |
Filtrer par statut |
get_broadcast |
IsReadOnly, IsIdempotent |
Statistiques par broadcast |
create_broadcast |
IsDestructive(false) |
Planifier une nouvelle campagne |
update_broadcast |
IsDestructive(false), IsIdempotent |
Éditer les brouillons/planifiés |
delete_broadcast |
IsDestructive |
Supprimer le broadcast et ses messages associés |
list_broadcasts
List broadcast campaigns with delivery stats. Filter by status.
| Entrée | Type | Notes |
|---|---|---|
status |
string | draft, scheduled, sending, completed, failed |
page, per_page |
integer |
get_broadcast
Get detailed broadcast info with delivery stats.
| Entrée | Type |
|---|---|
id |
UUID |
Renvoie le broadcast plus les compteurs en direct (sent_count, delivered_count, read_count, failed_count, revenue).
create_broadcast
Create a broadcast campaign. Target audience by tags (comma-separated) or contact_ids. Optionally schedule for later.
| Entrée | Type | Notes |
|---|---|---|
name |
string | requis |
template_id |
UUID | requis, doit être APPROVED |
language |
string | requis, doit avoir une traduction approuvée |
variables |
object | requis si le template a des placeholders |
target_tags |
string | noms de tags séparés par des virgules |
target_contact_ids |
UUID[] | liste explicite de contacts |
target_segment_id |
UUID | utilise un segment enregistré au lieu de tags/ids |
scheduled_at |
ISO 8601 | omettre pour envoyer immédiatement |
Choisissez exactement une source de cible. Le broadcast est créé en draft si aucun scheduled_at, ou en scheduled sinon.
update_broadcast
Update a draft or scheduled broadcast. Cannot update broadcasts that are sending or completed.
Mêmes champs que create_broadcast, tous optionnels. À utiliser pour reciblér, replanifier ou changer les variables avant l'envoi.
delete_broadcast
Delete a broadcast and its associated messages.
IsDestructive — les clients sollicitent à chaque fois. À n'exécuter en sécurité que sur les broadcasts draft ou failed. Les messages d'un broadcast completed vivent dans l'inbox ; les supprimer retire l'historique d'audit.