Pular para o conteúdo
Rex, seu assistente de IA: o trabalho braçal fica com ele, as ideias ficam com você 👉 Conheça o Rex

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.
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

    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

    Uma videochamada gratuita de 30 minutos com nossa equipe: um tour, ideias de campanhas ou ajuda com a configuração.

  • Mande um e-mail

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