Ir para conteúdo principal

Webhooks

Receba avisos automáticos sobre os eventos que acontecem na sua conta do Planner.

Escrito por Joao Lucio

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

Isto respondeu à sua pergunta?