> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Envie leads de workflows para o Klaviyo

> Saiba como enviar leads de um workflow do LanderLab para o Klaviyo. Crie um gatilho Lead, conecte uma landing page, adicione uma ação do Klaviyo, mapeie os campos e publique.

Use um workflow para enviar cada novo lead diretamente para uma lista do Klaviyo. Você cria um gatilho Lead, conecta uma landing page, adiciona uma ação do Klaviyo, mapeia seus campos e publica. Nenhum código é necessário.

## Pré-requisitos

Antes de começar, verifique se você tem:

* Uma conta do LanderLab com pelo menos uma landing page publicada
* Uma integração do Klaviyo já conectada no LanderLab
* A lista do Klaviyo à qual você quer adicionar os leads

<Note>
  Se você ainda não conectou o Klaviyo, configure-o primeiro. Veja [Conecte o Klaviyo ao LanderLab](/pt-BR/integrations/crm/klaviyo).
</Note>

## Passo 1: Crie o gatilho Lead

Todo workflow começa com um gatilho (trigger). O gatilho Lead é acionado sempre que um novo lead é capturado.

<Steps>
  <Step title="Abra o canvas do workflow">
    Crie um novo workflow e dê um nome a ele (por exemplo, "Klaviyo"). O canvas é aberto com um único botão **+** no centro.
  </Step>

  <Step title="Adicione o gatilho Lead">
    Clique em **+** e selecione o gatilho **Lead**. Ele é adicionado ao canvas e acionado quando um novo lead é capturado.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/7aru1L52hZH44UU4/images/image-21.png?fit=max&auto=format&n=7aru1L52hZH44UU4&q=85&s=8d0dd99aa88bba2f2c5d817cb4abf676" alt="Imagem" width="382" height="897" data-path="images/image-21.png" />
    </Frame>
  </Step>
</Steps>

## Passo 2: Conecte uma landing page

O workflow não será executado até que uma landing page esteja vinculada ao gatilho Lead.

<Steps>
  <Step title="Abra as configurações do gatilho">
    Clique no nó **Lead**. As configurações dele são abertas no painel à direita.
  </Step>

  <Step title="Adicione sua landing page">
    Em **Landing Page**, clique em **Add landing page** e selecione a página que deve acionar este workflow a cada novo lead.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/YUEiyipbMrmpawov/images/select-landing-page.png?fit=max&auto=format&n=YUEiyipbMrmpawov&q=85&s=ab9442ba5cbd3598f4be1a890f159c18" alt="Selecionar landing page" width="1288" height="946" data-path="images/select-landing-page.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Um ícone de aviso permanece no nó Lead até que uma landing page seja conectada. O workflow não pode ser executado sem ela.
</Warning>

## Passo 3: Adicione um nó após o gatilho

Clique no **+** abaixo do nó Lead para adicionar o próximo passo. Você verá dois grupos:

* Nós **Internal** para a lógica de roteamento: Filter, If, Switch, Delay
* **Actions** para enviar dados para fora, como HTTP Request, Google Sheets e Klaviyo

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/grX8nVmIYP3WzRJo/images/add-node.png?fit=max&auto=format&n=grX8nVmIYP3WzRJo&q=85&s=225890cf723befd3195ea8b72b0e9f7f" alt="Adicionar nó" width="410" height="592" data-path="images/add-node.png" />
</Frame>

A partir daqui, há dois caminhos comuns:

* **Enviar todos os leads para o Klaviyo:** adicione a ação do Klaviyo diretamente.
* **Enviar apenas alguns leads:** adicione primeiro um nó **Filter** para qualificar os leads e, depois dele, adicione a ação do Klaviyo.

<Tip>
  Use um Filter quando quiser que apenas os leads que atendem a uma condição (por exemplo, um país específico ou um campo preenchido) cheguem ao Klaviyo. Todo o resto para no filtro.
</Tip>

## Passo 4: Configure a ação do Klaviyo

Adicione a ação **Klaviyo** e clique nela para abrir as configurações no painel à direita.

<Steps>
  <Step title="Dê um nome ao nó">
    Em **General**, defina um **Name** para identificar este passo no canvas.
  </Step>

  <Step title="Selecione sua conta">
    Em **Account**, escolha sua conta do Klaviyo conectada.
  </Step>

  <Step title="Escolha uma lista">
    Em **List**, selecione a lista do Klaviyo à qual os leads devem ser adicionados.
  </Step>

  <Step title="Mapeie seus campos">
    Em **Field Mapping**, marque os campos do LanderLab que você quer enviar e escolha o campo correspondente do Klaviyo para cada um. Os campos padrão incluem LL Lander URL, LL Visitor IP, LL Visitor User Agent, LL Submission Time e LL Variant ID. Todos os campos de formulário personalizados também aparecem aqui.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/7aru1L52hZH44UU4/images/klaviyo.png?fit=max&auto=format&n=7aru1L52hZH44UU4&q=85&s=46953a647c0d7ecb44c79e10256e092c" alt="Klaviyo" width="382" height="897" data-path="images/klaviyo.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Mapeie o campo de e-mail para que cada lead se torne um perfil utilizável no Klaviyo. Sem ele, os leads não podem ser associados a assinantes.
</Note>

## Passo 5: Salve e publique

Clique em **Save** para armazenar suas alterações e, depois, clique em **Publish** para colocar o workflow no ar.

Após a publicação, cada novo lead da landing page conectada é enviado para a sua lista do Klaviyo em tempo real.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O workflow não está sendo executado">
    Confirme que uma landing page está conectada nas configurações do gatilho Lead e que o status do workflow é Published, e não Draft.
  </Accordion>

  <Accordion title="Os leads não estão chegando ao Klaviyo">
    Abra a ação do Klaviyo e verifique se a conta e a lista corretas estão selecionadas e se pelo menos um campo está mapeado, incluindo o campo de e-mail.
  </Accordion>

  <Accordion title="Apenas alguns leads estão sendo enviados">
    Isso é esperado quando há um nó Filter antes da ação do Klaviyo. Revise as condições do filtro para confirmar quais leads passam por ele.
  </Accordion>
</AccordionGroup>