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

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

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

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

Integrações

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

Continue a aprender

## Artigos relacionados

- [Como funcionam as integrações](https://scratcher.io/pt/help/integrations/how-integrations-work): Ligue a sua ferramenta de e-mail ou CRM uma vez, ative-a em cada campanha, escolha uma lista, associe os campos e envie apenas quem deu consentimento.
- [Verifique o estado da entrega e reenvie leads](https://scratcher.io/pt/help/integrations/delivery-status): Veja que leads foram enviados para as suas ferramentas, perceba as mensagens de erro, resolva o problema e envie-os novamente.
- [Peça consentimento e adicione termos e condições](https://scratcher.io/pt/help/forms/consent-and-permissions): Adicione caixas de consentimento para newsletters, ligue os seus termos, escolha que caixa subscreve as pessoas e envie para a sua ferramenta de e-mail apenas quem disse que sim.

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

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

    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](mailto:contact@scratcher.io)**

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