Que puis-je faire avec l'API CRM Telegram ?
+
Lister et rechercher des chats Telegram, lire l'historique des messages, gérer les contacts et champs personnalisés, créer et mettre à jour des tickets avec priorité et assigné, déclencher des broadcasts vers des segments tagués, ajouter et supprimer des tags, et mettre à jour les valeurs de champs personnalisés. Chaque endpoint est délimité à l'espace de travail et journalisé.
Quelles portées sont disponibles ?
+
workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Choisissez le minimum dont votre intégration a besoin - le moindre privilège limite l'impact en cas de fuite d'une clé. Les mêmes portées s'appliquent à l'API, au serveur MCP et à l'intégration Make.com.
Exemples concrets - que construisent les vraies équipes ?
+
Une équipe de trading synchronise chaque chat Telegram dans BigQuery toutes les heures afin que les analystes puissent le joindre avec des données on-chain. Une équipe de support SaaS a une tâche cron qui extrait les tickets non résolus de la veille et les pousse dans un digest Slack. Une équipe de croissance envoie un broadcast Telegram depuis un webhook chaque fois qu'un événement de mise à niveau Stripe arrive. Une équipe opérationnelle a construit un tableau de bord Retool montrant le temps de réponse par représentant, le débit des tickets et la distribution par étape de pipeline - tout alimenté par l'API Entergram.
Comment créer et gérer des clés API ?
+
Rendez-vous dans l'onglet Développeurs de votre espace de travail Entergram. Cliquez sur 'Créer une clé', sélectionnez les portées dont vous avez besoin, définissez optionnellement un TTL plus court et une liste blanche IP, et copiez la clé. La clé brute n'est affichée qu'une seule fois - stockez-la de manière sécurisée. Les clés sont hachées unidirectionnellement au repos. Révoquez toute clé immédiatement depuis le même onglet.
Comment faire pivoter une clé compromise ?
+
Onglet Développeurs → trouvez la clé par son préfixe → Révoquer (immédiat). Créez ensuite une nouvelle clé avec les mêmes portées et liste blanche IP, déployez-la dans votre intégration et vérifiez les informations de dernière utilisation de l'ancienne clé pour confirmer qu'il n'y a plus de trafic.
L'API peut-elle voir les données d'un autre espace de travail ?
+
Non. Chaque appel API est délimité à l'espace de travail qui a émis la clé. Une clé de l'espace de travail A ne peut littéralement pas lire l'espace de travail B - la délimitation est appliquée côté serveur sur chaque requête.
Quelles erreurs HTTP puis-je voir ?
+
401 = la clé est expirée, révoquée ou incorrecte pour l'espace de travail. 403 = la clé manque de la portée nécessaire, ou la requête provient d'une IP en dehors de la liste blanche. 429 = vous avez atteint une limite de débit ; attendez et réessayez avec l'en-tête Retry-After.
Quelle est la différence entre l'API et le serveur MCP ?
+
Les deux accèdent aux mêmes données d'espace de travail avec les mêmes portées. L'API est pour votre code - tâches cron, webhooks, outils internes, pipelines de synchronisation. Le serveur MCP est pour les agents IA - Claude, ChatGPT, Cursor - qui découvrent et appellent des outils automatiquement via le Model Context Protocol. Utilisez l'API quand le code est le consommateur ; utilisez le serveur MCP quand c'est l'IA.
L'API prend-elle en charge les webhooks ?
+
Les webhooks sortants sont sur la feuille de route. Aujourd'hui, le modèle est basé sur le pull : appelez l'API selon un calendrier ou en réponse à vos propres événements. L'app Make.com dispose aussi de déclencheurs sur les événements de l'espace de travail ; vérifiez la liste dans Make avant de construire un scénario autour de l'un d'eux.
