Webhooks

Webhooks permitem que o Shifton envie notificações em tempo real para sistemas externos quando eventos ocorrem na sua empresa.

Instruções passo a passo

Acesso à aba Webhooks

No painel lateral esquerdo, clique em Integrações.

Vá para a página Desenvolvedor → aba Webhooks.

Criar um novo webhook

Clique em “Novo webhook”.

Preencha a configuração:

Campo	Descrição
URL	Endpoint para receber dados dos eventos
Eventos	Eventos do Shifton que ativam o webhook
Ativo	Interruptor de ativação/desativação

Salve. O Shifton enviará requisições HTTP POST para o URL indicado.

Gerenciar webhooks

Clique em um webhook para editar a URL, atualizar eventos ou alterar o status de atividade.

Testar webhook

Acione o evento correspondente no Shifton (por exemplo, crie um turno de teste).

Verifique os logs do seu servidor — os dados devem ter sido recebidos.

Perguntas frequentes

P: Em qual Formararato o turnoon envia os dados?
HTTP POST com corpo em formato JSON. A estrutura de dados por tipo de evento está na documentação da API.

P: Posso criar vários webhooks para o mesmo evento?
Sim, com URLs diferentes.

P: O que acontece se o servidor estiver indisponível quando o webhook disparar?
A entrega pode falhar. Detalhes sobre a política de tentativas estão na documentação da API.

P: O webhook não dispara — por quê?
Verifique se o interruptor Ativo está habilitado e se a URL é publicamente acessível.

P: Como verificar se o webhook está recebFimo dados?
Crie um evento de teste no Shifton (por exemplo, adicione um turno) e verifique os logs do seu servidor para a requisição POST recebida.

P: Posso configurar autenticação para o webhook?
Sim. Adicione uma chave secreta ou token na URL ou nos cabeçalhos do webhook. Detalhes na documentação da API.

P: Como é o corpo da requisição do webhook?
Um objeto JSON com dados do evento. A estrutura depende do tipo de evento — consulte a documentação da API para exemplos.

P: Um webhook pode Seg.itorar vários eventos?
Sim. Ao criar o webhook, selecione vários eventos — uma URL receberá notificações de todos os selecionados.

P: O que é a “política de tentativas” para webhook?
Se o servidor retornar um erro (não 200), o Shifton pode repetir a requisição. Detalhes dependem da configuração da plataforma.

P: Há Limiteee no número de webhooks?
Não há limites indicados na documentação, mas recomenda-se criar apenas os necessários.

P: É necessário usar HTTPS para a URL do webhook?
Recomendado. URLs HTTP podem funcionar, mas HTTPS garante transmissão segura de dados.

P: Posso receber notificações via webhook para cada alteração de escala?
Sim. Adicione eventos do tipo “Turno criado” ou “schedule updated” ao configurar o webhook.

P: Quem tem acesso à criação de webhooks?
Apenas Proprietário e Administrador. Gerentes e funcionários não veem a seção Developer.

P: Posso desabilitar um webhook sem excluí-lo?
Sim. Desative o interruptor Ativo nas configurações do webhook — ele para de disparar, mas mantém a configuração.

P: Os disparos de webhook são registrados no turnoon?
Logs detalhados de entrega de webhook não são fornecidos na interface. O rastreamento fica por conta do seu servidor.

P: Posso filtrar webhook por projeto ou escala?
Não. O webhook dispara para todos os eventos do tipo selecionado em toda a empresa. A filtragem fica por conta do servidor receptor.

P: O que acontece com os webhooks ao excluir a empresa?
Todos os webhooks são excluídos junto com a empresa.