Funciones para enviar adjuntos en mensajes

! Estas funciones le permiten enviar archivos de cualquier tipo. Formatos recomendados: GIF, PDF, ZIP hasta 2 GB.

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_document(platform_id, document, caption, reply_markup, parse_mode,reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parámetros:

! platform_id — identificador del cliente en Telegram al que debe enviarse el mensaje *

! document - enlace al documento en el servidor de Telegram. Se explica cómo obtener el enlace mediante tg_request aquí.

caption - descripción, hasta 1024 caracteres

reply_markup — configuración de botones **

parse_mode — formato del texto en la descripción (negrita o cursiva) ***. Valores posibles: html, markdown, markdownV2. ссылка

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''.

disable_notification — marca para controlar las notificaciones de sonido (predeterminado: 0). 1 - enviar sin notificación, 0 - enviar con notificación

message_thread_id — identificador del hilo (disponible en supergrupos con la funcionalidad de foro) entities — le permite reutilizar texto preformateado con estilos. Simplemente defina el desplazamiento de caracteres y el rango para el formato. Ejemplo disponible en tg_request en el campo correspondiente. Debe ser un diccionario. Ejemplo de cómo pasar el parámetro: 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 este ejemplo, solo se muestra el diccionario, mientras que el texto real del mensaje se define en una variable aparte.

Para simplificar la descripción de un conjunto de botones, puede usar el siguiente truco.

! Estas funciones le permiten enviar archivos de cualquier tipo. Formatos recomendados: GIF, PDF, ZIP hasta 2 GB.

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parámetros:

! platform_id — identificador del cliente en Telegram al que debe enviarse el mensaje *

! document_list - un array de documentos. Abajo se proporciona un ejemplo de cómo construir dicho array

disable_notification — marca para controlar las notificaciones de sonido (predeterminado: 0). 1 - enviar sin notificación, 0 - enviar con notificación

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''.

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

message_thread_id — identificador del hilo (disponible en supergrupos con la funcionalidad de foro)

Ejemplo de construcción de un array document_list: '[["Enlace del documento", "caption", "parse_mode"], ["Enlace del documento 2"], ["Enlace del documento 3", "caption"]]'

Ejemplo de formato de datos para un solo documento ["Enlace del documento", "caption", "parse_mode"]

¡El orden de los parámetros es importante! Al crear un array de documentos, las comillas " " pueden omitirse.

Descripción de los parámetros del array document_list: ! Enlace del documento - enlace al documento desde el servidor de Telegram. Se explica cómo obtener el enlace mediante tg_request aquí caption — descripción de hasta 1024 caracteres parse_mode — formato de la descripción, es decir, resaltar texto en negrita o cursiva ***

Veamos un ejemplo de envío de un solo documento, añadiendo botones inline y una descripción al documento:

1. Primero, obtenga el enlace a su documento. Puede encontrar una explicación detallada de cómo hacerlo aquí.

2. Cree un bloque y establezca las variables como se muestra en la captura de pantalla:

   
3. Envíe el bloque a nosotros mismos y veamos el resultado de nuestro trabajo:

Ahora veamos el envío de varios documentos.

1. Aquí también debe obtener un enlace interno de Telegram para cada documento y formar un array. lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'

2. Por último, arme la función para enviar documentos:

3. Y compruebe el resultado del trabajo:

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

Ejemplo de código para enviar un solo documento:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excelente","callback_data":"Answer1"}, {"text": "No aceptado","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Envío de documento", opts) 

Ejemplo de código para enviar varios documentos:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Esta función permite enviar archivos de voz de tipo .OGG codificados con OPUS, de hasta 2 GB de tamaño.

¡Funciona solo con la cuenta empresarial de Telegram!

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parámetros:

! platform_id — identificador del cliente en Telegram al que debe enviarse el mensaje *

! voice - enlace al mensaje de voz en formato .OGG

caption - descripción hasta 1024 caracteres

reply_markup — configuración de botones **

parse_mode — formato del texto en la descripción en negrita o cursiva ***. Valores posibles: html, markdown, markdownV2.

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de ser copiado. Para activarla, pase cualquier valor excepto 0, False o comillas vacías ''.

disable_notification — marca para enviar un mensaje con notificación de sonido (el valor predeterminado es 0) 1 - desactivar notificación al recibir, 0 - enviar con notificación

message_thread_id — identificador del tema (disponible en supergrupos si la función de foro está habilitada). entities —con este parámetro puede simplemente copiar texto formateado con todas sus funciones y especificar desde qué carácter hasta cuál se mostrará con un estilo particular. Puede comprobar un ejemplo en tg_request en el campo correspondiente. El parámetro debe ser un diccionario. Ejemplo de paso del parámetro: 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"}] El ejemplo muestra solo un diccionario, mientras que el texto del mensaje en sí se define en una variable.

Para simplificar la descripción del conjunto de botones, puede usar lo siguiente truco

! Esta función permite enviar archivos de audio de tipo .MP3 o .M4A con un tamaño máximo de 2 GB.

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parámetros:

! platform_id — identificador del cliente en Telegram al que debe enviarse el mensaje *

! audio_list - un array de archivos de audio (detalles abajo)

disable_notification — marca para enviar el mensaje con o sin notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor excepto 0, False o comillas vacías ''.

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

message_thread_id — ID del tema (disponible en supergrupos con funcionalidad de foro)

Ejemplo de construcción del array audio_list: '[["Enlace de audio 1", "caption", "parse_mode"], ["Enlace de audio 2"], ["Enlace de audio 3", "caption"]]'

Ejemplo de un solo audio: ["Enlace de audio", "caption", "parse_mode"]

¡El orden de los parámetros es importante! Al construir el array de archivos de audio, las comillas "" pueden omitirse

Descripción de los parámetros: ! Enlace de audio - enlace a un archivo de audio en formato .OGG caption — descripción (hasta 1024 caracteres) parse_mode —formato del texto en el caption en negrita o cursiva ***

Como se indicó anteriormente, la función trabaja con archivos .OGG. Por lo tanto, la primera tarea es obtener una grabación de audio en este formato. Si tiene un .archivo MP3, puede convertirlo a .OGG usando el https://t.me/mp3toolsbot bot.

A continuación, envíe el archivo resultante a usted mismo en el bot para obtener el file_id siguiendo el algoritmo descrito aquí.

Ahora arme la función:

¡Genial! ¡Bien hecho!

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

Si un mensaje no se envía debido a la configuración de privacidad, se devuelve el siguiente error:

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

Causa del error: la configuración de privacidad del usuario contiene la opción “No recibir mensajes de voz” (ya sea de todos, o solo permitiendo de ciertos usuarios):

Incluso si el usuario desactiva esta restricción de privacidad, el error seguirá apareciendo.

De hecho, solo eliminar completamente al cliente de la base de datos de Mavibot ayuda a superar este error, aunque el usuario ya haya habilitado los permisos.

Solución:

Después de que el usuario cambie su configuración de privacidad, debe esperar una pausa de 30–60 segundos (hasta que los servidores del mensajero procesen los cambios) y solo entonces enviar una solicitud API a Telegram a través del bot: https://api.telegram.org/bot<TOKEN>/getChat?chat_id=#{platform_id}

Después de esto, los datos del usuario se actualizarán y los mensajes de voz se enviarán correctamente.

! Esta función permite enviar GIF o video H.264/MPEG-4 AVC sin sonido con un tamaño máximo de 2 GB.

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje. *

! animation- enlace a la animación. Se explica cómo obtener un enlace mediante tg_request aquí

caption - descripción de hasta 1024 caracteres

reply_markup — configuración de botones **

parse_mode —formato del texto en el caption en negrita o cursiva ***. Valores posibles: html, markdown, markdownV2

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''.

has_spoiler — habilita spoiler. Para activarlo, establezca True.

disable_notification — marca para enviar el mensaje con o sin notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro) entities — con este parámetro puede simplemente copiar texto formateado con todas sus funciones y especificar desde qué carácter hasta cuál se mostrará con un estilo particular. Puede comprobar un ejemplo en tg_request en el campo correspondiente. El parámetro debe ser un diccionario.

show_caption_above_media - si se establece en True, el caption del mensaje se mostrará encima del medio Ejemplo de paso del parámetro: 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 este ejemplo, solo se muestra el diccionario, mientras que el texto del mensaje en sí se almacena en una variable

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Hagamos la tarea más compleja y enviemos una animación con protección de copia y spoiler.

Como siempre, el proceso comienza con la obtención del enlace interno de Telegram para la animación seleccionada (detalles aquí).

Por último, arme la función:

Y compruebe el resultado del trabajo:

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

! Esta función le permite enviar archivos MPEG4 de hasta 2 GB de tamaño. (Otros formatos pueden enviarse como archivos usando tg_send_document())

¡Trabaja con cuenta de Telegram Business!

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover )

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! video - enlace al video. Cómo obtener enlaces mediante tg_request, vea aquí

caption - descripción de hasta 1024 caracteres

reply_markup — configuración de botones **

parse_mode — formato del texto en el caption en negrita o cursiva ***. Valores posibles: html, markdown, markdownV2.

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''.

has_spoiler — habilita spoiler. Para activarlo, establezca True

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro) entities — con este parámetro puede simplemente copiar texto formateado con todas sus funciones y especificar desde qué carácter hasta cuál se mostrará con un estilo particular. Puede comprobar un ejemplo en tg_request en el campo correspondiente. El parámetro debe ser un diccionario.

show_caption_above_media - si se establece en True, el texto del mensaje se mostrará encima del medio.

cover - imagen de portada del video en el mensaje. Obtener la URL mediante tg_request es aquí. Ejemplo de paso del parámetro: 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 este ejemplo, solo se muestra el diccionario, mientras que el texto del mensaje en sí se almacena en una variable

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! video_list - un array de archivos de video (detalles abajo)

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

has_spoiler — habilita el formato spoiler (opcional; establezca True para activarlo)

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Ejemplo de construcción de un array de video video_list: '[["Enlace de video1", "caption", "parse_mode"], ["Enlace de video2"], ["Enlace de video3", "caption"]]'

Ejemplo de construcción de audio único : ["Enlace de video", "caption", "parse_mode"]

¡El orden de los parámetros es importante! Al construir el array de archivos de video, las comillas "" pueden omitirse

Descripción de los parámetros: ! Enlace de video — URL interna de video de Telegram. Se describe cómo obtener el enlace mediante tg_request aquí. caption — caption de texto de hasta 1024 caracteres parse_mode — formato del texto en el caption en negrita o cursiva ***. Valores posibles: html, markdown, markdownV2.

Así que, comience por obtener el enlace al archivo que queremos enviar y luego complete los parámetros necesarios de la función:

Después de comprobarlo obtenemos el video:

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

! A partir de la versión 4.0, Telegram admite el envío de videos MPEG4 redondos con una duración de hasta un minuto.

¡Trabaja con cuenta de Telegram Business!

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! video_note - enlace al video. Cómo obtener el enlace mediante tg_request se describe aquí reply_markup — configuración de botones **

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Si tiene un video cuadrado, puede convertirlo en uno redondo usando el https://t.me/roundNoteBot bot:

Una vez que tenga el video redondo, envíelo a usted mismo en el bot para obtener el enlace (detalles aquí), y luego configure la función para enviar el video redondo:

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

¡Trabaja con cuenta de Telegram Business!

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! latitud —latitud

! longitud — longitud

! title — título

! address — dirección

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

reply_markup — configuración de botones **

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Así que, comencemos determinando las coordenadas del lugar. Puede obtenerlas usando Google Maps

A continuación, convierta las coordenadas obtenidas de grados decimales a formato geográfico usando cualquier convertidor de coordenadas:

Ahora, procedamos a completar los parámetros de la función y obtener el resultado deseado:

¡Trabaja con la cuenta empresarial de Telegram!

Telegram ofrece una forma rápida de compartir contactos de su libreta de direcciones. El mensajero admite el envío de vCard — una tarjeta de presentación electrónica

La función tg_send_contact permite enviar un número de teléfono con un nombre (o nombre de la organización), así como añadir botones y habilitar la protección del contenido del mensaje.

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - parámetro obligatorio de la función

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! phone — número de teléfono en formato internacional. Por ejemplo, para Rusia: +7XXXXXXXXXX

! nombre y apellido - nombre y apellido

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

reply_markup — configuración de botones **

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Rellene los parámetros: número de teléfono, nombre y apellido.

Vea el resultado:

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! sticker_id - ID de la pegatina. Se explica cómo obtener un enlace mediante tg_request aquí

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

reply_markup — configuración de botones **

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Enviar una pegatina no es diferente de enviar cualquier otro archivo adjunto: 1. Obtenga el enlace interno de Telegram (detalles aquí) 2. Rellene los parámetros de la función 3. Envíe el bloque a usted mismo y compruebe el resultado

Resultado:

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces

! La foto no debe superar los 10 MB. El ancho y el alto totales no deben exceder los 10.000 píxeles. La proporción ancho-alto no debe exceder 20.

¡Trabaja con la cuenta empresarial de Telegram!

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! foto - enlace a la imagen. Se explica cómo obtener un enlace mediante tg_request aquí.

caption - descripción de hasta 1024 caracteres

reply_markup — configuración de botones **

parse_mode — formato del texto en el caption en negrita o cursiva ***

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

has_spoiler — habilita el formato spoiler, establezca True para activarlo

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro) entities — con este parámetro puede simplemente copiar texto formateado con todas sus funciones y especificar desde qué carácter hasta cuál se mostrará con un estilo particular. Puede comprobar un ejemplo en tg_request en el campo correspondiente. El parámetro debe ser un diccionario.

show_caption_above_media - si se establece en True, el texto del mensaje se mostrará encima del medio Ejemplo de envío del parámetro: 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 este ejemplo, solo se muestra el diccionario, mientras que el texto del mensaje en sí se almacena en una variable

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

! La foto no debe superar los 10 MB. El ancho y el alto totales no deben exceder los 10.000 píxeles. La proporción ancho-alto no debe exceder 20.

¡Trabaja con cuenta de Telegram Business!

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

! image_list - array de archivos de imagen (detalles abajo)

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

protect_content — marca para proteger el contenido de la copia (parámetro opcional, para activarlo pase 1 como valor)

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

has_spoiler — habilita el formato spoiler (opcional; establezca True para activarlo)

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Ejemplo de image_list:

'[["Enlace de imagen 1", "caption", "parse_mode"], ["Enlace de imagen 2"], ["Enlace de imagen 3", "caption"]]'

Ejemplo de datos para una sola imagen: ["Enlace de imagen 1", "caption", "parse_mode"]

¡El orden de los parámetros es importante! Al construir el array de archivos de imagen, las comillas "" pueden omitirse

Descripción de los parámetros:

! Enlace de imagen 1 - enlace de imagen. Se explica cómo obtener el enlace mediante tg_request aquí

caption — caption de hasta 1024 caracteres

parse_mode — formato del texto en el caption en negrita o cursiva ***

Veamos un ejemplo de función para enviar varias imágenes:

primero, cree un array de imágenes

A continuación, complete los parámetros de la función

Envíe el bloque a usted mismo y disfrute del resultado

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces para video

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

¡Trabaja con la cuenta empresarial de Telegram!

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje *

emoji - el emoji que se enviará. Si dejó el parámetro vacío, se enviará un dado por defecto. Puede pasar el emoji en sí como cadena o la palabra clave utilizada para representarlo

reply_markup — configuración de botones **

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

reply_to_message_id -ID del mensaje al que responder (es decir, citar)

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro)

Para simplificar las descripciones del conjunto de botones, puede usar lo siguiente truco

Lista posible de emojis: 1) 'darts' o '🎯', valores de 1 a 6 2) 'dice' o '🎲', valores de 1 a 6 3) 'bowling' o '🎳', valores de 1 a 6 4) 'basketball' o '🏀',valores de 1 a 5 5) 'football' o '⚽', valores de 1 a 5 6) 'slots' o '🎰', valores de 1 a 64

Además, si un cliente envía uno de estos emojis al bot, recibirá una devolución de llamada con información sobre la puntuación y qué emoji se utilizó.

La opción más simple es llamar a la función con solo un parámetro obligatorio:

En este caso, el cliente recibirá un dado:

Si el cliente lanza el dado (haciendo clic en el emoji recibido), el bot recibirá una devolución de llamada con el número de puntos obtenidos:

Puede experimentar con esta función. Por ejemplo, creemos una máquina tragamonedas y añadamos un Puntos botón. Cuando se pulse el botón, recibiremos el total de puntos del cliente:

Primer ejemplo:

Segundo ejemplo:

¡Trabaja con la cuenta empresarial de Telegram!

Un método para enviar un grupo de fotos, videos, documentos o archivos de audio como un álbum. Si tiene éxito, se devuelve un array de los archivos enviados.

Nota: ¡los documentos y archivos de audio no pueden agruparse con otros tipos de archivo!

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parámetros:

! platform_id — ID del cliente de Telegram al que debe enviarse el mensaje

! media_list - un array que contiene de 2 a 10 fotos, videos, documentos o archivos de audio (detalles abajo);

disable_notification — marca para enviar el mensaje con una notificación de sonido (predeterminado: 0). 1 — enviar sin notificación, 0 — enviar con notificación

protect_content — marca para proteger el contenido de la copia. Para activarla, pase cualquier valor distinto de 0, False o comillas vacías ''

reply_to_message_id - ID del mensaje al que responder (es decir, citar)

message_thread_id — ID del hilo (disponible en supergrupos con funcionalidad de foro);

Contenido de los elementos del array media_list:

! type - tipo de archivo, “photo”, “video”, “audio” o ”document”

! media - archivo a enviar. Pase un file_id para enviar un archivo que ya existe en los servidores de Telegram (recomendado), una URL HTTP para que Telegram obtenga el archivo de Internet o «attach://<file_attach_name>» para subir un nuevo archivo usando multipart/form-data con el nombre <file_attach_name>.

Leer más: https://core.telegram.org/bots/api#sending-files

caption — título del archivo enviado, 0–1024 caracteres.

parse_mode — formato del texto en el caption en negrita o cursiva

Leer más: https://core.telegram.org/bots/api#sending-files

Ejemplo de array media_list:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "ghosts video"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “hare video”}]

Veamos un ejemplo de función para enviar varias imágenes:

primero, cree un array de imágenes

A continuación, complete los parámetros de la función

Envíe el bloque a usted mismo y disfrute del resultado

Recuerde que los enlaces son únicos para cada bot, así que asegúrese de generar sus propios enlaces para video

En Telegram (tanto para cuentas empresariales como cuentas normales), puede enviar archivos adjuntos mediante un enlace:

1. Puede enviar archivos adjuntos de cualquier tamaño, evitando los límites de tamaño de archivo.

2. También puede enviar cualquier tipo de archivo adjunto que necesite.

Cómo hacerlo:

Copie el enlace de un archivo adjunto que ya esté accesible públicamente:

Luego, pegue el enlace copiado en la función de archivo adjunto en su bloque:

Listo. De esta manera, puede enviar archivos adjuntos de cualquier tipo y tamaño.