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

# Mailchimp

> Adicione o Mailchimp ao seu projeto no Macaly

O Mailchimp permite coletar assinantes de e-mail, enviar newsletters e rodar campanhas de e-mail automatizadas. Se você quer montar e cultivar uma lista de contatos a partir do seu site no Macaly, o Mailchimp é uma das formas mais populares de fazer isso.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

<Note>
  **Você realmente precisa do Mailchimp?** O Macaly tem um [banco de dados integrado](/docs/pt-BR/features/databases) e notificações por e-mail. Se você só precisa de um formulário de contato ou de uma lista de espera, não precisa de uma ferramenta externa. O Mailchimp vale a pena quando você precisa de newsletters, sequências de e-mails ou segmentação de público.
</Note>

## Por que usar o Mailchimp

* **Aumente sua lista a partir do site.** Colete assinantes e gerencie todos em um só lugar. Segmente por interesses, origem do cadastro ou comportamento.
* **Envie newsletters sem mexer em código.** Crie e envie campanhas de e-mail para o seu público. Você pode agendá-las ou enviar na hora.
* **Automatize seus acompanhamentos.** Configure e-mails de boas-vindas, sequências de e-mails e lembretes de carrinho abandonado que funcionam sozinhos.
* **Veja o que realmente funciona.** Acompanhe taxas de abertura, taxas de clique e quais links geram mais engajamento.

## O que você precisa

Antes de começar, confira se você tem:

* Uma **conta no Mailchimp**. Crie uma gratuitamente em [mailchimp.com](https://mailchimp.com)
* Um **público (audience) do Mailchimp**, ou seja, uma lista de contatos para receber os assinantes

Há duas formas de conectar o Mailchimp ao seu site:

* **Formulário de cadastro incorporado.** Cole no seu site o código do formulário gerado pelo Mailchimp. Ideal para uma coleta de e-mails simples.
* **API do Mailchimp.** Conecte seus formulários à API do Mailchimp para ter controle total sobre os dados enviados. Ideal quando você quer formulários próprios que combinem com o seu design.

## Opção 1: formulário de cadastro incorporado

A forma mais simples. O Mailchimp gera um formulário que você coloca no seu site.

<Steps>
  <Step title="Pegue o código de incorporação do formulário">
    No Mailchimp, acesse **Audience**, depois **Signup forms** e **Embedded forms**. Personalize os campos que quiser e copie o código HTML gerado.
  </Step>

  <Step title="Peça ao agente para adicioná-lo">
    Abra o chat no seu projeto do Macaly e peça:

    ```
    Adicione este formulário de cadastro do Mailchimp ao meu site. Aqui está o código de incorporação:

    [cole aqui o seu código de incorporação do Mailchimp]
    ```
  </Step>

  <Step title="O agente posiciona o formulário">
    O agente adiciona o formulário ao seu projeto. Você pode dizer exatamente onde quer que ele fique, como no rodapé, em uma página própria ou em um pop-up.
  </Step>
</Steps>

<Tip>
  Se quiser que o formulário combine com o design do seu site, diga ao agente: *"Estilize o formulário do Mailchimp para combinar com o resto do meu site."*
</Tip>

## Opção 2: formulário personalizado com a API do Mailchimp

Para ter mais controle, o agente pode criar um formulário personalizado que envia os assinantes ao Mailchimp pela API.

<Steps>
  <Step title="Adicione suas credenciais do Mailchimp em Segredos">
    No seu projeto do Macaly, acesse **Configurações** e depois **Segredos**. Adicione dois segredos:

    * `MAILCHIMP_API_KEY`: sua chave de API do Mailchimp
    * `MAILCHIMP_AUDIENCE_ID`: o público ao qual você quer adicionar os assinantes

    <Accordion title="Como encontrar sua chave de API e o ID do público">
      **Chave de API:**

      1. No Mailchimp, clique no ícone do seu perfil e depois em **Account & billing**
      2. Acesse **Extras** e depois **API keys**
      3. Clique em **Create a key** e copie a chave

      **ID do público (Audience ID):**

      1. Acesse **Audience** e depois **All contacts**
      2. Clique em **Settings** e depois em **Audience name and defaults**
      3. O **Audience ID** aparece nesta página
    </Accordion>
  </Step>

  <Step title="Peça ao agente para criar o formulário">
    Abra o chat e peça:

    ```
    Crie no rodapé um formulário de cadastro na newsletter. Quando alguém se inscrever,
    adicione a pessoa ao meu público do Mailchimp usando a API.
    Já adicionei minha chave de API e o ID do público em Segredos.
    ```
  </Step>
</Steps>

<Warning>
  Nunca cole chaves de API diretamente no chat. Use sempre **Configurações** e depois **Segredos** para guardar credenciais sensíveis. O agente consegue lê-las de lá com segurança.
</Warning>

## Verifique se está funcionando

<Steps>
  <Step title="Faça um cadastro de teste">
    Acesse seu site e digite um e-mail de teste no formulário de cadastro.
  </Step>

  <Step title="Confira seu público no Mailchimp">
    No Mailchimp, acesse **Audience** e depois **All contacts**. Seu e-mail de teste deve aparecer como um novo assinante.
  </Step>
</Steps>

## Bom saber

* Se você só precisa coletar e-mails, o [banco de dados integrado](/docs/pt-BR/features/databases) do Macaly é mais simples e não exige uma conta externa
* Para estar em conformidade com o GDPR, ative o **double opt-in** nas configurações do seu público no Mailchimp. Assim, um e-mail de confirmação é enviado antes de a pessoa entrar na sua lista
* O agente também pode configurar formulários em pop-up e do tipo slide-in, se você quiser algo mais chamativo que um cadastro embutido na página


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.