Funções para envio de anexos em mensagens

! Estas funções permitem enviar arquivos de qualquer tipo. Formatos recomendados: GIF, PDF, ZIP até 2GB.

! Trabalho com conta empresarial do 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 do cliente no Telegram para o qual a mensagem deve ser enviada *

! document - link para o documento no servidor do Telegram. Obter o link via tg_request é explicado aqui.

caption - descrição, até 1024 caracteres

reply_markup — configurações dos botões **

parse_mode — formatação de texto na legenda (negrito ou itálico) ***. Valores possíveis: html, markdown, markdownV2. link

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

disable_notification — sinalizador para controlar notificações sonoras (padrão: 0).
1 - enviar sem notificação, 0 - enviar com notificação

message_thread_id — identificador do tópico (disponível em supergrupos com funcionalidade de fórum)

entities — permite reutilizar texto pré-formatado com estilos. Basta definir o deslocamento do caractere e o intervalo para formatação. Exemplo disponível em tg_request no campo correspondente. Deve ser um dicionário.

Exemplo de passagem do 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"}]

Neste exemplo, apenas o dicionário é mostrado, enquanto o texto real da mensagem é definido em uma variável separada.

Para simplificar a descrição de um conjunto de botões, você pode usar o seguinte lifehack.

! Estas funções permitem enviar arquivos de qualquer tipo. Formatos recomendados: GIF, PDF, ZIP até 2GB.

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

Parâmetros:

! platform_id — identificador do cliente no Telegram para o qual a mensagem deve ser enviada *

! document_list - um array de documentos. Exemplo de como construir esse array é fornecido abaixo

disable_notification — sinalizador para controlar notificações sonoras (padrão: 0).
1 - enviar sem notificação, 0 - enviar com notificação

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

message_thread_id — identificador do tópico (disponível em supergrupos com funcionalidade de fórum)

Exemplo de construção do array document_list:
'[["Link do documento", "legenda", "parse_mode"], ["Link do documento 2"], ["Link do documento 3", "legenda"]]'

Exemplo de formatação de dados para um único documento
["Link do documento", "legenda", "parse_mode"]

A ordem dos parâmetros é importante! Ao criar um array de documentos, as aspas " " podem ser omitidas.

Descrição dos parâmetros para o array document_list:
! Link do documento - link do documento do servidor do Telegram. Obter o link via tg_request é explicado aqui
caption — descrição até 1024 caracteres
parse_mode — formatação da descrição, ou seja, destacar texto em negrito ou itálico ***

Vamos percorrer um exemplo de envio de um único documento, adicionando botões inline e uma descrição ao documento:

1. Primeiro, obtenha o link para o seu documento. Uma explicação detalhada de como fazer isso pode ser encontrada aqui.

2. Crie um bloco e defina as variáveis conforme mostrado na captura de tela:
   

   

3. Envie o bloco para nós mesmos e veja o resultado do nosso trabalho:

Agora vamos ver o envio de vários documentos.

1. Aqui também, você precisa obter um link interno do Telegram para cada documento e formar um array.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Documento1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Documento2"]]'
2. Finalmente, monte a função para enviar documentos:

3. E confira o resultado do trabalho:

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

Exemplo de código para enviar um único documento:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excelente","callback_data":"Answer1"}, {"text": "Não aceito","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Envio de documento", opts) 

Exemplo de código para enviar vários documentos:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Documento1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Documento2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Esta função permite enviar arquivos de voz do tipo .OGG codificados com OPUS, até 2 GB de tamanho.

! Trabalho apenas com conta empresarial do 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 do cliente no Telegram para o qual a mensagem deve ser enviada *

! voice - link para a mensagem de voz no formato .OGG

caption - descrição até 1024 caracteres

reply_markup — configurações dos botões **

parse_mode — formatação de texto na descrição negrito ou itálico ***. Valores possíveis: html, markdown, markdownV2.

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

disable_notification — sinalizador para enviar uma mensagem com ou sem notificação sonora (padrão: 0) 1 - desabilitar notificação ao receber, 0 - enviar com notificação

message_thread_id — identificador do tópico (disponível em supergrupos se o recurso de fórum estiver ativado).

entities — com este parâmetro, você pode simplesmente copiar texto formatado com todos os seus recursos e especificar de qual caractere a qual caractere ele será exibido com um estilo específico. Você pode verificar um exemplo em tg_request no campo correspondente. O parâmetro deve ser um dicionário.

Exemplo de passagem de 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"}]

O exemplo mostra apenas um dicionário, enquanto o texto da mensagem em si é definido em uma variável.

Para simplificar a descrição do conjunto de botões, você pode usar o seguinte lifehack

! Esta função permite enviar arquivos de áudio do tipo .MP3 ou .M4A com tamanho máximo de 2GB.

! Trabalho com conta empresarial do 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 do cliente no Telegram para o qual a mensagem deve ser enviada *

! audio_list - um array de arquivos de áudio (detalhes abaixo)

disable_notification — sinalizador para enviar a mensagem com ou sem notificação sonora (padrão: 0). 1 — enviar sem notificação, 0 — enviar com notificação

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Exemplo de construção do array audio_list:
'[["Link de áudio 1", "legenda", "parse_mode"], ["Link de áudio 2"], ["Link de áudio 3", "legenda"]]'

Exemplo de um único áudio:
["Link de áudio", "legenda", "parse_mode"]

A ordem dos parâmetros é importante! Ao construir o array de arquivos de áudio, as aspas "" podem ser omitidas

Descrição dos parâmetros:
! Link de áudio - link para um arquivo de áudio no formato .OGG
caption — descrição (até 1024 caracteres)
parse_mode — formatação de texto na legenda negrito ou itálico ***

Conforme mencionado acima, a função funciona com arquivos .OGG. Portanto, a primeira tarefa é obter uma gravação de áudio neste formato.
Se você tiver um arquivo .MP3, pode convertê-lo para .OGG usando o bot https://t.me/mp3toolsbot.

Em seguida, envie o arquivo resultante para si mesmo no bot para obter o file_id seguindo o algoritmo descrito aqui.

Agora monte a função:

Ótimo! Muito bem!

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

Se uma mensagem falhar ao enviar devido às configurações de privacidade, o seguinte erro é retornado:

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

Causa do erro: as configurações de privacidade do usuário contêm a opção "Não receber mensagens de voz" (de todos ou permitindo apenas de certos usuários):

Mesmo que o usuário desative essa restrição de privacidade, o erro continuará aparecendo.

! Esta função permite enviar GIF ou vídeo H.264/MPEG-4 AVC sem som com tamanho máximo de 2GB.

! Trabalho com conta business do 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 do cliente Telegram para o qual a mensagem deve ser enviada. *

!** animation**- link para a animação. Como obter um link via tg_request é explicado aqui

caption - descrição de até 1024 caracteres

reply_markup — configuração dos botões **

parse_mode — formatação de texto na legenda em negrito ou itálico *****. Valores possíveis: html, markdown, markdownV2

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

has_spoiler — ativa o spoiler. Para ativar, defina True.

disable_notification — sinalizador para enviar a mensagem com ou sem notificação sonora (padrão: 0). 1 — enviar sem notificação, 0 — enviar com notificação

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)


entities — com este parâmetro você pode simplesmente copiar texto formatado com todos os seus recursos e especificar de qual caractere até qual ele será exibido com um estilo específico. Você pode verificar um exemplo em tg_request no campo correspondente. O parâmetro deve ser um dicionário.

show_caption_above_media - se definido como True, a legenda da mensagem será exibida acima da mídia


Exemplo de passagem de 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"}]


Neste exemplo, apenas o dicionário é mostrado, enquanto o texto da mensagem em si é armazenado em uma variável

Para simplificar as descrições de conjuntos de botões, você pode usar o seguinte lifehack

Vamos tornar a tarefa mais complexa e enviar uma animação com proteção contra cópia e spoiler.

Como sempre, o processo começa com a obtenção do link interno do Telegram para a animação selecionada (detalhes aqui).

Finalmente, monte a função:

E confira o resultado do trabalho:

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Feliz Ano Novo!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

! Esta função permite enviar arquivos MPEG4 de até 2GB de tamanho.
(Outros formatos podem ser enviados como arquivos usando tg_send_document())

! Trabalho com conta business do Telegram

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 do cliente Telegram para o qual a mensagem deve ser enviada *

!** video** - link do vídeo. Como obter links via tg_request veja aqui

caption - descrição de até 1024 caracteres

reply_markup — configurações dos botões **

parse_mode — formatação de texto na legenda em negrito ou itálico *****. Valores possíveis: html, markdown, markdownV2.

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''.

has_spoiler — ativa o spoiler. Para ativar, defina True

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)


entities — com este parâmetro você pode simplesmente copiar texto formatado com todos os seus recursos e especificar de qual caractere até qual ele será exibido com um estilo específico. Você pode verificar um exemplo em tg_request no campo correspondente. O parâmetro deve ser um dicionário.

show_caption_above_media - se definido como True, o texto da mensagem será exibido acima da mídia.

cover - imagem de capa do vídeo na mensagem. Obter URL via tg_request está aqui.


Exemplo de passagem de 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"}]


Neste exemplo, apenas o dicionário é mostrado, enquanto o texto da mensagem em si é armazenado em uma variável

Para simplificar as descrições de conjuntos de botões, você pode usar o seguinte lifehack

! Trabalho com conta business do 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 do cliente Telegram para o qual a mensagem deve ser enviada *

!** video_list** - um array de arquivos de vídeo (detalhes abaixo)

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

has_spoiler — ativa a formatação de spoiler (opcional; defina como True para ativar)

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Exemplo de construção de um array de vídeos video_list:
'[["Link do vídeo1", "legenda", "parse_mode"], ["Link do vídeo2"], ["Link do vídeo3", "legenda"]]'

Exemplo de construção de um único áudio:
["Link do vídeo", "legenda", "parse_mode"]

A ordem dos parâmetros é importante! Ao construir o array de arquivos de vídeo, as aspas "" podem ser omitidas

Descrição dos parâmetros: \ !** Link do vídeo** — URL interno do vídeo do Telegram. Obter o link via tg_request é descrito aqui.
caption — legenda de texto de até 1024 caracteres
parse_mode — formatação de texto na legenda em negrito ou itálico *****. Valores possíveis: html, markdown, markdownV2.

Então, comece obtendo o link para o arquivo que deseja enviar e, em seguida, preencha os parâmetros necessários da função:

Após verificar, obtemos o vídeo:

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

! A partir da versão 4.0, o Telegram suporta o envio de vídeos MPEG4 redondos com duração de até um minuto.

! Trabalho com conta business do Telegram

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 do cliente Telegram para o qual a mensagem deve ser enviada *

!** video_note** - link do vídeo. Como obter o link via tg_request é descrito aqui
reply_markup — configurações dos botões **

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Para simplificar as descrições de conjuntos de botões, você pode usar o seguinte lifehack

Se você tiver um vídeo quadrado, pode convertê-lo em um vídeo redondo usando o bot https://t.me/roundNoteBot:

Depois de obter o vídeo redondo, envie-o para si mesmo no bot para obter o link (detalhes aqui), e então configure a função para enviar o vídeo redondo:

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

! Trabalho com conta business do Telegram

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 do cliente Telegram para o qual a mensagem deve ser enviada *

! latitude — latitude

! longitude — longitude

! title — título

! address — endereço

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

reply_to_message_id - ID da mensagem a ser respondida (ou seja, citação)

reply_markup — configurações dos botões **

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Para simplificar as descrições dos conjuntos de botões, você pode usar o seguinte lifehack

Então, vamos começar determinando as coordenadas do local. Você pode obtê-las usando o Google Maps

Em seguida, converta as coordenadas obtidas de graus decimais para formato geográfico usando qualquer conversor de coordenadas online:

Agora, vamos preencher os parâmetros da função e obter o resultado desejado:

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 

! Trabalhe com conta Telegram business

O Telegram fornece uma maneira rápida de compartilhar contatos da sua agenda de endereços. O mensageiro suporta o envio de vCard — um cartão de visita eletrônico

A função tg_send_contact permite enviar um número de telefone com um nome (ou nome da organização), bem como adicionar botões e ativar a proteção de conteúdo para a mensagem.

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 obrigatório da função

Parâmetros:

! platform_id — ID do cliente Telegram para o qual a mensagem deve ser enviada *

! phone — número de telefone em formato internacional. Por exemplo, para a Rússia: +7XXXXXXXXXX

! first_name e last_name - nome e sobrenome

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

reply_to_message_id - ID da mensagem a ser respondida (ou seja, citação)

reply_markup — configurações dos botões **

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Para simplificar as descrições dos conjuntos de botões, você pode usar o seguinte lifehack

Preencha os parâmetros: número de telefone, nome e sobrenome.

Confira o resultado:

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 

! Trabalhe com conta Telegram business

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 do cliente Telegram para o qual a mensagem deve ser enviada *

! sticker_id - ID do sticker. Como obter um link via tg_request é explicado aqui

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

reply_to_message_id - ID da mensagem a ser respondida (ou seja, citação)

reply_markup — configurações dos botões **

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Para simplificar as descrições dos conjuntos de botões, você pode usar o seguinte lifehack

Enviar um sticker não é diferente de enviar qualquer outro anexo:\

1. Obtenha o link interno do Telegram (detalhes aqui) \
2. Preencha os parâmetros da função\
3. Envie o bloco para si mesmo e verifique o resultado

Resultado:

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! A foto não deve ter mais de 10 MB. A largura e altura totais não devem exceder 10.000 pixels. A proporção largura-altura não deve exceder 20.

! Trabalhe com conta Telegram business

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 do cliente Telegram para o qual a mensagem deve ser enviada *

! photo - link para a imagem. Como obter um link via tg_request é explicado aqui.

caption - descrição de até 1024 caracteres

reply_markup — configurações dos botões **

parse_mode — formatação de texto na legenda em negrito ou itálico ***

reply_to_message_id - ID da mensagem a ser respondida (ou seja, citação)

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

has_spoiler — ativa a formatação de spoiler, defina como True para ativar

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

entities — com este parâmetro, você pode simplesmente copiar texto formatado com todos os seus recursos e especificar de qual caractere a qual ele será exibido com um estilo específico. Você pode verificar um exemplo em tg_request no campo correspondente. O parâmetro deve ser um dicionário.

show_caption_above_media - se definido como True, o texto da mensagem será exibido acima da mídia

Exemplo de envio de 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"}]

Neste exemplo, apenas o dicionário é mostrado, enquanto o texto da mensagem em si é armazenado em uma variável

Para simplificar as descrições dos conjuntos de botões, você pode usar o seguinte lifehack

! A foto não deve ter mais de 10 MB. A largura e altura totais não devem exceder 10.000 pixels. A proporção largura-altura não deve exceder 20.

! Trabalhe com conta 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 do cliente Telegram para o qual a mensagem deve ser enviada *

! image_list - array de arquivos de imagem (detalhes abaixo)

disable_notification — sinalizador para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

protect_content — sinalizador para proteger o conteúdo contra cópia (parâmetro opcional, para ativar passe 1 como valor)

reply_to_message_id - ID da mensagem a ser respondida (ou seja, citação)

has_spoiler — ativa a formatação de spoiler (opcional; defina como True para ativar)

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Exemplo de image_list:

'[["Link da imagem 1", "caption", "parse_mode"], ["Link da imagem 2"], ["Link da imagem 3", "caption"]]'

Exemplo de dados para uma única imagem:
["Link da imagem 1", "caption", "parse_mode"]

A ordem dos parâmetros é importante! Ao construir o array de arquivos de imagem, as aspas "" podem ser omitidas

Descrição dos parâmetros:

! Link da imagem 1 - link da imagem. Como obter o link via tg_request é explicado aqui

caption — legenda de até 1024 caracteres

parse_mode — formatação de texto na legenda em negrito ou itálico ***

Vamos analisar um exemplo de função para enviar várias imagens:

primeiro, crie um array de imagens

Em seguida, preencha os parâmetros da função

Envie o bloco para si mesmo e aproveite o resultado

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links para vídeo

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

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

! Funciona com conta Telegram Business

Parâmetros:

! platform_id — ID do cliente Telegram para o qual a mensagem deve ser enviada *

emoji - o emoji a ser enviado. Se você deixar o parâmetro vazio, um dado será enviado por padrão. Você pode passar o próprio emoji como string ou a palavra-chave usada para representá-lo

reply_markup — configuração dos botões **

disable_notification — flag para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

protect_content — flag para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum)

Para simplificar as descrições dos conjuntos de botões, você pode usar o seguinte lifehack

Lista de emojis possíveis: \

1. 'darts' ou '🎯', valores de 1 a 6 \
2. 'dice' ou '🎲', valores de 1 a 6 \
3. 'bowling' ou '🎳', valores de 1 a 6 \
4. 'basketball' ou '🏀', valores de 1 a 5 \
5. 'football' ou '⚽', valores de 1 a 5 \
6. 'slots' ou '🎰', valores de 1 a 64

Além disso, se um cliente enviar um desses emojis para o bot, você receberá um callback contendo informações sobre a pontuação e qual emoji foi usado.

A opção mais simples é chamar a função com apenas um parâmetro obrigatório:

Neste caso, o cliente receberá um dado:

Se o cliente rolar o dado (clicando no emoji recebido), o bot receberá um callback com o número de pontos rolados:

Você pode experimentar com esta função. Por exemplo, vamos criar uma máquina caça-níqueis e adicionar um botão Pontos. Quando o botão for pressionado, receberemos os pontos totais do cliente:

Primeiro exemplo:

soob=tg_send_dice(platform_id)

Segundo exemplo:

/* Primeiro exemplo */
tg_send_message(platform_id,'Clique na máquina caça-níqueis para testar sua sorte!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* Segundo bloco - Mensagem de texto */
 #{res[1]} pontos rolados
/* Segundo bloco - Calculadora */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Terceiro bloco - Mensagem de texto */
Você tem um total de #{balls} pontos

! Funciona com conta Telegram Business

Um método para enviar um grupo de fotos, vídeos, documentos ou arquivos de áudio como um álbum. Em caso de sucesso, um array dos arquivos enviados é retornado.

Nota: documentos e arquivos de áudio não podem ser agrupados com outros tipos de arquivo!

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

Parâmetros:

! platform_id — ID do cliente Telegram para o qual a mensagem deve ser enviada

! media_list - um array contendo de 2 a 10 fotos, vídeos, documentos ou arquivos de áudio (detalhes abaixo);

disable_notification — flag para enviar a mensagem com notificação sonora (padrão: 0).
1 — enviar sem notificação, 0 — enviar com notificação

protect_content — flag para proteger o conteúdo contra cópia. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

reply_to_message_id - ID da mensagem para responder (ou seja, citar)

message_thread_id — ID do tópico (disponível em supergrupos com funcionalidade de fórum);

Conteúdo dos elementos do array media_list:

! type - tipo de arquivo, “photo”, “video”, “audio” ou ”document”

! media - arquivo a ser enviado. Passe um file_id para enviar um arquivo que já existe nos servidores do Telegram (recomendado), uma URL HTTP para o Telegram buscar o arquivo da Internet ou «attach://<file_attach_name>», para enviar um novo arquivo usando multipart/form-data com o nome <file_attach_name>.

Leia mais: https://core.telegram.org/bots/api#sending-files

caption — título do arquivo de envio, 0–1024 caracteres.

parse_mode — formatação de texto na legenda em negrito ou itálico

Leia mais: https://core.telegram.org/bots/api#sending-files

Exemplo de array media_list:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "vídeo de fantasmas"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “vídeo de lebre”}]

Vamos analisar um exemplo de função para enviar várias imagens:

primeiro, crie um array de imagens

Em seguida, preencha os parâmetros da função

Envie o bloco para si mesmo e aproveite o resultado

Lembre-se de que os links são únicos para cada bot, portanto, certifique-se de gerar seus próprios links para vídeo

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

No Telegram (tanto para contas business quanto para contas comuns), você pode enviar anexos via link:

1. Você pode enviar anexos de qualquer tamanho, ignorando os limites de tamanho de arquivo.
2. Você também pode enviar qualquer tipo de anexo que precisar.

Como fazer:

Copie o link para um anexo que já esteja publicamente acessível:

Em seguida, cole o link copiado na função de anexo no seu bloco:

Pronto. Desta forma, você pode enviar anexos de qualquer tipo e tamanho.