Dispare um workflow do seu ecommerce ou ERP com um webhook de entrada

Seu ecommerce ja sabe quando alguem paga, seu ERP sabe quando um pedido muda. A pergunta e: como transformar esse evento em uma mensagem de WhatsApp, uma tarefa para a equipe ou uma atualizacao de contato sem construir uma integracao inteira. A resposta e o gatilho Webhook de entrada dos workflows do Omnifox. Voce entrega uma URL ao seu sistema externo, cada evento chega como JSON, e voce decide o que fazer com ele. Neste guia montamos passo a passo.

O gatilho: Webhook de entrada

Todo workflow comeca com um unico gatilho. Aqui escolhemos Webhook de entrada. O Omnifox te da uma URL unica; voce cola na sua loja (Shopify, WooCommerce, seu ERP proprio) como destino dos webhooks. Toda vez que esse sistema dispara um evento, seu workflow roda.

A chave e o filtro path_match: uma expressao que decide se o payload interessa, por exemplo event.type == "order.paid". Assim um mesmo endpoint recebe varios tipos de evento e cada workflow reage so ao seu (pagamento confirmado, pedido enviado, reembolso, etc.).

Passo 1: ler o payload

O corpo do webhook fica disponivel como {{$webhook.payload}}. Voce navega pelos campos (email do cliente, total, numero do pedido) e insere em nos posteriores. Um bom primeiro no e Definir variavel para extrair os dados que vai reutilizar varias vezes (como o numero do pedido) e dar um nome curto e legivel.

Se o evento traz telefone ou email do cliente, adicione Buscar conversa anterior para reusar o thread existente em vez de abrir um novo. Assim o cliente recebe a notificacao na mesma conversa onde ja fala com voce.

Passo 2: ramificar por tipo de evento

Se o seu path_match ja filtrou fino, talvez nao precise ramificar. Mas se deixa passar varios eventos, um no Switch (varias ramas) permite abrir uma rama por tipo: pagamento, envio, cancelamento. Voce tambem pode usar Se (uma regra) para casos binarios, tipo "se o valor passa de X, trate como pedido VIP".

O esqueleto fica:

1. Webhook de entrada com path_match: event.type == "order.paid" (gatilho)
2. Definir variavel (numero do pedido, total)
3. Buscar conversa anterior (reusar o thread do cliente)
4. Switch (por tipo de evento, se aplicavel)

Passo 3: notificar o cliente com um template

Como o disparo vem de um sistema externo e nao de uma mensagem do cliente, e muito provavel que voce esteja fora da janela de 24 horas do WhatsApp. Por isso o no certo e Enviar template de WhatsApp. Escolha um template aprovado tipo "Seu pagamento foi confirmado" e injete as variaveis do payload: numero do pedido, valor, data estimada de entrega, {{$contact.first_name}}.

Se o cliente esta em um canal sem janela (email, por exemplo), use Enviar email ao cliente no lugar.

Passo 4: criar trabalho interno

Um pagamento confirmado quase sempre gera trabalho. Adicione Criar tarefa de acompanhamento para um agente preparar o envio, ou Criar cartao a partir da conversa para levar o pedido a um quadro de fulfillment. Voce pode encadear Atualizar contato para marcar o cliente como comprador ou subir a etapa de lifecycle.

Passo 5: responder ao sistema externo

As vezes voce precisa confirmar algo de volta ao ERP: marcar o pedido como "notificado", pedir a etiqueta de envio, sincronizar estoque. Para isso existe o no Requisicao HTTP, que chama qualquer API externa com o metodo, cabecalhos e corpo que voce definir, usando as variaveis extraidas. Envolva num Try/Catch para que um erro da API externa nao derrube o workflow inteiro.

Fluxo completo de exemplo

Webhook de entrada (order.paid) -> Definir variavel -> Buscar conversa anterior -> Enviar template de WhatsApp -> Criar tarefa de acompanhamento -> Requisicao HTTP (marcar como notificado) dentro de Try/Catch

Erros comuns

• path_match aberto demais. Se nao filtra, o workflow dispara a cada evento e manda mensagens a mais. Seja especifico: event.type == "order.paid".
• Supor que ha janela de WhatsApp. O webhook nao vem do cliente; use Enviar template de WhatsApp, nao Enviar mensagem.
• Nao envolver a Requisicao HTTP em Try/Catch. Uma API externa fora do ar nao deveria quebrar a notificacao ao cliente.
• Esquecer variaveis desconhecidas. Se um campo do payload nao existe, vira string vazia; confira os nomes exatos.

Variantes

• Jogar cada pedido no Google Sheets (adicionar linha) para um log simples que o financeiro consegue auditar.
• Usar Criar oportunidade (deal) se o pagamento abre um ciclo de venda maior, e depois Atribuir dono do deal para um vendedor cuidar do upsell.
• Combinar com o gatilho Agendado (cron) em outro workflow para reprocessar notificacoes que falharam durante a noite.
• Adicionar Adicionar etiqueta no contato (por exemplo cliente-pago) para que workflows e segmentos posteriores saibam que essa pessoa ja comprou.

Um webhook de entrada transforma o Omnifox no cerebro de notificacoes da sua operacao: seu ecommerce dispara, o Omnifox traduz esse evento em mensagens, tarefas e chamadas de volta. Copie a URL, cole no seu sistema e comece a automatizar hoje.