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 endpoint, champ et code d’erreur est listé dans la référence de l’API Entagl. Si votre développeur ne l’a pas encore, envoyez un email à support@entagl.com pour demander la référence API.
Fonctionnalités
Configuration et authentification
Générez une clé API dans Channels → API, activez le canal, puis appelez l'API sur https://api.entagl.com avec l'en-tête Authorization: Bearer <votre clé>. Les clés sont limitées à l'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é)
Ajoutez une URL de callback HTTPS publique et Entagl y enverra chaque réponse de l'agent par POST, signée avec l'en-tête X-Entagl-Signature (HMAC-SHA256). Vérifiez la signature et répondez 2xx en ~5 secondes. Il n'y a pas de nouvelle tentative automatique.
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- Allez dans Channels → API et cliquez sur Generate API Key. Copiez-la maintenant, car elle ne s’affiche qu’une seule fois.
- Activez le canal dans l'en-tête de la carte API.
- Recommandé : développez la carte, collez une URL de callback HTTPS publique, enregistrez et copiez le secret de signature.
- 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 ?