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.

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

Conectar el bot

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

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

A continuación, conectamos el bot de Telegram según las instrucciones .

Si Telegram está conectado.

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

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

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

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

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

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

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

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:

Ve a la configuración del bot:

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

¡Listo! Toda la configuración necesaria del chatbot con una cuenta empresarial se ha completado.

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:

Cómo desactivar

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:

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

Si desactivas tu cuenta empresarial, el chatbot seguirá funcionando en modo estándar.

Funciones disponibles

(API) Función en la calculadora:

tg_callback(platform_id , callback_message,group_id, tg_business)

tg_callback

Parámetros:

! platform_id - ID de cliente de Telegram

! callback_message - mensaje de devolución de llamada

group_id - ID del bot de Telegram

tg_business - para trabajar con clientes empresariales, toma el valor "1".

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)

tg_send_poll

Parámetros:

! platform_id - identificador del chat dentro de Telegram *

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

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 )

tg_send_quiz_poll

! platform_id - identificador del chat dentro de Telegram *

! 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

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)

tg_send_message_1

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 *

! text - texto del mensaje

client_message_id - ID del mensaje citado

reply_markup — configuración de botones **

parse_mode — modo de formato de texto para negrita o cursiva en la descripción del mensaje ***. 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"}]

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