A Routal usa webhooks para avisar sua aplicação sempre que um evento acontece na sua conta. Configure webhooks para eventos que a Routal já informa, como quando o status de um plano muda, uma nova rota é criada ou seus motoristas concluem uma parada.
Um endpoint de webhook é uma URL do seu servidor que a Routal chama quando certas coisas acontecem na sua conta. Cada evento contém dados que explicam o que aconteceu.
Seu handler de webhooks escuta os eventos que você escolher e executa uma ação sempre que esses eventos chegam ao endpoint.
Dica: configure seus endpoints de webhook para receber só os tipos de eventos que sua integração precisa. Escutar eventos a mais (ou todos os eventos) sobrecarrega seu servidor sem necessidade e não é recomendado.
Onde configurar os webhooks
Acesse Configurações → Desenvolvedores → Webhooks (pelo seu avatar, na parte de baixo da barra lateral). Você também chega a Webhooks por Conectores → Desenvolvedores.
QUANDO USAR WEBHOOKS
Use webhooks para manter outros sistemas (replicação, análise ou alertas) sincronizados com o que acontece na Routal. Por exemplo:
- Atualizar as rotas no seu banco de dados quando a etapa de planejamento termina
- Obter o feedback dos pedidos (imagens, comentários, problemas)
- Registrar as rotas que seus motoristas fazem durante a jornada
