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
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

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. Klik op Inlogcode verzenden.
  4. Telegram stuurt een inlogcode naar je Telegram-app (deze komt meestal aan als een bericht van de officiële “Telegram”-servicechat, niet altijd als een 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.

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.

Verbinding verbreken

Open de Telegram-kaart en klik op Verbinding verbreken. Hiermee logt het platform uit bij je Telegram-account en wordt de sessie opgeschoond. Je kunt de sessie 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.

Handmatige overschrijving na opwarming

Zodra een account de volledige opwarmperiode van 58 dagen heeft voltooid, kun je met een optionele overschrijving de dagelijkse berichtlimiet boven de 500 verhogen (van 750 tot 5.000, in stappen van 250 berichten). Er is geen “veilig” gepubliceerd getal voor Telegram — wees conservatief, let op spam-markeringen en doe een stap terug zodra je problemen ziet. De overschrijving is alleen beschikbaar op volledig opgewarmde accounts; een nieuw account kan de opwarming op deze manier niet overslaan.

Per-account follow-up kill-switch

De Geautomatiseerde follow-ups-schakelaar regelt dit alleen voor dit account. Wanneer deze uit staat, worden er geen geautomatiseerde follow-ups van welke aard dan ook vanuit dat account verstuurd, ongeacht je instellingen voor uitzendingen of campagnes. Op een nieuw account (minder dan ~30 opbouwdagen) is het veiliger om follow-ups uit te laten en alleen het eerste antwoord te sturen — follow-ups zorgen er het vaakst voor dat een account met een lage betrouwbaarheid wordt geclassificeerd als “dit is een bot”. Zet de schakelaar weer aan 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.


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 Verbonden aangeeft op de Kanalen-pagina.
  • Bevestig dat de contactpersoon iemand is naar wie je een bericht kunt sturen op Telegram.
  • Als het account onlangs is gemarkeerd voor spam, verlaag dan het volume en houd je bij 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.