GuideDighiConnect Public API #2

Notifications par Telegram

Configuration Telegram pour les Notifications

Prérequis

  • Un compte Telegram

  • L'application Telegram (mobile ou desktop)

Étape 1 : Créer un Bot Telegram

1.1 Ouvrir BotFather

  1. Ouvrez Telegram

  2. Recherchez @BotFather (compte officiel avec le badge vérifié ✓)

  3. Démarrez une conversation en cliquant sur Start

1.2 Créer votre bot

  1. Envoyez la commande : /newbot

  2. BotFather vous demandera un nom pour votre bot

    • Exemple : Notifications Optimus WiFi

    • Ce nom sera visible par tous les utilisateurs

  3. Ensuite, choisissez un username unique (doit finir par bot)

    • Exemple : optimus_wifi_notif_bot

    • L'username doit être unique sur tout Telegram

1.3 Récupérer le Bot Token

Une fois le bot créé, BotFather vous enverra un message contenant :

Use this token to access the HTTP API:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567

https://api.telegram.org/botVOTRE_BOT_TOKEN/getUpdates
⚠️ IMPORTANT :

  • Copiez ce token et conservez-le en lieu sûr

  • Ne partagez JAMAIS ce token publiquement

  • Toute personne avec ce token peut contrôler votre bot

Étape 2 : Obtenir votre Chat ID

Vous avez deux options pour recevoir les notifications :

Option A : Recevoir dans un chat privé (personnel)

  1. Recherchez votre bot dans Telegram (par son username, ex: @optimus_wifi_notif_bot)

  2. Démarrez une conversation en cliquant sur Start

  3. Envoyez n'importe quel message à votre bot (ex: Hello)

  4. Ouvrez cette URL dans votre navigateur (remplacez VOTRE_BOT_TOKEN) :

https://api.telegram.org/botVOTRE_BOT_TOKEN/getUpdates


Exemple avec token :

https://api.telegram.org/bot1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567/getUpdates


Vous verrez une réponse JSON. Cherchez la section "chat" :

{
  "ok": true,
  "result": [{
    "update_id": 123456789,
    "message": {
      "chat": {
        "id": 987654321,  ← Votre Chat ID
        "first_name": "Malkiel",
        "type": "private"
      }
    }
  }]
}

  1. Copiez le nombre dans "chat": { "id": ... }

    • Format : 987654321 (nombre positif pour chat privé)

Option B : Recevoir dans un groupe/canal (recommandé pour équipes)

Pour un groupe privé :

  1. Créez un groupe Telegram (ou utilisez un groupe existant)

  2. Ajoutez votre bot au groupe :

    • Cliquez sur le nom du groupe → Add members

    • Recherchez votre bot par son username

    • Ajoutez-le au groupe

  3. Donnez les permissions d'admin au bot (sinon il ne pourra pas envoyer de messages) :

    • Cliquez sur le nom du groupe → Administrators

    • Ajoutez votre bot comme admin

  4. Envoyez un message dans le groupe (ex: Test)

  5. Ouvrez l'URL (comme à l'étape précédente) :

https://api.telegram.org/botVOTRE_BOT_TOKEN/getUpdates

  1. Cherchez le Chat ID dans la réponse :

{
"ok": true,
"result": [{
"message": {
"chat": {
"id": -1001234567890, ← Chat ID du groupe
"title": "Notifications Optimus WiFi",
"type": "group"
}
}
}]
}

⚠️ IMPORTANT pour les groupes :

  • Le Chat ID commence par -100 (nombre négatif)

  • Exemple : -1001234567890

  • Incluez bien le signe moins - lors de la configuration

Pour un canal (channel) :

  1. Créez un canal Telegram

  2. Rendez votre bot administrateur du canal avec permission de poster

  3. Envoyez un message dans le canal

  4. Même procédure que pour le groupe pour récupérer le Chat ID

Étape 3 : Configurer dans DighiConnect

  1. Connectez-vous à votre compte DighiConnect

  2. Allez dans Paramètres → Notifications

  3. Cliquez sur Configurer les notifications

  4. Activez Telegram

  5. Remplissez les champs :

    • Bot Token : Collez le token obtenu de BotFather

    • Chat ID : Collez votre Chat ID (personnel ou groupe)

  6. Activez les événements souhaités :

    • ⚠️ Solde faible : Alerte quand votre solde descend sous un seuil

    • 📦 Stock faible : Alerte quand vos vouchers sont presque épuisés

    • 🚨 Stock épuisé : Alerte quand vous n'avez plus de vouchers

    • ✅ Génération en lot terminée : Confirmation après création de tickets

  7. Cliquez sur Enregistrer

  8. Testez en cliquant sur Envoyer un test

Vérification

Si tout est configuré correctement, vous devriez recevoir un message de test :

🔔 Test de Notification
━━━━━━━━━━━━━━━━
📍 Hotspot: Optimus_Wifi_Zone_Zogbadje
⏰ Heure: 2026-02-17T14:30:00+00:00
━━━━━━━━━━━━━━━━
✅ Votre configuration fonctionne correctement!

Dépannage

❌ "Chat not found"

  • Cause : Vous n'avez pas envoyé de message au bot

  • Solution : Ouvrez une conversation avec votre bot et envoyez n'importe quel message

❌ "Bot was blocked by the user"

  • Cause : Vous avez bloqué le bot

  • Solution : Débloquez le bot dans Telegram, puis re-démarrez avec /start

❌ "Bot is not a member of the chat"

  • Cause : Le bot n'est pas dans le groupe

  • Solution : Ajoutez le bot au groupe et donnez-lui les droits d'admin

❌ "Bad Request: can't parse entities"

  • Cause : Erreur de formatage (normalement géré automatiquement)

  • Solution : Contactez le support DighiConnect

❌ Aucun message reçu après le test

  1. Vérifiez que le Bot Token est correct (40+ caractères)

  2. Vérifiez que le Chat ID est correct (commence par -100 pour groupes)

  3. Vérifiez que le bot n'est pas bloqué

  4. Consultez l'historique des notifications dans Paramètres → Notifications → Historique récent

Exemple de Configuration Complète

✅ Telegram activé
Bot Token: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567
Chat ID: -1001234567890

✅ Événements actifs :

  • Solde faible (seuil: 500 XOF)

  • Stock faible (seuil: 15 vouchers)

  • Stock épuisé

  • Génération en lot terminée

✅ Réessai automatique : Activé (3 tentatives max)

Sécrité

🔒 Bonnes pratiques :

  • Ne partagez jamais votre Bot Token

  • Utilisez un groupe privé (non un canal public) pour les notifications sensibles

  • Limitez l'accès au groupe aux membres de confiance

  • Si votre token est compromis, contactez @BotFather et utilisez /revoke pour le révoquer