Cómo trabajar con la descripción de un bot de Telegram (completa y corta)
Para configurar el mensaje de bienvenida
tg_set_bot_description(description, language_code) - descripción del bot que se muestra cuando el chat con el bot está vacío
Parámetros:
Ejemplo de configuración de un mensaje de bienvenida y menú del bot:
Después del lanzamiento (esto debe hacerse una vez usando un comando de administrador):
Ejemplo de código para copiar:
tg_set_bot_description('¡Bienvenido! Soy tu asistente virtual, Yurgram.🤖') command = [["private_office", "Cuenta personal"]] tg_set_command(command, '', 'default')
Para configurar la descripción corta de vista previa
tg_set_bot_short_description(description, language_code) - una descripción corta del bot que aparece en la página de perfil del bot y se envía junto con el enlace cuando los usuarios comparten el bot.
Parámetros:
Para obtener la descripción actual
tg_get_bot_description(language_code) - usa este método para obtener la descripción actual del bot para el idioma de usuario especificado.
Para obtener la descripción corta actual
tg_get_bot_short_description(language_code) - usa este método para obtener la descripción corta actual del bot para el idioma de usuario especificado.
Cómo configurar comandos para el bot
Para configurar comandos
tg_set_command(commands, language, scope, platform_id, user_id)
command = [["count", "devuelve el recuento de usuarios"],["unpin", "desanclar todos los mensajes"]] tg_set_command(command, '', 'all_chat_administrators')
En este ejemplo, los comandos se colocan en una variable separada. También puedes agregar estos comandos directamente en la función.
tg_set_command('[["count", "devuelve el recuento de usuarios"],["unpin", "desanclar todos los mensajes"]]', '', 'all_chat_administrators')
Para llamar a los comandos, escribe el símbolo '/' en el campo de entrada de mensajes. Si todo se configuró correctamente, verás una lista de sugerencias de comandos disponibles. Los comandos aparecerán en negrita, con sus descripciones mostradas a la derecha.
Para usar comandos, configura una reacción a los mensajes que contengan comandos.
Cómo ver los comandos del bot
tg_get_command()
Para ver comandos
tg_get_command(language, scope, platform_id, user_id)
Si no deseas usar el parámetro de idioma pero necesitas usar el parámetro scope, asegúrate de especificar primero un parámetro vacío, como en el ejemplo:
tg_get_command('', scope)
command = tg_get_command('', 'all_chat_administrators')
Asigna esta función a una variable, y la variable contendrá la respuesta del servidor con los comandos para el ámbito de usuario especificado en el parámetro.
{"ok":true,"result":[{"command":"count","description":"devuelve el recuento de usuarios"},{"command":"unpin","description":"desanclar todos los mensajes"}]}
Si la función se llama sin parámetros, el ámbito se establecerá en 'default'.
command = tg_get_command()
Cómo eliminar comandos en el bot
tg_delete_command()
Para eliminar comandos
tg_delete_command(language, scope, platform_id, user_id), donde
Si no deseas usar el parámetro de idioma pero necesitas usar el parámetro scope, asegúrate de especificar un valor vacío para el primer parámetro, como en el ejemplo:
tg_delete_command('', scope)
Un comando como tg_delete_command() eliminará comandos sin especificar el parámetro de idioma, usando el valor de ámbito predeterminado.
Puedes eliminar los comandos configurados llamando a la función con parámetros en la calculadora:
Ejemplo de código para copiar:
tg_delete_command('', 'all_chat_administrators')
Cómo configurar reacciones a comandos
Para comandos en un chat privado con el bot, debes reaccionar a mensajes como: '/command_name' – donde command_name es el comando.
Para comandos en grupos y chats, los mensajes aparecerán como: '/command_name@bot_username' – donde command_name es el comando y @bot_username es el nombre de usuario del bot.
Lista de valores de scope:
Si no deseas usar el parámetro de idioma pero necesitas usar el parámetro scope, asegúrate de especificar un valor vacío para el primer parámetro, como en el ejemplo:
tg_delete_command('', scope)