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

SDK (API REST)

Quand l'utiliser

• L'équipe du client a des développeurs qui intégreront le flow dans leur application.
• Le flow est appelé depuis un backend (pas d'interface utilisateur directe).
• Besoin de contrôle total sur l'expérience utilisateur.

Comment ça marche

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

Exemple d'appel

curl -X POST https://naixus.example.com/api/v1/channels/{channel_id}/messages \
  -H "Authorization: Bearer nx_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"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.
2. Copier le snippet JavaScript fourni.
3. L'intégrateur colle le snippet dans le HTML du site client.

Snippet type

<script src="https://naixus.example.com/widget.js" data-channel-id="ch_xxxxxxxx" async></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).

Slack

Quand l'utiliser

• Le flow cible des collaborateurs internes qui utilisent déjà Slack.
• FAQ RH, support IT, assistant de productivité.

Comment ça marche

1. Créer une Slack App dans l'espace Slack du client.
2. Configurer le webhook entre Slack et nAIxus.
3. Les messages envoyés au bot Slack sont routés vers le flow.

Points d'attention BA

• Le client doit avoir un plan Slack qui autorise les apps personnalisées.
• Définir dans quel(s) canal(aux) le bot sera disponible.
• Les conversations Slack sont visibles par les membres du canal → attention aux données sensibles.
• Prévoir un message clair quand le bot ne sait pas répondre.

WhatsApp

Quand l'utiliser

• Service client B2C.
• Communication avec des utilisateurs qui ne sont pas devant un ordinateur.

Prérequis

• Compte Meta Business avec accès à l'API WhatsApp Business.
• Numéro de téléphone vérifié.

Points d'attention BA

• WhatsApp impose des templates de messages pour les conversations initiées par l'entreprise.
• Les conversations initiées par l'utilisateur sont libres pendant 24h.
• La facturation WhatsApp est par conversation (pas par message).
• Attention RGPD : les données transitent par les serveurs Meta.

Microsoft Teams

Quand l'utiliser

• Le client est un grand compte qui utilise Teams comme outil de collaboration principal.
• Assistant interne, support IT, FAQ.

Prérequis

• Accès Azure AD de l'organisation cliente.
• Permissions pour enregistrer un bot Teams.

Points d'attention BA

• L'approbation d'un bot Teams dans une grande entreprise peut prendre du temps (processus IT, sécurité).
• Prévoir ce délai dans le planning projet.
• Tester en environnement de dev avant de déployer en production.

Environnements

Chaque canal dispose de trois environnements :

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 dans nAIxus.
2. Cliquez sur Rotate Key.
3. La nouvelle clé est active immédiatement.
4. L'ancienne clé reste active pendant une période de grâce (configurable).
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 ?).