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

Conecte o Apsis One

Crie uma chave de API no Apsis One, conecte-a e envie novos cadastros para uma seção com seus atributos e assinaturas, passo a passo.

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

  1. No Apsis One, abra Account settings e vá até API keys (em integrações).
  2. Clique para criar uma nova chave de API. Dê a ela um nome fácil de reconhecer, por exemplo, “Scratcher”.
  3. Dê à chave acesso à seção ou às seções para as quais você quer que o Scratcher envie perfis, com as permissões abaixo.
  4. 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

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

Passo 3: Ative em uma campanha

  1. No editor, vá até Conectar > Integrações > Apsis One e clique em Ativar.
  2. Se você conectou mais de uma conta do Apsis One, escolha-a em Selecionar conta.
  3. Em Seção da Apsis, escolha a seção (Selecione uma seção).
  4. 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.
  5. 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.”
  6. 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.
  7. 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.
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.