# Chatbot para una cuenta de Telegram Business

Ahora puedes crear **asistentes empresariales personales** — bots especiales que se integran directamente en chats individuales de Telegram. Estos bots procesan automáticamente las solicitudes entrantes y responden en nombre del propietario de la cuenta, reduciendo drásticamente el tiempo dedicado a tareas rutinarias y mejorando la eficiencia de la comunicación.

**Casos de uso:**\
Estos asistentes se pueden configurar para diversos fines, como:

* Brindar consultas sobre productos o servicios.
* Responder preguntas frecuentes.
* Realizar una amplia gama de otras tareas automatizadas.

**Función clave: control fluido**

Un usuario puede **cambiar instantáneamente a comunicación manual** en cualquier momento sin interrumpir ni desactivar el funcionamiento del bot, garantizando un control total sobre el chat.

{% hint style="warning" %}
¡Atención! 

La cuenta de Telegram Business tiene una ventana de 24 horas.

Una vez que un usuario envía su primer mensaje, el bot tiene una **ventana de 24 horas** para responder y continuar la conversación. Esta ventana se restablece cada vez que el usuario responde.

* **Si el usuario responde:** La ventana de 24 horas se reinicia, permitiendo un diálogo continuo.
* **Si el usuario NO responde dentro de 24 horas:** La ventana se cierra. Se bloqueará al bot para que no envíe más mensajes hasta que el usuario envíe un nuevo mensaje para reiniciar el contacto.
  {% endhint %}

## Conectar el bot

Paso 1. Configuración en la **Mensajeros** sección.

1.  **Si estás conectando un bot de Telegram por primera vez.**

Primero, ve a la pestaña Channels en la sección Mavibot para conectar el chatbot de Telegram (si todavía no hay uno).

<div data-with-frame="true"><figure><img src="/files/3e673f509761ae235970d2115f528eea6155e0ca" alt="" width="563"><figcaption></figcaption></figure></div>

A continuación, conectamos el bot de Telegram según las[ instrucciones](/doc/es/chatbot/mensajeros/telegram/chatbot.md) .&#x20;

2. **Si Telegram está conectado**.&#x20;

En caso de que ya tengas un bot de Telegram conectado, encuentra este bot en los canales:

<div data-with-frame="true"><figure><img src="/files/48aa4f3436bcc174804329b300611c9780c2ffaa" alt="" width="563"><figcaption></figcaption></figure></div>

A continuación, haz clic en el botón de configuración, tras lo cual verás una ventana modal con campos de token, etc.:

<div data-with-frame="true"><figure><img src="/files/082b622225f6c1e2a754350decb99afd7be944fe" alt="" width="563"><figcaption></figcaption></figure></div>

En la ventana modal que se abre, haz clic en DONE para actualizar la configuración de tu bot de Telegram (no necesitas cambiar ninguna otra configuración):

<div data-with-frame="true"><figure><img src="/files/86527446db405318c4d43d8937310d13fac6231d" alt="" width="563"><figcaption></figcaption></figure></div>

En esta etapa, el trabajo con los canales está completado. Ve a la configuración del mensajero.&#x20;

Paso 2. Configuración del mensajero.

Para conectar el chatbot de Telegram a tu cuenta empresarial, ve a la configuración de tu perfil, donde debes encontrar la pestaña "Telegram Business":

<div data-with-frame="true"><figure><img src="/files/cfb4b29fca6ab14cfbc7691cb07acd2b90956f00" alt="" width="375"><figcaption></figcaption></figure></div>

A continuación, verás la pestaña "Chatbots", a la que debes ir:

<div data-with-frame="true"><figure><img src="/files/546e4ffeba3d6ea8cfb6ba7c194ad477001e7864" alt="" width="375"><figcaption></figcaption></figure></div>

Luego, en la pestaña recién abierta, introduce el enlace al bot de Telegram requerido o su nombre de usuario (se recomienda introducir el enlace).

<div data-with-frame="true"><figure><img src="/files/5ca46e3a18f1041564af9ae7f1623d106d743e17" alt="" width="375"><figcaption></figcaption></figure></div>

En la misma pestaña, establece el permiso (casilla de verificación "Reply to messages") para que el chatbot responda a los mensajes.

En esta etapa, la configuración del chatbot en la cuenta empresarial está completada. Continúa.

Paso 3. Configuración de BotFather.

Después de vincular el chatbot a la cuenta empresarial, debes actualizar la configuración del chatbot en BotFather, donde creaste inicialmente el bot de Telegram.

Para hacerlo, abre el chat con BotFather y habilítalo para trabajar con la cuenta empresarial:

<div data-with-frame="true"><figure><img src="/files/d3364b7bd169d2af53b7a16766d8faf93f58fc00" alt="" width="375"><figcaption></figcaption></figure></div>

Ve a la configuración del bot:

<div data-with-frame="true"><figure><img src="/files/6a98e6cbfbfa7df06e4df4c3bf8541463b259b37" alt="" width="375"><figcaption></figcaption></figure></div>

A continuación, haz clic en el botón "Business Mode" para habilitar el modo empresarial para el chatbot:

<div data-with-frame="true"><figure><img src="/files/5a902c4a203b649f7459cd417e229c5115582623" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
¡Listo! Toda la configuración necesaria del chatbot con una cuenta empresarial se ha completado.
{% endhint %}

Ahora, en la configuración del canal, encontrarás el bot de Telegram y verás el ID empresarial y también el nombre del propietario de la cuenta empresarial:

<div data-with-frame="true"><figure><img src="/files/cb0254f29236c0cb94bab5fea9e402ff8cd67846" alt=""><figcaption></figcaption></figure></div>

### Cómo desactivar&#x20;

Para desactivar el chatbot con modo empresarial, ve a canales y encuentra el chatbot en el que deseas desactivar esta configuración. Haz clic en el botón de configuración:

<div data-with-frame="true"><figure><img src="/files/dba66fa84e4e44efe04f8c264992c7f5e5265f61" alt=""><figcaption></figcaption></figure></div>

Haz clic en el botón "Disable Business Account".

<div data-with-frame="true"><figure><img src="/files/b8144a439a69390b343acfbdc4c2e3d4faf44ab7" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Si desactivas tu cuenta empresarial, el chatbot seguirá funcionando en modo estándar.
{% endhint %}

## Funciones disponibles

1. (API) Función en la calculadora:

**tg\_callback(platform\_id , callback\_message,group\_id, tg\_business)**

<details>

<summary><strong>tg_callback</strong></summary>

Parámetros:

**! platform\_id** - ID de cliente de Telegram

**! callback\_message** - mensaje de devolución de llamada&#x20;

**group\_id** - ID del bot de Telegram

**tg\_business -** para trabajar con clientes empresariales, toma el valor "1".

</details>

**tg\_send\_poll(platform\_id, question, options, is\_anonymous, allows\_multiple\_answers, reply\_markup, disable\_notification, protect\_content, token, reply\_to\_message\_id, message\_thread\_id, business\_connection\_id)**

<details>

<summary><strong>tg_send_poll</strong></summary>

Parámetros:&#x20;

**! platform\_id** - identificador del chat dentro de Telegram [**\***](/doc/es/chatbot/mensajeros/telegram/api.md)

**! question** - pregunta

**! options** - matriz de opciones de respuesta

**is\_anonymous** - 1 - encuesta anónima, '' - no anónima

**allows\_multiple\_answers** - 1 - se permiten múltiples respuestas, '' - solo una respuesta

**reply\_markup** - teclado, o '' - sin teclado

**disable\_notification** — indicador para enviar con notificación sonora (predeterminado 0); 1 - enviar en silencio, 0 - enviar con notificación

**protect\_content** - 1 - proteger de copias y capturas de pantalla, '' - sin protección

**token** - token del bot; si no se proporciona, se usa el actual

**reply\_to\_message\_id** - ID del mensaje citado

**message\_thread\_id** — identificador del hilo (disponible en supergrupos con funcionalidad de foro)

**business\_connection\_id -**&#x76;alor utilizado al conectar un bot (Business ID, mostrado en los canales); debe pasarse si se proporciona el token del bot y el mensaje debe enviarse a través de la cuenta de usuario vinculada al bot

</details>

**tg\_send\_quiz\_poll(platform\_id, question, options, explanation, correct\_option\_id, is\_anonymous, reply\_markup, parse\_mode, protect\_content, disable\_notification, token, reply\_to\_message\_id, message\_thread\_id )**

<details>

<summary><strong>tg_send_quiz_poll</strong></summary>

**! platform\_id** - identificador del chat dentro de Telegram [**\***](/doc/es/chatbot/mensajeros/telegram/api.md)

**! question** - pregunta

**! options** - matriz de opciones de respuesta

**! explanation** - texto que se muestra cuando el usuario selecciona una respuesta incorrecta o toca el icono de bombilla en una encuesta de tipo quiz; 0–200 caracteres, con no más de dos saltos de línea después del análisis de entidades.

**! correct\_option\_id** - número de la respuesta correcta, comenzando desde 1.

**is\_anonymous** -1 - encuesta anónima, '' - no anónima

**reply\_markup** -  teclado, o '' - sin teclado

**parse\_mode** - markdown o html para *explanation*, o '' para sin formato.

**protect\_content** - 1 protege de copias y capturas de pantalla, '' - sin protección.

**disable\_notification** — indicador para enviar con notificación sonora (predeterminado 0); 1 - enviar en silencio, 0 - enviar con notificación

**token** - token del bot; si no se proporciona, se usa el actual.

**reply\_to\_message\_id** - ID del mensaje citado

**message\_thread\_id** — identificador del hilo (disponible en supergrupos con funcionalidad de foro)

**open\_period** - tiempo permitido para completar el quiz/test; valor numérico de 5 a 600, representando segundos.

**business\_connection\_id -** valor utilizado al conectar un bot (Business ID, mostrado en los canales); debe pasarse si se proporciona el token del bot y el mensaje debe enviarse a través de la cuenta de usuario vinculada al bot

</details>

**tg\_send\_message\_1(token, platform\_id, text, client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities, business\_connection\_id)**

<details>

<summary><strong>tg_send_message_1</strong></summary>

Parámetros:

**! token** — token del bot de Telegram obtenido de BotFather

**! platform\_id** — identificador del cliente de Telegram al que se debe enviar el mensaje [**\***](/doc/es/chatbot/mensajeros/telegram/api.md)

**! text** - texto del mensaje

**client\_message\_id** - ID del mensaje citado

**reply\_markup** — configuración de botones [**\*\***](/doc/es/chatbot/mensajeros/telegram/api.md)

**parse\_mode** — modo de formato de texto para negrita o cursiva en la descripción del mensaje [**\*\*\***](/doc/es/chatbot/builder/telegram_messages.md)**.** valores posibles: html, markdown, markdownV2

**disable\_web\_page\_preview -** si mostrar una vista previa del enlace; establece 1 para desactivarla, de lo contrario 0 o deja vacío ("")

**protect\_content** — indicador para proteger el contenido de copias; para activarlo, pasa cualquier valor distinto de 0, False o comillas vacías ('')

**disable\_notification** — indicador para enviar con notificación sonora (predeterminado 0); 1 - enviar en silencio, 0 - enviar con notificación

**message\_thread\_id** — identificador del hilo (disponible en supergrupos con funcionalidad de foro) **entities** — permite copiar texto preformateado con todo el estilo; especifica rangos de caracteres para cada estilo de formato. Puedes encontrar un ejemplo en el campo tg\_request. El parámetro debe contener un diccionario.

**business\_connection\_id -** valor utilizado al conectar un bot (Business ID, mostrado en los canales); debe pasarse si se proporciona el token del bot y el mensaje debe enviarse a través de la cuenta de usuario vinculada al bot

Ejemplo de paso de parámetros:

`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`&#x20;

En el ejemplo, solo se muestra el diccionario, mientras que el texto del mensaje en sí se define en una variable separada.

</details>

2. Métodos

\- [tg\_send\_chat\_action](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-raboty-v-chatakh-i-kanalakh-telegram#tg_send_chat_action)

\- [tg\_send\_message](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-dlya-otpravki-i-redaktirovaniya-soobshenii)

\- [tg\_send\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_quiz\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_video\_note](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_sticker](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_contact](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-kontakt-tg_send_contact)

\- [tg\_send\_venue](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-geotochku-tg_send_venue)

\- [tg\_send\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii?q=#primer-koda-dlya-kopirovaniya-6)

\- [tg\_send\_animation](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_voice](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_media\_group](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_photo](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_audio](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_dice ](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

Funcionan automáticamente con los clientes que han escrito a la cuenta de Telegram Business de la misma manera que en los bots.

{% hint style="info" %}
Para obtener más información sobre estos métodos, consulta el artículo [API de Telegram](/doc/es/chatbot/mensajeros/telegram/api.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/chatbot/mensajeros/telegram/business.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.