Connecter un channel Telegram

Ce guide vous montre comment connecter votre channel Telegram à AdTarget pour que les conversions soient suivies automatiquement.

Prérequis

Avoir créé un bot Telegram
Un channel Telegram (vous devez être administrateur)
Le token du bot ajouté à AdTarget

Étape 1 : Ajoutez le bot à votre channel

Ouvrez les paramètres de votre channel

Ouvrez votre channel Telegram, appuyez sur le nom du channel en haut, puis appuyez sur Administrateurs.

Ajoutez le bot comme administrateur

Appuyez sur Ajouter un administrateur, recherchez le nom d’utilisateur de votre bot et sélectionnez-le.

Définissez les permissions

Lors de l’ajout du bot comme administrateur, assurez-vous que cette permission est activée :

Inviter des utilisateurs via un lien (obligatoire) — le bot en a besoin pour générer des liens d’invitation uniques et traçables par visiteur

Les autres permissions peuvent rester désactivées.

Appuyez sur Terminé pour confirmer.

Étape 2 : Confirmez la détection du channel dans AdTarget

AdTarget détecte automatiquement votre channel lorsque vous ajoutez le bot comme administrateur. Il n’est pas nécessaire d’entrer manuellement un nom ou un identifiant de channel.

Après avoir ajouté le bot comme administrateur (Étape 1), allez sur votre tableau de bord AdTarget
Allez dans les Paramètres de votre site et sélectionnez l’onglet Channels — votre channel devrait apparaître automatiquement en quelques secondes
Cochez la case à côté du channel et cliquez sur Save pour l’assigner au site

L’assignation du channel à un site est nécessaire avant que le suivi ne fonctionne. Les channels non assignés ne généreront pas de liens d’invitation et ne suivront pas les conversions.

Optionnellement, ajustez le type d’événement de conversion (par défaut Lead)

Le channel n’apparaît pas ? Essayez de retirer le bot de la liste des administrateurs du channel et de le re-ajouter. Cela re-déclenche le webhook Telegram qu’AdTarget utilise pour la détection. Voir Dépannage ci-dessous pour plus de conseils.

Étape 3 : Vérifiez la connexion

Une fois le bot ajouté comme administrateur, le channel apparaît dans l’onglet Paramètres > Channels de votre site. Si le bot est retiré du channel, le statut du channel passe à removed.

Pour tester la connexion :

Rejoignez votre channel depuis un autre compte
Vérifiez AdTarget dans les 30 secondes
Vous devriez voir l’événement d’adhésion

Plusieurs channels

Vous pouvez connecter plusieurs channels au même site AdTarget :

Ajoutez votre bot comme administrateur à chaque channel — chacun est auto-détecté
Allez dans les Paramètres de votre site et sélectionnez l’onglet Channels, puis cochez chaque channel que vous souhaitez assigner
Les conversions de chaque channel sont suivies séparément

Astuce : Utilisez le même bot pour tous les channels pour simplifier la gestion.

Channels privés vs publics

Nous recommandons fortement d’utiliser des channels privés pour la meilleure précision d’attribution. Les channels publics ont une limitation Telegram connue qui peut empêcher le suivi des conversions de fonctionner de manière fiable — voir les détails ci-dessous.

Channels privés (Recommandés)

Les utilisateurs doivent utiliser un lien d’invitation pour rejoindre — il n’y a pas d’autre moyen
AdTarget génère un lien d’invitation unique et traçable par visiteur
Lorsque l’utilisateur rejoint, Telegram inclut le lien d’invitation dans le webhook, permettant à AdTarget d’associer l’adhésion au clic publicitaire d’origine
Résultat : précision d’attribution proche de 100% et événements CAPI fiables vers Meta

Channels publics

Les utilisateurs peuvent rejoindre via t.me/channelname, la recherche Telegram ou des messages transférés — sans utiliser votre lien d’invitation suivi
AdTarget génère toujours des liens d’invitation uniques par visiteur, mais même lorsqu’un utilisateur en clique un, l’application Telegram (surtout sur Android) peut silencieusement le convertir en “adhésion directe”
Lorsque cela se produit, le webhook de Telegram n’inclut pas le lien d’invitation, donc AdTarget ne peut pas associer l’adhésion au clic publicitaire
Ces adhésions apparaissent comme organiques dans votre tableau de bord — aucun événement CAPI n’est envoyé à Meta

Pourquoi c’est important

Il s’agit d’une limitation connue de l’API Telegram Bot : pour les channels publics, le champ invite_link dans le webhook ChatMemberUpdated est souvent absent, même lorsque l’utilisateur a effectivement cliqué sur un lien suivi. Le client Telegram résout le channel public et effectue une adhésion directe au lieu d’une adhésion par lien d’invitation.

En pratique, cela signifie :

L’attribution des channels publics peut être peu fiable, surtout pour les utilisateurs Android
Des adhésions qui devraient être attribuées à vos publicités peuvent apparaître comme organiques
L’algorithme de Meta ne recevra pas ces signaux de conversion, réduisant l’optimisation publicitaire

Notre recommandation

Si la précision de l’attribution et le reporting Meta CAPI sont importants pour vos campagnes (c’est généralement le cas), utilisez un channel privé. Vous pouvez toujours partager des liens d’invitation suivis sur votre page d’atterrissage — l’expérience utilisateur est identique, mais l’attribution est garantie.

Paramètres du channel

Modifier la configuration du channel

Allez dans les Paramètres de votre site et sélectionnez l’onglet Channels
Cliquez sur le bouton Setup (ou Edit) sur la ligne du channel pour ouvrir la boîte de dialogue de configuration
Modifiez les paramètres selon vos besoins
Cliquez sur Save

Désassigner ou supprimer un channel

Pour désassigner un channel d’un site, décochez-le dans l’onglet Channels et cliquez sur Save. Le channel reste dans votre compte mais arrête le suivi pour ce site.

Pour supprimer définitivement un channel, utilisez l’option de suppression sur la ligne du channel. Cela supprime en cascade tous les liens d’invitation, conversions et affectations aux sites associés à ce channel. Cette action est irréversible.

Dépannage

“Bot is not an administrator”

Ajoutez le bot comme administrateur à votre channel
Assurez-vous que la permission “Inviter des utilisateurs via un lien” est activée
Attendez 30 secondes et réessayez

Le channel n’apparaît pas dans le tableau de bord ?

Retirez le bot de la liste des administrateurs du channel, puis re-ajoutez-le
Assurez-vous que le bot a été ajouté en tant qu’administrateur, pas comme simple membre
Attendez jusqu’à 30 secondes pour que le webhook arrive

Les adhésions ne sont pas détectées ?

Vérifiez que le bot a les permissions d’administrateur
Testez en rejoignant depuis un autre compte

Événements retardés ?

Les webhooks Telegram ont parfois des délais
Les événements apparaissent généralement en moins de 5 secondes
Si c’est systématiquement lent, contactez le support

Bonnes pratiques

Utilisez des noms de channels descriptifs : Nommez clairement les channels dans AdTarget pour les identifier facilement dans les rapports.

Testez avant de lancer des publicités : Vérifiez que le suivi fonctionne en rejoignant depuis un compte de test avant de dépenser en publicité.

Surveillez le statut des channels : Vérifiez périodiquement l’onglet Paramètres > Channels de votre site pour vous assurer que les channels restent actifs.

Conservation des liens d’invitation : Chaque lien d’invitation est à usage unique et valide pendant 7 jours après sa création. Les liens restent ouverts pendant cette période afin que les utilisateurs qui cliquent sur une publicité mais rejoignent plus tard soient toujours correctement attribués. Après 7 jours, Telegram expire automatiquement le lien.

Étapes suivantes

Avec votre channel connecté, configurez l’intégration Meta Pixel pour envoyer des événements de conversion à Meta.