Twilio

Envie notificações SMS para alertas e escalonamentos de incidentes, e configure roteamento de chamadas de voz para contatar respondentes de plantão diretamente.

Configuração

1. Vá em Configurações > Integrações > Twilio no painel do Batida.
2. Insira seu Twilio Account SID e Auth Token do Twilio Console.
3. Insira um número de telefone Twilio (comprado ou provisionado na sua conta Twilio).
4. Clique em Salvar e Verificar.

Account SID:  ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auth Token:   seu_auth_token_aqui
Telefone:     +1234567890

Custos de SMS

O Twilio cobra por segmento SMS e por minuto para chamadas de voz. Revise a página de preços do Twilio e configure regras de notificação com cuidado para controlar custos.

Notificações SMS

O Batida pode enviar mensagens SMS para os seguintes eventos:

Evento	Conteúdo do SMS
Incidente aberto	"Batida INC-{id}: {título}. Severidade: {severidade}. Responda em: {url}"
Escalonamento	"Batida INC-{id} escalado para {severidade}. Ação necessária: {url}"
Atribuição	"Batida INC-{id} atribuído a você. Ver: {url}"

Configuração

Em Configurações > Integrações > Twilio > Regras SMS:

• Ativar SMS para níveis de severidade específicos (ex.: apenas SEV1 e SEV2)
• Números de destino: adicione números para cada membro da equipe ou cargo
• Horário de silêncio: opcionalmente suprimir notificações SMS fora do horário

{
  "sms_rules": {
    "enabled_severities": ["critical", "high"],
    "recipients": ["+5511912345678", "+5511987654321"],
    "quiet_hours": {
      "start": "22:00",
      "end": "07:00",
      "timezone": "America/Sao_Paulo"
    }
  }
}

Roteamento de chamadas de voz

Para incidentes críticos, o Batida pode iniciar chamadas de voz para respondentes de plantão através do Twilio.

Configuração

1. No Twilio, garanta que seu número de telefone tenha Voice habilitado.
2. No Batida, configure regras de chamada em Configurações > Integrações > Twilio > Chamadas de Voz:
   • Ativar chamadas para: selecione níveis de severidade
   • Ordem de chamada: defina a sequência de escalonamento (primário, secundário, terciário)
   • Máximo de tentativas: número de retries antes de passar para o próximo respondente
   • Intervalo de retry: segundos entre tentativas

Fluxo de chamada

1. O Batida inicia uma chamada Twilio para o primeiro respondente na lista de escalonamento.
2. Se a chamada não é atendida em 30 segundos, o próximo respondente é chamado.
3. Se nenhum respondente atende após todas as tentativas, um SMS é enviado ao líder da equipe.

Chamadas de teste

Use os botões Enviar SMS de Teste e Iniciar Chamada de Teste na página de configurações da integração para verificar sua configuração Twilio antes de depender dela em produção.

Troubleshooting

• SMS não entregue: Verifique se o formato do número inclui o código do país (ex.: +55). Confira o console do Twilio para logs de entrega e códigos de erro.
• Chamada falha ao conectar: Garanta que o número Twilio tem capacidades de Voice. Verifique se sua conta Twilio tem crédito suficiente.
• Erros "Unauthorized": Confirme se o Account SID e Auth Token estão corretos e não foram rotacionados.