--- title: "Alarmes CloudWatch por ligação sem Lambda nem Twilio" description: "O SNS não liga para um telefone. Envie os alarmes do CloudWatch pelo EventBridge a um webhook de ligação: configuração, filtros e armadilhas." date: 2026-10-16 author: Nooc authorAvatarLink: /images/avatars/nooc.webp authorLink: https://nooc.me tags: - AWS - CloudWatch - EventBridge - alertas por ligação - webhooks - plantão --- # Alarmes do CloudWatch por ligação: do EventBridge ao seu telefone, sem Lambda Um alarme do CloudWatch não consegue ligar para o seu telefone. As únicas ações embutidas são SNS, Auto Scaling, EC2 e Systems Manager, e o SNS termina em e-mail, SMS ou numa fila que você precisa estar olhando. Os tutoriais que de fato fazem o telefone tocar montam uma função Lambda e uma conta Twilio. Dá para pular os dois: deixe o EventBridge receber a mudança de estado do alarme, remodelá-la num pequeno corpo JSON e enviá-la por POST a um canal de ligação do Echobell. Este guia cobre o caminho inteiro: o canal, a regra do EventBridge, o input transformer, os filtros que mantêm o toque relevante e por que apontar o SNS direto para o webhook parece que deveria funcionar e, na maioria das vezes, não funciona. ## Por que o caminho usual pelo SNS fica complicado O conselho padrão é "alarme → tópico SNS → assinante". Para uma ligação telefônica, isso tem três problemas: - **O SNS não tem protocolo de voz.** Os tipos de assinante são e-mail, SMS, push móvel, SQS, Lambda, Firehose e HTTP(S). SMS é fácil de perder e é bloqueado pelo Não Perturbe; uma chamada de voz exige algo que você mesmo monte. - **A mensagem HTTPS é uma string dentro de uma string.** O SNS entrega seu envelope com `Content-Type: text/plain`, e o alarme em si é um documento JSON serializado no campo `Message` do envelope. Um receptor de webhook que lê campos — `AlarmName`, `NewStateValue` — encontra apenas um bloco opaco. - **O envelope é grande.** Entre a assinatura, a URL do certificado de assinatura e o link de cancelamento, o envelope adiciona bem mais de um kilobyte antes de o texto do seu alarme começar. O Echobell trunca o corpo de uma notificação em 1500 bytes, então um template "despeje o corpo inteiro" corta justamente onde a parte útil começa. Dá para fazer o SNS funcionar com uma Lambda que desembrulha a mensagem e a encaminha. Mas o CloudWatch já publica toda mudança de estado de alarme no EventBridge como um evento JSON limpo — sem nenhuma ação para configurar — e o EventBridge consegue remodelá-lo e chamar um endpoint HTTPS por conta própria. ## O que você precisa - Uma conta AWS e permissão para criar regras, conexões e API destinations no EventBridge - Echobell instalado ([App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-cloudwatch-alarm-phone-call-alerts-pt&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid)) - Pelo menos um alarme do CloudWatch existente - Dez minutos Nada do seu lado precisa aceitar tráfego de entrada. Quem faz a requisição de saída é o EventBridge. ## Passo 1 — Crie um canal que toca No Echobell, crie um canal e defina o tipo de notificação como **Ligação**. Um canal de ligação se comporta como uma chamada recebida em vez de um push, então atravessa o modo Foco e o Não Perturbe do iOS. O transformer do passo 3 envia um corpo plano com os campos `alarm`, `state`, `reason`, `region` e `link`, então os templates ficam curtos: ``` Título: {{state}}: {{alarm}} Corpo: {{reason}} ``` Configure o **template de link** nas configurações avançadas para que tocar na notificação abra o alarme no console: ``` {{link}} ``` Copie a URL do webhook na tela de detalhes do canal: ``` https://hook.echobell.one/t/ ``` ## Passo 2 — Crie a connection e a API destination O EventBridge chama endpoints HTTPS externos por meio de uma **API destination**, que precisa de uma **connection** que carregue a autenticação. O Echobell autentica pelo token secreto na URL, então a connection é só formalidade — mas o EventBridge não cria uma destination sem ela. 1. Abra **EventBridge → Integration → API destinations → Connections → Create connection** 2. **Name**: `echobell` 3. **Authorization type**: **API key** 4. **API key name**: `x-source`, **Value**: `eventbridge` 5. Crie-a e depois vá em **API destinations → Create API destination** 6. **Name**: `echobell-calling` 7. **API destination endpoint**: a URL do seu canal Echobell do passo 1 8. **HTTP method**: `POST` 9. **Invocation rate limit**: `1` por segundo é mais que suficiente e funciona como válvula de segurança 10. **Connection**: `echobell` O cabeçalho da API key é enviado em toda requisição. Você pode verificá-lo numa condição de canal do Echobell se quiser uma segunda barreira antes do token: ``` header["x-source"] == "eventbridge" ``` ## Passo 3 — Crie a regra e o input transformer Vá em **EventBridge → Rules → Create rule** na mesma região dos seus alarmes. Regras são regionais: um alarme em `eu-west-1` é invisível para uma regra em `us-east-1`. Use o event bus **default** e uma regra de **event pattern**. Este padrão casa com todo alarme que passa para `ALARM`: ```json { "source": ["aws.cloudwatch"], "detail-type": ["CloudWatch Alarm State Change"], "detail": { "state": { "value": ["ALARM"] } } } ``` Como alvo, escolha **EventBridge API destination** e selecione `echobell-calling`. Deixe o console criar uma nova execution role — ela concede `events:InvokeApiDestination` para esta destination e mais nada. Depois expanda **Additional settings → Configure target input → Input transformer**: **Input path** ```json { "alarm": "$.detail.alarmName", "state": "$.detail.state.value", "reason": "$.detail.state.reason", "region": "$.region", "time": "$.time" } ``` **Template** ```json { "alarm": "", "state": "", "reason": "", "region": "", "time": "