O guia do Mokapen

MailerLite

Ligue o MailerLite aos contatos da sua organização Mokapen. Importe subscritores e leads já presentes nas suas listas, mantenha os dados alinhados entre email marketing e CRM, ou exporte para o MailerLite os contatos criados no Mokapen — conforme a direção de sync, filtros e mapeamento de campos que configurar.

Visão geral: Integrações.

Requisitos

• Conta MailerLite ativa com pelo menos um subscritor ou grupo para sincronizar.
• API key MailerLite (Classic ou nova plataforma MailerLite) com permissões suficientes para ler e gerir subscritores.
• Plano Mokapen que inclua a integração de marketing (Premium 3 — ícone de medalha na página se indisponível).
• Permissões Mokapen sobre contatos na org (consulte Funções e permissões).

Ligar MailerLite

Ao contrário do Google Contacts ou MailChimp, o MailerLite liga-se com a API key, não com login OAuth no site MailerLite.

1. Menu do usuário → Integrações → MailerLite.
2. Prima Sincronizar MailerLite (requer Premium 3).
3. Abra a seção API key.
4. Obtenha a chave no painel MailerLite (link de guia na página).
5. Escolha o tipo de conta:

• MailerLite Classic — conta na versão anterior; use a API key «clássica».
• MailerLite — conta na plataforma atual; use o token API da nova interface.

Tipo errado = ligação falhada mesmo com chave válida.

6. Cole a chave no campo e prima Ligar.
7. Se a chave estiver correta, aparece Conta ligada com o e-mail da conta MailerLite e as configurações de sync.

Se a chave estiver incorreta ou expirada, o Mokapen mostra uma mensagem de erro a vermelho: corrija o tipo de conta ou gere uma nova API key no MailerLite, depois desligue e volte a ligar.

O que a API key permite

A chave autoriza o Mokapen a comunicar com o MailerLite via API: ler subscritores, grupos e campos personalizados, criar ou atualizar subscritores quando a direção de sync o permitir. Não abre uma sessão web MailerLite no seu browser — salve a chave em segurança e não a partilhe fora da equipe autorizada.

Se revogar ou regenerar a chave no MailerLite → a sync no Mokapen deixa de funcionar até introduzir a nova chave (desligue e volte a ligar).

Configurações a configurar

Direção da sincronização

• Apenas para Mokapen — MailerLite → CRM (importação de subscritores).
• Apenas para MailerLite — CRM → MailerLite (exportação de contatos).
• Ambas — alinhamento nos dois sentidos, com regras sobre duplicados e conflitos.

Ao alterar a direção, os blocos de filtros «do MailerLite» e «do Mokapen» aparecem ou desaparecem: siga o que vir na página.

Filtros de importação do MailerLite

Visível com sync para Mokapen ou bidirecional. Escolha que subscritores importar:

• Subscritores ativos — apenas subscritores ativos no MailerLite (recomendado na maioria dos casos).
• Todos os subscritores — inclui também cancelados ou estados não ativos, se existirem.
• Grupos — limita a um grupo MailerLite: «pertence a» ou «não pertence a» o grupo escolhido.
• Campos — filtra por um campo personalizado MailerLite com operadores (igual, contém, começa por, vazio, tem um valor, etc.) e valor de texto.

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

Filtros de exportação para MailerLite

Visível quando a direção de sync é para MailerLite ou ambas. Estes filtros definem quais contatos Mokapen podem sair para o MailerLite — não apenas no primeiro «Sincronizar», mas também sempre que criar ou modificar um contato no CRM.

Na prática: guarda um contato no Mokapen → o Mokapen verifica se corresponde ao tipo, tags e consentimentos de privacidade que configurou → só se passar todos os filtros é criado ou atualizado no MailerLite. Um contato fora das regras fica no Mokapen mas não é enviado (e não aparece na pré-visualização de exportação). Se alterar os filtros depois de já ter sincronizado, convém relançar a sync: os contatos que já não correspondam podem deixar de ser atualizados para o MailerLite.

Tipo e Tipo 2 — restringem a exportação às categorias do diretório CRM (ex. apenas «Cliente» ou «Lead qualificado»). Útil se pretende ter no MailerLite apenas um segmento comercial, não toda a agenda de contatos.

Tags — uma ou mais tags de contato: exporta apenas quem as tem (ex. tag «Newsletter» ou «Evento 2026»). Combinável com Tipo/Tipo 2: todos os critérios selecionados têm de ser satisfeitos.

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

Exemplo: marca apenas «Consentimento newsletter» → o Mokapen envia para o MailerLite apenas os contatos que têm esse consentimento registrado na ficha. Um lead sem consentimento de marketing fica no CRM mas não vai parar ao MailerLite, mesmo que tenha o e-mail e tags corretos. Este é o filtro mais importante para não subscrever pessoas sem base jurídica: configure-o antes de ativar a sync automática para o MailerLite.

O contador e o link de pré-visualização na página mostram quantos contatos correspondem aos filtros agora mesmo, antes de sincronizar. Use-os para verificar que não está prestes a exportar milhares de fichas por engano ou, ao contrário, que os filtros não são demasiado restritivos (pré-visualização a zero contatos).

Mapeamento de campos

Na seção Ligar campos, associe os campos MailerLite (predefinidos e personalizados) às colunas Mokapen. O e-mail principal permanece no campo e-mail do contato e é fixo.

Cada coluna Mokapen só pode ser usada uma vez. Deixe vazio um campo MailerLite se não precisar dele no CRM.

Duplicados e conflitos

Quando a mesma pessoa existe tanto no MailerLite como no Mokapen (mesmo e-mail), o Mokapen tem de decidir se funde, ignora ou atualiza. Duas opções na página:

Comparação de e-mail — sempre ativa e não desativável. Antes de criar um contato do MailerLite, 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 conflitos abaixo). Evita agendas duplicadas após a primeira importação em massa.

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

• MailerLite — em caso de discrepância, os valores do MailerLite sobrescrevem os do Mokapen na sync.
• Mokapen — prevalece o CRM; o MailerLite é atualizado com os dados Mokapen quando a direção de sync o permitir.

Conselho: na importação inicial de listas de marketing, muitas vezes é preferível que o MailerLite prevaleça nos campos do diretório; se o CRM é a fonte de verdade comercial, escolha Mokapen. Teste numa amostra antes da sync automática sobre milhares de contatos.

Sync automática ou manual

Decide quando o Mokapen realiza o alinhamento, não o que sincronizar (isso é definido pela direção e pelos filtros).

Sync automática — o Mokapen propaga as alterações em segundo plano: um novo subscritor no MailerLite pode aparecer no CRM, uma modificação de contato no Mokapen (se passar os filtros de exportação) pode atualizar o MailerLite sem premir o botão de cada vez. Cómodo para equipes que trabalham todos os dias em ambos os sistemas.

Sync manual — sem atualizações até premir Sincronizar. Útil durante a configuração (verificar mapeamento e filtros), após alterações importantes nos consentimentos de privacidade, ou se quiser aprovar cada lote antes de ir para o MailerLite.

Pode passar de manual para automática em qualquer momento com Salvar; a escolha não exclui os dados já sincronizados.

Visibilidade

Diz respeito aos contatos importados do MailerLite para o Mokapen (sync para CRM ou bidirecional). Não altera quem vê o MailerLite — apenas quem, dentro do Mokapen, pode abrir as fichas criadas por esta sync.

Todos os membros (visibilidade pública) — cada usuário da org com permissão sobre contatos vê as fichas importadas: adequado para um CRM compartilhado, com vendas e marketing na mesma base de subscritores.

Apenas membros selecionados (visibilidade privada) — limite o acesso a si mesmo e/ou aos usuários ou equipes que escolher no menu. Os outros na org não veem essas fichas mesmo que a sync esteja ativa. Útil se ligar uma lista pessoal ou um segmento reservado; combine com as funções Mokapen: um usuário sem permissão sobre contatos não as gere de qualquer forma.

Se a org já tem regras de privacidade globais (Team Master obrigatório), algumas opções podem estar pré-definidas ou bloqueadas na página — siga o que aparecer na integração.

Compartilhar sync

Com plano adequado, outros membros podem usar a sua ligação MailerLite (mesma API key) sem a voltar a introduzir. Quem criou a ligação permanece visível em Criado por.

Autorização obrigatória

Marque «Autorizo o Mokapen a criar uma cópia…» — sem essa caixa, os botões Salvar e Sincronizar permanecem desativados.

Depois prima Sincronizar. Em listas grandes a operação pode demorar vários minutos.

Comportamento no Mokapen

• A partir da lista de contatos pode relançar a sync no menu de integrações (se permitido).
• Com exportação ativa, criar ou atualizar um contato no Mokapen que respeite os filtros pode atualizar o subscritor no MailerLite.
• Os grupos MailerLite não se tornam automaticamente tags Mokapen: use tags e filtros CRM se precisar de segmentação interna.
• Esta integração sincroniza contatos / subscritores, não campanhas de email: existe uma ligação separada «MailerLite Campaigns» em Integrações.

Problemas comuns

• Erro de API key — verifique Classic vs MailerLite atual; regenere a chave no painel MailerLite.
• Nenhum subscritor importado — verifique filtros (apenas ativos, grupo errado) e direção de sync.
• Demasiados duplicados — a comparação de e-mail é fixa; use a ferramenta Duplicados após a primeira importação.
• Exportação vazia — filtros tipo/tag/privacidade demasiado restritivos; use a pré-visualização da contagem de contatos.
• Sync bloqueada — verifique a caixa de autorização; desligue e volte a ligar com chave válida.

Desligar

Prima Desligar: abre-se uma janela com a seção Conservar. Aí decide o que fazer com os dados já importados no Mokapen com esta sync.

Opções no Mokapen (caixas marcadas = conservar, predefinição):

• Contatos — se deixar a caixa ativa, os contatos importados do MailerLite permanecem no Mokapen mas deixam de sincronizar. Se a desmarcar, o Mokapen exclui da org os contatos ligados a esta integração MailerLite.
• Empresas — mesma lógica para fichas de empresa ligadas à sync (conservar ou remover do Mokapen).

Desligar não exclui automaticamente subscritores no MailerLite: permanecem na sua conta salvo se os excluir lá. O Mokapen não revoga a API key no MailerLite — revogue-a manualmente no painel MailerLite se já não a usar.

Após escolher, escreva a palavra de confirmação e confirme Desligar. Remover muitos contatos pode demorar alguns minutos.

Saiba mais: guia Contatos.