Os webhooks fazem a Martz avisar automaticamente outro sistema (um CRM, uma automação como N8N ou Zapier, um sistema próprio) sempre que um evento acontece na sua loja, como um cliente novo, uma resposta de pesquisa ou o uso de um bônus.
Onde fica
No menu, abra Configurações e, em Desenvolvedor, clique em Webhooks. A lista mostra cada webhook com o nome, a URL, o status (Habilitado ou Desabilitado) e a Chave de validação. Use Pesquisar por nome ou URL para encontrar um webhook.
Como criar um webhook
Passo 01 — Abra o cadastro
Na tela Webhooks, clique em criar novo webhook. Abre a janela Criar novo webhook.
Passo 02 — Preencha os dados
Nome: para identificar o webhook. Ex.: Integração N8N.
Webhook ativado?: deixe ligado para começar a receber os avisos.
URL de notificação: o endereço do seu sistema que vai receber os avisos.
Passo 03 — Escolha os eventos
Em Eventos, marque o que deve gerar aviso. Marcar a categoria seleciona todos os eventos dela. É preciso escolher pelo menos um evento.
Clientes: Cadastro, Atualização e Remoção de cliente ou lead.
Pop-ups: Assinatura (o visitante se cadastrou em um pop-up).
Pesquisas: Nova resposta.
Bônus: Utilização e Cancelamento.
Mensagens de conversa: Nova mensagem e Atualização de status (mensagens do WhatsApp API Oficial).
Passo 04 — Salve e teste
Salve o webhook. Para testar, você pode cadastrar temporariamente uma URL de um serviço de testes de webhook, provocar o evento (por exemplo, editar um cliente de teste) e conferir o aviso que chega.
Como os avisos são enviados
Cada aviso informa o evento, a data e hora e os dados do registro (cliente, resposta, bônus ou mensagem).
O seu sistema precisa confirmar o recebimento em até 10 segundos. Se não confirmar, a Martz tenta enviar de novo algumas vezes, com intervalos.
Cada aviso traz uma assinatura de segurança gerada com a Chave de validação do webhook. O seu time técnico pode usá-la para confirmar que o aviso veio mesmo da Martz. As instruções técnicas estão na documentação da API.
Editar, desativar ou remover
Na lista, use Editar para mudar URL, eventos ou desligar o webhook em Webhook ativado?, e Remover para excluí-lo. A remoção pede confirmação.
Dúvidas comuns
Os avisos de cliente trazem as tags do cliente?
Os eventos de cliente trazem os dados de cadastro do cliente. Se o seu caso depende de informações específicas, como tags ou a origem de um anúncio, consulte a documentação ou fale com o suporte antes de montar a integração.
Quero enviar dados para a Martz, não receber.
Use a API. Veja Chaves de Acesso e documentação da API.
Dá para chamar um webhook só em um ponto da jornada?
Sim, nos Fluxos há a ação de webhook de saída. Veja Ações de integração: Chamar IA e Webhook de saída.