> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Envie acionamentos para um grupo, tópico ou canal do Telegram usando um bot da sua organização.

O Telegram não tem webhook de entrada. Por isso, o aciona.me envia as mensagens por meio de um **bot criado pela sua organização**. O nome e a foto que aparecem no chat são os do seu bot.

## Configurando

<Steps>
  <Step title="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…`).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Descubra o Chat ID">
    Envie qualquer mensagem no grupo e abra no navegador:

    ```text theme={null}
    https://api.telegram.org/bot<TOKEN>/getUpdates
    ```

    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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Teste o envio">
    Clique em **Testar**. Uma mensagem de teste deve aparecer no chat em poucos segundos.
  </Step>
</Steps>

<Warning>
  O token dá controle total sobre o bot. Não o compartilhe em tickets, prints ou mensagens. Se ele vazar, gere outro com `/revoke` no @BotFather e atualize a integração.
</Warning>

## 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.

A mensagem acompanha o ciclo de vida: criação, reconhecimento, atribuição, escalonamento e resolução geram mensagens correspondentes. Reconhecimento, atribuição e resolução chegam **sem som** — só a abertura e o escalonamento chamam atenção.

<Note>
  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.
</Note>

## 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

<AccordionGroup>
  <Accordion title="Use um grupo ou tópico dedicado" icon="hash">
    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.
  </Accordion>

  <Accordion title="Telegram não substitui push" icon="triangle-alert">
    Mensagem em grupo é visibilidade, não acionamento. Quem está de plantão precisa de push no celular.
  </Accordion>

  <Accordion title="Um bot por organização" icon="bot">
    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.
  </Accordion>
</AccordionGroup>

## Solução de problemas

| Sintoma | O que verificar |
| - | - |
| Token recusado no formulário | Use o token completo gerado pelo @BotFather, no formato `123456789:AA…`. |
| Chat ID recusado no formulário | Use um número (ex.: `-1001234567890`) ou `@canal_publico`. |
| O teste falha | O token está correto; o bot está no grupo ou canal; em canais, o bot é administrador com permissão de postar; o Chat ID de supergrupos e canais começa com `-100`. |
| Mensagem cai fora do tópico | Confira o **ID do tópico**. Sem ele, a mensagem vai para o tópico geral do grupo. |
| Chegava e parou | O bot foi removido do grupo, perdeu a permissão de administrador ou o token foi revogado. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.