Com a integração do Apsis One, todas as pessoas que se cadastram são criadas ou atualizadas como perfil no Apsis One, na seção que você escolher, e podem ser inscritas em uma das suas assinaturas do Apsis One.
O que você precisa
- Uma conta no Apsis One e um usuário que possa gerenciar chaves de API (geralmente um administrador).
- Saber se a sua conta do Apsis One está na região Europa ou Ásia. A maioria das contas está na Europa.
Passo 1: Crie uma chave de API no Apsis One
- No Apsis One, abra Account settings e vá até API keys (em integrações).
- Clique para criar uma nova chave de API. Dê a ela um nome fácil de reconhecer, por exemplo, “Scratcher”.
- Dê à chave acesso à seção ou às seções para as quais você quer que o Scratcher envie perfis, com as permissões abaixo.
- Salve e copie o Client ID e o Client secret. O secret é exibido apenas uma vez.
A Apsis tem seu próprio guia passo a passo para isso. O link está no Guia de configuração da janela de instalação no Scratcher (“Para instalar a integração, siga o guia aqui”).
Permissões necessárias para a chave
O Scratcher usa a chave para:
- ler suas seções e os atributos, assinaturas (tópicos de consentimento) e eventos nelas, para que você possa escolhê-los na campanha;
- criar perfis e atualizar seus atributos;
- adicionar consentimentos (opt-ins) aos perfis;
- adicionar eventos aos perfis.
Portanto, a chave precisa de acesso de leitura às seções e de acesso de gravação a perfis, consentimentos e eventos nas seções que você usa. Sem acesso de gravação, os envios falham com a mensagem de erro do próprio Apsis One.
Passo 2: Conecte o Apsis One ao Scratcher
- No Scratcher, vá até Configurações > Integrações e clique em Apsis One.
- Escolha a Região da API: Europa ou Ásia.
- Cole o Client ID e o Client secret.
- Clique em Instalar integração. O Scratcher faz login no Apsis One para verificar os dados.
Passo 3: Ative em uma campanha
- No editor, vá até Conectar > Integrações > Apsis One e clique em Ativar.
- Se você conectou mais de uma conta do Apsis One, escolha-a em Selecionar conta.
- Em Seção da Apsis, escolha a seção (Selecione uma seção).
- Em Mapeamento de campos, clique em Adicionar mapeamento de campo para cada campo e associe o Campo do Scratcher ao atributo do Apsis One em Campo de destino. A lista mostra os atributos da seção escolhida, incluindo os seus próprios.
- Em Assinaturas (consentimentos), escolha a assinatura em que as pessoas devem ser inscritas, ou Nenhuma. “Escolha qualquer assinatura em que o participante deve ser inscrito.”
- Em Filtrar por permissões (opcional), escolha a sua caixa de seleção de consentimento de marketing, para que sejam enviadas apenas as pessoas que a marcaram.
- Clique em Salvar e depois em Testar para enviar um perfil de teste.
Mapeamento de campos
- O endereço de e-mail é sempre enviado e é usado para identificar o perfil. Não é preciso mapeá-lo.
- Para números de telefone, use a configuração Formato para enviar o número no formato que o seu atributo espera.
- Atributos de sim/não recebem true ou false; por isso, mapeie o campo Aceito de um consentimento para um atributo de sim/não.
Consentimento
Se você escolher uma assinatura, cada pessoa é inscrita nela com o motivo “Subscribed via” e o nome da campanha, e a origem “Scratcher”. Se a pessoa já estiver inscrita, nada muda. Use Filtrar por permissões para que apenas quem marcou a sua caixa de marketing seja inscrito.
Se a sua seção tiver o evento de formulário de consentimento do Apsis One, o Scratcher também registra o cadastro como um evento no perfil, com o endereço da campanha.
O que é enviado e quando
Novos cadastros são enviados em um ou dois minutos. Quando você ativa a integração, os leads já existentes da campanha também são enviados. Quando alguém participa novamente, o perfil é atualizado. Confira cada envio em Configurações > Integrações > Status de envio; ali também aparece se o perfil era novo ou já existia. Veja Verifique o status de envio e reenvie leads.
Solução de problemas
- “All or some of the fields are invalid...” ao instalar: verifique a região e copie novamente o client ID e o secret.
- Os envios falham com um erro de acesso do Apsis One: a chave não tem acesso à seção ou não possui permissões de gravação. Edite a chave no Apsis One.
- Assinaturas (consentimentos) está vazio: a seção ainda não tem assinaturas. Crie uma no Apsis One e abra a integração novamente.