À quoi ça sert
L’intégration Telegram permet à votre agent d’écrire dans un groupe Telegram pendant l’appel : prévenir l’équipe d’une commande, d’une demande particulière, ou déclencher une alerte sonore quand un client est mécontent ou qu’une situation demande une intervention immédiate. Vous branchez votre propre bot : Bookivox ne fournit ni bot ni identifiants. Vous collez simplement deux valeurs (le jeton du bot et l’identifiant du groupe) et vous cochez les actions à exposer. Aucune URL, aucun en-tête, aucun champ technique à saisir.Ce qu’il faut préparer
1
Créer le bot
Dans Telegram, ouvrez @BotFather, envoyez
/newbot, choisissez un nom et un
identifiant. BotFather vous renvoie le jeton. Gardez-le secret.2
Ajouter le bot au groupe
Créez ou ouvrez le groupe de l’équipe, puis ajoutez le bot comme membre.
Pour publier dans un canal, le bot doit être administrateur.
3
Récupérer l'identifiant du groupe
Deux méthodes : ajoutez temporairement un bot qui affiche les identifiants, ou
appelez
https://api.telegram.org/bot<TOKEN>/getUpdates après avoir envoyé un
message dans le groupe et lisez result[].message.chat.id. Pour un groupe
public, l’identifiant @nom_du_groupe suffit.4
Configurer dans Bookivox
Dans Intégrations → Telegram, collez le jeton et l’identifiant, cochez les
actions voulues, puis cliquez sur Enregistrer. Le bouton reste grisé tant que
le jeton et l’identifiant ne sont pas valides : impossible de créer une
configuration incomplète.
Les deux actions
Les deux actions utilisent la même route Telegram (
sendMessage) ; seule la
notification sonore change. Vous pouvez n’en créer qu’une seule, puis compléter plus
tard : la page Configurations Telegram indique l’état de chaque groupe
(Prêt quand les deux actions existent, Partiel sinon) et un badge
Déjà créé apparaît sur les actions déjà configurées.
La carte Telegram de la page Intégrations affiche le logo officiel du service et
un lien Documentation vers la page que vous lisez. Chaque configuration créée
garde ce même lien dans sa colonne latérale.
Comment l’agent s’en sert
Chaque action devient un outil rattachable à un nœud Étape agent (onglet Outils). L’agent fournit lui-même le texte du message ; le groupe, lui, est figé dans la configuration : il ne peut pas être modifié pendant l’appel. Rédigez la description de l’outil comme une consigne :Cas d’usage
Exemple de conversation
Ce que l’agent peut écrire
Le jeton est placé dans l’URL de la requête, car l’API Bot de Telegram
n’accepte aucune authentification par en-tête. Côté serveur, l’URL est
masquée dans les journaux avant d’être écrite.
Limites et dépannage
Si vous changez de groupe ou de bot, créez une nouvelle configuration :
l’identité d’une configuration est le couple bot + groupe. Les outils d’une
ancienne configuration restent visibles jusqu’à leur suppression.
Intégrations
Toutes les intégrations et les catégories d’outils.
Outil Appel HTTP
Pour brancher une API maison, sans preset.