---
title: "Conectar Klaviyo"
description: "Crie uma chave de API privada no Klaviyo com os escopos certos, conecte-a e inscreva os novos cadastros em uma lista do Klaviyo."
url: https://scratcher.io/pt-br/help/integrations/klaviyo
language: pt-BR
---

1. [Central de ajuda](https://scratcher.io/pt-br/help)
2. [Integrações](https://scratcher.io/pt-br/help/integrations)
3. Conectar Klaviyo

# Conectar Klaviyo

Crie uma chave de API privada no Klaviyo com os escopos certos, conecte-a e inscreva os novos cadastros em uma lista do Klaviyo.

Com a integração do Klaviyo, cada pessoa que se cadastra é criada ou atualizada como perfil no Klaviyo, adicionada à lista que você escolher e inscrita no e-mail marketing.

## O que você precisa

- Uma conta no Klaviyo. O plano gratuito funciona.
- Um usuário do Klaviyo que possa criar chaves de API privadas (no Klaviyo, normalmente é um **Owner**, **Admin** ou **Manager**).

## Passo 1: Crie uma chave de API privada no Klaviyo

1. No Scratcher, vá em **Configurações** > **Integrações**, clique em **Klaviyo** e veja o **Guia de configuração**: “Crie uma chave de API privada. As permissões corretas já vêm pré-selecionadas.”
2. Clique no link **Criar uma chave de API privada**. O Klaviyo abre com os escopos certos já selecionados. Faça login se o Klaviyo pedir.
3. Dê à chave um nome fácil de reconhecer, por exemplo “Scratcher”.
4. Confira os escopos (veja a lista abaixo) e clique para criar a chave.
5. Copie a chave. Ela começa com “pk\_”. O Klaviyo mostra a chave completa só uma vez, então mantenha a aba aberta até colá-la.

Se preferir criar a chave por conta própria: no Klaviyo, abra o menu sob o nome da sua conta, vá em **Settings** > **API keys** e clique em **Create Private API Key**. Escolha **Custom Key** e defina os escopos abaixo.

## Escopos necessários para a chave

A chave precisa exatamente destes escopos (texto de ajuda do Scratcher: “A chave de API precisa de acesso de leitura/gravação a ‘Lists’ e ‘Profiles’ e acesso de gravação a ‘Subscriptions’”).

- **Lists**: leitura e gravação. Para exibir suas listas e adicionar pessoas a elas.
- **Profiles**: leitura e gravação. Para criar e atualizar perfis.
- **Subscriptions**: gravação. Para inscrever pessoas no e-mail marketing.

Todos os outros escopos podem ficar em **No Access**.

## Passo 2: Conecte o Klaviyo ao Scratcher

1. Na janela do Klaviyo no Scratcher, cole a chave em **Chave de API privada**. A caixa **Permissões de acesso** lista o que o Scratcher pode fazer: “Acesso de leitura e gravação a Contatos e Listas” e “Sincronização automática em segundo plano dos participantes da campanha”.
2. Clique em **Instalar integração**. O Scratcher verifica se a chave consegue ler suas listas.

## Passo 3: Ative em uma campanha

1. No editor, vá em **Conectar** > **Integrações** > **Klaviyo** e clique em **Ativar**.
2. Se você conectou mais de uma conta do Klaviyo, escolha-a em **Selecionar conta**.
3. Em **Lista externa**, escolha a lista do Klaviyo.
4. Em **Mapeamento de campos**, adicione os dados extras que você quer no perfil. Aqui você mesmo digita o nome da propriedade no Klaviyo (**Nome do campo externo**), por exemplo “favourite\_product” ou “Campaign”.
5. Em **Filtrar por permissões (opcional)**, escolha sua caixa de seleção de consentimento de marketing.
6. Clique em **Salvar** e depois em **Testar**.

## Mapeamento de campos

- E-mail, telefone, nome e sobrenome são enviados automaticamente para os campos de perfil nativos do Klaviyo. Você não precisa mapeá-los.
- Tudo o que você mapear é salvo como propriedade personalizada no perfil, com o nome que você digitou. Se a propriedade ainda não existir, o Klaviyo a cria.
- O Klaviyo só aceita números de telefone com + e código do país. Garanta que o campo de telefone do seu formulário tenha código do país.

## Consentimento

O Scratcher inscreve no e-mail marketing do Klaviyo todas as pessoas que envia, com “Scratcher” como origem. Por isso o filtro de consentimento é importante: escolha sua caixa de seleção de marketing em **Filtrar por permissões (opcional)** se ela for opcional no seu formulário.

Se a sua lista do Klaviyo usa confirmação dupla (double opt-in), o Klaviyo envia o próprio e-mail de confirmação, e as pessoas só são inscritas quando confirmam. Depois, você pode iniciar um fluxo de boas-vindas no Klaviyo quando as pessoas forem adicionadas à lista.

## O que é enviado e quando

Novos cadastros são enviados em um ou dois minutos. Ao ativar a integração, os leads já existentes da campanha também são enviados. Quando alguém participa novamente, o perfil é atualizado.

## Solução de problemas

Envios com falha aparecem em **Configurações** > **Integrações** > **Status de entrega**.

- “The API key used does not have the correct API Scopes.”: falta à chave um dos escopos acima. Edite a chave no Klaviyo ou crie uma nova com o link de configuração e conecte-a com **Adicionar nova conta**.
- “Conflict: Duplicate profile detected.”: o Klaviyo encontrou dois perfis correspondentes, por exemplo um com o e-mail e outro com o mesmo número de telefone. Mescle ou corrija os perfis no Klaviyo e reenvie.
- Um número de telefone é rejeitado: o número não tem código do país. Adicione um seletor de país ao campo de telefone do seu formulário.
- Nada chega depois da instalação: verifique se há uma lista escolhida em **Lista externa** na campanha e se você clicou em **Salvar**.

Integrações

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work)
- [Todas as integrações](https://scratcher.io/pt-br/help/integrations/other-integrations)
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status)
- [Conecte o HubSpot](https://scratcher.io/pt-br/help/integrations/hubspot)
- [Conecte o Salesforce Marketing Cloud](https://scratcher.io/pt-br/help/integrations/salesforce-marketing-cloud)
- [Conecte o Microsoft Dynamics 365 com o Zapier](https://scratcher.io/pt-br/help/integrations/microsoft-dynamics-365)
- [Conecte o Emarsys](https://scratcher.io/pt-br/help/integrations/emarsys)
- [Conectar Klaviyo](https://scratcher.io/pt-br/help/integrations/klaviyo)
- [Conecte o Mailchimp](https://scratcher.io/pt-br/help/integrations/mailchimp)
- [Conecte o ActiveCampaign](https://scratcher.io/pt-br/help/integrations/activecampaign)
- [Conecte o Apsis One](https://scratcher.io/pt-br/help/integrations/apsis-one)
- [Conecte o Drip](https://scratcher.io/pt-br/help/integrations/drip)
- [Conecte o HeyLoyalty](https://scratcher.io/pt-br/help/integrations/heyloyalty)
- [Conectar Peytz](https://scratcher.io/pt-br/help/integrations/peytz)
- [Conecte o Marketingplatform](https://scratcher.io/pt-br/help/integrations/marketingplatform)
- [Conecte o Campaign Monitor com o Zapier](https://scratcher.io/pt-br/help/integrations/campaign-monitor)
- [Conecte o ActiveTrail com o Zapier](https://scratcher.io/pt-br/help/integrations/activetrail)
- [Conecte o Bloomreach](https://scratcher.io/pt-br/help/integrations/bloomreach)
- [Conecte o Iterable](https://scratcher.io/pt-br/help/integrations/iterable)
- [Conecte o Mapp](https://scratcher.io/pt-br/help/integrations/mapp)
- [Conectar o Agillic](https://scratcher.io/pt-br/help/integrations/agillic)
- [Conectar Ortto](https://scratcher.io/pt-br/help/integrations/ortto)
- [Conecte o Emarketeer](https://scratcher.io/pt-br/help/integrations/emarketeer)
- [Conectar Shopify](https://scratcher.io/pt-br/help/integrations/shopify)
- [Conecte o Hello Retail](https://scratcher.io/pt-br/help/integrations/hello-retail)
- [Conecte mais de 8.000 apps com o Zapier](https://scratcher.io/pt-br/help/integrations/zapier)
- [Conecte o monday.com ao Zapier](https://scratcher.io/pt-br/help/integrations/monday-com)
- [Conecte o Asana com o Zapier](https://scratcher.io/pt-br/help/integrations/asana)
- [Conecte o Podio com o Zapier](https://scratcher.io/pt-br/help/integrations/podio)
- [Conecte o Intercom com o Zapier](https://scratcher.io/pt-br/help/integrations/intercom)

Continue aprendendo

## Artigos relacionados

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work): Conecte sua ferramenta de e-mail ou CRM uma única vez, ative-a em cada campanha, escolha uma lista, mapeie seus campos e envie apenas quem deu consentimento.
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status): Veja quais leads foram enviados para suas ferramentas, entenda as mensagens de erro, corrija o problema e envie-os novamente.
- [Peça consentimento e adicione termos e condições](https://scratcher.io/pt-br/help/forms/consent-and-permissions): Adicione caixas de seleção de consentimento para newsletters, vincule seus termos, escolha qual caixa inscreve as pessoas e envie à sua ferramenta de e-mail apenas quem disse sim.

Precisa de ajuda?

## Ainda precisa de ajuda?

Pessoas de verdade estão aqui para ajudar. Se você já usa o Scratcher, o jeito mais rápido é o chat dentro da plataforma.

- **[Converse com a gente](https://platform.scratcher.io/pt-BR/login)**

    Entre na sua conta e clique no botão de chat no canto inferior direito. O Rex responde na hora, e nossa equipe está a um clique.
- **[Agende uma reunião](https://scratcher.io/pt-br/book-a-meeting)**

    Uma videochamada gratuita de 30 minutos com nossa equipe: um tour, ideias de campanhas ou ajuda com a configuração.
- **[Mande um e-mail](mailto:contact@scratcher.io)**

    Escreva para contact@scratcher.io e retornaremos o contato.
