Saltar para o conteúdo
Rex, o seu assistente de IA: o trabalho repetitivo fica tratado. As ideias são suas 👉 Conheça o Rex

Ligue o Apsis One

Crie uma chave da API no Apsis One, ligue-a e envie os novos registos para uma secção com os respetivos atributos e subscrições, passo a passo.

Com a integração do Apsis One, todas as pessoas que se registam são criadas ou atualizadas como perfil no Apsis One, na secção que escolher, e podem ser inscritas numa das suas subscrições do Apsis One.

O que precisa

  • Uma conta do Apsis One e um utilizador que possa gerir chaves da API (normalmente 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: criar uma chave da API no Apsis One

  1. No Apsis One, abra Account settings e vá a API keys (nas integrações).
  2. Clique para criar uma nova chave da API. Dê-lhe um nome que reconheça, por exemplo "Scratcher".
  3. Dê à chave acesso à secção ou às secções para onde quer que o Scratcher envie perfis, com as permissões indicadas abaixo.
  4. Guarde e copie o Client ID e o Client secret. O secret só é mostrado uma vez.

O Apsis tem o seu próprio guia passo a passo para isto. Tem ligação no Guia de configuração da janela de instalação no Scratcher ("To install the integration, follow the guide here").

Permissões de que a chave precisa

O Scratcher usa a chave para:

  • ler as suas secções e os atributos, as subscrições (temas de consentimento) e os eventos que contêm, para que os possa escolher na campanha;
  • criar perfis e atualizar os respetivos atributos;
  • adicionar consentimentos (opt-ins) aos perfis;
  • adicionar eventos aos perfis.

Por isso, a chave precisa de acesso de leitura às secções e de acesso de escrita a perfis, consentimentos e eventos nas secções que usa. Sem acesso de escrita, as entregas falham com a mensagem de erro do próprio Apsis One.

Passo 2: ligar o Apsis One ao Scratcher

  1. No Scratcher, vá a Definições > Integrações e clique em Apsis One.
  2. Escolha a Região da API: Europa ou Ásia.
  3. Cole o ID do cliente e o Client secret.
  4. Clique em Instalar integração. O Scratcher inicia sessão no Apsis One para verificar os dados.

Passo 3: ativar numa campanha

  1. No editor, vá a Ligar > Integrações > Apsis One e clique em Ativar.
  2. Se tiver ligado mais do que uma conta do Apsis One, escolha-a em Selecionar conta.
  3. Em Secção Apsis, escolha a secção (Selecione uma secção).
  4. Em Mapeamentos de campos, clique em Adicionar mapeamento de campos para cada campo e associe o Campo do Scratcher ao atributo do Apsis One em Campo de destino. A lista mostra os atributos da secção que escolheu, incluindo os seus.
  5. Em Subscrições (consentimentos), escolha a subscrição em que as pessoas devem ser inscritas, ou Nenhum. "Escolha a subscrição em que o participante deve ser inscrito."
  6. Em Filtrar por consentimentos (opcional), escolha a sua caixa de consentimento de marketing, para que só sejam enviadas as pessoas que a assinalaram.
  7. Clique em Guardar 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 precisa de o associar.
  • Nos números de telefone, use a definição Formato para enviar o número da forma que o seu atributo espera.
  • Os atributos sim/não recebem true ou false, por isso associe o campo Aceite de um consentimento a um atributo sim/não.

Consentimento

Se escolher uma subscrição, 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 consentimentos para que só sejam inscritas as pessoas que assinalaram a sua caixa de marketing.

Se a sua secção tiver o evento de formulário de consentimento do Apsis One, o Scratcher regista também o registo como evento no perfil, com o endereço da campanha.

O que é enviado e quando

Os novos registos são enviados em um ou dois minutos. Quando ativa a integração, os leads existentes da campanha também são enviados. Quando alguém volta a participar, o seu perfil é atualizado. Verifique cada entrega em Definições > Integrações > Estado da entrega; também mostra se o perfil era novo ou já existia. Consulte Verifique o estado da entrega e reenvie leads.

Resolução de problemas

  • "Alguns ou todos os campos são inválidos..." ao instalar: verifique a região e copie novamente o client ID e o secret.
  • As entregas falham com um erro de acesso do Apsis One: a chave não tem acesso à secção, ou não tem permissões de escrita. Edite a chave no Apsis One.
  • Subscrições (consentimentos) está vazio: a secção ainda não tem subscrições. Crie uma no Apsis One e abra novamente a integração.
Precisa de ajuda?

Ainda precisa de ajuda?

Há pessoas reais prontas para ajudar. Se já usa o Scratcher, o mais rápido é o chat dentro da plataforma.

  • Fale connosco no chat

    Inicie sessão e clique no botão de chat no canto inferior direito. O Rex responde de imediato e a nossa equipa está à distância de um clique.

  • Marque uma reunião

    Uma videochamada gratuita de 30 minutos com a nossa equipa: uma demonstração, ideias de campanhas ou ajuda com a sua configuração.

  • Envie-nos um e-mail

    Escreva para contact@scratcher.io e entraremos em contacto consigo.