Le Wiring Lab

Le Wiring Lab est l'endroit où vous connectez un persona à un moteur. Cette connexion s'appelle un lien: il associe exactement un persona à un moteur, pour que le moteur s'exprime avec la voix de ce persona. Chaque lien reçoit son propre api_slug, un identifiant unique de ce câblage précis, pour que la plateforme sache toujours à quelle combinaison persona-moteur appartient une requête.

Pour câbler un lien :

Ouvrez le Wiring Lab et choisissez le persona que vous voulez mettre en ligne.
Faites glisser un moteur depuis la bibliothèque sur le canevas pour l'attacher à ce persona.
Appuyez sur Enregistrer (le bouton Valider le câblage) pour conserver le lien. Tant que vous ne validez pas, le câblage n'est pas enregistré.

Vous pouvez câbler plusieurs liens persona-moteur dans un même compte. Chacun est une connexion à part entière avec son propre api_slug.

Clés API

Une clé API est ce qui permet à un bot ou à une intégration externe de s'authentifier auprès de FluidTalk. Il y a deux façons d'en créer une :

Créer: générer une clé simple, valable pour tout le compte , qui n'est encore rattachée à aucun persona ni moteur.
Provisionner: générer une clé déjà restreinte à un persona et un moteur précis , en une seule étape. C'est la voie recommandée , car une clé déjà restreinte est prête à servir du trafic réel.

Vous gérez les clés depuis le Wiring Lab :

Lier / restreindre une clé: rattacher une clé existante valable pour tout le compte à un persona et un moteur (et éventuellement la renommer). Une clé jamais restreinte ne peut pas servir d'appels en production.
Lister: voir toutes les clés du compte.
Révoquer: supprimer une clé pour qu'elle ne puisse plus être utilisée.

Attention

Le secret d'une clé API n'est affiché qu'une seule fois, au moment de sa création. Copiez-le à ce moment-là et rangez-le en lieu sûr. Si vous le perdez, vous ne pourrez plus le revoir : révoquez simplement cette clé et créez-en une nouvelle.

Attention

Une clé doit être restreinte à un persona (et à un moteur) avant de pouvoir servir du trafic réel. Une clé non restreinte, valable pour tout le compte, est rejetée sur les appels en production. Provisionnez d'abord une clé restreinte, ou reliez-en une existante.

Checklist de mise en production

Quand ces quatre points sont vrais, vous êtes en production :

Persona prêt: identité et photos configurées.
Moteur relié: le moteur câblé à ce persona et validé dans le Wiring Lab.
Une clé API restreinte: provisionnée (ou reliée) à ce persona et ce moteur exacts.
Pointez votre bot sur le handshake: votre intégration envoie chaque message entrant à l'endpoint de handshake, en passant la clé dans l'en-tête X-API-Key . FluidTalk répond avec le message suivant et l'action à effectuer.

Pour les endpoints exacts, les champs de requête et les réponses, voir la référence de l'API développeur.

Astuce

Vous n'avez pas besoin de passer en production pour essayer. Déroulez d'abord toute la conversation dans le simulateur intégré (même moteur, sans clé ni trafic réel), puis câblez le tout une fois qu'il se comporte comme vous le souhaitez.

Attention

Servir du trafic en production nécessite une formule payanteactive. Un compte gratuit ou expiré est refusé au handshake : votre bot cesse donc de servir dès la fin de la formule. Voir Facturation et formules.

Guides associés

Constructeur de moteur: concevez la conversation avant de la câbler.
Tester dans le simulateur: essayez le moteur de bout en bout sans clé.
Référence de l'API développeur: les appels de handshake et les en-têtes exacts.
Facturation et formules: ce qu'une formule payante débloque pour la production.