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

# Configura la integración con Telegram

> Aprende a conectar Telegram a tus landing pages en LanderLab y a enviar notificaciones instantáneas de leads a un chat, grupo o canal de Telegram en tiempo real.

Conecta Telegram a tus landing pages en LanderLab para recibir una notificación instantánea cada vez que llegue un lead nuevo. En lugar de revisar tu panel, tu equipo ve cada lead en el momento en que se envía, directamente en un chat, grupo o canal de Telegram.

## Qué es la integración con Telegram

La integración con Telegram usa un bot de Telegram para enviar un mensaje al chat que elijas cada vez que se recoge un lead en tu landing page. Todos los campos del lead se incluyen automáticamente, así que recibes el envío completo sin más configuración que conectar la integración.

Es perfecta para alertas en tiempo real: avisa a tu equipo de ventas en un grupo compartido, envía los leads a un canal privado o recibe un aviso personal con cada envío nuevo.

## Antes de empezar

Necesitas dos cosas para conectar Telegram:

1. **Un token de bot**, creado con BotFather de Telegram.
2. **Un Chat ID**, que indica al bot adónde enviar las notificaciones (un chat personal, un grupo o un canal).

Solo tienes que crear el bot una vez. Después puedes reutilizar el mismo bot para enviar notificaciones desde todas las landing pages que quieras.

## Paso 1: crea un bot de Telegram y consigue tu token

Tu bot es la cuenta que entrega las notificaciones. Lo creas con BotFather, el bot oficial de Telegram para gestionar bots.

<Steps>
  <Step title="Abre BotFather en Telegram">
    En la barra de búsqueda de Telegram, escribe `BotFather` y abre la cuenta verificada (la que tiene la marca azul y el nombre de usuario `@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="La cuenta verificada de BotFather en los resultados de búsqueda de Telegram, con la marca azul" width="1456" height="829" data-path="images/botfather.png" />
    </Frame>
  </Step>

  <Step title="Crea un bot nuevo">
    Haz clic en **Start** y envía el comando `/newbot`.
  </Step>

  <Step title="Ponle nombre a tu bot">
    BotFather te pedirá un **nombre** (el nombre visible, el que quieras) y después un **nombre de usuario**. El nombre de usuario tiene que ser único y terminar en `bot` (por ejemplo, `LanderLabdoc_Bot`).
  </Step>

  <Step title="Copia el token de tu bot">
    Cuando se acepte el nombre de usuario, BotFather responderá con un mensaje de confirmación que contiene el token de tu bot. Tiene un aspecto como `123456789:AAExampleTokenReplaceWithYourOwn000`. Cópialo y guárdalo en un lugar seguro.

    <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="El mensaje de confirmación de BotFather en Telegram, con el token de API del nuevo bot" width="1456" height="829" data-path="images/botapi.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Trata el token de tu bot como una contraseña. Cualquiera que lo tenga puede controlar tu bot. No lo publiques nunca ni lo compartas con personas en las que no confíes.
</Warning>

## Paso 2: consigue tu Chat ID

El Chat ID indica al bot exactamente adónde enviar las notificaciones. Cómo encontrarlo depende de dónde quieras recibir tus leads. Elige la opción que corresponda a tu caso.

<AccordionGroup>
  <Accordion title="Chat de grupo (recomendado para equipos)">
    La forma más sencilla de conseguir el Chat ID de un grupo es desde la aplicación de escritorio de Telegram.

    <Steps>
      <Step title="Crea un grupo y añade tu bot">
        Crea un grupo de Telegram (o abre uno existente) y añade tu bot como miembro.

        <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="Un grupo de Telegram con el bot añadido como miembro" width="1456" height="820" data-path="images/botgroup.png" />
        </Frame>
      </Step>

      <Step title="Envía un mensaje y copia su enlace">
        Envía cualquier mensaje en el grupo. Después haz clic derecho en el mensaje (o mantén pulsado en el móvil) y elige **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="El menú contextual de Telegram sobre un mensaje del grupo, con Copy Message Link resaltado" width="1568" height="768" data-path="images/copylink.webp" />
        </Frame>
      </Step>

      <Step title="Lee el Chat ID en el enlace">
        El enlace copiado tiene este aspecto: `https://t.me/c/4302014071/2`. El número justo después de `/c/` es el ID de tu grupo. En este ejemplo, el Chat ID es `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="Un enlace de mensaje de Telegram copiado, con el ID del grupo resaltado después de /c/" width="1568" height="277" data-path="images/groupid.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Si las notificaciones no llegan con el número tal cual, añade el prefijo `-100` al ID del grupo. Por ejemplo, `4302014071` pasa a ser `-1004302014071`. Es el formato que usa la API de bots de Telegram para grupos y canales.
    </Note>
  </Accordion>

  <Accordion title="Chat privado (solo tú)">
    Úsalo cuando quieras recibir las notificaciones directamente en tu propio Telegram.

    <Steps>
      <Step title="Inicia tu bot">
        Abre tu nuevo bot y haz clic en **Start**, o envíale cualquier mensaje.
      </Step>

      <Step title="Abre la URL getUpdates">
        En un navegador, abre la URL de abajo sustituyendo `<YOUR_BOT_TOKEN>` por tu token. Deja la palabra `bot` justo delante del token.

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

      <Step title="Encuentra tu Chat ID">
        La página devuelve un bloque de JSON. Busca el objeto `chat` y copia el valor de `id`. Ese número es tu Chat ID.

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

  <Accordion title="Canal">
    Úsalo para difundir los leads en un canal de Telegram.

    <Steps>
      <Step title="Añade tu bot como administrador del canal">
        Añade tu bot al canal, dale permisos de administrador y publica cualquier mensaje en el canal.
      </Step>

      <Step title="Abre la URL getUpdates">
        En un navegador, abre la URL de abajo sustituyendo `<YOUR_BOT_TOKEN>` por tu token.

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

      <Step title="Encuentra tu Chat ID">
        Busca el objeto `chat` dentro de `channel_post` y copia el valor de `id`. Los ID de canal empiezan por `-100`.

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

<Tip>
  ¿Ves un resultado vacío en la URL `getUpdates`? Asegúrate de haber enviado antes al menos un mensaje a tu bot, grupo o canal. Telegram solo devuelve la actividad reciente.
</Tip>

## Paso 3: conecta Telegram en LanderLab

Con el token de tu bot y el Chat ID listos, ya puedes conectar la integración.

### Añade la integración

<Steps>
  <Step title="Abre tu landing page">
    Ve a **Landing Pages** y haz clic en el **nombre de la landing page** de la que quieres recibir notificaciones de leads.
  </Step>

  <Step title="Abre la pestaña de integraciones">
    Haz clic en **Add Integration** para abrir el panel de integraciones, busca **Telegram** y selecciónalo.
  </Step>

  <Step title="Introduce un nombre y el token de tu bot">
    Ponle un **Name** a la integración para identificarla y pega el **Bot Token** del paso 1. Haz clic en **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="El formulario de la integración con Telegram en LanderLab, con los campos Name y Bot Token" width="551" height="317" data-path="images/bot-token.webp" />
    </Frame>
  </Step>
</Steps>

### Configura la notificación

Después de añadir el bot, se abre un breve asistente para que elijas adónde van las notificaciones y qué aspecto tienen.

<Steps>
  <Step title="Introduce tu Chat ID">
    Pega el **Chat ID** que encontraste en el paso 2 (por ejemplo, `-1004309994071`). Haz clic en **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="El paso Chat ID del asistente de configuración de Telegram en LanderLab" width="696" height="331" data-path="images/chatid.webp" />
    </Frame>
  </Step>

  <Step title="Elige el formato del mensaje">
    Elige cómo se redacta cada notificación:

    | Formato    | Qué hace                                                                                                                                 |
    | :--------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
    | **List**   | LanderLab da formato automáticamente a todos los campos del lead. Solo añades un **Intro text** que se muestra al principio del mensaje. |
    | **Custom** | Escribes tu propia plantilla de mensaje y controlas exactamente lo que dice cada notificación.                                           |

    En la mayoría de los casos, **List** es la opción más rápida. Añade una introducción como `Nuevo lead de la landing page de preventa` y haz clic en **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="El paso del formato del mensaje en el asistente de Telegram, con los formatos List y Custom y un campo de texto de introducción" width="912" height="502" data-path="images/image-27.png" />
    </Frame>
  </Step>

  <Step title="Revisa y conecta">
    El último paso muestra una vista previa del destino, el formato del mensaje y el texto de introducción. Todos los campos del lead se incluyen automáticamente. Si todo está bien, haz clic en **Connect Telegram**.
  </Step>
</Steps>

<Note>
  Si tu landing page tiene varias variantes de un test A/B, se te pedirá que elijas a qué variante o variantes se aplica esta integración antes de añadirla.
</Note>

## Prueba la integración

Envía un lead de prueba desde el formulario o el quiz de tu landing page y revisa tu chat de Telegram. El bot debería entregar un mensaje con los datos del lead en pocos segundos.

## Solución de problemas

<AccordionGroup>
  <Accordion title="No llega ninguna notificación">
    Comprueba tres cosas: que el token de tu bot es correcto, que tu bot es miembro (o administrador) del grupo o canal y que has introducido bien el Chat ID. En grupos y canales, prueba a añadir el prefijo `-100` al ID.
  </Accordion>

  <Accordion title="Las notificaciones llegan al chat equivocado">
    Revisa el Chat ID. Es fácil confundir un grupo, un canal o un chat personal. Repite el paso 2 para el destino exacto que quieres.
  </Accordion>

  <Accordion title="El bot no responde">
    Asegúrate de haber hecho clic en **Start** en el chat del bot o de haber enviado al menos un mensaje al grupo o canal. Telegram no devuelve ningún dato del chat hasta que hay actividad.
  </Accordion>
</AccordionGroup>
