Se você usa Klaviyo pra automação de marketing/e-commerce e quer que eventos do Klaviyo criem leads automaticamente na LigueLead (pra depois disparar SMS, ligação ou entrar num flow), você faz essa ponte via webhook.

Este artigo cobre os DOIS cenários do lado LigueLead:

1. Cenário A — Você ainda NÃO tem a integração Klaviyo ativa (é o primeiro cliente da conta a mexer nisso)

2. Cenário B — A integração já está ativa e você quer criar um webhook adicional (novo evento pra escutar)

A configuração dentro do Klaviyo (onde você cola a URL gerada) segue o padrão de webhooks da própria plataforma Klaviyo.

Antes de começar

• Acesso ao painel do Klaviyo (você vai colar a URL lá depois)

• Definir qual evento do Klaviyo você quer que crie lead na LigueLead (ex: novo lead capturado por popup, primeira visita etc)

Cenário A — Primeira vez: ativar a integração Klaviyo

1. Vá em Integrações

No menu lateral esquerdo, clique em Integrações.

Se Klaviyo NÃO aparecer em SUAS INTEGRAÇÕES ATIVAS, você precisa conectar primeiro.

2. Clique em "+ Conectar nova"

No canto superior direito. Abre o modal Conectar nova integração com 2 passos.

3. Passo 1 — Escolha a plataforma

O modal mostra o catálogo de integrações disponíveis (50+ plataformas: Klaviyo, ActiveCampaign, Hotmart, Kiwify, Cartpanda, GoHighLevel, Manychat, entre outras).

Role até encontrar o card Klaviyo e clique nele.

4. Passo 2 — Configure o primeiro webhook

Ao selecionar a Klaviyo, você avança pra o passo 2 (Configurar). Aqui você já cria o PRIMEIRO webhook da integração — a integração é ativada junto com esse webhook.

Preencha:

• Nome do webhook — descritivo, referente ao evento de negócio (ex: Novo lead popup, Compra aprovada)

• Novo evento — clique em "Selecione um evento" e escolha o evento a escutar (ver seção sobre eventos abaixo)

• + Adicionar evento — se quiser que o mesmo webhook escute múltiplos eventos

Clique em Criar webhook.

5. Pronto: integração ativada

A partir daí, Klaviyo aparece em SUAS INTEGRAÇÕES ATIVAS com bolinha verde, e o webhook que você acabou de criar já tá disponível na tela Webhooks — Klaviyo.

Pule pra a seção Depois de criar um webhook abaixo pra ver como pegar a URL e o payload.

Cenário B — Integração já ativa: criar novo webhook

1. Vá em Integrações → clique no card Klaviyo

Você vai pra a tela Webhooks — Klaviyo, onde ficam todos os webhooks já cadastrados.

Cada linha da tabela tem 4 informações:

• Ativo — toggle liga/desliga (sem apagar)

• Nome — o nome que você deu

• URL — o endereço único gerado pela LigueLead

• Ações — botões Copiar URL e Copiar payload

2. Clique em "+ Novo webhook"

Canto superior direito. Abre o modal Configurar novo webhook.

3. Preencha nome + evento

Mesma lógica do cenário A passo 4: nome descritivo + selecione o evento + Criar webhook.

Eventos disponíveis

Ao clicar em Selecione um evento, aparece a lista de eventos que a LigueLead reconhece pra Klaviyo:

• Lead Criado — dispara quando o Klaviyo envia um novo lead capturado

Novos eventos podem ser adicionados pela LigueLead conforme a integração evolui. Se você precisa escutar um evento que não aparece na lista, avise ao nosso suporte.

Depois de criar um webhook

Copie a URL

Na linha do webhook, clique em Copiar URL. A URL segue o formato:

https://areadocliente.liguelead.app.br/api/crm/webhook/{uuid}

O {uuid} é único por webhook — cada webhook novo tem endereço próprio.

Cole essa URL no lugar correspondente da configuração de webhook DENTRO do Klaviyo (o campo onde o Klaviyo dispara HTTP POST quando o evento acontece).

Veja o formato do payload esperado

Clique em Copiar payload — copia o formato JSON que o webhook LigueLead espera receber:

{
  "event": "create_lead",
  "phone": "+5531997457001",
  "email": "testepopup@gmail.com",
  "name": " "
}

Campos:

• event — o tipo (fixo create_lead quando o webhook é do tipo "Lead Criado")

• phone — telefone com DDI (+55...)

• email — email do lead

• name — nome (pode vir em branco se o Klaviyo não capturou)

O Klaviyo precisa ser configurado pra montar o payload EXATAMENTE nesse formato ao chamar a URL. Campo faltando ou com nome diferente = LigueLead descarta o evento.

O que acontece depois

Toda vez que o Klaviyo dispara o evento configurado, ele chama a URL do webhook LigueLead com o payload JSON. A LigueLead:

1. Cria um lead novo na sua base (aparece em Leads)

2. Se você tem um flow ativo com gatilho Evento CRM configurado, o flow dispara automaticamente pra esse lead

Isso permite encadear: Klaviyo captura o lead → webhook cria lead na LigueLead → flow dispara SMS/ligação de boas-vindas na hora.

Como testar

1. Configure o webhook no Klaviyo apontando pra URL que você copiou

2. Provoque o evento manualmente no Klaviyo (ex: preencher popup teste, criar contato teste)

3. Vá em Leads na LigueLead — o lead novo deve aparecer em segundos

4. Se você tem um flow ativo com gatilho Evento CRM, veja nos relatórios do flow se ele disparou

Se nada aparecer, cheque:

• URL colada no Klaviyo tá EXATAMENTE igual à copiada (sem espaço nem quebra de linha)

• Toggle Ativo do webhook está ligado

• Payload que o Klaviyo envia bate com o formato esperado (campos event, phone, email, name)

Gerenciando webhooks

• Toggle Ativo/Inativo — desliga sem apagar. Útil pra pausar temporariamente

• Copiar URL — pega a URL de novo se perdeu

• Copiar payload — pega o formato JSON de referência

• Múltiplos webhooks na mesma integração — permitido. Ex: um pra "Compra aprovada", outro pra "Carrinho abandonado", cada um com sua URL única

Dicas rápidas

• Nomeie descritivo pelo EVENTO DE NEGÓCIO ("Compra aprovada"), não pelo evento técnico ("create_lead"). Fica claro pro time depois.

• Um webhook por evento no Klaviyo é o padrão mais fácil de manter. Se você tem 3 fluxos (compra, carrinho, popup), crie 3 webhooks.

• Teste antes de ligar em produção — provoque o evento manualmente uma vez, veja o lead cair, depois deixe rodando.

• Se receber eventos duplicados, veja se o Klaviyo tem retry configurada — pode estar reenviando por não receber 200 em tempo hábil.