Funções para enviar anexos em mensagens

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

! Funciona 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. ссылка

reply_to_message_id - ID da mensagem à qual 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 de formatação. Exemplo disponível em tg_request no campo correspondente. Precisa 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 macete.

! Essas 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. Um 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 à qual responder (ou seja, citar)

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

Exemplo de construção de um 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 de até 1024 caracteres parse_mode — formatação da descrição, ou seja, destaque de texto em negrito ou itálico ***

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

1. Primeiro, obtenha o link do 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. Por fim, 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, então 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, com tamanho de até 2 GB.

! Funciona 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 de até 1024 caracteres

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

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

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

protect_content — sinalizador para proteger o conteúdo contra cópia. Para ativá-lo, passe qualquer valor exceto 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

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 até qual ele será exibido com um estilo específico. Você pode ver um exemplo em tg_request no campo correspondente. O parâmetro 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"}] 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 macete

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

! Funciona 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 exceto 0, False ou aspas vazias ''.

reply_to_message_id - ID da mensagem à qual 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 do áudio 1", "legenda", "parse_mode"], ["Link do áudio 2"], ["Link do áudio 3", "legenda"]]'

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

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

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

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

Em seguida, envie o arquivo resultante para você 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, então certifique-se de gerar seus próprios links

Se uma mensagem falhar ao ser enviada devido às configurações de privacidade, o seguinte erro será 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” (seja de todos, ou permitindo apenas de certos usuários):

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

Na prática, apenas remover completamente o cliente do banco de dados do Mavibot ajuda a contornar esse erro, mesmo que o usuário já tenha ativado as permissões.

Solução:

Depois que o usuário alterar suas configurações de privacidade, é necessário aguardar uma pausa de 30–60 segundos (até que os servidores do mensageiro processem as alterações) e só então enviar uma solicitação de API ao Telegram via bot: https://api.telegram.org/bot<TOKEN>/getChat?chat_id=#{platform_id}

Depois disso, os dados do usuário serão atualizados e as mensagens de voz serão enviadas corretamente.

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

! Funciona com conta empresarial 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 do 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 do texto na legenda em negrito ou itálico ***. Valores possíveis: html, markdown, markdownV2

reply_to_message_id - ID da mensagem à qual 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 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 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 da mensagem em si é armazenado em uma variável

Para simplificar as descrições do conjunto de botões, você pode usar o seguinte macete

Vamos tornar a tarefa mais complexa e enviar uma animação com proteção de 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).

Por fim, monte a função:

E confira o resultado do trabalho:

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

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

! Trabalhe com conta empresarial 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 do 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 à qual 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 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 a URL via tg_request é aqui. 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 da mensagem em si é armazenado em uma variável

Para simplificar as descrições do conjunto de botões, você pode usar o seguinte macete

! Funciona com conta empresarial 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 do 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 à qual 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ídeo 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 interna do vídeo no 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 do arquivo que queremos enviar e, em seguida, preencha os parâmetros necessários da função:

Depois de conferir, obtemos o vídeo:

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

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

! Trabalhe com conta empresarial 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 do 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 à qual 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 do conjunto de botões, você pode usar o seguinte macete

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

Depois de ter o vídeo circular, 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 circular:

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

! Trabalhe com conta empresarial 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 do 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 à qual responder (ou seja, citar)

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 do conjunto de botões, você pode usar o seguinte macete

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

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

Agora, vamos prosseguir preenchendo os parâmetros da função e obtendo o resultado desejado:

! Funciona com conta empresarial do Telegram

O Telegram oferece uma maneira rápida de compartilhar contatos da sua agenda. O mensageiro oferece suporte ao 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 primeiro nome (ou nome da organização), além de 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 do Telegram para o qual a mensagem deve ser enviada *

! phone — número de telefone no 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 à qual responder (ou seja, citar)

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 do conjunto de botões, você pode usar o seguinte macete

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

Confira o resultado:

! Funciona com conta empresarial do 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 do cliente do 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 à qual responder (ou seja, citar)

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 do conjunto de botões, você pode usar o seguinte macete

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, então certifique-se de gerar seus próprios links

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

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

! foto - 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 à qual 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 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 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 Exemplo de envio 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 da mensagem em si é armazenado em uma variável

Para simplificar as descrições do conjunto de botões, você pode usar o seguinte macete

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

! Trabalhe com conta empresarial do Telegram

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

! image_list - um 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 à qual 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 image_list:

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

Exemplo de dados para uma única imagem: ["Link da imagem 1", "legenda", "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 ver 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, então certifique-se de gerar seus próprios links para o vídeo

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

! Funciona com conta empresarial do Telegram

Parâmetros:

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

emoji - o emoji a ser enviado. Se você deixou 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 — 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 à qual 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 ''

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

Para simplificar as descrições do conjunto de botões, você pode usar o seguinte macete

Lista possível de emojis: 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 usando apenas um parâmetro obrigatório:

Nesse caso, o cliente receberá um dado:

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

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

Primeiro exemplo:

Segundo exemplo:

! Funciona com conta empresarial do Telegram

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

Observação: 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 do 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 — 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. Para ativar, passe qualquer valor diferente de 0, False ou aspas vazias ''

reply_to_message_id - ID da mensagem à qual 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á exista nos servidores do Telegram (recomendado), uma URL HTTP para o Telegram buscar o arquivo na 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 enviado, 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 ver 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, então certifique-se de gerar seus próprios links para o vídeo

No Telegram (tanto para contas empresariais quanto para contas comuns), você pode enviar anexos por meio de um link:

1. Você pode enviar anexos de qualquer tamanho, contornando os limites de tamanho de arquivo.

2. Você também pode enviar qualquer tipo de anexo de que precisar.

Como fazer:

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

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

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