À destination de vos collaborateurs

Créez des bots Telegram pour vos collaborateurs et simplifez leur usage de la plateforme.

En complément de l'engagement de votre communauté, les bots Telegram peuvent jouer un rôle important dans la simplification de l'usage de Citipo auprès de vos collaborateurs.

Ils vous permettront de développer des outils plus simples d'utilisation au sein d'une plateforme que vos collaborateurs utilisent déjà.

1. Créer un bot Telegram

De manière très schématique, un bot Telegram est une application Web réagissant aux appels des serveurs de Telegram avec votre propre logique et vos propres processus.

Développer un bot Telegram à destination de vos collaborateurs revient à créer une application Web qui agira à leur place sur la console Citipo.

Étant donné les forts enjeux de sécurité associés à un tel usage, il est essentiel que vous soyez très vigilants à la sécurité de votre bot.

Pour créer un bot Telegram, vous pouvez suivre la documentation officielle.

2. Enregistrer le bot sur Citipo

Au sein de votre organisation, dans la section Intégrations en haut de page, vous retrouverez l'intégration Telegram :

Cliquez sur Configurer pour obtenir la liste des bots Telegram actuellement configurés sur votre Organisation :

Enregistrez votre bot en cliquant sur le bouton "Enregistrer un bot". Vous obtiendrez alors une URL de partage :

Cette URL de partage est une URL que vous pouvez transmettre à vos collaborateurs.

3. Partager l'intégration avec vos collaborateurs

Lorsque vos collaborateurs ouvriront l'URL de partage, Citipo leur demandera si ils sont d'accord pour partager leur accès à la console avec votre bot :

Si ils cliquent sur "Oui, autoriser", vos collaborateurs seront redirigés vers votre bot dans Telegram.

Un premier message sera alors envoyé à votre bot, contenant le token de consentement :

/start telegram_6cbecdad1a33ea8afa60def486578b9e99b238ec0c330d9c521e86308e092f57

Vous pouvez ainsi récupérer ce token depuis votre bot et le stocker dans une base de donnée, associée à l'utilisateur Telegram actuel.

4. Utiliser l'API Intégrations

Une fois que vous avez obtenu ce token de consentement, vous pouvez l'utiliser pour effectuer des requêtes sur l'API Intégrations :

API Intégrations