Chatbot para una cuenta de Telegram Business

Ahora puedes crear asistentes comerciales 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:

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

Característica clave: control sin interrupciones

Un usuario puede cambiar instantáneamente a la comunicación manual en cualquier momento sin interrumpir ni deshabilitar el funcionamiento del bot, lo que garantiza 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 reinicia 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 las 24 horas: La ventana se cierra. El bot no podrá enviar más mensajes hasta que el usuario envíe un nuevo mensaje para reiniciar el contacto.

Conexión del bot

Paso 1. Configuración en la sección Mensajería.

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

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

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

Si Telegram ya está conectado.

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

Luego, 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 HECHO para actualizar la configuración de tu bot de Telegram (no necesitas cambiar más configuraciones):

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

Paso 2. Configuración del mensajero.

Para conectar el chatbot de Telegram a tu cuenta de negocio, 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, ingresa el enlace al bot de Telegram requerido o su nombre de usuario (se prefiere ingresar el enlace).

En la misma pestaña, establece el permiso (casilla "Responder a mensajes") para que el chatbot responda a los mensajes.

En esta etapa, la configuración del chatbot en la cuenta de negocio está completa. Continúa.

Paso 3. Configuración de BotFather.

Después de vincular el chatbot a la cuenta de negocio, 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 de negocio:

Ve a la configuración del bot:

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

¡Listo! Se han completado todos los ajustes necesarios del chatbot con una cuenta de negocio.

Ahora, en la configuración del canal, encontrarás el bot de Telegram y verás el ID de negocio, así como el nombre del propietario de la cuenta de negocio:

Cómo deshabilitar

Para deshabilitar el chatbot con modo de negocio, ve a los canales y busca 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 "Deshabilitar cuenta de negocio".

Si deshabilitas tu cuenta de negocio, el chatbot continuará funcionando en modo estándar.

Funciones disponibles

(API) Función en calculadora:

tg_callback(platform_id , callback_message,group_id, tg_business)

Parámetros:

! platform_id - ID del cliente de Telegram

! callback_message - mensaje de callback

group_id - ID del bot de Telegram

tg_business - para trabajar con clientes de negocio, 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)

Parámetros:

! platform_id - identificador del chat dentro de Telegram *

! question - pregunta

! options - array de opciones de respuesta

is_anonymous - 1 - encuesta anónima, '' - no anónima

allows_multiple_answers - 1 - respuestas múltiples permitidas, '' - solo respuesta única

reply_markup - teclado, o '' - sin teclado

disable_notification — indicador para enviar con notificación sonora (por defecto 0); 1 - enviar silenciosamente, 0 - enviar con notificación

protect_content - 1 - proteger contra copia 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 (ID de negocio, mostrado en 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 )

! platform_id - identificador del chat dentro de Telegram *

! question - pregunta

! options - array de opciones de respuesta

! explanation - texto que se muestra cuando el usuario selecciona una respuesta incorrecta o toca el ícono de la bombilla en una encuesta 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 '' sin formato.

protect_content - 1 proteger contra copia y capturas de pantalla, '' - sin protección.

disable_notification — indicador para enviar con notificación sonora (por defecto 0); 1 - enviar silenciosamente, 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, en segundos.

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)

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 se muestra una vista previa del enlace; establecer en 1 para deshabilitar, de lo contrario 0 o dejar vacío ("")

protect_content — indicador para proteger el contenido contra copia; para habilitar, pasa cualquier valor distinto de 0, False o comillas vacías ('')

disable_notification — indicador para enviar con notificación sonora (por defecto 0); 1 - enviar silenciosamente, 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.

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 se define en una variable separada.