Experimente o Omnifox grátis 7 dias grátis. Sem cartão de crédito.
Guias

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

Conecte sua loja ou ERP ao Omnifox: um webhook de entrada com path_match order.paid dispara templates, tarefas e chamadas HTTP de volta.

July 11, 2026
Dispare um workflow do seu ecommerce ou ERP com um webhook de entrada
Neste artigo

    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.

    Pronto para testar no seu negócio?

    Reúna WhatsApp, Instagram, Messenger, e-mail e chamadas em uma só caixa de entrada e deixe a IA dar a primeira resposta. Configure hoje mesmo.

    7 dias grátis. Sem cartão de crédito.

    Comentários (0)

    Ainda não há comentários. Seja o primeiro a compartilhar.

    Deixe um comentário

    Seu email nunca é publicado. Os comentários são moderados antes de aparecer.

    Markdown suportado. HTML é removido.

    Leia mais

    Fale conosco no WhatsApp