O guia do Mokapen

MailChimp

Ligue o MailChimp aos contatos da sua organização Mokapen. Importe subscritores das suas audiences, mantenha CRM e listas de marketing alinhados, ou exporte para o MailChimp os contatos criados no Mokapen — para cada audience com regras, filtros e mapeamento de campos dedicados.

Visão geral: Integrações.

Requisitos

• Conta MailChimp com pelo menos uma audience (lista) criada.
• Permissão para autorizar o Mokapen via login MailChimp (OAuth).
• Plano Mokapen Premium 3 para ligar e sincronizar.
• A primeira ligação da conta MailChimp é normalmente iniciada pelo Proprietário da organização (botão visível apenas para quem tem essa função).
• Permissões Mokapen sobre contatos na org (consulte Funções e permissões).

Ligar a conta MailChimp

Ao contrário do MailerLite (API key), o MailChimp usa acesso com conta MailChimp no site do fornecedor.

1. Menu do usuário → Integrações → MailChimp.
2. O Proprietário org prime Sincronizar MailChimp (Premium 3).
3. Inicie sessão com a conta MailChimp desejada (pode ser diferente do e-mail Mokapen).
4. Aceite as permissões solicitadas pelo Mokapen.
5. Volte ao Mokapen: aparece Conta ligada com o e-mail MailChimp e quem criou a ligação.

Se não aceitar, nenhuma audience será sincronizada. A página permanecerá sem listas ligadas.

Após o login da conta, configure a direção de sync ao nível org, depois ligue uma ou mais audiences (ver abaixo). O MailChimp não usa uma única sync global como o MailerLite: cada lista tem configurações próprias.

O que o Mokapen solicita ao MailChimp

Acesso OAuth à sua conta MailChimp para ler audiences, subscritores, grupos e merge fields, e para criar ou atualizar subscritores quando a direção de sync o permitir. O Mokapen não substitui o painel MailChimp para criar campanhas de email — esta página é para a lista de subscritores alinhada com o CRM.

Se revogar o Mokapen no painel MailChimp ou a sessão expirar → desligue e volte a ligar no Mokapen.

Configurações de conta (toda a integração)

Direção da sincronização

• Apenas para Mokapen — MailChimp → CRM.
• Ambas — importação e exportação entre audiences ligadas e Mokapen.
• Apenas para MailChimp — CRM → MailChimp.

Exportação de contatos (Proprietário)

Com sync bidirecional, o Proprietário org (Premium 3) pode marcar a opção que ativa a exportação explícita de contatos Mokapen para o MailChimp além da importação das audiences. Sem Proprietário ou plano adequado, a caixa permanece desativada.

Isto não substitui os filtros de exportação por lista (tipo, tags, GDPR): define apenas se, em modo bidirecional, o Mokapen também pode enviar contatos do CRM para o MailChimp. Os filtros por audience permanecem no bloco de cada lista ligada.

Compartilhar sync

Quem ligou a conta pode permitir que outros membros usem o mesmo login MailChimp (org inteira ou usuários selecionados). Não é necessário repetir OAuth para cada colega, mas cada audience deve ser configurada.

Ligar audiences (listas)

O MailChimp organiza subscritores em audiences. No Mokapen cada audience ligada tem um bloco de configurações separado.

1. Com conta já ligada, prima Ligar lista MailChimp (ou equivalente «Connect list»).
2. Escolha a audience no menu (listas já sincronizadas estão desativadas).
3. Configure filtros, mapeamento de campos, duplicados e sync automática para essa lista.
4. Marque a autorização de dados, depois Salvar / Sincronizar.
5. Repita para cada audience que quiser alinhar com o CRM.

Se não tiver audiences no MailChimp, crie pelo menos uma no painel MailChimp antes de ligar.

Filtros de importação do MailChimp (por lista)

Para cada audience ligada, visível com sync para Mokapen ou bidirecional. Define quais subscritores do MailChimp entram no CRM para essa lista — não a conta MailChimp inteira, apenas a audience escolhida.

Todos os subscritores — importa qualquer pessoa na audience, incluindo estados não ativos se presentes. Use com precaução em listas históricas grandes.

Subscritores ativos — limita aos subscritores ativos (recomendado na maioria dos casos): evita encher o CRM de desinscritos ou endereços já inválidos.

Grupo — segmento ou grupo interno da audience MailChimp: importa apenas quem pertence a esse subconjunto (p. ex. «Clientes VIP» ou «Webinar março»). Útil se a mesma audience contém segmentos diferentes e no Mokapen só precisa de um.

Ao modificar os filtros aparece um aviso: após a alteração convém relançar a sync nessa audience.

Filtros de exportação para MailChimp (por lista)

Visível com sync para MailChimp ou bidirecional, dentro do bloco de cada audience ligada. Os filtros valem apenas para essa lista: audiences diferentes podem ter regras de exportação diferentes.

Definem quais contatos Mokapen podem sair para essa audience MailChimp — não só no primeiro «Sincronizar», mas também sempre que criar ou modificar um contato no CRM (se a exportação estiver ativa e a direção sync o permitir).

Na prática: guarda um contato no Mokapen → o Mokapen verifica se cumpre o tipo, as tags e os consentimentos de privacidade definidos para essa audience → só se passar todos os filtros, cria ou atualiza o registro no MailChimp nessa lista. Um contato fora da norma fica no Mokapen mas não é enviado (e não aparece na pré-visualização de exportação dessa audience). Se alterar os filtros após já ter sincronizado, relance a sync na lista: contatos que deixem de corresponder podem deixar de ser atualizados nessa audience.

Tipo e Tipo 2 — restringem a exportação a categorias de contato do CRM (p. ex. apenas «Cliente»). Combináveis com tags e privacidade abaixo.

Tags — uma ou mais tags de contato: exporta apenas quem as tem. Exemplo: audience «Newsletter B2B» com tag «B2B» na exportação → só esses contatos acabam lá.

Permissões de privacidade / GDPR — caixas com os consentimentos configurados na sua org (newsletter, tratamento de dados, marketing, etc.). Marque apenas os que devem estar já registrados no contato para que a inscrição no MailChimp seja lícita e conforme com o GDPR.

Exemplo: na audience «Newsletter» marca apenas «Consentimento newsletter» → o Mokapen envia para essa lista apenas contatos com esse consentimento na ficha. Um lead sem consentimento fica no CRM mas não acaba no MailChimp, mesmo com email e tags corretos. Configure este filtro antes de ativar a sync automática para a audience — especialmente se o Proprietário tiver ativado a exportação bidirecional.

O contador e a pré-visualização no bloco de lista mostram quantos contatos correspondem aos filtros agora, antes de sincronizar. Verifique que não está prestes a exportar milhares de fichas por engano ou que os filtros não estão demasiado restritivos (zero contatos na pré-visualização).

Lembre-se: a caixa Exportação de contatos (Proprietário) ao nível da conta também é necessária se usar sync bidirecional com exportação explícita do Mokapen para o MailChimp — caso contrário, a exportação fica limitada pela direção sync escolhida no topo da página.

Mapeamento de campos (por lista)

Ligue os merge fields MailChimp da audience às colunas Mokapen. O e-mail permanece no campo e-mail do contato e é fixo. Cada coluna Mokapen uma só vez por lista. Audiences diferentes podem ter mapeamentos diferentes se os merge fields não coincidirem.

Duplicados e conflitos (por lista)

Quando o mesmo e-mail existe no MailChimp (audience ligada) e no Mokapen, o Mokapen decide se cria, une ou atualiza. Ao contrário do MailerLite, aqui a comparação de e-mail pode ser desativada — faça-o apenas se compreender o risco de duplicados na sua agenda.

Comparação de e-mail — ativa por predefinição. Antes de criar um contato a partir do MailChimp, o Mokapen procura na org um contato com o mesmo e-mail: se encontrar, não cria um segundo mas atualiza o existente (de acordo com as regras de conflito). Recomenda-se manter ativo, especialmente se ligar várias audiences com subscritores que se sobrepõem.

Gestão de conflitos — se mesmo e-mail mas nome, telefone ou outros campos mapeados não coincidem, escolha quem «ganha» para essa audience:

• MailChimp — em discrepância, os valores do MailChimp sobrescrevem o Mokapen na sync.
• Mokapen — prevalece o CRM; o MailChimp é atualizado quando a direção sync e os filtros de exportação o permitem.

Recomendação: importação inicial de uma audience de marketing → o MailChimp prevalece frequentemente nos campos demográficos; se o CRM é a fonte de verdade comercial, escolha Mokapen. Teste numa amostra antes da sync automática em listas grandes.

Sync automática ou manual (por lista)

Decide quando o Mokapen alinha essa audience, não o quê (direção da conta + filtros por lista). Cada audience ligada pode ser automática ou manual independentemente das outras.

Sync automática — o Mokapen propaga as alterações em segundo plano para essa lista: um novo subscritor no MailChimp pode aparecer no CRM, uma modificação de contato no Mokapen (se passar os filtros de exportação dessa audience) pode atualizar o MailChimp sem premir o botão de cada vez.

Sync manual — sem atualizações nessa audience enquanto não premir Sincronizar no bloco de lista. Útil na configuração (verificação de mapeamento e filtros GDPR), após alterações de consentimentos, ou se quiser aprovar cada lote antes de sair para o MailChimp.

Pode alterar o modo com Salvar sem apagar dados já sincronizados nessa audience.

Visibilidade (por lista)

Diz respeito aos contatos importados dessa audience MailChimp para o Mokapen (sync para CRM ou bidirecional). Não altera quem vê o MailChimp — apenas quem, no Mokapen, pode abrir as fichas criadas pela sync dessa lista.

Todos os membros (visibilidade pública) — cada usuário da org com permissões sobre contatos vê os perfis importados dessa audience: adequado para CRM compartilhado.

Apenas membros selecionados (visibilidade privada) — limita o acesso a usuários ou equipes escolhidos no menu. Os outros na org não veem essas fichas mesmo que a sync esteja ativa. Útil para audiences restritas; combine com as funções Mokapen.

Se a org tiver regras de privacidade globais (Team Master obrigatório), algumas opções podem estar predefinidas ou bloqueadas — siga o que aparece no bloco de lista.

Remover uma única lista

No final do bloco de uma audience ligada está Remove LIST: interrompe a sync apenas para essa audience, sem desligar toda a conta MailChimp nem as outras listas. Os contatos já importados permanecem no Mokapen salvo regras de limpeza manual.

Autorização obrigatória

Como nas outras integrações de contatos, marque «Autorizo o Mokapen a criar uma cópia…» antes de Salvar e Sincronizar.

Comportamento no Mokapen

• Pode ligar várias audiences em simultâneo: mesma conta MailChimp, regras diferentes por lista.
• Um subscritor presente em duas audiences ligadas pode gerar dois contatos no Mokapen se os e-mails coincidirem mas as sync forem separadas — avalie audiences e regras anti-duplicado.
• Com exportação ativa, atualizações de contato no Mokapen (nos limites dos filtros) podem atualizar o subscritor na audience correspondente.
• Esta integração é para contatos / subscritores, não campanhas: existe «MailChimp Campaigns» como ligação separada em Integrações.

Problemas comuns

• Não vejo o botão Sincronizar — apenas o Proprietário org pode iniciar a primeira ligação de conta.
• Nenhuma lista disponível — crie uma audience no MailChimp; verifique a conta ligada correta.
• Duplicados entre audiences — mesmo e-mail em duas listas ligadas → duas fichas de contato possíveis; unifique com Duplicados ou ligue apenas uma audience.
• Exportação desativada — requer sync bidirecional + Proprietário + Premium 3 para a caixa de exportação.
• Ligação expirada — desligue a conta e volte a entrar no MailChimp.

Desligar a conta MailChimp

O botão Desligar no final da página (não «Remove LIST») fecha toda a ligação MailChimp para a org. Abre-se a janela com a seção Conservar:

• Contatos — caixa ativa (predefinição): contatos importados do MailChimp permanecem no Mokapen sem sync. Desmarcada: o Mokapen exclui da org contatos ligados a esta integração MailChimp.
• Empresas — mesma lógica para fichas de empresa ligadas à sync.

Desligar a conta não exclui automaticamente subscritores no MailChimp. Revogue também o Mokapen no painel MailChimp se já não usar a integração.

Para desvincular apenas uma audience use Remove LIST no bloco dessa lista, sem desligar toda a conta.

Escreva a palavra de confirmação e confirme Desligar. Operações com muitos contatos podem demorar minutos.

Saiba mais: guia Contatos.