---
title: "Integração com Upptime - Alertas de monitoramento de uptime"
sidebarTitle: Upptime
description: Integre o Upptime ao Echobell para receber notificações push ou chamadas telefônicas assim que seu site sair do ar. Guia de configuração baseado em GitHub Actions.
---

import { Step, Steps } from "fumadocs-ui/components/steps";

# Integração com Upptime

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](https://upptime.js.org/docs/notifications).

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

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

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

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

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

## 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](https://upptime.js.org/docs/notifications) e os logs do GitHub Actions.