Produktanleitungen
Telegram-Konto verbinden
Sie können Ihr eigenes Telegram-Konto mit Wbiztool verbinden, neben Ihren WhatsApp-Nummern. Es sendet über dieselbe API und dieselben Seiten wie eine WhatsApp-Nummer, und die Empfänger sehen Ihre Nachrichten als ganz normale Telegram-Nachrichten von Ihnen.
- Eine API für beide. Nachricht senden, An mehrere Nummern senden, Nachricht planen, An Gruppe senden, Nachricht stornieren und die Webhooks für den Nachrichtenstatus funktionieren genauso. Übergeben Sie die ID des Telegram-Kontos als
whatsapp_client. - Dieselben Seiten. Schnellversand, Kampagnen und Erinnerungen können von dem Konto senden.
- Mehr Wege, Menschen zu erreichen. Senden Sie an eine Telefonnummer, einen @Benutzernamen, einen t.me-Link oder eine Gruppe.
Wer das darf: Inhaber und Bearbeiter verbinden und verwalten Telegram-Konten.
Bevor Sie beginnen#
- Telegram auf Ihrem Smartphone, angemeldet mit dem Konto, von dem Sie senden möchten.
- Eine bestätigte E-Mail-Adresse.
- Ein Plan ohne offene Zahlung und mit einem freien Platz für eine Nummer. Ein Telegram-Konto belegt wie eine WhatsApp-Nummer einen der Nummernplätze Ihres Plans. Siehe Limits für Nummern.
- Nachrichten, die in Ihrem Plan noch übrig sind. Jede Nachricht von einem Telegram-Konto verbraucht eine Nachricht Ihres Plans, wie bei WhatsApp.
Konto verbinden#
Klicken Sie auf der Seite Nummern auf Telegram-Konto hinzufügen. Sie finden die Schaltfläche auch im Fenster WhatsApp-Nummer hinzufügen: Möchten Sie ein Telegram-Konto verbinden? Telegram-Konto hinzufügen.
Das Fenster Telegram-Konto hinzufügen bietet zwei Wege zur Anmeldung: QR-Code scannen oder Anmeldecode. Beide führen zum selben Ergebnis.
Mit einem QR-Code#
Nutzen Sie diesen Weg, wenn Ihr Smartphone neben dem Computer liegt.
Telegram-Konto hinzufügen öffnen
Klicken Sie auf der Seite Nummern auf Telegram-Konto hinzufügen. Das Fenster öffnet sich, QR-Code scannen ist bereits ausgewählt.
QR-Code anzeigen
Klicken Sie auf QR-Code zeigen. Das Fenster Mit Telegram scannen zeigt den Code.
Gerät hinzufügen auf dem Smartphone öffnen
Öffnen Sie Telegram auf Ihrem Smartphone und gehen Sie zu Einstellungen → Geräte → Gerät hinzufügen.
Code scannen
Richten Sie das Smartphone auf den QR-Code. Der Code ändert sich alle 30 Sekunden: Scannen Sie den neuesten. Sobald die Anmeldung klappt, zeigt das Fenster Telegram-Konto verbunden und „… ist verbunden. Nachrichten, die Sie von diesem Konto senden, werden über Telegram verschickt.“
Mit einem Anmeldecode#
Nutzen Sie diesen Weg, wenn Sie keinen QR-Code scannen können, etwa weil das Smartphone Ihr einziges Gerät ist.
Anmeldecode wählen
Klicken Sie im Fenster Telegram-Konto hinzufügen auf den Tab Anmeldecode.
Nummer eingeben
Prüfen Sie Ihr Land unter Ländervorwahl. Geben Sie unter Telegram-Telefonnummer die Nummer ein, die Ihr Telegram-Konto verwendet, ohne Ländervorwahl, zum Beispiel
9876543210. Klicken Sie auf Anmeldecode senden.Code eingeben
Telegram sendet einen Anmeldecode an Ihre Telegram-App (oder per SMS). Geben Sie ihn im Fenster Geben Sie den Anmeldecode ein unter Anmeldecode ein und klicken Sie auf Anmelden. Danach zeigt das Fenster Telegram-Konto verbunden.
Zweistufige Bestätigung#
Ist für Ihr Konto die zweistufige Bestätigung aktiv, fragt das Fenster nach dem QR-Code oder dem Anmeldecode nach dem Telegram-Passwort: Geben Sie Ihr Telegram-Passwort ein. Geben Sie Ihr Telegram-Passwort (Cloud-Passwort) unter Telegram-Passwort ein und klicken Sie auf Anmelden. Wbiztool verwendet es nur einmal zur Anmeldung und speichert es nie.
Nach dem Verbinden#
- Das Konto erhält auf der Seite Nummern eine Karte mit dem Badge Telegram und seiner ID, zum Beispiel ID 702. Klicken Sie auf die ID, um sie zu kopieren, und verwenden Sie sie in der API als
whatsapp_client, wie bei einer Nummer. - Klicken Sie auf Testnachricht senden, um zu prüfen, ob das Senden klappt. Geben Sie unter Senden an einen @Benutzernamen oder eine Telefonnummer mit Ländervorwahl ein, zum Beispiel
@nameoder+91 98765 43210. - Umbenennen und Entfernen funktionieren wie bei einer WhatsApp-Nummer. Siehe Nummer verwalten.
Von Ihrem Telegram-Konto senden#
Wählen Sie das Telegram-Konto wie jede Nummer: unter Von im Schnellversand, als Absendernummer einer Kampagne oder einer Erinnerung oder mit seiner ID als whatsapp_client in der API. Seine Nachrichten erscheinen unter Berichte, und der webhook von Nachricht senden meldet SENT oder FAILED wie bei 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."
}'
Ersetzen Sie 12345, YOUR_API_KEY und 702 durch Ihre eigenen Werte: 702 ist die ID des Telegram-Kontos von seiner Karte.
An wen Sie senden können#
Von einem Telegram-Konto aus nimmt phone in der API (ebenso die Nummern im Schnellversand, die Nummern einer Kampagne und Senden an bei einer Erinnerung) jede dieser Angaben an:
| Sie schreiben | Beispiel | Gut zu wissen |
|---|---|---|
| Eine Telefonnummer mit Ländervorwahl | +91 98765 43210 | Die Person muss bei Telegram sein. Beim ersten Mal wird die Nummer zu den Telegram-Kontakten Ihres Kontos hinzugefügt. Telegram lehnt Personen ab, die ihre Nummer vor Fremden verbergen: Die Nachricht schlägt mit „Not on Telegram, or their privacy settings hide this number“ fehl. |
| Ein @Benutzername | @emma_thompson | Der Telegram-Benutzername der Person. |
| Ein t.me-Link | t.me/emma_thompson | Dasselbe wie der @Benutzername. https://t.me/emma_thompson funktioniert auch. |
tg:<id> | tg:5012345678 | So nennen der Posteingang und seine Webhooks eine Person, die weder Nummer noch Benutzernamen zeigt. Verwenden Sie es, um ihr zu antworten. |
Benutzernamen, t.me-Links und tg:<id> funktionieren nur von einem Telegram-Konto aus. Von einer WhatsApp-Nummer aus antworten Nachricht senden und Nachricht planen mit „Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client“, und An mehrere Nummern senden überspringt sie.
Welches Konto die API wählt#
Wenn Sie whatsapp_client weglassen, verwendet Nachricht senden die einzige verbundene Nummer, WhatsApp zuerst:
- Eine verbundene WhatsApp-Nummer wird verwendet, auch wenn zusätzlich ein Telegram-Konto verbunden ist. Ein neues Telegram-Konto übernimmt Ihre bestehenden Integrationen also nicht.
- Ein Telegram-Konto wird nur verwendet, wenn keine WhatsApp-Nummer verbunden ist.
- Ein @Benutzername verwendet das einzige verbundene Telegram-Konto.
Um in allen anderen Fällen vom Telegram-Konto zu senden, übergeben Sie seine ID als whatsapp_client.
Gruppen#
Von einem Telegram-Konto aus nimmt group_name (und Gruppen im Schnellversand) Folgendes an:
- den @Benutzernamen oder t.me-Link einer öffentlichen Gruppe, zum Beispiel
@lumen_clubodert.me/lumen_club, oder - den genauen Namen einer Gruppe oder eines Kanals, in dem das Konto Mitglied ist, zum Beispiel
Lumen VIP Club. Groß- und Kleinschreibung spielen keine Rolle.
Das Konto muss bereits Mitglied der Gruppe sein und dort posten dürfen. Es tritt nie von selbst einer Gruppe bei.
- Passt keine Gruppe, schlägt die Nachricht mit „Group not found“ fehl.
- Darf das Konto dort nicht posten, schlägt sie mit „This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)“ fehl.
Limits von Telegram#
Telegram begrenzt, wie vielen Personen, die ein Konto noch nicht kontaktiert haben, dieses Konto schreiben darf. Neue Konten sind am stärksten begrenzt.
- Wenn Telegram zum Verlangsamen auffordert, pausiert das Konto, und seine Nachrichten warten. Sie werden nach der Pause gesendet.
- Wenn Telegram Nachrichten an Fremde begrenzt, schlägt diese Nachricht mit „Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour“ fehl, und das Konto pausiert eine Stunde.
Der Posteingang (Unibox)#
Ein Telegram-Konto lässt sich wie eine Nummer zum Unibox-Posteingang hinzufügen: Klicken Sie unter Posteingangsnummern auf Nummer zum Posteingang hinzufügen und wählen Sie es aus. Es belegt wie eine WhatsApp-Nummer eine der Posteingangsnummern Ihres Unibox-Add-ons.
- Seine privaten Chats erscheinen im Posteingang: Nachrichten, die es empfängt, und Nachrichten, die vom Telefon oder von Wbiztool gesendet werden. Chats aus Telegram tragen ein Telegram-Zeichen.
- Dateien bis 16 MB werden in den Posteingang kopiert.
- Antworten funktionieren auch an Personen, die ihre Nummer verbergen.
- Gruppen, Kanäle, Gespeicherte Nachrichten und der eigene Service-Chat von Telegram (der mit den Anmeldecodes) werden nie angezeigt.
Der Webhook eines Kontos im Posteingang sendet dessen Nachrichten wie der einer Nummer. Der Payload hat platform gleich telegram, und contact.phone und message.from sind die Nummer der Person, ihr @username oder tg:<id>: Senden Sie Ihre Antwort an diesen Wert als phone. Siehe Payload.
Trennen oder neu verbinden#
- Trennen auf der Karte beendet das Senden von diesem Konto. Außerdem wird Wbiztool aus der Geräteliste des Kontos in Telegram abgemeldet.
- Wenn Telegram die Sitzung beendet, zum Beispiel wenn Sie Wbiztool unter Einstellungen → Geräte abmelden oder das Konto überall abgemeldet wird, zeigt die Karte Nicht verbunden. Inhaber und Bearbeiter erhalten wie bei einer WhatsApp-Nummer eine Benachrichtigung über den Verbindungsabbruch, auf Telegram zugeschnitten. Siehe Benachrichtigungen bei WhatsApp-Verbindungsabbruch.
- Solange das Konto nicht verbunden ist, warten seine Nachrichten unter Wartet auf Versand.
- Um es wieder zu verbinden, klicken Sie auf seiner Karte auf Neu verbinden und melden Sie sich erneut an, per QR-Code oder Anmeldecode.
Noch nicht verfügbar#
- Das Exportieren der Mitglieder von Telegram-Gruppen. Der Gruppenmitglieder-Export funktioniert nur für WhatsApp-Gruppen.
- Telegram-Gruppen im Unibox-Posteingang. Dort erscheinen nur private Chats.
Fehlerbehebung#
| Problem | Was zu tun ist |
|---|---|
| Keine Schaltfläche Telegram-Konto hinzufügen | Sie sind in diesem Arbeitsbereich Analyst. Bitten Sie einen Inhaber, es zu erledigen oder Sie zum Bearbeiter zu machen. |
| Telegram-Konto hinzufügen ist ausgegraut | Zeigen Sie mit der Maus darauf, um den Grund zu sehen: Ihre E-Mail ist nicht bestätigt, alle Nummernplätze Ihres Plans sind belegt, oder eine Zahlung für den Plan ist offen. Es gelten dieselben Regeln wie für Nummern, siehe Limits für Nummern. |
| Der QR-Code funktioniert nicht | Er ändert sich alle 30 Sekunden: Scannen Sie den neuesten, in Telegram unter Einstellungen → Geräte → Gerät hinzufügen. Zeigt das Fenster „Die Anmeldung hat zu lange gedauert. Starten Sie erneut.“, klicken Sie auf Erneut starten. |
| „Dieser Code ist nicht richtig. Prüfen Sie den neuesten Code, den Telegram gesendet hat, und versuchen Sie es erneut.“ | Geben Sie den neuesten Anmeldecode aus Ihrer Telegram-App (oder der SMS) ein. |
| „Der Code ist abgelaufen. Starten Sie erneut, um einen neuen zu erhalten.“ | Klicken Sie auf Erneut starten und geben Sie den neuen Code ein. |
| „Dieses Passwort ist nicht richtig. Versuchen Sie es erneut.“ | Geben Sie das Telegram-Passwort aus der zweistufigen Bestätigung des Kontos ein, nicht den Anmeldecode. |
| „Zu dieser Nummer gibt es kein Telegram-Konto.“ | Prüfen Sie Land und Nummer, oder melden Sie sich mit dem QR-Code an. |
| „Telegram verlangt eine Wartezeit vor dem nächsten Versuch. Versuchen Sie es später erneut.“ | Warten Sie eine Weile und melden Sie sich dann erneut an. |
| Fehlgeschlagen mit „Not on Telegram, or their privacy settings hide this number“ | Die Person ist nicht bei Telegram oder verbirgt ihre Nummer vor Personen, die sie nicht kennt. Senden Sie stattdessen an ihren @Benutzernamen, oder bitten Sie sie, Ihrem Konto zuerst zu schreiben, und antworten Sie aus dem Posteingang. |
| Fehlgeschlagen mit „Group not found“ | Prüfen Sie den genauen Namen der Gruppe, oder verwenden Sie ihren @Benutzernamen oder t.me-Link. Das Konto muss Mitglied der Gruppe sein. |
| Fehlgeschlagen mit „This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)“ | Treten Sie der Gruppe zuerst in Telegram mit diesem Konto bei. Dürfen nur Admins posten, fragen Sie einen Admin der Gruppe. |
| Fehlgeschlagen mit „Telegram limited this account: …“ | Siehe Limits von Telegram. Das Senden geht nach einer Stunde weiter. |
| Die API antwortet „Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client“ | Übergeben Sie die ID des Telegram-Kontos als whatsapp_client. Siehe Welches Konto die API wählt. |
| Die Karte zeigt Nicht verbunden | Telegram hat die Sitzung beendet. Klicken Sie auf Neu verbinden und melden Sie sich erneut an. |
