Canal API
Connectez Entagl à votre propre app ou à Make : envoyez des messages, recevez les réponses et gérez votre workspace.
Aperçu
Le channel API vous permet d’utiliser le même agent AI qui alimente vos DM depuis le chat de votre site web, votre app mobile ou votre backend. Vous envoyez un message, l’agent réfléchit (avec le même buffering et des réponses en plusieurs messages, comme un vrai DM), puis la réponse vous parvient un peu plus tard, via un webhook callback ou par polling. Configurez-le dans Canaux → API : générez une API key, activez le channel, puis choisissez callback ou polling. La même API permet aussi à votre développeur, ou à Make, de travailler avec les contacts, conversations, réservations, commandes et plus encore. Voir l’onglet Workspace API.
Onglets de cette page
L’API ne sert pas qu’au chat. Votre développeur, ou un outil comme Make, peut l’utiliser pour lire et mettre à jour la plupart des éléments de votre workspace.
Ce que vous pouvez faire avec
En plus d’envoyer des messages, l’API couvre :
- Contacts : créer, mettre à jour, rechercher, fusionner, ajouter des notes, marquer comme ne pas contacter
- Tags et lifecycle stages : ajouter ou supprimer des tags, déplacer un contact vers une autre étape
- Conversations : assigner à un membre de l’équipe, clôturer avec une note de clôture, mettre en pause ou reprendre l’AI, ajouter des commentaires d’équipe, envoyer un message au nom de votre entreprise
- Bookings et reminders : vérifier les créneaux disponibles, réserver, reprogrammer, annuler, créer et clôturer des reminders
- Orders et products : créer et mettre à jour des orders et leurs items, gérer votre catalogue
- Calls : lancer un appel téléphonique AI ou en mettre un en file d’attente, lire le résultat
- Campaigns : voir vos campaigns et en envoyer une
Quand quelque chose change, Entagl peut prévenir vos outils immédiatement via des webhooks.
Deux façons de se connecter
Make. Quand vous connectez Make, vous vous connectez avec votre propre compte Entagl. Make agit alors en votre nom, avec exactement vos droits : un owner ou un admin peut tout faire, un membre de l’équipe seulement ce que ses permissions autorisent. Si votre connexion a plusieurs workspaces, vous choisissez lequel utiliser.
API key. Pour votre propre serveur, créez une clé dans Canaux → API ou Paramètres → API keys et envoyez-la en Authorization: Bearer <your key>. Une clé appartient à un seul workspace et lui donne un accès owner complet, traitez-la donc comme un mot de passe.
Sans risque en cas de retry : le header Idempotency-Key
Parfois, une requête passe, mais la réponse se perd au retour. Si votre système n’est pas sûr qu’une requête a abouti, il peut la renvoyer avec le même header Idempotency-Key. Pendant 24 heures, Entagl reconnaît la clé, ignore le traitement et renvoie la première réponse, pour éviter de créer deux commandes ou deux contacts. L’utilisation de la même clé pour une requête différente est refusée avec une erreur.
Nombre de requêtes autorisées
Jusqu’à 120 requêtes par minute pour chaque workspace. Au-delà, Entagl répond avec l’erreur 429 (rate_limited). Attendez un instant puis réessayez. La plupart des automatisations n’atteignent jamais cette limite.
La référence API complète
Chaque point de terminaison, champ et code d'erreur est listé dans la référence API d'Entagl. Ouvrez-la avec le lien Pour les développeurs : référence API près du haut de cette page et partagez-la avec votre développeur.
Fonctionnalités
Configuration et authentification
Ouvrez Paramètres → Intégrations, choisissez API et cliquez sur Générer une clé API. Activez l'interrupteur dans la carte API Channel, puis appelez l'API à https://api.entagl.com avec l'en-tête Authorization: Bearer <votre clé>. Chaque clé fonctionne pour un seul espace de travail.
Envoyer un message
POST /api/v1/messages avec { message, externalUserId }. Vous recevez immédiatement un 202 et un conversationId. Réutilisez ce conversationId pour poursuivre la conversation. La réponse de l’agent arrive plus tard, pas dans cette réponse.
Webhook (callback) (recommandé)
Collez une URL de rappel dans la carte API Channel et cliquez sur Enregistrer. Entagl envoie ensuite chaque réponse d'agent à celle-ci, signée avec l'en-tête X-Entagl-Signature (HMAC-SHA256). Utilisez une adresse HTTPS publique et cliquez sur Envoyer une livraison de test pour vérifier que cela fonctionne. Votre serveur doit vérifier la signature et répondre avec un code 2xx dans environ 5 secondes. Les rappels échoués ne sont pas réessayés.
Interrogation (Polling)
Si vous ne pouvez pas héberger d'URL de callback, appelez GET /api/v1/conversations/:id/messages?since=<cursor> pour récupérer les nouvelles réponses. Renvoyez le cursor de chaque réponse en ?since= pour ne recevoir que les nouveaux messages.
Sécurité et isolation
Les API keys sont stockées hashées et le secret de signature est chiffré (tous deux affichés une seule fois). Chaque recherche est limitée au workspace : un ID de conversation provenant d’un autre workspace renvoie 404, et vous ne pouvez pas transmettre d’ID utilisateur (il est dérivé de votre clé).
Tâches courantes
Configurer le canal API
Environ 3 min- Ouvrez Paramètres → Intégrations, choisissez API et cliquez sur Générer une clé API. Donnez-lui un nom si vous le souhaitez, puis copiez la clé maintenant, car elle n'est affichée qu'une seule fois.
- Activez l'interrupteur dans l'en-tête de la carte API Channel. Tant qu'il n'est pas activé, les messages envoyés à l'API sont refusés.
- Recommandé : ouvrez les paramètres de la carte, collez votre URL de rappel et cliquez sur Enregistrer. Copiez le secret de signature qui apparaît, puis cliquez sur Envoyer une livraison de test.
- Depuis votre application, envoyez des messages par POST à https://api.entagl.com/api/v1/messages et recevez les réponses via votre callback ou par interrogation.
Conseils
Questions fréquentes
Cette page vous a-t-elle été utile ?