---
title: "Conecte o Mapp"
description: "Crie um usuário de API no Mapp Engage, conecte-o e adicione os novos cadastros como contatos em um grupo do Mapp."
url: https://scratcher.io/pt-br/help/integrations/mapp
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 Mapp

# Conecte o Mapp

Crie um usuário de API no Mapp Engage, conecte-o e adicione os novos cadastros como contatos em um grupo do Mapp.

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

## O que você precisa

- Uma conta no Mapp Engage e um usuário que possa criar usuários 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 você o encontra na documentação de API do Mapp para o seu sistema ou pedindo ao suporte do Mapp.

## Passo 1: crie um usuário de API no Mapp Engage

O Mapp Engage usa um usuário separado para a API, com nome de usuário e senha.

1. No Mapp Engage, acesse **Administration** > **System Users**.
2. Crie um novo usuário de sistema e dê a ele um nome, por exemplo, “Scratcher”.
3. Atribua ao usuário a função de API (acesso à API), com as permissões abaixo.
4. Defina uma senha forte e salve. Copie o nome de usuário e a senha.

## Permissões necessárias para o usuário de API

O Scratcher usa esse usuário para:

- ler seus grupos, para que você possa escolher um na campanha;
- ler seus atributos de contato, para que você possa mapear campos para eles;
- criar e atualizar contatos;
- adicionar contatos aos grupos (inscrevê-los).

O usuário não precisa de acesso a mensagens, relatórios nem a qualquer outra coisa.

## Passo 2: conecte o Mapp ao Scratcher

1. No Scratcher, acesse **Configurações** > **Integrações** e clique em **Mapp**.
2. Cole o endereço da API, o nome de usuário e a senha nos campos correspondentes.
3. Clique em **Instalar integração**. O Scratcher verifica se consegue ler seus grupos.

## Passo 3: ative na campanha

1. No editor, acesse **Conectar** > **Integrações** > **Mapp** e clique em **Ativar**.
2. Se você conectou mais de uma conta, escolha a desejada em **Selecionar conta**.
3. Em **Lista externa**, escolha o grupo do Mapp.
4. Em **Mapeamento de campos**, clique em **Adicionar mapeamento de campo** e associe cada **Campo do Scratcher** a um atributo do Mapp, por exemplo, “Lead - Nome” a **FirstName**.
5. Em **Filtrar por permissões (opcional)**, escolha sua caixa de seleção de consentimento de marketing.
6. Clique em **Salvar** e depois em **Testar**.

## Mapeamento de campos

- O endereço de e-mail é sempre enviado e identifica o contato. Não é preciso mapeá-lo.
- A lista **Campo de destino** mostra os atributos padrão e personalizados do seu sistema Mapp. Crie primeiro os atributos personalizados no Mapp.
- Para números de celular, use a configuração **Formato**. O Mapp normalmente espera o + e o código do país.

## Consentimento

Os contatos são inscritos no grupo que você escolher. Se o grupo usar double opt-in no Mapp, o Mapp envia seu próprio e-mail de confirmação, e as pessoas só são inscritas depois de confirmar. Use **Filtrar por permissões** para que apenas quem marcou sua caixa de seleção de marketing seja adicionado.

## O que é enviado e quando

Os 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 contato é atualizado. Confira cada envio em **Configurações** > **Integrações** > **Status de entrega**.

## Solução de problemas

- “All or some of the fields are invalid...” ao instalar: verifique o endereço da API e se o usuário de sistema tem a função de API e não está bloqueado.
- Os envios falham com erro de acesso: o usuário de sistema não tem uma das permissões acima.
- A senha expirou: alguns sistemas Mapp fazem as senhas expirarem. Defina uma nova senha no Mapp e conecte novamente em **Adicionar nova conta**.

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.
