Novas Vistorias
Descrição
Esse webhook será ativado toda vez que uma vistoria for sincronizada. Ele irá realizar uma operação GET
na url que está preenchida no campo Webhook (Novas Vistorias).
Como configurar
Acesse a tela de Integração do painel administrativo e insira a URL do Webhook no campo Webhook (Novas Vistorias).
Headers
Você também pode configurar headers para serem enviados no disparo ao Webhook. Para isso:
- Acesse a página de configurações de integração:
- Ative a checkbox “Mostrar configurações avançadas” para exibir a configuração necessária:
- Configure as chaves e valores dos headers na configuração “Webhook (Novas Vistorias): Headers para enviar no disparo do Webhook”:
- Aperte o botão "Salvar” no final da página após configurar as opções desejadas.
Pronto! Agora os headers configurados serão enviados no disparo do webhook 😃
Variáveis disponíveis para colocar no Webhook
É possível enviar pela URL de integração os seguintes parâmetros através do Query String:
| Variável | Tipo | Descrição |
|---|---|---|
{id} | int | ID númerico da vistoria |
{vistoriaId} | string | ID da vistoria |
{nomeCliente} | string | Nome do cliente |
Registro de log
Toda vez que o Webhook (Novas Vistorias) for acionado o sistema registrada um log na vistoria.
Exemplo de url
https://meu.webhook.com.br/integracao/webhook?nomeCliente={nomeCliente}&vistoriaId={vistoriaId}
Testando Url de integração
O botão Testar conexão permite que seja realizado um teste na sua URL de integração, antes de ter que atualizar o valor no botão Salvar.
Exemplo de resposta
A API do VEX espera como resposta o código de status 200 OK, isso serve para saber se a url de integração
está funcionando adequadamente.
Erro na requisição
Sucesso na requisição
Não há necessidade de corpo na resposta.
Se um corpo for retornado na resposta, esse corpo deve ser um JSON válido e deve conter o header Content-Type: application/json !
Você pode testar se o seu corpo é um JSON válido clicando aqui.
Clique no botão Salvar no final da página para salvar as alterações.