> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhalivre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração Mailchimp

> Configure o Mailchimp e acompanhe o funcionamento da conexão com o SenhaLivre.

## Conectando via OAuth

Para conectar sua conta do Mailchimp ao SenhaLivre:

1. Acesse **Configurações > Integrações** no menu lateral.
2. Clique no botão **Conectar Mailchimp**.
3. Faça login na sua conta Mailchimp com permissões de administrador.
4. Autorize o SenhaLivre a acessar seus recursos por meio do OAuth.
5. Ao finalizar, a integração aparecerá como **Ativa** no painel.

<Warning>
  É necessário ter permissões de administrador na conta do Mailchimp para conectar a integração.
</Warning>

## Ativando ou Desativando a Integração

### Pausar Temporariamente

* Use o botão de alternância ao lado do Mailchimp para pausar a sincronização.
* Campanhas continuam disponíveis, mas nenhuma informação nova será enviada enquanto estiver desligada.
* Útil para manutenções ou ajustes temporários.

### Reativar

* Reative quando necessário clicando no botão de alternância novamente.
* Confirme se as credenciais ainda são válidas.
* Se houver problemas, pode ser necessário reconectar.

## Escolhendo a Audiência

### Configuração Padrão

* Defina a audiência padrão nas configurações da integração.
* Esta será a audiência usada quando não especificada nas campanhas.

### Sobrescrever por Campanha

* Em cada campanha você pode sobrescrever a audiência ao configurar a ação **Enviar para Mailchimp**.
* Isso permite direcionar contatos para diferentes audiências baseado no contexto da campanha.

### Requisitos

* Certifique-se de que a audiência selecionada permite a criação ou atualização de contatos via API.
* Verifique as permissões da sua conta Mailchimp.

## Campos Enviados Automaticamente

Por padrão, o SenhaLivre envia os seguintes campos para o Mailchimp:

* **Nome** — Nome completo do visitante
* **E-mail** — Endereço de e-mail (obrigatório)
* **Telefone** — Quando coletado no formulário
* **Tags** — Tags configuradas no fluxo da campanha
* **Data** — Data e hora do cadastro
* **Origem** — Nome da campanha que originou o cadastro

### Campos Personalizados

* Inclua campos personalizados no formulário da campanha.
* Mapeie-os durante a configuração da ação de envio.
* Os campos personalizados serão enviados como campos de merge no Mailchimp.

## Como os Visitantes são Sincronizados

### Sincronização Automática

* **Nodes automáticos** — Quando o visitante passa por uma ação de envio, os dados são transmitidos imediatamente para o Mailchimp.
* A sincronização acontece em tempo real durante o fluxo da campanha.

### Sincronização Manual

* Use a ação em massa **Enviar para integração** na lista de visitantes.
* Útil para reenviar contatos específicos ou sincronizar dados antigos.
* Selecione múltiplos visitantes e escolha a ação em massa.

### Acompanhamento

* Acompanhe o status das sincronizações no histórico da campanha.
* Verifique erros ou pendências no painel de integrações.
* Logs detalhados ajudam a identificar problemas de sincronização.

## Configurando Tags do Mailchimp

### Tags Automáticas

* Tags configuradas no fluxo da campanha são automaticamente enviadas ao Mailchimp.
* Use tags para segmentar seus contatos no Mailchimp.

### Tags Adicionais

* Você pode configurar tags adicionais na ação "Enviar para Mailchimp".
* Essas tags serão aplicadas além das tags do fluxo.

## Solução de Problemas

### Integração não conecta

* Verifique se você tem permissões de administrador no Mailchimp.
* Tente desconectar e reconectar a integração.
* Limpe o cache do navegador e tente novamente.

### Dados não sincronizam

* Verifique se a integração está ativa.
* Confirme se o campo de e-mail está preenchido.
* Verifique os logs de erro no painel de integrações.

### Campos não aparecem no Mailchimp

* Certifique-se de que os campos estão mapeados corretamente.
* Verifique se os campos existem na audiência do Mailchimp.
* Alguns campos podem precisar ser criados manualmente no Mailchimp.

<Tip>
  Teste a integração com um cadastro de teste antes de usar em produção para garantir que tudo está funcionando corretamente.
</Tip>