> ## 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

> Adiciona o Mailchimp ao teu projeto Macaly

O Mailchimp permite-te recolher subscritores de email, enviar newsletters e gerir campanhas de email automatizadas. Se queres criar e desenvolver uma lista de emails a partir do teu site Macaly, o Mailchimp é uma das formas mais populares de o fazer.

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

<Note>
  **Precisas mesmo do Mailchimp?** O Macaly tem uma [base de dados integrada](/docs/pt/features/databases) e notificações por email. Se só precisares de um formulário de contacto ou de uma lista de espera, não precisas de uma ferramenta externa. O Mailchimp vale a pena quando precisas de newsletters, sequências automatizadas ou segmentação de audiência.
</Note>

## Porquê usar o Mailchimp

* **Faz crescer a tua lista a partir do teu site.** Recolhe subscritores e gere-os num só lugar. Segmenta por interesses, origem da subscrição ou comportamento.
* **Envia newsletters sem tocar em código.** Cria e envia campanhas de email para a tua audiência. Agenda-as ou envia-as de imediato.
* **Automatiza os teus seguimentos.** Configura emails de boas-vindas, sequências automatizadas e lembretes de carrinho abandonado que funcionam sozinhos.
* **Vê o que realmente resulta.** Acompanha taxas de abertura, taxas de cliques e quais os links com mais interação.

## O que precisas

Antes de começares, garante que tens:

* Uma **conta Mailchimp**. Cria uma gratuitamente em [mailchimp.com](https://mailchimp.com)
* Uma **audiência Mailchimp** (lista de emails) para recolher subscritores

Há duas formas de ligar o Mailchimp ao teu site:

* **Formulário de subscrição incorporado.** Cola no teu site o código do formulário gerado pelo Mailchimp. Ideal para uma recolha simples de emails.
* **API do Mailchimp.** Liga os teus formulários à API do Mailchimp para teres controlo total sobre os dados que envias. Ideal quando queres formulários personalizados que combinem com o teu design.

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

A abordagem mais simples. O Mailchimp gera um formulário que podes incorporar no teu site.

<Steps>
  <Step title="Obtém o código de incorporação do formulário">
    No Mailchimp, vai a **Audience** e depois a **Signup forms** e depois a **Embedded forms**. Personaliza os campos que quiseres e copia o código HTML gerado.
  </Step>

  <Step title="Pede ao agente para o adicionar">
    Abre o chat no teu projeto Macaly e pede:

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

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

  <Step title="O agente posiciona o formulário">
    O agente adiciona o formulário ao teu projeto. Podes dizer-lhe exatamente onde o queres: rodapé, página dedicada ou um popup.
  </Step>
</Steps>

<Tip>
  Se quiseres que o formulário combine com o design do teu site, diz ao agente: *"Adapta o estilo do formulário do Mailchimp ao resto do meu site."*
</Tip>

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

Para mais controlo, o agente pode criar um formulário personalizado que envia subscritores para o Mailchimp através da respetiva API.

<Steps>
  <Step title="Adiciona as tuas credenciais do Mailchimp aos Segredos">
    Vai a **Definições** e depois a **Segredos** no teu projeto Macaly. Adiciona dois segredos:

    * `MAILCHIMP_API_KEY`, a tua chave API do Mailchimp
    * `MAILCHIMP_AUDIENCE_ID`, a audiência à qual queres adicionar subscritores

    <Accordion title="Como encontrar a tua chave API e o ID da audiência">
      **Chave API:**

      1. No Mailchimp, clica no ícone do teu perfil e depois em **Account & billing**
      2. Vai a **Extras** e depois a **API keys**
      3. Clica em **Create a key** e copia-a

      **ID da audiência:**

      1. Vai a **Audience** e depois a **All contacts**
      2. Clica em **Settings** e depois em **Audience name and defaults**
      3. O teu **Audience ID** está indicado nesta página
    </Accordion>
  </Step>

  <Step title="Pede ao agente para criar o formulário">
    Abre o chat e pede:

    ```
    Cria um formulário de subscrição da newsletter no rodapé. Quando
    alguém se subscrever, adiciona-o à minha audiência do Mailchimp
    usando a API. Já adicionei a minha chave API e o ID da audiência
    aos Segredos.
    ```
  </Step>
</Steps>

<Warning>
  Nunca coles chaves API diretamente no chat. Usa sempre **Definições** e depois **Segredos** para guardar credenciais sensíveis. O agente consegue lê-las a partir daí em segurança.
</Warning>

## Verifica que está a funcionar

<Steps>
  <Step title="Envia uma subscrição de teste">
    Visita o teu site e introduz um endereço de email de teste no formulário de subscrição.
  </Step>

  <Step title="Verifica a tua audiência Mailchimp">
    Vai a **Audience** e depois a **All contacts** no Mailchimp. O teu email de teste deve aparecer como um novo subscritor.
  </Step>
</Steps>

## Bom saber

* Se só precisares de recolher emails, a [base de dados integrada](/docs/pt/features/databases) do Macaly é mais simples e não requer uma conta externa
* Para conformidade com o RGPD, ativa o **double opt-in** nas definições da tua audiência Mailchimp. Isto envia um email de confirmação antes de adicionar alguém à tua lista
* O agente também consegue configurar formulários pop-up e formulários deslizantes se quiseres algo mais evidente do que uma subscrição em linha


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