---
title: "Ligue o Emarsys"
description: "Crie credenciais de API com as permissões certas no Emarsys, ligue-as ao Scratcher e adicione os novos registos a uma lista de contactos do Emarsys."
url: https://scratcher.io/pt/help/integrations/emarsys
language: pt
---

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

# Ligue o Emarsys

Crie credenciais de API com as permissões certas no Emarsys, ligue-as ao Scratcher e adicione os novos registos a uma lista de contactos do Emarsys.

Com a integração do Emarsys, todas as pessoas que se registam são criadas ou atualizadas como contacto no Emarsys e adicionadas à lista de contactos que escolher.

## O que precisa

- Uma conta do Emarsys e um utilizador que possa gerir credenciais de API (em **Management** > **Security Settings**).

## Passo 1: criar credenciais de API no Emarsys

1. No Emarsys, vá a **Management** > **Security Settings** > **API Credentials**.
2. Clique em **Create API Credentials** e certifique-se de que seleciona **OpenID Connect**.
3. Em **Permissions**, ative estas quatro: `contact.create`, `contact.update`, `contactlist.list` e `field.list`.
4. Guarde e copie o **Client ID** e o **Client Secret**. Precisa de ambos no Scratcher.

## Permissões de que as credenciais precisam

- `contact.create` e `contact.update`: para criar novos contactos e atualizar os existentes.
- `contactlist.list`: para mostrar as suas listas de contactos na campanha.
- `field.list`: para mostrar os seus campos do Emarsys no mapeamento de campos.

Não são necessárias outras permissões.

## Passo 2: ligar o Emarsys ao Scratcher

1. No Scratcher, vá a **Definições** > **Integrações** e clique em **Emarsys**. O **Guia de configuração** na janela repete os passos acima.
2. Cole o **ID do cliente** e o **Client secret**.
3. Clique em **Instalar integração**. O Scratcher verifica se consegue ler as suas listas de contactos.

## Passo 3: ativar numa campanha

1. No editor, vá a **Ligar** > **Integrações** > **Emarsys** e clique em **Ativar**.
2. Se tiver ligado mais do que uma conta, escolha-a em **Selecionar conta**.
3. Em **Lista externa**, escolha a lista de contactos.
4. Em **Mapeamentos de campos**, associe pelo menos "Lead - E-mail" ao campo **Email** do Emarsys e depois os seus outros campos, por exemplo **First Name** e **Last Name**. Os campos do Emarsys aparecem pelo nome.
5. Em **Filtrar por consentimentos (opcional)**, escolha a sua caixa de consentimento de marketing.
6. Clique em **Guardar** e depois em **Testar**.

## Mapeamento de campos

- Associe o endereço de e-mail você mesmo. O Emarsys usa-o para encontrar contactos existentes, por isso um contacto sem ele não pode ser associado.
- Só são enviados os campos que associar.
- Alguns campos de sistema do Emarsys, como o opt-in, a data de registo e a newsletter, não são oferecidos, porque é o próprio Emarsys que os define.

## Consentimento

O Scratcher define o campo de opt-in do contacto no Emarsys como "true" para todas as pessoas que envia. Por isso, use sempre **Filtrar por consentimentos (opcional)** com a sua caixa de consentimento de marketing, se ela for opcional no seu formulário.

## O que é enviado e quando

Os novos registos são enviados em um ou dois minutos, e os leads existentes da campanha são enviados quando ativa a integração. Se o contacto já existir, é atualizado e adicionado à lista.

## Resolução de problemas

- "Alguns ou todos os campos são inválidos..." ao instalar: o client ID ou o secret estão errados, ou as credenciais não usam OpenID Connect.
- As entregas falham, ou os menus pendentes de listas ou de campos estão vazios: falta às credenciais uma das quatro permissões. Edite-as no Emarsys.
- Os contactos são criados em duplicado: "Lead - E-mail" não está associado ao campo **Email**.

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.
