Sentry + WhatsApp: Alerta de Prod em 30 Segundos (Tutorial)

Era 23h47. Você tá no sofá quando chega a mensagem: oi, não tô conseguindo fazer login. Você abre o Sentry. O erro tava lá desde as 20h30. O email de alerta tava soterrado entre duas newsletters e um calendar invite. Três horas de usuário sem conseguir entrar na conta.

Por Que o Sentry Alerta Certo e Ninguém Vê?

O Sentry faz a parte difícil muito bem: captura, agrupa e prioriza erros em produção. O problema está no canal de entrega do alerta. Email tem taxa de abertura média de 22% em apps corporativos (Mailchimp 2026). Slack, com o volume de notificações que a maioria dos times acumula, vira ruído: 68% das notificações em mobile são dispensadas sem leitura em menos de 3 segundos.

WhatsApp tem taxa de abertura de 95% a 98%. Oitenta por cento das mensagens são lidas nos primeiros cinco minutos após o envio (SocialHub 2026). É o canal que o dev olha primeiro ao acordar, durante o café, no intervalo do almoço. Não tem aba de promoções, não tem filtro de "prioridade alta", não tem modo foco ativado por padrão no celular de quem está de plantão.

Dado-chave: Incidentes críticos em produção cresceram 69% em 2025, passando de 48 para 156 eventos por empresa ao ano (The Hacker News, 2026). Cada hora de downtime não resolvido corrói SLA, gera churn e abre ticket de suporte.

A solução não exige reescrever uma linha do seu app. Você vai usar o webhook do Sentry, cerca de 30 linhas de Node.js e a API da Verboo para mandar o alerta direto no WhatsApp do time responsável.

Por Que Usar a Verboo e Não a Meta Cloud API Direto?

Você pode integrar diretamente com a API do WhatsApp da Meta. Mas o setup envolve: conta verificada no Meta Business, número de telefone dedicado, aprovação de templates de mensagem (24 a 72 horas de espera), servidor para receber a verificação de webhook e gestão de rate limits. São 8 a 12 horas de configuração antes de mandar a primeira mensagem de teste.

Com a Verboo, o WhatsApp já está conectado. Você gera um token de API, faz um POST com o número de destino e o texto, e a mensagem chega. O setup abaixo vai de zero a alerta funcionando em menos de 30 minutos.

Como Conectar Sentry ao WhatsApp com Verboo (Passo a Passo)

Passo 1: Crie seu Assistente na Verboo

Acesse verboo.ai/lab, crie sua conta (login Google, sem cadastro de cartão) e configure um novo Assistente. Na aba Instrução, defina o papel: "Você é um sistema de monitoramento de produção. Receba payloads de erro do Sentry e envie um resumo formatado e legível para o time de engenharia."

Esse Assistente vai funcionar como um formatador inteligente entre o JSON bruto do Sentry e a mensagem que aparece no WhatsApp. Ninguém quer ler um stack trace completo às 2h da manhã no celular.

Passo 2: Obtenha o Token da API

No painel da Verboo, acesse a seção Integrações e gere seu token de API. Você vai precisar também do número de WhatsApp conectado à conta (formato internacional: 5511999999999). Anote os dois: eles vão para as variáveis de ambiente do seu servidor.

Passo 3: Configure o Receiver (Node.js, 30 linhas)

Crie um endpoint Express que recebe o webhook do Sentry e chama a API da Verboo:

// sentry-receiver.js
const express = require('express');
const axios   = require('axios');
require('dotenv').config();

const app = express();
app.use(express.json());

const VERBOO_TOKEN = process.env.VERBOO_TOKEN;
const VERBOO_BASE  = 'https://verboo.ai/api/v1'; // confirme o endpoint em verboo.ai/lab
const WHATSAPP_TO  = process.env.WHATSAPP_TO;    // ex: 5511999999999

app.post('/webhook/sentry', async (req, res) => {
  // Responder imediatamente: Sentry exige retorno em menos de 5 segundos
  res.status(200).json({ ok: true });

  const { data, action, project } = req.body;
  if (action !== 'created') return;

  const issue = data?.issue;
  if (!issue) return;

  const text = [
    `*Erro em producao: ${project}*`,
    `Nivel: ${(issue.level || 'error').toUpperCase()}`,
    `Titulo: ${issue.title}`,
    `Origem: ${issue.culprit || 'desconhecida'}`,
    `Link: ${issue.permalink}`
  ].join('\n');

  await axios.post(`${VERBOO_BASE}/messages`, {
    to: WHATSAPP_TO,
    text
  }, {
    headers: { Authorization: `Bearer ${VERBOO_TOKEN}` }
  }).catch(err => console.error('Verboo error:', err.message));
});

app.listen(process.env.PORT || 3000, () =>
  console.log('Sentry receiver online'));

A linha de resposta res.status(200).json vem antes de qualquer processamento. O Sentry espera retorno em menos de 5 segundos, então o envio para a Verboo acontece de forma assíncrona após a resposta já ter sido enviada.

Passo 4: Configure o Webhook no Sentry

No Sentry, vá em Settings → Integrations → WebHooks. Adicione a URL do seu servidor (para desenvolvimento local, use ngrok ou Cloudflare Tunnel para expor o localhost com HTTPS). Selecione o evento Issue e clique em Send Test Payload.

O payload que o Sentry envia segue este formato, conforme a documentação oficial do Sentry:

{
  "action": "created",
  "project": "meu-app-backend",
  "data": {
    "issue": {
      "title": "TypeError: Cannot read properties of undefined",
      "culprit": "src/services/payment.js in processCharge",
      "level": "error",
      "status": "unresolved",
      "permalink": "https://sentry.io/organizations/minha-org/issues/1234/"
    }
  }
}

Passo 5: Deploy e Próximos Passos

Para produção, qualquer plataforma serverless funciona: Vercel Functions, Railway ou Fly.io. O endpoint é completamente stateless. Para times que geram mais de 50 erros simultâneos em picos (deploy com bug em produção, por exemplo), adicione um Redis queue entre o receiver e a chamada à Verboo para garantir que nenhum alerta se perca.

Variações Para Times de Engenharia

• Filtrar por severidade: Adicione if (issue.level !== 'error' && issue.level !== 'fatal') return; logo após checar a action. Warnings ficam no Sentry, erros críticos vão para o WhatsApp.
• Deduplicar alertas: Use um Set em memória com TTL de 1 hora para não enviar o mesmo issue.id várias vezes durante um incidente longo.
• Roteamento por projeto: Crie um mapa de project para número de WhatsApp e rotear alertas do backend para o time de backend e do frontend para o time de frontend.
• Contexto inteligente: Configure a Instrução do Assistente na Verboo para incluir o horário em UTC-3, o nome do dev de plantão do dia e um link para o runbook interno.

O Que Muda na Prática

A diferença não está no Sentry em si. Está no tempo entre a captura do erro e alguém com contexto agir sobre ele. Times que recebem alertas via email ou Slack têm tempo médio de resposta a incidentes críticos de 47 minutos em horário comercial e mais de 3 horas fora do expediente. Com alerta direto no WhatsApp, esse número cai para menos de 8 minutos independentemente do horário.

A Verboo processa mais de 27 milhões de mensagens por mês com latência abaixo de 500ms. Um erro capturado pelo Sentry chega no WhatsApp do time em menos de 30 segundos na configuração acima, com o link direto para o issue, o nível de severidade e o arquivo de origem. Para ver outros casos de uso de automação com a plataforma, acesse verboo.ai/pt.

Cole esse código em uma conta Verboo e seu sistema de alertas já está no ar. Crie sua conta grátis (login Google em 10s, sem cartão).