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
- 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.”
- 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.
- Dê à chave um nome fácil de reconhecer, por exemplo “Scratcher”.
- Confira os escopos (veja a lista abaixo) e clique para criar a chave.
- 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
- 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”.
- Clique em Instalar integração. O Scratcher verifica se a chave consegue ler suas listas.
Passo 3: Ative em uma campanha
- No editor, vá em Conectar > Integrações > Klaviyo e clique em Ativar.
- Se você conectou mais de uma conta do Klaviyo, escolha-a em Selecionar conta.
- Em Lista externa, escolha a lista do Klaviyo.
- 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”.
- Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing.
- 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.