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.
- No Mapp Engage, acesse Administration > System Users.
- Crie um novo usuário de sistema e dê a ele um nome, por exemplo, “Scratcher”.
- Atribua ao usuário a função de API (acesso à API), com as permissões abaixo.
- 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
- No Scratcher, acesse Configurações > Integrações e clique em Mapp.
- Cole o endereço da API, o nome de usuário e a senha nos campos correspondentes.
- Clique em Instalar integração. O Scratcher verifica se consegue ler seus grupos.
Passo 3: ative na campanha
- No editor, acesse Conectar > Integrações > Mapp e clique em Ativar.
- Se você conectou mais de uma conta, escolha a desejada em Selecionar conta.
- Em Lista externa, escolha o grupo do Mapp.
- 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.
- Em Filtrar por permissões (opcional), escolha sua caixa de seleção de consentimento de marketing.
- 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.