Como Receber Dados de Formulários Externos via Webhook

Nem sempre os formulários do seu site ou landing page estão hospedados dentro da Marketek. Se você utiliza formulários em plataformas externas — como WordPress, Webflow ou até HTML customizado — os webhooks de entrada permitem que esses dados cheguem à Marketek automaticamente, criando contatos e disparando automações sem nenhuma intervenção manual.

Neste tutorial, você vai aprender a configurar tudo do zero, com um exemplo prático completo.

Pré-requisitos:
– Acesso administrativo à Marketek
– Formulário externo com suporte a envio via webhook (POST HTTP)
– Conhecimento básico de campos e propriedades de contato na Marketek

Passo 1: Criar a URL de Webhook na Marketek

O primeiro passo é gerar uma URL de recebimento dentro da Marketek. Essa URL funcionará como o “endereço” para onde o formulário externo vai enviar os dados.

1. Acesse Configurações > Integrações > Webhooks
2. Clique em + Novo Webhook de Entrada
3. Preencha o campo Nome com algo descritivo (ex.: “Formulário Contato Site”)
4. A plataforma gerará automaticamente uma URL única
5. Copie essa URL — você vai precisar dela no próximo passo

Dica: Dê nomes claros aos seus webhooks. Quando você tiver vários configurados, a organização faz toda a diferença na manutenção.

Passo 2: Configurar o Formulário Externo

Agora você precisa configurar o formulário externo para enviar os dados via POST para a URL que acabou de criar.

Em um formulário WordPress (Contact Form 7 ou similar)

Instale um plugin de webhook (como “CF7 to Webhook”) e configure:
– URL de destino: cole a URL gerada pela Marketek
– Método: POST
– Formato: JSON
– Campos: mapeie os campos do formulário para os nomes esperados

Em um formulário HTML customizado

<form id="meuFormulário">
  <input type="text" name="nome" placeholder="Seu nome" />
  <input type="email" name="email" placeholder="Seu e-mail" />
  <input type="tel" name="telefone" placeholder="Seu telefone" />
  <button type="submit">Enviar</button>
</form>

No JavaScript de envio, faça um fetch para a URL do webhook:

document.getElementById('meuFormulário').addEventListener('submit', function(e) {
  e.preventDefault();
  const dados = Object.fromEntries(new FormData(this));
  fetch('SUA_URL_WEBHOOK_AQUI', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(dados)
  });
});

Passo 3: Mapear Campos para Propriedades de Contato

Com o webhook criado e o formulário configurado, você precisa garantir que os campos enviados sejam corretamente interpretados pela Marketek.

1. Na tela do webhook em Configurações > Integrações > Webhooks, clique em Editar no webhook criado
2. Acesse a aba Mapeamento de Campos
3. Para cada campo do payload JSON, selecione a propriedade correspondente no contato:
   – nome → Nome Completo
   – email → E-mail
   – telefone → Telefone
   – Campos personalizados → selecione ou crie o campo customizado correspondente
4. Salve o mapeamento

Dica: Se o payload contém campos que ainda não existem na Marketek, crie campos personalizados antes de fazer o mapeamento em Configurações > Campos Personalizados.

Passo 4: Criar Workflow com Gatilho de Webhook

Para que algo aconteça automaticamente quando o webhook receber dados, você precisa criar um workflow com o gatilho correto.

1. Acesse Automações > Workflows
2. Clique em + Criar Workflow
3. Selecione o gatilho Webhook Recebido
4. Escolha o webhook específico que você criou no Passo 1
5. Adicione as ações desejadas, por exemplo:
   – Atribuir uma tag (ex.: “Lead Site Externo”)
   – Enviar e-mail de boas-vindas
   – Criar uma oportunidade no pipeline
   – Notificar um membro da equipe
6. Ative o workflow

Sempre que o formulário externo for preenchido, o webhook receberá os dados, criará ou atualizará o contato e o workflow será disparado automaticamente.

Passo 5: Testar e Verificar os Dados

Antes de considerar a integração pronta, faça testes completos.

1. Preencha o formulário externo com dados de teste
2. Aguarde alguns segundos e acesse Contatos na Marketek
3. Busque pelo e-mail de teste e verifique se o contato foi criado
4. Confira se todos os campos foram mapeados corretamente
5. Verifique se o workflow foi disparado (acesse Automações > Histórico de Execuções)
6. Repita o teste com campos vazios ou parciais para garantir que o sistema lida bem com dados incompletos

Dica: Use um e-mail de teste diferente a cada vez para evitar que a Marketek atualize um contato existente em vez de criar um novo. Isso facilita a verificação.

Resumo rápido:
1. Crie o webhook de entrada na Marketek e copie a URL
2. Configure o formulário externo para enviar POST para essa URL
3. Mapeie os campos do JSON para propriedades do contato
4. Crie um workflow com gatilho de webhook recebido
5. Teste e valide todos os campos e automações

Artigos Relacionados:
– Guia Completo: Webhooks de Entrada e Saída na Marketek
– Webhook Não Funciona? Diagnóstico Passo a Passo