Ver categorias

Webhooks

1 minutos de leitura

Neste artigo

Atualizado em 18/09/2026

O que você vai aprender #

O que é um webhook (em linguagem simples), o que é um evento de webhook, e como configurá-lo. A parte de configuração é técnica, mas o conceito é para todos.

Em palavras simples #

Pense num webhook como um “me avise quando acontecer”. Em vez de o seu outro sistema ficar perguntando toda hora ao GTI-Plug “já chegou? já saiu?”, o GTI-Plug avisa sozinho o seu sistema no instante em que algo acontece.

🔔 Analogia: é como pedir para a portaria te ligar quando a encomenda chegar, em vez de você descer no hall de dez em dez minutos para conferir.

Na prática, quando o evento acontece (ex.: uma expedição foi confirmada), o GTI-Plug manda um aviso para um endereço na internet (uma URL) que o seu sistema disponibiliza — levando junto os dados do que aconteceu.

O que é um “evento de webhook” #

O evento é o que faz o aviso disparar. Você escolhe quais acontecimentos merecem um aviso:

  • Evento de Etapa: dispara quando uma etapa muda (ex.: uma etapa de recebimento ou de expedição avança/conclui).
  • Evento de Operação: dispara quando a operação como um todo acontece.

Assim você recebe avisos só do que interessa, sem ruído.

API × Webhook #

  • API: você pergunta ao WMS quando quer (sob demanda).
  • Webhook: o WMS avisa você assim que o evento ocorre (o WMS faz uma chamada HTTP para a URL que você configurou).

Como configurar #

No menu Integração:

  1. Em Configuração Webhook, cadastre a URL que vai receber os avisos (o endpoint do seu sistema).
  2. Em Configuração de Eventos Webhook, escolha quais eventos disparam o aviso:
  3. Evento de Etapa (ex.: mudança de etapa de recebimento/expedição)
  4. Evento de Operação
  5. Salve. A partir daí, quando o evento ocorrer, o GTI-Plug envia o webhook com os dados do evento (JSON).

Acompanhamento #

Os envios ficam registrados nos Logs do Webhook (e nos Logs de Integração). Use-os para conferir entregas e diagnosticar falhas (ex.: sua URL fora do ar).

💡 Sua URL deve responder rápido e retornar sucesso (HTTP 2xx). Se ela falhar, o evento fica registrado no log para você tratar.

Boas práticas #

  • Valide a origem do webhook antes de confiar no dado.
  • Responda rápido e processe em segundo plano se necessário.
  • Monitore os logs para não perder eventos por indisponibilidade.

Artigos Relacionados #

Não resolveu sua dúvida?

Nossa equipe de suporte ajuda você.

Falar com o suporte

Quais são seus sentimentos
Rolar para cima