Prérequis d'intégration

Avant d'écrire du code d'intégration, vérifiez les points suivants.

Prérequis

• Un flow lié au canal. Les intégrations exécutent un canal, pas un flow directement. Créez le canal dans la console, puis sélectionnez-le dans le nœud Channel Trigger d'un flow - voir Déployer un canal.
• Pour un canal de production, un flow publié au moins une fois (sinon 409 no_published_version). En dev et staging, l'état courant du flow suffit. Dans tous les cas, c'est l'état enregistré du flow qui s'exécute : la publication versionnée n'est pas encore appliquée.
• Une clé d'API émise pour ce canal.

Identifiants

Les clés sont émises et renouvelées depuis le canal dans la console. Décidez qui gère la rotation avant la mise en production.

Environnements

Exigences réseau

• HTTPS vers l'origine du service Core.
• Le système appelant doit pouvoir joindre l'origine du service Core.
• Les widgets navigateur envoient un en-tête Origin ; cette origine doit figurer dans la liste des origines autorisées du canal.
• La limitation de débit s'applique par canal API ou Webchat (3000 requêtes par minute par défaut), ainsi que par IP pour les clés publiques (60 par minute par défaut). Gérez les réponses 429 rate_limit_exceeded et adaptez les deux limites avant une mise en production à fort trafic.

Valider votre configuration

1. Vérifiez que le canal est actif et sélectionné dans le nœud Channel Trigger d'un flow (publié, pour un canal de production).
2. Appelez POST /public/v1/api/execute avec un payload minimal.
3. Attendez 200 OK avec un run_id et status: "success".

Si vous recevez 409, le canal est inactif (channel_inactive) ou, pour un canal de production, le flow n'a jamais été publié (no_published_version). Si vous recevez 404 channel_not_bound, aucun flow ne sélectionne ce canal.

Voir aussi

• Référence de l'API publique
• Changelog