> ## Documentation Index > Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt > Use this file to discover all available pages before exploring further. # Telegram > Connectez un compte Telegram à Fanify pour envoyer et recevoir des messages depuis votre instance ## Introduction Telegram est le canal de messagerie principal utilisé par Fanify pour discuter avec vos fans. Une fois un compte Telegram connecté, votre instance peut : * Recevoir les messages entrants de vos fans * Envoyer des messages, photos, vidéos et notes vocales * Synchroniser l'historique des conversations * Déclencher l'IA de chatting et les workflows automatiques La connexion se fait depuis l'interface, sans manipulation technique. ## Prérequis * **Un compte Telegram dédié** à votre activité Fanify (un compte personnel peut convenir, un compte dédié est recommandé) * **L'application Telegram installée** sur votre téléphone (pour scanner le QR code) ou l'accès aux SMS du numéro associé * **Accès administrateur** à votre instance Fanify * **Configuration initiale terminée** : la création de l'opérateur administrateur via la [mise en route](/fr/basics/configuration/onboarding) doit être faite Telegram se configure dans l'onglet **Admin** > **Services**, une fois votre compte administrateur créé. Le guide de [mise en route](/fr/basics/configuration/onboarding) vous y redirige via l'étape « Canal de communication ». ## Étapes ### 1) Ouvrir la page Telegram 1. Connectez-vous à votre instance Fanify 2. Allez dans l'onglet **Admin** Onglet Admin

3. Section **Services** Section Services

4. Cliquez sur **Telegram**

La page **Service Telegram** s'ouvre. Tant qu'aucun compte n'est connecté, elle propose deux méthodes de connexion : QR code ou numéro de téléphone. ### 2) Connecter votre compte La page de connexion vous propose deux méthodes au choix : scanner un **QR code** (recommandé) ou saisir votre **numéro de téléphone**. Choisissez celle qui vous convient. Méthode la plus rapide. Ne nécessite généralement pas de code 2FA.

Lancez l'application **Telegram** sur le téléphone du compte que vous voulez connecter. Dans Telegram : **Paramètres** > **Appareils** > bouton bleu **Ajouter un appareil**. Pointez votre téléphone vers le QR code affiché dans Fanify. Validez la demande sur votre téléphone. Si votre compte Telegram a un mot de passe cloud (2FA), une fenêtre vous le demandera dans Fanify. Le QR code se renouvelle automatiquement toutes les 30 secondes. Si vous ratez le délai, un nouveau QR est généré sans action de votre part.

Page de connexion Telegram : QR code et numéro de téléphone

Utilisez cette méthode si vous ne pouvez pas scanner le QR code.

Saisissez votre numéro en spécifiant le pays. Il sera automatiquement converti au format international (ex : `+33 6 12 34 56 78`). Cliquez sur **Se connecter avec ce numéro**. Telegram envoie un code de vérification (sur l'application Telegram en priorité, sinon par SMS). Entrez le code dans la fenêtre qui s'ouvre dans Fanify. Si votre compte a un mot de passe cloud (2FA), saisissez-le également.

Modale de saisie du code de vérification Telegram

Une fois la connexion établie, la page affiche le **Compte connecté** avec le nom d'utilisateur et le numéro de téléphone. ### 3) Vérifier la connexion Après connexion, vérifiez en haut de la page : * Le badge de statut affiche **En ligne** * La carte **Compte connecté** affiche le bon nom d'utilisateur Telegram À partir de cet instant, votre instance reçoit en temps réel les messages Telegram entrants. ## Synchronisation des conversations A chaque démarrage de votre instance, et à chaque redémarrage du service, Fanify récupère l'historique récent de vos conversations Telegram (en cas d'arrêt prolongé de votre instance, mise à jour etc...). Paramétrable dans la carte **Synchronisation automatique**. Si vous compte Telegram contient déjà des conversation que vous souhaitez récupérer, vous devez faire une **Synchronisation manuelle**, carte visible en scrollant en bas de la page:

| Paramètre | Description | | ------------------------------- | --------------------------------------------------------------------------------------------------- | | **Fenêtre temporelle (heures)** | Synchroniser uniquement les conversations actives sur les X dernières heures | | **Limite de messages** | Nombre maximum de nouveaux messages récupérés par conversation issu de la fenêtre temporelle | | **Délai (ms)** | Pause minimale entre deux appels à l'API Telegram (anti-flood, minimum 2000 ms, 5000 ms recommandé) | Pour relancer une synchronisation immédiate, cliquez sur **Synchroniser** en haut de la page. Cette opération peut prendre un certain temps selon vos paramètres et la quantité de données à synchroniser. ## Bon à savoir ### Déconnecter un compte Dans la carte **Compte connecté**, cliquez sur **Déconnecter**. La session Telegram est fermée, le fichier de session local supprimé, et le compte retiré de Fanify. Pour réutiliser Telegram, relancez une connexion (QR ou numéro). ### Mot de passe cloud Telegram (2FA) Si votre compte Telegram a un mot de passe cloud activé, Fanify le demande lors de la connexion via une fenêtre dédiée. Ce mot de passe n'est jamais stocké : il sert uniquement à valider la session, puis Telegram émet un jeton de session que Fanify conserve. Il s'agit du mot de passe cloud configuré dans **Telegram > Confidentialité et sécurité > Validation en deux étapes**, et non de votre mot de passe Fanify. ### Service en pause (flood wait) Telegram impose des limites anti-spam. Si votre instance dépasse ces limites, le service passe en statut **En pause** pendant une durée affichée à l'écran. Les envois reprennent automatiquement à la fin du délai. Aucune action n'est requise. ### Clé d'API Telegram personnelle (optionnel) Par défaut, Fanify utilise une clé d'API Telegram partagée. Pour utiliser votre propre clé, à la connexion d'un compte : 1. Ouvrez la section **J'ai ma propre clé d'API Telegram** sur la page Telegram 2. Récupérez vos identifiants sur [my.telegram.org](https://my.telegram.org) 3. Saisissez l'**Identifiant d'API** (`api_id`) et le **Hash d'API** (`api_hash`) 4. Cliquez sur **Enregistrer**, puis sur **Redémarrer** Cette étape est réservée aux utilisateurs avancés. La clé partagée fonctionne pour la grande majorité des cas. Cependant si vous subissez des problèmes de connexion ou des limites d'utilisation, vous pouvez utiliser votre propre clé d'API. ### Redémarrer le service Le bouton **Redémarrer** en haut de la page relance le service Telegram. Utile après une modification d'identifiants API ou en cas d'erreur de connexion. ## Dépannage rapide * **Statut "Erreur"** : consultez le message affiché sous le badge, puis cliquez sur **Redémarrer** * **QR code non scannable** : utilisez la connexion par numéro de téléphone * **Code 2FA jamais reçu** : vérifiez l'application Telegram d'un autre appareil connecté, puis les SMS * **Mot de passe cloud refusé** : vérifiez que vous saisissez bien le mot de passe Telegram, pas celui de Fanify * **Messages non reçus** : vérifiez que le statut est **En ligne** et lancez une synchronisation manuelle En cas de soucis, désactivez au maximum les protections de votre compte Telegram depuis l'application > Paramètres > Confidentialité et sécurité. ## Liens utiles * Application Telegram : [telegram.org/apps](https://telegram.org/apps) * Identifiants API personnels : [my.telegram.org](https://my.telegram.org)