Webhooks: conectar o sistema que não está na lista de integrações
Toda plataforma tem uma lista de integrações prontas. E toda empresa tem pelo menos um sistema que não está nela — o ERP que o contador instalou, a…
Toda plataforma tem uma lista de integrações prontas. E toda empresa tem pelo menos um sistema que não está nela — o ERP que o contador instalou, a plataforma de curso do nicho, o sistema que alguém mandou fazer em 2019 e que funciona bem demais para ser trocado.
Webhook é como esses sistemas conversam com a IAZIS sem existir integração pronta. E há dois sentidos, que resolvem problemas diferentes.
Sentido 1 — algo aconteceu lá fora, faça alguma coisa aqui
É o mais comum. A venda foi aprovada no seu sistema, e você quer que a IAZIS mande a mensagem de boas-vindas.
Funciona assim: a IAZIS te dá um endereço próprio. Você cadastra esse endereço no seu sistema, no lugar onde ele pergunta para onde aviso quando algo acontecer. Pronto.
O que faz ele funcionar com quase tudo
Aqui está o detalhe que decide se um webhook é útil ou uma fonte de dor de cabeça.
Cada sistema manda os dados de um jeito. Um manda o telefone dentro de um bloco de cliente; outro manda solto; outro chama de celular; um manda formulário em vez de dados estruturados; e sistema antigo às vezes manda texto cru.
A IAZIS aceita os três formatos e procura o telefone e o nome onde eles estiverem. Ela desmonta a estrutura aninhada e localiza os campos por conta própria.
⚠️ Na prática isso significa que você não precisa de um programador para traduzir o formato. Cadastra o endereço e testa — na maioria dos casos, já funciona.
E se o seu sistema for daqueles que não manda o telefone no corpo, dá para passá-lo no próprio endereço. É a saída para os casos difíceis, e ela existe justamente porque esses casos aparecem.
Sentido 2 — no meio da conversa, pergunte lá fora
Este é o menos conhecido e o que muda mais coisa.
Dentro de um fluxo do FluxMind existe um bloco de webhook: ele chama uma API externa e guarda a resposta numa variável que os blocos seguintes usam.
O que isso permite:
- o cliente manda o número do pedido, o fluxo consulta o seu sistema e responde o status real
- alguém pergunta se tem em estoque, o fluxo pergunta ao ERP e responde
- o fluxo confere no seu cadastro se aquele CPF já é cliente antes de decidir o caminho
⚠️ É a diferença entre um menu e um atendimento. Um menu devolve as mesmas opções para todo mundo. Um fluxo que consulta o seu sistema devolve o dado daquela pessoa — e é isso que faz o cliente parar de pedir para falar com alguém.
Como testar sem virar noite
Webhook falha em silêncio, e é por isso que assusta. Um roteiro que evita:
1. Confirme que chegou. A tela de integrações mostra os eventos recebidos. Dispare um evento de teste no seu sistema e veja se ele aparece. Se não apareceu, o problema é do lado de lá — endereço errado, ou o sistema não disparou.
2. Confira se o telefone foi encontrado. É o campo que importa. Se o evento chegou mas sem telefone, é aí que está o trabalho: ou o sistema não manda, ou manda com um nome de campo incomum — e é o caso de passar o telefone no endereço.
3. Só então ligue a ação. Primeiro receber, depois reagir. Quem liga a ação antes de confirmar o recebimento fica depurando duas coisas ao mesmo tempo.
Quando webhook não é a resposta
Duas situações em que existe caminho melhor:
Quando já existe integração pronta. Plataformas de venda como Eduzz, Hotmart, Kiwify e PerfectPay já têm integração própria na IAZIS, com os eventos mapeados. Webhook cru só dá mais trabalho.
Quando você quer disparar a partir de um fluxo externo de automação. Se a sua operação usa uma ferramenta de automação para orquestrar tudo, há um caminho específico para ela — com autenticação por chave, mais simples que webhook cru.
(Os dois casos têm artigos próprios.)
O ganho real
Webhook não é um recurso que se demonstra bem numa apresentação. Ele é o que faz a IAZIS caber na operação que você já tem, em vez de obrigar a operação a se mudar para caber na IAZIS.
E é a diferença entre "não integra com o nosso sistema" e "integra, leva uma tarde".
Tem um sistema que precisa conversar com a IAZIS? Fale com a gente.