Configurando seu primeiro escalonamento

Escalonamentos (on-call schedules) garantem que a pessoa certa seja notificada quando um incidente ocorre. Este guia acompanha você na criação do seu primeiro escalonamento na Batida.

O Que É um Escalonamento?

Um escalonamento define quem está de plantão e quando. Ele é a base da atribuição de incidentes -- quando um incidente é criado, a Batida consulta os escalonamentos ativos para determinar qual responsável deve ser notificado.

Cada escalonamento pertence a uma equipe e opera em um fuso horário específico.

Criando um Escalonamento

1. Navegue até Schedules na barra lateral.

2. Clique em New Schedule.

3. Preencha os campos obrigatórios:

   Name:     Backend On-Call
   Team:     Platform
   Timezone: America/Sao_Paulo

4. Clique em Create para salvar o escalonamento.

Neste ponto, o escalonamento existe mas não tem nenhuma rotação atribuída. Você precisa adicionar pelo menos uma rotação para que o escalonamento fique ativo.

Adicionando uma Rotação

Uma rotação é um ciclo repetitivo que determina quais membros da equipe assumem os turnos de plantão.

1. Abra seu escalonamento e clique em Add Rotation.

2. Configure a rotação:

   Rotation Name:  Weekly Primary
   Period:         Weekly (every 7 days)
   Start Time:     09:00
   Handoff Day:    Monday

3. Selecione os membros que participarão desta rotação. Arraste para reordenar -- a primeira pessoa na lista assume o primeiro turno.

4. Clique em Save Rotation.

TIP

Se sua equipe tem múltiplas camadas de plantão (ex.: primário e secundário), crie rotações separadas dentro do mesmo escalonamento. Quando um incidente é atribuído, o plantão primário é notificado primeiro, e o secundário é notificado se o primário não reconhecer dentro do timeout de escalação.

Períodos de Rotação

A Batida suporta vários períodos de rotação:

Período	Descrição	Ideal Para
Diário	Troca de turno a cada 24 horas	Equipes com cobertura follow-the-sun
Semanal	Troca de turno a cada 7 dias	Equipes pequenas com um plantão por semana
Personalizado	Defina qualquer número de dias	Equipes com padrões de rotação não padronizados
Mensal	Troca de turno em um dia específico de cada mês	Equipes com ciclos de rotação mensais

Tratamento de Fuso Horário

Cada escalonamento usa um único fuso horário. Quando você define uma rotação para começar às 09:00 em America/Sao_Paulo, isso significa 09:00 BRT independentemente de onde o responsável de plantão esteja localizado.

Se sua equipe abrange múltiplos fusos horários, escolha o fuso do serviço coberto, não dos indivíduos. Isso mantém o escalonamento consistente e evita confusão durante transições de horário de verão.

INFO

Os membros da equipe veem seus turnos designados no fuso horário local no calendário pessoal, mas o escalonamento em si sempre referencia o fuso configurado.

Substituições e Trocas

Escalonamentos de plantão devem ser previsíveis, mas imprevistos acontecem. A Batida suporta:

• Substituições temporárias -- um admin ou o membro de plantão pode definir uma pessoa específica para cobrir um período (ex.: cobertura de férias).
• Pedidos de troca -- um responder pode solicitar a troca de um turno com outro membro da equipe. Ambas as partes devem confirmar antes que a troca tenha efeito.

Para criar uma substituição, abra o escalonamento, clique na data e selecione Add Override.

Testando Seu Escalonamento

Após configurar seu escalonamento, verifique se ele funciona corretamente:

1. Ative Mock Incidents em Settings > Organization.
2. Crie um incidente de teste e confirme se ele é atribuído ao responsável de plantão correto.
3. Verifique se as notificações são entregues pelos canais esperados (Slack, email, push).

WARNING

Sempre teste com mock incidents ativados. Criar incidentes reais para fins de teste acionará notificações reais e pode causar alertas desnecessários.

Próximos Passos

• Conecte seu escalonamento a uma política de escalação para que incidentes não reconhecidos sejam reatribuídos automaticamente.
• Configure a integração com Slack para ver mudanças de plantão no canal da sua equipe.