Configurando
1
Crie o bot no @BotFather
No Telegram, abra o @BotFather e envie
/newbot. Dê o nome aciona.me e um username terminado em bot. Se quiser, defina a foto do bot com /setuserpic usando o ícone oficial do aciona.me.Copie o token que o BotFather devolve (formato 123456789:AA…).2
Adicione o bot ao chat
Adicione o bot ao grupo que deve receber os acionamentos. Para um canal, adicione o bot como administrador com permissão de postar mensagens.
3
Descubra o Chat ID
Envie qualquer mensagem no grupo e abra no navegador:Procure por
"chat":{"id":-100…}. Grupos, supergrupos e canais têm ID começando com -100. Canais públicos também aceitam @nome_do_canal.Em grupos com tópicos, o mesmo resultado mostra o message_thread_id do tópico — informe-o no campo ID do tópico para que as mensagens caiam nele.4
Adicione a integração no aciona.me
Em Integrações → Telegram, informe o Token do bot, o Chat ID e, opcionalmente, o ID do tópico e um nome de exibição. Owners e admins podem fazer isso.
5
Teste o envio
Clique em Testar. Uma mensagem de teste deve aparecer no chat em poucos segundos.
Depois de salvar
Por segurança, o aciona.me nunca exibe o token de volta. O formulário mostra o Chat ID, o ID do tópico e apenas uma máscara com os últimos caracteres do token.- Para mudar nome, status, chat ou tópico, não é preciso digitar o token de novo.
- Para trocar o token, basta digitar o novo token no campo.
Um chat por time
A configuração da organização é o padrão para todos os times. Em Overrides por Time, você pode apontar um time específico para outro bot e chat (ou desabilitá-lo). Times sem override continuam usando a configuração da organização. Remover o override de um time faz com que ele volte a usar a configuração da organização, se existir.O que chega no chat
Uma mensagem no idioma da organização com:- Título em destaque e a severidade indicada por emoji: 🔴 crítico, 🟠 alto, 🟡 atenção, 🔵 baixo, ⚪ info.
- Serviço afetado, fonte do alerta, responsável atual e horário do evento, no fuso da escala acionada (com o fuso indicado; UTC quando não há escala).
- Botões Abrir acionamento, Reconhecer e Atribuir para mim, que abrem o painel autenticado.
Assim como Slack, Teams e Discord, o Telegram recebe o acionamento independentemente de haver destinatários pessoais. Mesmo que a escala não aponte ninguém, o chat vê o acionamento.
Privacidade
Grupos e canais do Telegram não têm criptografia ponta a ponta. O conteúdo do acionamento fica visível para o Telegram e para todos os membros do chat. Escolha um grupo restrito a quem precisa ver os acionamentos.Boas práticas
Use um grupo ou tópico dedicado
Use um grupo ou tópico dedicado
Um grupo (ou um tópico) só para acionamentos mantém o histórico legível e permite silenciar o restante da conversa sem perder alertas.
Telegram não substitui push
Telegram não substitui push
Mensagem em grupo é visibilidade, não acionamento. Quem está de plantão precisa de push no celular.
Um bot por organização
Um bot por organização
Crie um bot próprio para o aciona.me em vez de reaproveitar um bot com outras funções. Assim, revogar o token não afeta outras automações.