Your AI Connector Docs

Telegram (Bèta)

Koppel je bestaande Telegram-account aan het platform zodat je Telegram-gesprekken direct in de app binnenkomen en een AI-agent kan antwoorden. Je koppelt dit door je telefoonnummer en een inlogcode in te voeren — op dezelfde manier als wanneer je Telegram op een nieuw apparaat toevoegt.

Bèta. Telegram is nu voor iedereen beschikbaar, maar het is nog nieuw — verwacht af en toe wat onvolkomenheden terwijl we het verder verfijnen. Als iets niet werkt zoals beschreven, laat het dan weten aan de ondersteuning.


Wat is de Telegram-integratie?

De Telegram-integratie koppelt je persoonlijke Telegram-account aan het platform via de eigen inlogprocedure van Telegram. Er hoeft geen bot te worden aangemaakt en er hoeft geen apart telefoonnummer te worden gekocht — je logt in met het Telegram-account dat je al gebruikt, en je 1-op-1 chats worden beschikbaar in de app.

Dit is ideaal voor bedrijven die al met klanten communiceren via Telegram en een AI-agent, Broadcasts en een gedeelde inbox willen toevoegen aan hun bestaande account.

Belangrijk — lees dit voordat je verbinding maakt. Dit is een onofficiële integratie die een persoonlijk Telegram-account automatiseert. De regels van Telegram ontmoedigen automatisering en bulk- of ongevraagde berichten, en accounts die deze regels overtreden kunnen worden beperkt of permanent verbannen (in sommige gevallen kan het telefoonnummer zelf worden geblokkeerd voor herregistratie). Gebruik dit kanaal alleen om mensen te berichten die al contact met je hebben opgenomen of opgeslagen contacten zijn, houd het volume laag en laat de AI op een natuurlijk tempo antwoorden. Gebruik het niet voor koude massale benadering.


Telegram vs. WhatsApp Web

Beide koppelen een account dat je al bezit, zonder officiële Business API.

Functie Telegram WhatsApp Web
Installatie Voer telefoonnummer + inlogcode in Koppel je telefoon (QR of koppelcode)
Accounttype Je persoonlijke Telegram-account Je persoonlijke/zakelijke WhatsApp
Maandelijkse kosten 50 credits per maand per gekoppeld account 50 credits per maand per gekoppeld nummer
Kosten per bericht Gratis Gratis
Sjabloonberichten Niet van toepassing Niet ondersteund
Typ-indicatoren Ondersteund Ondersteund
Media (in) Foto’s, documenten, spraakberichten Foto’s, documenten, spraakberichten
Officiële ondersteuning Onofficiële integratie Onofficiële integratie
Beste voor Bedrijven die al actief zijn op Telegram, warme/bestaande contacten Bedrijven op WhatsApp, snelle start

Wat het kost. Elk gekoppeld Telegram-account kost 50 credits per maand, die van je credit-saldo worden afgeschreven, zonder extra kosten per bericht. De eerste afschrijving vindt 30 dagen na het koppelen plaats, en daarna elke 30 dagen zolang het account gekoppeld blijft. Ontkoppelen stopt de betaling. Als je saldo te laag is wanneer de maandelijkse vergoeding verschuldigd is, wordt die maand overgeslagen en wordt het ongeveer 30 dagen later opnieuw geprobeerd. Een overgeslagen maand wordt achteraf nooit in rekening gebracht, opwaarderen activeert geen afschrijving en het account blijft gekoppeld.

Hetzelfde nummer voor beide? Ja. Als hetzelfde telefoonnummer op zowel Telegram als WhatsApp (Web) staat, kun je dit als beide kanalen verbinden — ze werken als twee afzonderlijke verbindingen op de pagina Kanalen, elk met een eigen status, opwarmperiode en limieten. Het verbinden van de een heeft geen invloed op de ander en vervangt deze ook niet.


Telegram instellen

Stap 1: Open de koppelingsflow

  1. Klik in de linkerzijbalk onderaan op Settings.
  2. Klik in de linkerzijbalk van Settings onder Channels op Channels.
  3. Zoek de Telegram-kaart — deze bevat een Beta-melding — en klik op Connect.

Stap 2: Voer je telefoonnummer in

  1. Typ het telefoonnummer van het Telegram-account dat je wilt koppelen, inclusief de landcode (bijvoorbeeld 555 123 4567).
  2. Schakel Bestaande chats importeren in als je je recente één-op-één Telegram-gesprekken wilt importeren als contacten, zodat je niet met een lege inbox begint. (Als je dit inschakelt, kun je ook AI gepauzeerd houden voor geïmporteerde chats beheren — aanbevolen en standaard ingeschakeld, zodat het importeren van je geschiedenis nooit automatische antwoorden op oude berichten activeert. Schakel dit later per contact uit zodra je er klaar voor bent.)
  3. Vink Ik begrijp dat mijn account 50 credits/maand in rekening wordt gebracht voor deze koppeling aan. De knop Inlogcode verzenden blijft grijs totdat je dit doet.
  4. Klik op Inlogcode verzenden.
  5. Telegram stuurt een inlogcode naar je Telegram-app (deze komt meestal aan als bericht van de officiële “Telegram”-servicechat, niet altijd als sms).

Stap 3: Voer de inlogcode in

  1. Open Telegram op je telefoon.
  2. Lees de inlogcode uit de Telegram-servicechat.
  3. Typ de code in de app.
  4. Klik op Code verifiëren.

De code verloopt snel. Houd je telefoon bij de hand voordat je op Inlogcode verzenden klikt en voer de code direct in. Als de code verloopt, start de koppeling dan opnieuw om een nieuwe te ontvangen.

Stap 4: Tweestapsverificatie-wachtwoord (indien van toepassing)

Als je Telegram-account tweestapsverificatie heeft ingeschakeld, vraagt de app na de code om je 2FA-wachtwoord. Voer dit in en klik op Wachtwoord verifiëren. Je wachtwoord wordt alleen gebruikt om de beveiligde login te voltooien en wordt nooit in leesbare vorm opgeslagen.

Eenmaal geverifieerd, wordt je account op de Kanalen-pagina weergegeven als Gekoppeld. Je Telegram-gesprekken zijn nu toegankelijk via het platform en een AI-agent die aan dit kanaal is toegewezen, kan reageren op inkomende berichten.

Elk Telegram-account kan slechts één keer per werkruimte worden gekoppeld. Als het account al is gekoppeld, zelfs onder een ander telefoonnummer, stopt het koppelingsproces en krijg je een melding: gebruik de bestaande koppeling of verbreek deze eerst.

Je bestaande chats importeren

Als je Bestaande chats importeren hebt ingeschakeld in Stap 2:

  • Alleen recente privéchats (één-op-één) worden geïmporteerd. Groepschats zijn niet inbegrepen en er wordt slechts een beperkte hoeveelheid recente geschiedenis per chat opgehaald.
  • Het importeren gebeurt eenmalig, op de achtergrond, direct nadat je verbinding hebt gemaakt. Bij grotere accounts kan het even duren voordat alles verschijnt.
  • Geïmporteerde berichten vullen de conversatie in Chats aan, maar ze tellen niet mee voor de cijfers of grafieken in je Dashboard. Alleen wat je verstuurt en ontvangt nadat je verbinding hebt gemaakt, wordt daar gemeten.

Als je verbinding maakt zonder te importeren, komen nieuwe gesprekken vanaf dat moment nog steeds normaal binnen — alleen de oudere geschiedenis wordt overgeslagen.


Sessiebeheer

Verbindingsstatus controleren

De status van je Telegram-koppeling wordt getoond op de Telegram-kaart op de Kanalen-pagina:

Status Betekenis
Verbonden Actief en ontvangt/verstuurt berichten
Code verzonden Wacht op het invoeren van de inlogcode
Tweestapsverificatie vereist Wacht op je wachtwoord voor tweestapsverificatie
Niet verbonden Geen actieve sessie

Opnieuw verbinden

Als je sessie wordt verbroken, open dan Instellingen → Kanalen → Kanalen, zoek de Telegram-kaart en gebruik de actie voor verbinden/beheren. Als de sessie niet automatisch kan worden hersteld (bijvoorbeeld omdat je deze vanaf je telefoon hebt beëindigd), wordt je gevraagd opnieuw in te loggen met een nieuwe code.

U hoeft er niet naar te zoeken. Wanneer Telegram de sessie beëindigt, verschijnt er een Telegram signed you out-balk bovenaan elke pagina in de app met een Reconnect-knop die direct het inlogscherm opent. Als de verbinding om een andere reden wegvalt, wordt er een Telegram disconnected-balk getoond terwijl de app op de achtergrond blijft proberen opnieuw verbinding te maken; deze verdwijnt vanzelf zodra de verbinding is hersteld. Dit geldt ook voor een verbinding die open blijft maar niet meer reageert: de app controleert elke paar minuten of Telegram nog antwoordt en herstelt een inactieve verbinding automatisch. Zolang het account niet opnieuw verbonden is, zal de AI er niet op reageren.

Verbinding verbreken

Open de Telegram-kaart en klik op Ontkoppelen. Hiermee logt het platform uit bij je Telegram-account, wordt de sessie opgeschoond en stoppen de maandelijkse kosten. Je kunt dit ook beëindigen vanuit Telegram zelf: Instellingen → Apparaten → Actieve sessies, en vervolgens de sessie van het platform beëindigen.


Veilig blijven op Telegram

Omdat dit een persoonlijk account automatiseert, is het jouw verantwoordelijkheid om het te beschermen tegen verbanningen. Het platform reguleert de AI en uitgaande berichten om er natuurlijk uit te zien, maar volg deze richtlijnen:

  • Stuur alleen berichten naar warme/bestaande contacten. Beantwoord mensen die jou als eerste een bericht stuurden of die opgeslagen contacten zijn. Vermijd het massaal berichten sturen naar vreemden — dat is de snelste manier om de spam-markering van Telegram te activeren.
  • Houd het volume laag, vooral bij een nieuw verbonden account. Bouw het langzaam op over meerdere dagen, niet alles tegelijk.
  • Vermijd het sturen van links naar mensen die je niet kennen — berichten vol links naar vreemden zijn een veelvoorkomende reden voor een blokkering.
  • Laat de AI antwoorden in een natuurlijk tempo. De ingebouwde vertragingen en de type-indicator zijn er om het gesprek menselijk te houden — probeer deze niet te omzeilen.
  • Gebruik een echt nummer dat je beheert. Wegwerp-/virtuele (VoIP — een internetgebaseerd telefoonnummer, geen fysieke simkaart) nummers worden veel sneller gemarkeerd.

Waarschuwing. Als Telegram het account markeert voor spam, stopt het verzenden totdat het gedrag verandert — alleen wachten lost dit niet op. Herhaaldelijke overtredingen kunnen leiden tot een permanente verbanning van het account en het bijbehorende telefoonnummer.


Verzendlimieten, opwarmen & follow-up controles

Telegram gebruikt dezelfde beschermende verzendlimieten, automatische opwarmperiode en per-account ‘kill switch’ voor follow-ups als WhatsApp Web. Deze zijn er om te voorkomen dat een persoonlijk account eruitziet als een spam-farm en wordt gemarkeerd. Zodra je Telegram-account is verbonden op de Kanalen-pagina, zie je:

  • Een Verzendlimieten & Opwarmen-kaart met dezelfde meters als WhatsApp Web — vandaag verzonden berichten, vandaag nieuwe contacten en de huidige opwarmdag.
  • Een Geautomatiseerde follow-ups-schakelaar — deze staat aan voor een nieuw gekoppeld nummer, dus schakel deze zelf uit terwijl het nummer nog aan het opwarmen is. Deze blijft gedurende het hele proces interactief, maar toont welke opwarmfasen (leeftijd van het nummer, activiteitsopbouw, recente betrokkenheid van contacten) nog niet zijn voltooid.

Automatische opwarming (ramp-up)

Een vers gekoppeld Telegram-account wordt bewust beperkt en ontgrendelt na verloop van tijd meer capaciteit. Het account verdient alleen een “kwalificerende dag” op dagen dat het daadwerkelijk ten minste 75% van zijn huidige limiet verstuurt — inactieve dagen tellen niet mee, dus het account kan niet promoveren zonder echt, constant gebruik.

  • Dagelijkse berichtlimiet = 50 + 8 × (day − 1), begrensd op 500/dag (bereikt op dag 58).
  • Dagelijkse limiet voor nieuwe contacten = floor((day − 1) × 5 / 6) (afgerond naar beneden op een heel getal), begrensd op 50/dag (bereikt op dag 61).

Op een nieuw account begin je dus met 50 berichten/dag en 0 nieuwe contacten/dag, wat in ongeveer twee maanden oploopt tot het volledige plafond. De pagina Kanalen toont de huidige dag, het verbruik van vandaag ten opzichte van de limiet en hoe ver het nog moet gaan.

Tip: Als je een account verbindt dat al maandenlang een echte Telegram-geschiedenis heeft, kun je via het opbouwpaneel de opwarmdag vooruitzetten zodat de limieten direct worden verhoogd. Gebruik dit eerlijk — alleen voor accounts die echt een organische geschiedenis hebben. Een gloednieuw account dat de opwarmfase overslaat, loopt een veel groter risico om verbannen te worden.

Stel je eigen dagelijkse limiet in

Je kunt de dagelijkse berichtlimiet op elk gewenst moment zelf instellen, op elke opwarmdag: open de Telegram-kaart op de pagina Kanalen, klik op Dagelijkse limiet instellen en kies een getal tussen 100 en 1.500 berichten per dag. Je limiet vervangt direct de berichtlimiet van de opwarmfase, zowel daaronder als daarboven. De dagelijkse limiet voor nieuwe contacten blijft de opwarmfase volgen, dus een nieuw account kan meer antwoorden sturen, maar niet meer berichten naar vreemden sturen. Het wissen van de limiet zet het account terug op het opwarmingsschema.

Het verhogen van de limiet gaat direct in en activeert alle gesprekken die waren gepauzeerd bij de oude limiet. Er is geen “veilig” gepubliceerd getal voor Telegram: houd het conservatief, let op spam-meldingen en doe een stap terug zodra je problemen ziet. Veel meer versturen dan een normaal account is de snelste manier om het account beperkt te krijgen, en de beperking geldt voor je Telegram-account, niet voor het platform.

Je kunt de limiet ook instellen via de API: stuur daily_message_limit_manual_override (100 tot 1.500, of 0 om te wissen) met het Update Phone Number-eindpunt (zie Verzendlimieten en opwarmdag op de pagina Kanalen in de API-referentie), of verplaats de opwarmdag met het ramp-day-eindpunt.

Opnieuw verbinden behoudt je opwarmfase

Als je hetzelfde Telegram-account loskoppelt en opnieuw verbindt, zelfs onder een nieuw telefoonnummer, wordt de opwarmdag hersteld op basis van de verzendgeschiedenis van het account op dit platform zodra het opnieuw verbinding maakt, zodat je niet opnieuw bij dag 1 begint.

Per-account follow-up kill-switch

De schakelaar Geautomatiseerde follow-ups is alleen van toepassing op dit account. Wanneer deze is uitgeschakeld, worden er geen enkele vorm van geautomatiseerde follow-ups vanuit dat account verzonden, ongeacht uw instellingen voor Broadcast of Agent. Bij een nieuw account (jonger dan ongeveer 30 opstartdagen) is het het veiligst om follow-ups uitgeschakeld te laten en alleen het eerste antwoord te versturen — follow-ups zorgen er het vaakst voor dat een account met een lage vertrouwensscore wordt geclassificeerd als “dit is een bot”. Schakel het weer in zodra het account is opgewarmd en stabiel is.

Wanneer de dagelijkse berichtlimiet is bereikt, worden geplande follow-ups automatisch doorgeschoven naar de volgende dag in plaats van dat ze mislukken.


Bezoekers verspreiden over meerdere accounts

Een korte link kan roteren over verschillende Telegram-accounts, op dezelfde manier als bij WhatsApp-nummers. Elke klik opent t.me/<username> van het account dat vandaag de meeste ruimte over heeft; accounts die zijn losgekoppeld, geen gebruikersnaam hebben of de dagelijkse verzendlimiet hebben bereikt, worden overgeslagen, zodat de link blijft werken als een account uitvalt. Maak deze aan onder Instellingen → Korte links → Nieuwe link en kies Telegram. Elk account moet een openbare gebruikersnaam hebben ingesteld in Telegram.


Mediaberichten

Inkomende foto’s, documenten en spraakberichten worden in de chat geladen zodat de AI ze kan begrijpen (spraakberichten worden automatisch getranscribeerd). Uitgaande AI-antwoorden zijn in deze versie alleen tekst. Lange antwoorden worden automatisch ingekort tot de limiet van 4.096 tekens van Telegram.


Leesstatus op je telefoon

Wanneer de AI antwoordt op een Telegram-chat, of wanneer je die chat opent in Chats, wordt de chat ook op je eigen Telegram-app als gelezen gemarkeerd — zodat de badge voor ongelezen berichten op je telefoon synchroon blijft in plaats van dat er honderden ongelezen chats opstapelen.

Chats die de bot niet beantwoordt (bijvoorbeeld wanneer deze uit staat, buiten de actieve uren, of wanneer de bot ervoor koos niet te antwoorden) blijven bewust ongelezen, zodat je ze zelf nog kunt zien en afhandelen.


Beperkingen

  • Alleen persoonlijke 1-op-1 chats. Groeps- en kanaalberichten worden in deze versie niet afgehandeld.
  • Geen inline knoppen. Interactieve knopmenu’s worden niet ondersteund.
  • Alleen tekst verzenden. De AI antwoordt met tekst; het verzenden van media staat gepland voor een latere update.
  • Niet-officiële integratie. Het is afhankelijk van de client-login van Telegram en wordt niet ondersteund door Telegram; wijzigingen aan hun kant kunnen hier invloed op hebben.
  • Accountrisico. Overmatige of ongevraagde automatisering kan ertoe leiden dat het account wordt beperkt of verbannen — volg de bovenstaande veiligheidsrichtlijnen.

Probleemoplossing

Inlogcode komt niet aan

  • Controleer de Telegram-servicechat in de Telegram-app — de code wordt meestal daar afgeleverd, niet via sms.
  • Zorg ervoor dat je het telefoonnummer met de juiste landcode hebt ingevoerd.
  • Telegram beperkt codes voor accounts/nummers die het als verdacht beschouwt. Wacht een paar minuten en probeer het opnieuw.

“Code verlopen” of “Ongeldige code”

  • De code is slechts kort geldig. Start de verbinding opnieuw om een nieuwe code aan te vragen en voer deze direct in.

Onverwacht om wachtwoord gevraagd

  • Je account heeft tweestapsverificatie ingeschakeld. Voer je Telegram-wachtwoord in om het inloggen te voltooien. Als je het bent vergeten, reset het dan via Instellingen → Privacy en beveiliging → Tweestapsverificatie in Telegram.

Berichten worden niet verzonden

  • Controleer of de verbindingsstatus Connected aangeeft op de pagina Channels.
  • Als het verzenden mislukt door een time-out, controleert de app direct de verbinding en herstelt deze als Telegram niet reageert. Probeer het bericht een paar minuten later opnieuw.
  • Bevestig dat de contactpersoon iemand is naar wie u een bericht kunt sturen op Telegram.
  • Als het account onlangs is gemarkeerd voor spam, verlaag dan het volume en beperk u tot bestaande contacten.

Account uitgelogd

  • Je sessie is beëindigd (door jou, vanaf een ander apparaat of door Telegram). Ga naar Instellingen → Kanalen → Kanalen, klik op Verbinding verbreken en log daarna opnieuw in.

Best practices

  • Verbind een account dat al met klanten communiceert op Telegram, geen gloednieuw wegwerpaccount.
  • Begin met een laag automatiseringsvolume en verhoog dit geleidelijk.
  • Reageer op inkomende en warme contacten in plaats van ongevraagde berichten naar vreemden te sturen.
  • Houd je account gezond — een echt nummer, normaal gebruik en een conservatief tempo verkleinen het risico op een verbanning aanzienlijk.