Concepts clés

Comptes

Un compte est un utilisateur final identifié par un numéro de téléphone E.164 (+228…).

État	Signification
`pending`	Invité / pas encore entièrement revendiqué
`claimed`	L'utilisateur a terminé la revendication OTP - peut utiliser l'app
`blocked`	Désinscrit / bloqué

Les partenaires rattachent des comptes à eux-mêmes (M2M ou champs fournisseur). Les utilisateurs rattachés voient ce partenaire dans leur hub.

Un partenaire est une organisation (ex. SEED) avec :

Les messages partenaire → utilisateur peuvent être :

Type	Comportement hub
Texte, média, lien, HTML	Messages hub autonomes (liste, plus récents en premier)
Invitations flow	Cartes flow autonomes
Réponses support	Dans une conversation démarrée par l'utilisateur

L'API partenaire POST /messages crée des messages hub, pas des fils de chat support.

`content_type`	Description
`text`	Texte brut
`image`	URL d'image ou base64
`document`	PDF / fichiers
`audio`	Fichier audio
`video`	Fichier vidéo
`link`	Carte CTA (url + label + title)
`html`	Newsletter mobile (HTML)
`flow`	Invitation de formulaire multi-étapes interactif
`system`	Message système plateforme

Les conversations sont des fils de type support :

Créées lorsqu'un utilisateur démarre une assistance
Les agents répondent via Partner Hub / API agent
Les sessions bot peuvent utiliser des sujets comme Bot · … (masqués du menu « Conversations » utilisateur)

Configurés par partenaire comme une chaîne ordonnée, par exemple :

Les OTP et messages critiques peuvent forcer un sous-ensemble de canaux.

Catalogue complet des surfaces client, outils partenaires et comportement des canaux : Plateformes.

Passez idempotency_key à l'envoi pour éviter les doublons lors des retries :

{ "idempotency_key": "partner-order-98765" }

Même partenaire + même clé renvoie le message d'origine.