---
title: "Conecte o Apsis One"
description: "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."
url: https://scratcher.io/pt-br/help/integrations/apsis-one
language: pt-BR
---

1. [Central de ajuda](https://scratcher.io/pt-br/help)
2. [Integrações](https://scratcher.io/pt-br/help/integrations)
3. Conecte o Apsis One

# 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](https://scratcher.io/pt-br/help/integrations/delivery-status).

## 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.

Integrações

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work)
- [Todas as integrações](https://scratcher.io/pt-br/help/integrations/other-integrations)
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status)
- [Conecte o HubSpot](https://scratcher.io/pt-br/help/integrations/hubspot)
- [Conecte o Salesforce Marketing Cloud](https://scratcher.io/pt-br/help/integrations/salesforce-marketing-cloud)
- [Conecte o Microsoft Dynamics 365 com o Zapier](https://scratcher.io/pt-br/help/integrations/microsoft-dynamics-365)
- [Conecte o Emarsys](https://scratcher.io/pt-br/help/integrations/emarsys)
- [Conectar Klaviyo](https://scratcher.io/pt-br/help/integrations/klaviyo)
- [Conecte o Mailchimp](https://scratcher.io/pt-br/help/integrations/mailchimp)
- [Conecte o ActiveCampaign](https://scratcher.io/pt-br/help/integrations/activecampaign)
- [Conecte o Apsis One](https://scratcher.io/pt-br/help/integrations/apsis-one)
- [Conecte o Drip](https://scratcher.io/pt-br/help/integrations/drip)
- [Conecte o HeyLoyalty](https://scratcher.io/pt-br/help/integrations/heyloyalty)
- [Conectar Peytz](https://scratcher.io/pt-br/help/integrations/peytz)
- [Conecte o Marketingplatform](https://scratcher.io/pt-br/help/integrations/marketingplatform)
- [Conecte o Campaign Monitor com o Zapier](https://scratcher.io/pt-br/help/integrations/campaign-monitor)
- [Conecte o ActiveTrail com o Zapier](https://scratcher.io/pt-br/help/integrations/activetrail)
- [Conecte o Bloomreach](https://scratcher.io/pt-br/help/integrations/bloomreach)
- [Conecte o Iterable](https://scratcher.io/pt-br/help/integrations/iterable)
- [Conecte o Mapp](https://scratcher.io/pt-br/help/integrations/mapp)
- [Conectar o Agillic](https://scratcher.io/pt-br/help/integrations/agillic)
- [Conectar Ortto](https://scratcher.io/pt-br/help/integrations/ortto)
- [Conecte o Emarketeer](https://scratcher.io/pt-br/help/integrations/emarketeer)
- [Conectar Shopify](https://scratcher.io/pt-br/help/integrations/shopify)
- [Conecte o Hello Retail](https://scratcher.io/pt-br/help/integrations/hello-retail)
- [Conecte mais de 8.000 apps com o Zapier](https://scratcher.io/pt-br/help/integrations/zapier)
- [Conecte o monday.com ao Zapier](https://scratcher.io/pt-br/help/integrations/monday-com)
- [Conecte o Asana com o Zapier](https://scratcher.io/pt-br/help/integrations/asana)
- [Conecte o Podio com o Zapier](https://scratcher.io/pt-br/help/integrations/podio)
- [Conecte o Intercom com o Zapier](https://scratcher.io/pt-br/help/integrations/intercom)

Continue aprendendo

## Artigos relacionados

- [Como funcionam as integrações](https://scratcher.io/pt-br/help/integrations/how-integrations-work): Conecte sua ferramenta de e-mail ou CRM uma única vez, ative-a em cada campanha, escolha uma lista, mapeie seus campos e envie apenas quem deu consentimento.
- [Verifique o status de envio e reenvie leads](https://scratcher.io/pt-br/help/integrations/delivery-status): Veja quais leads foram enviados para suas ferramentas, entenda as mensagens de erro, corrija o problema e envie-os novamente.
- [Peça consentimento e adicione termos e condições](https://scratcher.io/pt-br/help/forms/consent-and-permissions): Adicione caixas de seleção de consentimento para newsletters, vincule seus termos, escolha qual caixa inscreve as pessoas e envie à sua ferramenta de e-mail apenas quem disse sim.

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](https://platform.scratcher.io/pt-BR/login)**

    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](https://scratcher.io/pt-br/book-a-meeting)**

    Uma videochamada gratuita de 30 minutos com nossa equipe: um tour, ideias de campanhas ou ajuda com a configuração.
- **[Mande um e-mail](mailto:contact@scratcher.io)**

    Escreva para contact@scratcher.io e retornaremos o contato.
