Guide de déploiement par canal

Un flow sans canal, c'est un prototype. Le canal est le point de contact entre votre workflow et les utilisateurs finaux. Ce guide vous aide à choisir le bon canal et à le configurer correctement.

Matrice de choix

Arbre de décision

Canal API

Quand l'utiliser

• L'équipe du client a des développeurs qui intégreront le flow dans leur application (service backend, application mobile iOS/Android, client natif).
• Serveur-à-serveur : un backend ou script côté serveur appelle le flow avec des clés nx_live_/nx_test_.
• Client-à-serveur : une application mobile ou un client natif appelle le flow avec une clé nx_pub_ (applique les origines autorisées).
• Besoin de contrôle total sur l'expérience utilisateur.

Comment ça marche

1. Créer un canal API dans nAIxus (Settings > Channels > + New > API channel).
2. Récupérer la clé API générée (préfixe nx_live_ ou nx_test_ selon l'environnement, ou nx_pub_ pour une application mobile ou une SPA).
3. L'intégrateur appelle l'API avec cette clé.

Exemple d'appel

curl -X POST https://naixus.example.com/public/v1/api/execute \
  -H "Authorization: Bearer nx_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"payload": {"user_message": "Bonjour, j ai une question sur ma facture"}}'

Points d'attention BA

• Fournir à l'équipe technique : l'URL de l'API, la clé API, et la documentation du format de réponse.
• Définir qui gère la rotation des clés API.
• Clarifier les environnements : nx_test_ pour les tests, nx_live_ pour la production.

Webchat

Quand l'utiliser

• Le client veut un widget de chat intégré sur son site web.
• Pas de développement backend nécessaire.
• Déploiement rapide (quelques minutes).

Comment ça marche

1. Créer un channel Webchat dans nAIxus et renseigner les origines du site client dans Origines autorisées.
2. Sélectionner le canal dans le nœud Channel Trigger d'un flow.
3. L'intégrateur colle le snippet dans le HTML du site client, avec la clé publique du canal (nx_pub_) et les adresses fournies par l'exploitant de la plateforme. Voir Intégrer le widget webchat.

Snippet type

<script src="https://<hôte-du-widget>/widget.js"></script>
<script>
  window.Naixus.init({ widgetId: 'nx_pub_xxxxxxxx', apiUrl: 'https://<origine-api-core>' });
</script>

Personnalisation possible

Points d'attention BA

• Le client doit autoriser le script sur son site (CSP, politique de sécurité).
• Tester le widget sur les navigateurs du client (Chrome, Firefox, Safari, Edge).
• Le widget charge depuis le serveur nAIxus → le site du client doit pouvoir y accéder.
• Définir le message d'accueil avec le client (première impression).

Environnements

Chaque canal est créé dans un environnement :

Règle d'or : Ne jamais tester avec une clé nx_live_. Les exécutions en production sont facturées et tracées.

Promotion d'environnement

Development → tests OK → Staging → validation client → Production

Chaque promotion implique :

• Vérifier que le flow fonctionne correctement dans l'environnement cible.
• Mettre à jour les clés API dans les intégrations.
• Valider les permissions et les accès.

Sécurité des canaux

Rotation de clé API

1. Accédez au canal API dans nAIxus (la rotation est disponible pour les canaux API).
2. Cliquez sur Rotate Key.
3. La nouvelle clé est active immédiatement.
4. L'ancienne clé est révoquée immédiatement : coordonnez-vous avec l'intégrateur avant la rotation.
5. L'intégrateur met à jour la clé dans son système.

Checklist de déploiement d'un canal

• Le flow associé est testé et validé.
• L'environnement cible est correct (dev, staging, prod).
• La clé API est configurée côté intégrateur.
• Le message d'accueil est défini et validé par le client (Webchat).
• Les permissions côté client sont accordées (Slack app, Teams bot, Meta Business).
• Un test end-to-end a été réalisé dans l'environnement cible.
• Le plan de escalade est défini (que faire si le canal tombe ?).