Webhook é um mecanismo que permite a comunicação instantânea entre sistemas. Com ele, você pode receber notificações automáticas sempre que algo acontecer na sua conta Zouti, como uma nova venda, um reembolso ou um carrinho abandonado.
Para que serve?
Integrar a Zouti com outras ferramentas (CRMs, automações, planilhas)
Receber alertas em tempo real sobre vendas e eventos
Automatizar processos no seu negócio
Passo 1: Acesse Integrações no menu lateral esquerdo
Passo 2: Navegue até a lista de parceiros integráveis
Passo 3: Localize e clique em Webhooks, depois em Acessar
Passo 4: Clique em Criar Webhook
Passo 5: Preencha os campos:
Nome: Um nome para identificar seu webhook (ex: "Integração com meu CRM")
URL: O endereço que vai receber as notificações
Passo 6: Clique em Selecionar eventos para escolher quais eventos deseja receber
Passo 7: Clique em Criar Webhook para finalizar
Dica: Você pode criar vários webhooks diferentes, cada um com seus próprios eventos e URL de destino.
Evento | Quando é disparado |
ORDER_CREATED | Quando um novo pedido é criado no sistema |
ORDER_UPDATED | Quando qualquer informação do pedido é atualizada |
ORDER_PAID | Quando o pagamento do pedido é confirmado |
ORDER_AWAITING_PAYMENT | Quando o pedido está aguardando o pagamento (PIX ou Boleto gerado) |
ORDER_UNPAID | Quando o pagamento não é realizado dentro do prazo |
ORDER_REFUNDED | Quando o pedido é reembolsado (total ou parcialmente) |
ORDER_DISPUTED | Quando o cliente abre uma disputa/chargeback no cartão |
ORDER_CANCELED | Quando o pedido é cancelado |
ORDER_SHIPPED | Quando o pedido é marcado como enviado |
ORDER_DELIVERED | Quando o pedido é marcado como entregue |
ORDER_TRIAL | Quando o pedido entra em período de trial/teste |
Evento | Quando é disparado |
PIX_CREATED | Quando um código PIX é gerado para pagamento |
BOLETO_CREATED | Quando um boleto é gerado para pagamento |
Observação: Esses eventos são úteis para enviar lembretes de pagamento ao cliente ou para rastrear pedidos aguardando pagamento.
Evento | Quando é disparado |
SUBSCRIPTION_CREATED | Quando uma nova assinatura é criada |
SUBSCRIPTION_ACTIVATED | Quando a assinatura é ativada (primeiro pagamento confirmado) |
SUBSCRIPTION_UPDATED | Quando qualquer informação da assinatura é atualizada |
SUBSCRIPTION_RENEWED | Quando a assinatura é renovada com sucesso |
SUBSCRIPTION_PRE_RENEWAL | Alguns dias antes da renovação (útil para avisar o cliente) |
SUBSCRIPTION_LATE_RENEWAL | Quando a renovação está atrasada (falha no pagamento) |
SUBSCRIPTION_CANCELED | Quando a assinatura é cancelada |
Evento | Quando é disparado |
ABANDONED_CART_CREATED | Quando um carrinho é detectado como abandonado |
ABANDONED_CART_UPDATED | Quando o carrinho abandonado é atualizado (cliente voltou mas não finalizou) |
PERSONAL_DATA - Cliente abandonou na etapa de dados pessoais
PAYMENT - Cliente abandonou na etapa de pagamento
AWAITING_PAYMENT - Cliente gerou PIX/Boleto mas não pagou
REFUSED - Pagamento foi recusado
Dica: Use esses eventos para criar automações de recuperação de carrinho abandonado!
Evento | Quando é disparado |
SMART_INSTALLMENT_CREATED | Quando um parcelamento inteligente é criado |
SMART_INSTALLMENT_PAID | Quando uma parcela é paga com sucesso |
SMART_INSTALLMENT_AWAITING_PAYMENT | Quando uma parcela está aguardando pagamento |
SMART_INSTALLMENT_UNPAID | Quando uma parcela não é paga no prazo |
SMART_INSTALLMENT_LATE_RENEWAL | Quando há atraso na cobrança de uma parcela |
SMART_INSTALLMENT_CANCELED | Quando o parcelamento é cancelado |
Quando você recebe um evento de pedido, as seguintes informações são enviadas:
Identificação: ID do pedido, ID da conta
Status: Situação atual do pedido
Valores: Subtotal, total, moeda
Cliente: Nome, e-mail, telefone, documento, Instagram
Produtos: Lista de itens comprados com nome, quantidade e valor
Pagamento: Método utilizado, taxas, valor líquido
Endereço: Endereço de entrega (quando aplicável)
Rastreamento: UTMs, origem do tráfego, dados do navegador
Datas: Data de criação e última atualização
Quando você recebe um evento de assinatura, as seguintes informações são enviadas:
Identificação: ID da assinatura, ID do pedido original
Status: ACTIVE, CANCELED, INCOMPLETE ou TRIAL
Plano: Nome, valor, intervalo de cobrança
Cliente: Nome, e-mail, telefone, documento
Pagamento: Método e número de parcelas
Período: Data de início do período atual
Itens: Produtos incluídos na assinatura
Rastreamento: UTMs e dados de origem
Quando você recebe um evento de carrinho abandonado:
Identificação: ID do carrinho, etapa do abandono
URL de recuperação: Link para o cliente retomar a compra
Valores: Total do carrinho, moeda
Cliente: Nome, e-mail, telefone (quando preenchidos)
Produtos: Lista de itens no carrinho
Rastreamento: UTMs e dados de origem
Quando você recebe um evento de parcelamento:
Identificação: ID do parcelamento, ID do pedido
Status: Situação da parcela
Parcela: Número atual e total de parcelas
Valores: Valor da parcela, juros, descontos
Vencimento: Data de vencimento da parcela
Cliente: Nome, e-mail, telefone, documento
Cartão: Bandeira e últimos dígitos (quando aplicável)
Produtos: Lista de produtos do parcelamento
Status | Significado |
AWAITING_PAYMENT | Aguardando pagamento (PIX ou Boleto gerado) |
PAID | Pagamento confirmado |
UNPAID | Não pago (expirou ou foi recusado) |
REFUNDED | Reembolsado |
DISPUTED | Em disputa (chargeback) |
CANCELED | Cancelado |
TRIAL | Em período de teste |
Status | Significado |
ACTIVE | Assinatura ativa e em dia |
INCOMPLETE | Aguardando primeiro pagamento |
TRIAL | Em período de teste gratuito |
CANCELED | Assinatura cancelada |
Método | Descrição |
CREDIT_CARD | Cartão de crédito |
PIX | Pagamento via PIX |
BOLETO | Boleto bancário |
Se a URL configurada não responder corretamente, a Zouti tenta reenviar automaticamente:
Tentativa | Quando |
1ª | Imediatamente |
2ª | Após ~1 minuto |
3ª | Após ~5 minutos |
4° | Após -30 minutos |
5ª | Após ~2 horas |
6ª em diante | Intervalos crescentes |
As tentativas continuam por até 4 dias. Após esse período, o envio é considerado falho.
Para testar se seu webhook está funcionando:
Acesse Integrações > Webhooks
Clique no webhook que deseja testar
Clique em Enviar teste
Selecione o tipo de evento para simular
Verifique se sua URL recebeu a notificação
Posso criar mais de um webhook?
Sim! Você pode criar quantos webhooks precisar, cada um com eventos e URLs diferentes.
Preciso receber todos os eventos?
Não. Você escolhe quais eventos são relevantes para sua integração.
O que acontece se minha URL estiver fora do ar?
A Zouti tenta reenviar automaticamente por até 4 dias com intervalos crescentes.
Posso filtrar por produto?
Sim! Ao criar o webhook, você pode selecionar para quais produtos ele deve ser disparado.
Se tiver dúvidas sobre webhooks ou precisar de suporte técnico para sua integração:
Central de Ajuda: ajuda.zouti.com.br
E-mail: suporte@zouti.com.br
Última atualização: Janeiro de 2025
