Connecter un compte Telegram

Vous pouvez connecter votre propre compte Telegram à Wbiztool, à côté de vos numéros WhatsApp. Il envoie avec la même API et les mêmes pages qu'un numéro WhatsApp, et les destinataires voient vos messages comme des messages Telegram ordinaires venant de vous.

• Une seule API pour les deux. Envoyer un message, Envoyer à plusieurs numéros, Programmer un message, Envoyer à un groupe, Annuler un message et les webhooks de statut des messages fonctionnent de la même façon. Passez l'ID du compte Telegram comme whatsapp_client.
• Les mêmes pages. L'envoi rapide, les campagnes et les rappels peuvent envoyer depuis ce compte.
• Plus de façons de joindre les gens. Envoyez à un numéro de téléphone, à un @username, à un lien t.me ou à un groupe.

Qui peut le faire : les Propriétaires et les Éditeurs connectent et gèrent les comptes Telegram.

Avant de commencer#

• Telegram sur votre téléphone, connecté avec le compte depuis lequel vous voulez envoyer.
• Une adresse email confirmée.
• Un forfait à jour de ses paiements, avec une place libre pour un numéro. Un compte Telegram occupe l'une des places de numéro de votre forfait, comme un numéro WhatsApp. Consultez Limites de numéros.
• Des messages restants sur votre forfait. Chaque message envoyé depuis un compte Telegram utilise un crédit de messages, comme sur WhatsApp.

Connecter votre compte#

Sur la page Numéros, cliquez sur Ajouter un compte Telegram. Vous le trouvez aussi en bas de la fenêtre Ajouter un numéro WhatsApp : Vous voulez connecter un compte Telegram ? Ajouter un compte Telegram.

La fenêtre Ajouter un compte Telegram propose deux façons de se connecter : Scanner le code QR ou Code de connexion. Les deux donnent le même résultat.

Avec un code QR#

Utilisez cette méthode quand votre téléphone est à côté de l'ordinateur.

1. Ouvrez Ajouter un compte Telegram

   Sur la page Numéros, cliquez sur Ajouter un compte Telegram. La fenêtre s'ouvre avec Scanner le code QR sélectionné.

2. Affichez le code QR

   Cliquez sur Afficher le code QR. La fenêtre Scannez avec Telegram affiche le code.

3. Ouvrez Ajouter un appareil sur votre téléphone

   Ouvrez Telegram sur votre téléphone et allez dans Paramètres → Appareils → Ajouter un appareil.

4. Scannez le code

   Pointez le téléphone vers le code QR. Le code change toutes les 30 secondes : scannez le plus récent. Quand la connexion réussit, la fenêtre affiche Compte Telegram connecté et « … est connecté. Les messages que vous envoyez depuis ce compte partent par Telegram. »

Avec un code de connexion#

Utilisez cette méthode quand vous ne pouvez pas scanner de code QR, par exemple quand le téléphone est votre seul appareil.

1. Choisissez Code de connexion

   Dans la fenêtre Ajouter un compte Telegram, cliquez sur l'onglet Code de connexion.

2. Saisissez votre numéro

   Vérifiez votre pays sous Indicatif du pays. Sous Numéro de téléphone Telegram, saisissez le numéro utilisé par votre compte Telegram, sans l'indicatif, par exemple 9876543210. Cliquez sur Envoyer le code de connexion.

3. Saisissez le code

   Telegram envoie un code de connexion à votre application Telegram (ou par SMS). Dans la fenêtre Saisissez le code de connexion, saisissez-le sous Code de connexion et cliquez sur Se connecter. La fenêtre affiche ensuite Compte Telegram connecté.

Validation en deux étapes#

Si votre compte utilise la validation en deux étapes, la fenêtre demande son mot de passe Telegram après le code QR ou le code de connexion : Saisissez votre mot de passe Telegram. Saisissez votre mot de passe Telegram (cloud) sous Mot de passe Telegram et cliquez sur Se connecter. Wbiztool ne l'utilise qu'une fois pour la connexion et ne l'enregistre jamais.

Après la connexion#

• Le compte reçoit une carte sur la page Numéros, avec un badge Telegram et son ID, par exemple ID 702. Cliquez sur l'ID pour le copier : utilisez-le comme whatsapp_client dans l'API, comme pour un numéro.
• Cliquez sur Envoyer un message test pour vérifier que l'envoi fonctionne. Sous Envoyer à, saisissez un @username ou un numéro de téléphone avec son indicatif pays, par exemple @name ou +91 98765 43210.
• Renommer et Supprimer fonctionnent comme pour un numéro WhatsApp. Consultez Gérer un numéro.

Envoyer depuis votre compte Telegram#

Choisissez le compte Telegram comme n'importe quel numéro : sous De dans l'envoi rapide, comme numéro d'envoi d'une campagne ou d'un rappel, ou avec son ID comme whatsapp_client dans l'API. Ses messages apparaissent dans les Rapports, et le webhook d'Envoyer un message signale SENT ou FAILED comme pour WhatsApp.

curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 702,
    "phone": "@emma_thompson",
    "msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
  }'

Remplacez 12345, YOUR_API_KEY et 702 par vos propres valeurs : 702 est l'ID du compte Telegram, sur sa carte.

À qui vous pouvez envoyer#

Depuis un compte Telegram, phone dans l'API (ainsi que les numéros de l'envoi rapide, les numéros d'une campagne et le champ Envoyer à d'un rappel) accepte chacun de ces formats :

Les noms d'utilisateur, les liens t.me et tg:<id> ne fonctionnent que depuis un compte Telegram. Depuis un numéro WhatsApp, Envoyer un message et Programmer un message répondent « Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client », et Envoyer à plusieurs numéros les ignore.

Quel compte l'API choisit#

Quand vous omettez whatsapp_client, Envoyer un message utilise le seul numéro connecté, WhatsApp d'abord :

• Un seul numéro WhatsApp connecté est utilisé, même si un compte Telegram est aussi connecté. Ajouter un compte Telegram ne bascule pas vos intégrations existantes vers celui-ci.
• Un compte Telegram n'est utilisé que si aucun numéro WhatsApp n'est connecté.
• Un @username utilise le seul compte Telegram connecté.

Pour envoyer depuis le compte Telegram dans tous les autres cas, passez son ID comme whatsapp_client.

Groupes#

Depuis un compte Telegram, group_name (ainsi que Groupes dans l'envoi rapide) accepte :

• le @username ou le lien t.me d'un groupe public, par exemple @lumen_club ou t.me/lumen_club, ou
• le nom exact d'un groupe ou d'un canal dont le compte fait partie, par exemple Lumen VIP Club. Les majuscules et minuscules ne comptent pas.

Le compte doit déjà être membre du groupe et avoir le droit d'y publier. Il ne rejoint jamais un groupe de lui-même.

• Si aucun groupe ne correspond, le message échoue avec « Group not found ».
• Si le compte ne peut pas publier dans le groupe, il échoue avec « This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post) ».

Les limites de Telegram#

Telegram limite le nombre de personnes qui n'ont pas contacté un compte auxquelles ce compte peut écrire. Les nouveaux comptes sont les plus limités.

• Quand Telegram demande de ralentir, le compte fait une pause et ses messages attendent. Ils partent après la pause.
• Quand Telegram limite les messages aux inconnus, ce message échoue avec « Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour », et le compte se repose pendant une heure.

La boîte de réception (Unibox)#

Un compte Telegram peut être ajouté à la boîte de réception Unibox comme un numéro : dans Numéros de la boîte, cliquez sur Ajouter un numéro à la boîte et choisissez-le. Il utilise l'un des numéros de boîte de votre module Unibox, comme un numéro WhatsApp.

• Ses discussions privées apparaissent dans la boîte de réception : les messages qu'il reçoit, et les messages envoyés depuis le téléphone ou par Wbiztool. Les discussions venant de Telegram affichent une icône Telegram.
• Les fichiers jusqu'à 16 Mo sont copiés dans la boîte de réception.
• Les réponses fonctionnent même avec les personnes qui masquent leur numéro.
• Les groupes, les canaux, les Messages enregistrés et la discussion de service de Telegram (celle qui envoie les codes de connexion) n'apparaissent jamais.

Le webhook d'un compte de la boîte de réception transmet ses messages comme celui d'un numéro. Le contenu a platform à telegram, et contact.phone et message.from contiennent le numéro, le @username ou le tg:<id> de la personne : envoyez votre réponse à cette valeur, comme phone. Consultez Contenu (payload).

Déconnecter ou reconnecter#

• Déconnecter, sur la carte, empêche le compte d'envoyer. Wbiztool se retire aussi de la liste des appareils du compte dans Telegram.
• Si Telegram met fin à la session, par exemple quand vous déconnectez Wbiztool sous Paramètres → Appareils ou que le compte est déconnecté partout, la carte affiche Non connecté. Les Propriétaires et les Éditeurs reçoivent une alerte de déconnexion formulée pour Telegram, comme pour un numéro WhatsApp. Consultez Alertes de déconnexion WhatsApp.
• Tant que le compte n'est pas connecté, ses messages attendent sous En attente d’envoi.
• Pour le connecter de nouveau, cliquez sur Reconnecter sur sa carte et reconnectez-vous, avec un code QR ou un code de connexion.

Pas encore disponible#

• L'export des membres des groupes Telegram. L'export des membres de groupe ne fonctionne que pour les groupes WhatsApp.
• Les groupes Telegram dans la boîte de réception Unibox. Seules les discussions privées y apparaissent.

Dépannage#

Voir aussi#

• Connecter votre numéro WhatsApp
• Envoyer un message rapide
• Boîte de réception Unibox et Webhooks de messages entrants
• Forfaits et facturation
• API : Envoyer un message, Envoyer à un groupe et Lister les numéros connectés