Telegram¶

Integre seu código com o Telegram para enviar mensagens, arquivos e muito mais.

Instalação¶

PythonJava

pip install botcity-telegram-plugin

Configurando o token da API¶

Precisamos criar um Telegram Bot e gerar um token para que seu código possa interagir com a API do Telegram.

Criando um BotTelegram:¶

Abra um bate-papo com @BotFather no seu Telegram. Ele estará na lista de seus usuários.
Envie o comando /start.
Envie o comando /newbot.
O BotFather pedirá um nome e um nome de usuário para o seu bot.

Seu bot está pronto e seu token aparecerá na conversa com @BotFather.

Iniciar o bot¶

Agora, será necessário iniciar seu bot clicando no link que @BotFather disponibiliza ao lado do seu token. Ele o direcionará para uma conversa com seu bot, então basta clicar no botão start.

Configurações de privacidade do grupo¶

Usando o bate-papo com @BotFather, será necessário desligar as configurações de privacidade do grupo usando o seguinte:

Envie o comando /mybots.
Escolha o bot que você acabou de criar.
Clique em bot settings.
Clique em Group Privacy.
Clique em turn off privacidade do grupo.

Adicionando um bot a um grupo¶

Com o seu Telegram Bot criado e seu token em mãoes, adicione seu bot ao grupo com o qual deseja interagir e comece a usar o plugin.

Importante

Sugerimos que após iniciar seu primeiro bot e incluí-lo em um grupo, que você envie uma mensagem manual para o bot para que as atualizações identifiquem o grupo criado. A API do Telegram tem um bug onde, em alguns casos, as atualizações só reconhecem o grupo a partir de uma mensagem iniciada manualmente. Se você receber o erro Bad Request: chat not found ao tentar enviar uma mensagem, lembre-se de iniciar uma interação manual com o grupo ao qual foi adicionado.

Importando o Plugin¶

Depois de instalar este pacote, a próxima etapa é importar o pacote para o seu código e começar a usar as funções.

Python

from botcity.plugins.telegram import BotTelegramPlugin

Enviar mensagem¶

PythonJava

from botcity.plugins.telegram import BotTelegramPlugin

# Instancie o plugin
telegram = BotTelegramPlugin(token='<seu_token_bot_telegram>')

# Enviar mensagem
resposta = telegram.send_message(
    text="Esta é uma mensagem de teste automatizada.",
    group="botGrouptest",
    username=["@testbotcitybot"]
)

Aqui está a saída esperada:

Editando uma mensagem¶

PythonJava

from botcity.plugins.telegram import BotTelegramPlugin

# Instancie o plugin
telegram = BotTelegramPlugin(token='<seu_token_bot_telegram>')

# Enviar mensagem
resposta = telegram.send_message(
    text="Esta é uma mensagem de teste automatizada.",
    group="BotGrouptest"
)

# Editar mensagem
telegram.edit_message(
    text="Esta é uma mensagem editada",
    response=resposta,
    username=["@testbotcitybot"]
)

Aqui está a saída esperada:

Carregando um Documento¶

PythonJava

from botcity.plugins.telegram import BotTelegramPlugin

# Instancie o plugin
telegram = BotTelegramPlugin(token='<seu_token_bot_telegram>')


# Carregar documento
resposta = telegram.upload_document(
    document='test_document.zip',
    group="botGrouptest",
    caption="Este é um upload de documento"
)

Aqui está a saída esperada:

Excluindo uma Mensagem/Arquivo¶

PythonJava

from botcity.plugins.telegram import BotTelegramPlugin

# Instancie o plugin
telegram = BotTelegramPlugin(token='<seu_token_bot_telegram>')

# Enviar mensagem
resposta = telegram.send_message(
    text="Esta é uma mensagem de teste automatizada",
    group="BotGrouptest"
)

# Apagar mensagem
delete = telegram.delete_message(resposta=resposta)

# Carregar documento
resposta = telegram.upload_document(
    document='test_document.zip',
    group="botGrouptest",
    caption="Este é um upload de documento"
)

# Exclua upload
delete = telegram.delete_message(response=resposta)