Echobell
App Store Google Play

Integração com Upptime - Alertas de monitoramento de uptime

Integre o Upptime ao Echobell e receba notificações push ou chamadas telefônicas quando seu site sair do ar. Configuração baseada em GitHub Actions.

Você pode encaminhar os eventos de queda e recuperação do Upptime diretamente para o Echobell, para que seu time receba alertas push urgentes ou chamadas telefônicas sem precisar montar um pipeline separado. Este guia foca na configuração do lado do Echobell e usa as variáveis de notificação nativas do Upptime. Para opções específicas do Upptime, consulte a documentação oficial de notificações.

Por que usar o Echobell para alertas do Upptime

  • Escalonamento para chamada telefônica em quedas críticas, mantendo as verificações de rotina como push padrão ou urgente
  • Modelos e variáveis para que cada alerta mostre o site afetado, o status, o código de resposta e o link da issue no GitHub
  • Sem infraestrutura extra—basta uma URL de webhook segura por canal do Echobell

Pré-requisitos

  • Um repositório Upptime já existente com GitHub Actions habilitado
  • Permissão para adicionar secrets no repositório do GitHub
  • Um canal do Echobell com uma URL de webhook (no app, abra o canal → copie a URL do webhook)

Prepare um canal do Echobell

  1. Crie ou abra um canal no Echobell e escolha o estilo de notificação que preferir (padrão, urgente ou chamada).
  2. Copie a URL de webhook do canal; ela se parece com https://hook.echobell.one/t/<channel-token>.
  3. (Opcional) Defina um modelo que use variáveis como {{site}}, {{status}}, {{code}}, {{url}} e {{issue}} para que seus alertas fiquem estruturados.

Adicione os secrets do Upptime para o Echobell

No seu repositório Upptime, vá em Settings → Secrets and variables → Actions e adicione:

  • NOTIFICATION_CUSTOM_WEBHOOK=true
  • NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
  • (Opcional) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
  • (Opcional) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Observações:

  • Os parâmetros de consulta levam dados estruturados até o Echobell. O Upptime substitui as variáveis e o Echobell as armazena como variáveis de modelo (site, status, url, issue, code, emoji).
  • Mantenha a URL codificada (substitua espaços por %20 se você personalizar o texto) para não quebrar a requisição.
  • Outros provedores ou estratégias de notificação continuam sendo gerenciados no Upptime—adicione apenas o que precisar para o Echobell e mantenha o restante na interface de secrets do GitHub.

Mapeie as variáveis no Echobell

Use um modelo conciso para que os alertas continuem legíveis:

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Você pode mudar o estilo de notificação do canal para "Urgente" ou "Chamada" nos sites de alta prioridade, mantendo os demais como push padrão.

Teste a integração

  • Aponte temporariamente uma URL monitorada para um endpoint inexistente ou pause um serviço para provocar uma falha.
  • Confirme que o alerta chega no Echobell com os campos do seu modelo preenchidos.
  • Restaure o serviço e verifique a mensagem de recuperação.

Solução de problemas

  • Verifique se NOTIFICATION_CUSTOM_WEBHOOK e NOTIFICATION_CUSTOM_WEBHOOK_URL estão escritos exatamente como na lista de secrets.
  • Se você alterar o token do canal do Echobell, atualize o secret.
  • Para falhas do lado do Upptime ou provedores adicionais, consulte a documentação oficial e os logs do GitHub Actions.