> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram-Integration einrichten

> Erfahren Sie, wie Sie Telegram mit Ihren Landingpages in LanderLab verbinden und Lead-Benachrichtigungen in Echtzeit an einen Telegram-Chat, eine Gruppe oder einen Kanal senden.

Verbinden Sie Telegram mit Ihren Landingpages in LanderLab, um bei jedem neuen Lead sofort eine Benachrichtigung zu erhalten. Statt Ihr Dashboard zu prüfen, sieht Ihr Team jeden Lead direkt im Moment der Übermittlung – in einem Telegram-Chat, einer Gruppe oder einem Kanal.

## Was ist die Telegram-Integration?

Die Telegram-Integration nutzt einen Telegram-Bot, um bei jedem auf Ihrer Landingpage erfassten Lead eine Nachricht an den von Ihnen gewählten Chat zu senden. Alle Felder des Leads werden automatisch übernommen, sodass Sie die vollständige Übermittlung erhalten – ohne Einrichtungsaufwand über das Verbinden der Integration hinaus.

Sie eignet sich hervorragend für Echtzeit-Benachrichtigungen: Informieren Sie Ihr Vertriebsteam in einer gemeinsamen Gruppe, senden Sie Leads in einen privaten Kanal oder lassen Sie sich persönlich über jede neue Übermittlung benachrichtigen.

## Bevor Sie beginnen

Für die Verbindung mit Telegram benötigen Sie zwei Dinge:

1. **Ein Bot-Token**, das Sie über den BotFather von Telegram erstellen.
2. **Eine Chat-ID**, die dem Bot mitteilt, wohin die Benachrichtigungen gesendet werden sollen (ein persönlicher Chat, eine Gruppe oder ein Kanal).

Sie erstellen den Bot nur einmal. Danach können Sie denselben Bot verwenden, um Benachrichtigungen von beliebig vielen Landingpages zu senden.

## Schritt 1: Einen Telegram-Bot erstellen und das Bot-Token abrufen

Ihr Bot ist das Konto, das die Benachrichtigungen zustellt. Sie erstellen ihn über den BotFather, den offiziellen Bot von Telegram zur Verwaltung von Bots.

<Steps>
  <Step title="Öffnen Sie BotFather in Telegram">
    Geben Sie in der Telegram-Suchleiste `BotFather` ein und öffnen Sie das verifizierte Konto (das mit dem blauen Häkchen und dem Benutzernamen `@BotFather`).

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botfather.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=ea65bfd31940bb7d2833927589e1eb7d" alt="Das verifizierte BotFather-Konto in den Telegram-Suchergebnissen mit blauem Häkchen" width="1456" height="829" data-path="images/botfather.png" />
    </Frame>
  </Step>

  <Step title="Starten Sie einen neuen Bot">
    Klicken Sie auf **Start** und senden Sie anschließend den Befehl `/newbot`.
  </Step>

  <Step title="Benennen Sie Ihren Bot">
    Der BotFather fragt zunächst nach einem **Namen** (dem Anzeigenamen, beliebig wählbar) und anschließend nach einem **Benutzernamen**. Der Benutzername muss eindeutig sein und auf `bot` enden (zum Beispiel `LanderLabdoc_Bot`).
  </Step>

  <Step title="Kopieren Sie Ihr Bot-Token">
    Sobald der Benutzername akzeptiert ist, antwortet der BotFather mit einer Bestätigungsnachricht, die Ihr Bot-Token enthält. Es sieht etwa so aus: `123456789:AAExampleTokenReplaceWithYourOwn000`. Kopieren Sie es und bewahren Sie es sicher auf.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botapi.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=40bea8773dd6af8e9fd6411bdae12929" alt="Die Bestätigungsnachricht des BotFather in Telegram mit dem API-Token des neuen Bots" width="1456" height="829" data-path="images/botapi.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Behandeln Sie Ihr Bot-Token wie ein Passwort. Jeder, der es besitzt, kann Ihren Bot steuern. Veröffentlichen Sie es niemals und geben Sie es nicht an Personen weiter, denen Sie nicht vertrauen.
</Warning>

## Schritt 2: Ihre Chat-ID abrufen

Die Chat-ID sagt dem Bot genau, wohin er Benachrichtigungen senden soll. Wie Sie sie finden, hängt davon ab, wohin Ihre Leads gehen sollen. Wählen Sie unten die Option, die zu Ihrem Setup passt.

<AccordionGroup>
  <Accordion title="Gruppenchat (für Teams empfohlen)">
    Am einfachsten ermitteln Sie die Chat-ID einer Gruppe über die Telegram-Desktop-App.

    <Steps>
      <Step title="Erstellen Sie eine Gruppe und fügen Sie Ihren Bot hinzu">
        Erstellen Sie eine Telegram-Gruppe (oder öffnen Sie eine bestehende) und fügen Sie Ihren Bot als Mitglied hinzu.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botgroup.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=d6b8b1e180f8daae0f1d1e1e8a77b80e" alt="Eine Telegram-Gruppe mit dem als Mitglied hinzugefügten Bot" width="1456" height="820" data-path="images/botgroup.png" />
        </Frame>
      </Step>

      <Step title="Senden Sie eine Nachricht und kopieren Sie deren Link">
        Senden Sie eine beliebige Nachricht in der Gruppe. Klicken Sie anschließend mit der rechten Maustaste auf die Nachricht (oder tippen Sie auf dem Smartphone lange darauf) und wählen Sie **Copy Message Link**.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/copylink.webp?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=1a45ce1fd9ad6c51951db3239fccbfa7" alt="Das Rechtsklick-Menü in Telegram auf einer Gruppennachricht mit hervorgehobenem Copy Message Link" width="1568" height="768" data-path="images/copylink.webp" />
        </Frame>
      </Step>

      <Step title="Lesen Sie die Chat-ID aus dem Link ab">
        Der kopierte Link sieht etwa so aus: `https://t.me/c/4302014071/2`. Die Zahl direkt nach `/c/` ist Ihre Gruppen-ID. In diesem Beispiel lautet die Chat-ID `4302014071`.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/groupid.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=194aa213dd4d7d3ee65dfe5bb5f6ca9b" alt="Ein kopierter Telegram-Nachrichtenlink mit hervorgehobener Gruppen-ID nach dem Segment /c/" width="1568" height="277" data-path="images/groupid.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Falls mit der reinen Zahl keine Benachrichtigungen ankommen, stellen Sie der Gruppen-ID `-100` voran. Aus `4302014071` wird dann beispielsweise `-1004302014071`. Dies ist das Format, das die Telegram-Bot-API für Gruppen und Kanäle verwendet.
    </Note>
  </Accordion>

  <Accordion title="Privater Chat (nur Sie)">
    Nutzen Sie dies, wenn Sie persönliche Benachrichtigungen direkt in Ihr eigenes Telegram erhalten möchten.

    <Steps>
      <Step title="Starten Sie Ihren Bot">
        Öffnen Sie Ihren neuen Bot und klicken Sie auf **Start** oder senden Sie ihm eine beliebige Nachricht.
      </Step>

      <Step title="Öffnen Sie die getUpdates-URL">
        Öffnen Sie in einem Browser die folgende URL und ersetzen Sie `<YOUR_BOT_TOKEN>` durch Ihr Token. Das Wort `bot` muss direkt vor dem Token stehen bleiben.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Finden Sie Ihre Chat-ID">
        Die Seite gibt einen JSON-Block zurück. Suchen Sie nach dem Objekt `chat` und kopieren Sie den Wert von `id`. Diese Zahl ist Ihre Chat-ID.

        ```json theme={null}
        "chat": {
          "id": 21xxxxx38,
          "type": "private"
        }
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Kanal">
    Nutzen Sie dies, um Leads in einen Telegram-Kanal zu senden.

    <Steps>
      <Step title="Fügen Sie Ihren Bot als Kanal-Administrator hinzu">
        Fügen Sie Ihren Bot dem Kanal hinzu, geben Sie ihm Administratorrechte und posten Sie anschließend eine beliebige Nachricht im Kanal.
      </Step>

      <Step title="Öffnen Sie die getUpdates-URL">
        Öffnen Sie in einem Browser die folgende URL und ersetzen Sie `<YOUR_BOT_TOKEN>` durch Ihr Token.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Finden Sie Ihre Chat-ID">
        Suchen Sie das Objekt `chat` unter `channel_post` und kopieren Sie den Wert von `id`. Kanal-IDs beginnen mit `-100`.

        ```json theme={null}
        "chat": {
          "id": -1001xxxxxx062,
          "type": "channel"
        }
        ```
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Tip>
  Die getUpdates-URL liefert ein leeres Ergebnis? Stellen Sie sicher, dass Sie zuvor mindestens eine Nachricht an Ihren Bot, Ihre Gruppe oder Ihren Kanal gesendet haben. Telegram gibt nur kürzliche Aktivität zurück.
</Tip>

## Schritt 3: Telegram in LanderLab verbinden

Mit Bot-Token und Chat-ID können Sie die Integration verbinden.

### Die Integration hinzufügen

<Steps>
  <Step title="Öffnen Sie Ihre Landingpage">
    Gehen Sie zu **Landing Pages** und klicken Sie auf den **Namen der Landingpage**, für die Sie Lead-Benachrichtigungen möchten.
  </Step>

  <Step title="Öffnen Sie den Tab Integrations">
    Klicken Sie auf **Add Integration**, um das Integrationsfenster zu öffnen, suchen Sie nach **Telegram** und wählen Sie es aus.
  </Step>

  <Step title="Geben Sie einen Namen und Ihr Bot-Token ein">
    Geben Sie der Integration einen **Name** zur Identifikation und fügen Sie anschließend Ihr **Bot Token** aus Schritt 1 ein. Klicken Sie auf **Add Telegram**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/bot-token.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=f8eddbe2a0c4d7c7c4b23e535679460e" alt="Das Formular der Telegram-Integration in LanderLab mit den Feldern Name und Bot Token" width="551" height="317" data-path="images/bot-token.webp" />
    </Frame>
  </Step>
</Steps>

### Die Benachrichtigung konfigurieren

Nach dem Hinzufügen des Bots öffnet sich ein kurzer Einrichtungsassistent, in dem Sie festlegen, wohin die Benachrichtigungen gehen und wie sie aussehen.

<Steps>
  <Step title="Geben Sie Ihre Chat-ID ein">
    Fügen Sie die in Schritt 2 ermittelte **Chat ID** ein (zum Beispiel `-1004309994071`). Klicken Sie auf **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/chatid.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=632546f1d1b7169a066b71284e43f1c2" alt="Der Chat-ID-Schritt des Telegram-Einrichtungsassistenten in LanderLab" width="696" height="331" data-path="images/chatid.webp" />
    </Frame>
  </Step>

  <Step title="Wählen Sie Ihr Nachrichtenformat">
    Legen Sie fest, wie jede Benachrichtigung formuliert wird:

    | Format     | Bedeutung                                                                                                                            |
    | :--------- | :----------------------------------------------------------------------------------------------------------------------------------- |
    | **List**   | LanderLab formatiert alle Lead-Felder automatisch. Sie ergänzen lediglich einen **Intro text**, der oben in der Nachricht erscheint. |
    | **Custom** | Schreiben Sie Ihre eigene Nachrichtenvorlage und bestimmen Sie genau, was in jeder Benachrichtigung steht.                           |

    In den meisten Fällen ist **List** die schnellste Option. Fügen Sie einen Einleitungstext wie `Neuer Lead von der Pre-Sell-Warm-Up-Landingpage` hinzu und klicken Sie auf **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/image-27.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=b6df23cb4f87f08a4771194b23d91fc2" alt="Der Schritt zum Nachrichtenformat im Telegram-Einrichtungsassistenten mit den Formaten List und Custom sowie einem Feld für den Einleitungstext" width="912" height="502" data-path="images/image-27.png" />
    </Frame>
  </Step>

  <Step title="Prüfen und verbinden">
    Der letzte Schritt zeigt eine Vorschau von Ziel, Nachrichtenformat und Einleitungstext. Alle Lead-Felder werden automatisch übernommen. Wenn alles korrekt aussieht, klicken Sie auf **Connect Telegram**.
  </Step>
</Steps>

<Note>
  Wenn Ihre Landingpage mehrere A/B-Test-Varianten hat, werden Sie vor dem Hinzufügen gefragt, für welche Variante oder Varianten diese Integration gelten soll.
</Note>

## Die Integration testen

Übermitteln Sie einen Test-Lead über das Formular oder Quiz Ihrer Landingpage und prüfen Sie anschließend Ihren Telegram-Chat. Der Bot sollte innerhalb weniger Sekunden eine Nachricht mit den Lead-Details zustellen.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Es kommen keine Benachrichtigungen an">
    Prüfen Sie drei Dinge: ob Ihr Bot-Token korrekt ist, ob Ihr Bot Mitglied (oder Administrator) der Gruppe bzw. des Kanals ist und ob Ihre Chat-ID korrekt eingetragen wurde. Versuchen Sie bei Gruppen und Kanälen, der ID das Präfix `-100` voranzustellen.
  </Accordion>

  <Accordion title="Benachrichtigungen gehen an den falschen Chat">
    Prüfen Sie die Chat-ID noch einmal. Gruppe, Kanal und persönlicher Chat lassen sich leicht verwechseln. Wiederholen Sie Schritt 2 für genau das gewünschte Ziel.
  </Accordion>

  <Accordion title="Der Bot reagiert nicht">
    Stellen Sie sicher, dass Sie im Bot-Chat auf **Start** geklickt oder mindestens eine Nachricht an die Gruppe bzw. den Kanal gesendet haben. Telegram gibt erst dann Chat-Daten zurück, wenn Aktivität vorliegt.
  </Accordion>
</AccordionGroup>
