---
title: "Ligue o Mapp"
description: "Crie um utilizador de API no Mapp Engage, ligue-o e adicione os novos registos como contactos a um grupo do Mapp."
url: https://scratcher.io/pt/help/integrations/mapp
language: pt
---

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

# Ligue o Mapp

Crie um utilizador de API no Mapp Engage, ligue-o e adicione os novos registos como contactos a um grupo do Mapp.

Com a integração do Mapp, todas as pessoas que se registam são criadas ou atualizadas como contacto no Mapp Engage e adicionadas ao grupo (lista) que escolher.

## O que precisa

- Uma conta do Mapp Engage e um utilizador que possa criar utilizadores de sistema (normalmente um administrador).
- O endereço da API do seu Mapp Engage. É o endereço do seu sistema Mapp Engage com o caminho da API, e encontra-o na documentação da API do Mapp para o seu sistema, ou perguntando ao suporte do Mapp.

## Passo 1: criar um utilizador de API no Mapp Engage

O Mapp Engage usa um utilizador separado para a API, com nome de utilizador e palavra-passe.

1. No Mapp Engage, vá a **Administration** > **System Users**.
2. Crie um novo utilizador de sistema e dê-lhe um nome, por exemplo "Scratcher".
3. Dê ao utilizador a função de API (acesso à API), com os direitos indicados abaixo.
4. Defina uma palavra-passe forte e guarde. Copie o nome de utilizador e a palavra-passe.

## Direitos de que o utilizador de API precisa

O Scratcher usa o utilizador para:

- ler os seus grupos, para que possa escolher um na campanha;
- ler os seus atributos de contacto, para lhes poder associar campos;
- criar e atualizar contactos;
- adicionar contactos a grupos (subscrevê-los).

O utilizador não precisa de acesso a mensagens, relatórios nem a mais nada.

## Passo 2: ligar o Mapp ao Scratcher

1. No Scratcher, vá a **Definições** > **Integrações** e clique em **Mapp**.
2. Cole o endereço da API, o nome de utilizador e a palavra-passe nos campos correspondentes.
3. Clique em **Instalar integração**. O Scratcher verifica se consegue ler os seus grupos.

## Passo 3: ativar numa campanha

1. No editor, vá a **Ligar** > **Integrações** > **Mapp** e clique em **Ativar**.
2. Se tiver ligado mais do que uma conta, escolha-a em **Selecionar conta**.
3. Em **Lista externa**, escolha o grupo do Mapp.
4. Em **Mapeamentos de campos**, clique em **Adicionar mapeamento de campos** e associe cada **Campo do Scratcher** a um atributo do Mapp, por exemplo "Lead - Nome próprio" a **FirstName**.
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

- O endereço de e-mail é sempre enviado e identifica o contacto. Não precisa de o associar.
- A lista **Campo de destino** mostra os atributos padrão e personalizados do seu sistema Mapp. Crie primeiro os atributos personalizados no Mapp.
- Nos números de telemóvel, use a definição **Formato**. O Mapp normalmente espera + e indicativo do país.

## Consentimento

Os contactos são subscritos no grupo que escolher. Se o grupo usar double opt-in no Mapp, o Mapp envia o seu próprio e-mail de confirmação, e as pessoas só ficam subscritas quando confirmam. Use **Filtrar por consentimentos** para que só sejam adicionadas as pessoas que assinalaram a sua caixa de marketing.

## 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 contacto é atualizado. Verifique cada entrega em **Definições** > **Integrações** > **Estado da entrega**.

## Resolução de problemas

- "Alguns ou todos os campos são inválidos..." ao instalar: verifique o endereço da API e se o utilizador de sistema tem a função de API e não está bloqueado.
- As entregas falham com um erro de acesso: falta ao utilizador de sistema um dos direitos acima.
- A palavra-passe expirou: alguns sistemas Mapp fazem as palavras-passe expirar. Defina uma nova palavra-passe no Mapp e ligue novamente com **Adicionar nova conta**.

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.
