Utiliser l'API avec une clé API

Avec l'API, vous utilisez vos bots depuis votre propre logiciel : un intranet, une application ou un CRM. Vous posez des questions à un bot, récupérez des leads ou modifiez le contenu sans ouvrir le portail.

Que pouvez-vous faire avec l'API ?

• Interroger vos bots et poser une question à un bot, y compris avec streaming. Vous pouvez récupérer et poursuivre une conversation.
• Avec Accès aux leads : récupérer des leads, des plaintes et des signalements de bugs, modifier le suivi, consulter les réservations et réserver directement, lister les conversations et configurer des webhooks.
• Avec Gérer le contenu : modifier les formulaires de devis, les réservations (y compris les jours de fermeture), les FAQ et les sources.
• Avec Peut créer des bots : créer de nouveaux bots. Chaque bot a son propre plan, donc un bot supplémentaire a un coût. L'appelant doit confirmer ce prix.
• Récupérer les chiffres et les insights d'un bot.

Tous les appels, avec des exemples en curl, JavaScript et Python, sont disponibles dans la documentation de l'API.

Créer une clé API

1. Dans le menu, allez dans Connexions → Clés API.
2. Cliquez sur Nouvelle clé.
3. Donnez un Nom pour savoir plus tard à quoi sert la clé.
4. Choisissez Accès à tous les bots (y compris les bots que vous ajouterez plus tard), ou désactivez cette option et sélectionnez des bots spécifiques sous Bots.
5. Activez les autorisations supplémentaires pour la clé : Peut créer des bots, Accès aux leads et Gérer le contenu. Par défaut, tout est désactivé.
6. Cliquez sur Créer.
7. Copiez immédiatement la clé et conservez-la en lieu sûr. Vous ne pourrez plus la consulter par la suite. Sous Essayez, un premier appel est disponible pour tester.

Gérer les clés

Dans la liste, vous voyez pour chaque clé les accès, quand elle a été Dernière utilisation et qui l'a créée. Avec Modifier, vous ajustez le nom, les bots et les droits. Avec Révoquer, vous désactivez immédiatement une clé. Les applications qui l'utilisent n'auront alors plus d'accès, et les webhooks créés avec elle seront supprimés. Cela ne peut pas être annulé.

Bon à savoir

• Seul l'administrateur du compte (rôle Administrateur) peut créer et gérer les clés API. Voir Team.
• Donnez à une clé uniquement les droits dont elle a besoin. Avec Accès aux leads, un logiciel peut lire les coordonnées des visiteurs.
• Une clé a-t-elle fuité ? Révoquez-la et créez-en une nouvelle.
• Souhaitez-vous envoyer les leads immédiatement sans les demander vous-même ? Utilisez des webhooks.
• Voulez-vous utiliser vos bots dans ChatGPT ou Claude ? Aucune clé n'est nécessaire. Voir MCP.