fullmetrixDocs

Klaviyo

Crie uma chave de API privada do Klaviyo, ligue uma ou mais contas ao Fullmetrix e envie os seus públicos como listas do Klaviyo que se mantêm atualizadas.

O Klaviyo é uma ferramenta de marketing por email e SMS. A integração Klaviyo envia os seus públicos do Fullmetrix para o Klaviyo e mantém-nos atualizados. Um público é uma lista de pessoas construída a partir de um segmento do Fullmetrix, por exemplo "clientes que não encomendam há seis meses".

O Fullmetrix não envia nenhum email nem SMS. Cria as suas campanhas e fluxos no Klaviyo como de costume, tendo como alvo as listas que o Fullmetrix criou lá.

Como os seus públicos chegam ao Klaviyo

Para cada público enviado ao Klaviyo, o Fullmetrix cria uma lista estática com o nome fullmetrix: seguido do nome do público, por exemplo fullmetrix: Clientes VIP. Uma lista estática é uma lista cujos membros são adicionados um a um, ao contrário dos segmentos do Klaviyo, que são calculados a partir de regras.

Depois disso, mais ou menos a cada cinco minutos, o Fullmetrix compara o público com a lista. Uma pessoa que entra no público é adicionada à lista, uma pessoa que já não corresponde é removida. As suas outras listas e os outros perfis do Klaviyo nunca são alterados.

O Fullmetrix envia o email, o telefone, o nome próprio, o apelido e o país quando são conhecidos. Uma pessoa sem email nem telefone não pode ser enviada ao Klaviyo.

O que precisa antes de começar

Tenha isto à mão

Acesso à sua conta Klaviyo, com permissão para criar uma chave de API privada. Se gere várias contas Klaviyo, inicie primeiro sessão na conta que corresponde a esta organização Fullmetrix.

O Klaviyo não tem início de sessão com um clique para esta integração. Cria uma chave de API privada, uma espécie de palavra-passe reservada ao Fullmetrix, e cola-a no Fullmetrix.

Criar a chave de API privada no Klaviyo

Abra a janela de ligação

Na barra lateral, clique em Definições e depois no separador Integrações. Na categoria Comunicação, clique em Ligar no cartão Klaviyo. A janela Ligar o Klaviyo abre-se.

Abra a página de criação já preenchida

Clique no link Criar a chave com os scopes corretos. O Klaviyo abre num novo separador, na página de criação de chaves privadas, com as permissões necessárias já marcadas. Os scopes são as permissões concedidas à chave.

PermissãoNívelPara que serve
AccountsLeituraLer o nome da sua conta para o mostrar no Fullmetrix
ListsLeitura e escritaCriar as listas e gerir os seus membros
ProfilesLeitura e escritaEncontrar e criar perfis
SubscriptionsEscritaAplicar o estado de consentimento que escolher

Crie e copie a chave

Dê um nome à chave, como "Fullmetrix", e crie-a. O Klaviyo mostra a chave apenas uma vez. Copie-a logo. Ela começa por pk_.

Trate a chave como uma palavra-passe

Nunca a cole num email, numa captura de ecrã ou num documento partilhado. Se ela foi exposta, apague-a no Klaviyo, crie uma nova e volte a ligar a conta.

Ligar o Klaviyo

Cole a chave

Volte à janela Ligar o Klaviyo e cole a chave em Chave API privada. O campo esconde o valor.

Confirme

Clique em Ligar. O Fullmetrix verifica a chave junto do Klaviyo antes de a guardar e obtém o nome da conta. A mensagem Klaviyo ligado aparece, a janela fecha-se e o cartão mostra um ponto verde, o nome da sua conta e o botão Gerir.

Ligar outra conta Klaviyo

Clique em Gerir no cartão do Klaviyo. A janela Gerir contas Klaviyo lista cada conta ligada. Clique em Ligar outra conta e cole a chave privada da outra conta. O cartão passa então a mostrar 2 contas ligadas, por exemplo.

Se colar uma nova chave para uma conta que já está ligada, o Fullmetrix substitui a chave antiga dessa conta em vez de criar um duplicado. Esta é a forma certa de trocar as chaves.

Enviar um público para o Klaviyo

Crie o público

Na barra lateral, abra Sincronização com a Audiência e depois Sincronização. Clique em Criar um público, dê-lhe um nome e escolha o seu segmento.

Escolha o Klaviyo

Em Plataformas, selecione Klaviyo. O bloco Definições do Klaviyo aparece. Se houver várias contas ligadas, escolha a certa em Conta Klaviyo.

Escolha o estado de consentimento

OpçãoEfeito
Não subscrito (predefinição)Adiciona os perfis à lista sem os subscrever. Não altera um subscritor existente
SubscritoSubscreve os perfis através da lista. O Klaviyo aplica então o opt-in simples ou duplo definido nessa lista. Exige um consentimento válido segundo o RGPD
Subscrição canceladaCancela a subscrição dos perfis dos seus emails e SMS de marketing

Este estado só se aplica aos perfis que o Klaviyo cria nesse momento. Um perfil que já existia mantém o seu estado.

Envie

Clique em Criar e enviar. A página é tratada em Sincronização de públicos.

Verificar se tudo funciona

No Klaviyo, abra a página de listas e segmentos. Uma lista com o nome fullmetrix: seguido do nome do seu público deve aparecer, com os seus membros. Para um público grande, aguarde alguns minutos antes de comparar as contagens.

Desligar uma conta Klaviyo

Escolha a conta

Clique em Gerir e depois em Desligar ao lado da conta em causa. A janela Desligar o Klaviyo? mostra quantos públicos esta conta alimenta.

Decida o que acontece às listas

  • Manter no Klaviyo apaga a chave do Fullmetrix, mas deixa as listas no Klaviyo. Se voltar a ligar a mesma conta mais tarde, a sincronização dos públicos retoma automaticamente.
  • Eliminar do Klaviyo apaga as listas que o Fullmetrix criou, retira o Klaviyo desses públicos e elimina a ligação. Os perfis continuam no Klaviyo.
  • Cancelar fecha a janela sem alterar nada.

Se não pretende voltar a ligar a conta, apague também a chave privada no Klaviyo.

Problemas comuns

Se o problema persistir, consulte Ligação e acesso ou fale connosco indicando o nome da organização, a conta Klaviyo, o público em causa e a mensagem mostrada. Nunca nos envie a sua chave privada.

Nesta página