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

# Configuração do Mailchimp

> Guia passo a passo para configurar o Mailchimp (anteriormente Mandrill) com OneSignal para entrega de email transacional. Inclui configuração de domínio, configuração de chave API, teste de email e gerenciamento de assinantes.

<Warning>
  Este guia é para usuários que já têm uma conta Mailchimp e querem integrá-la com OneSignal. Se você não tem uma conta Mailchimp, considere usar [Email OneSignal](./email-setup) em vez disso.
</Warning>

## Requisitos

* [Conta Mailchimp](https://www.mailchimp.com)
* [Plano de Email Transacional Mailchimp (anteriormente Mandrill)](https://mailchimp.com/help/add-or-remove-transactional-email/)
* [Conta OneSignal](https://onesignal.com)
* Acesso ao seu domínio e provedor de DNS

***

## Configuração

### 1. Configure seu domínio para email

Vá para a [página de Domínios de Email Transacional do Mailchimp](https://mandrillapp.com/settings/sending-domains) e adicione seu domínio se ainda não foi adicionado.

<Frame caption="Adicionar domínio">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5a4f614-esp-mandrill-domain.jpg?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=3c39403028ceab636638ed20ce6394d4" width="2500" height="1030" data-path="images/docs/5a4f614-esp-mandrill-domain.jpg" />
</Frame>

Após adicionar seu domínio:

* Clique em **View DKIM/SPF Setup Instructions** para obter seus registros DNS.
* Opcionalmente verifique a propriedade via email em **View details**.

<Frame caption="Ver Instruções de Configuração DKIM/SPF">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/208fa77-esp-mandrill-domain-2.jpg?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=5389f9723d5aa450d1623a933617e78a" width="2500" height="830" data-path="images/docs/208fa77-esp-mandrill-domain-2.jpg" />
</Frame>

Atualize seus registros DNS com seu provedor de DNS. Siga o [guia de configuração do Mailchimp](https://mailchimp.com/developer/transactional/docs/authentication-delivery/#configure-your-dns) se necessário.

O Mailchimp pode levar até 48 horas para verificar seu domínio. Você receberá um email de confirmação assim que concluído.

***

### 2. Criar Chave API

Nas [Configurações de Email Transacional](https://mandrillapp.com/settings), clique em **+ New API Key**.

<Frame caption="Criar Chave API">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/34f8ee5-esp-mandrill-apikey.jpg?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=c6e1729e222e76863a355a419223eabc" width="2500" height="1210" data-path="images/docs/34f8ee5-esp-mandrill-apikey.jpg" />
</Frame>

Você pode nomeá-la como `OneSignal API Key`.

<Frame caption="Nomear a Chave API">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/635e416-esp-mandrill-apikey-2.jpg?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=a42b769f287aba8e49fcee5f8a05103e" width="2500" height="1210" data-path="images/docs/635e416-esp-mandrill-apikey-2.jpg" />
</Frame>

Uma vez criada:

* Copie a chave API com segurança
* Anote seu **SMTP Username**

<Frame caption="Copiar a chave API e o Nome de Usuário SMTP">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c630834-esp-mandrill-apikey-3.jpg?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=2064667fc2226e93ef3975cd23a3a404" width="2500" height="1340" data-path="images/docs/c630834-esp-mandrill-apikey-3.jpg" />
</Frame>

<Warning>
  Trate sua chave API como uma senha — mantenha-a segura e nunca a compartilhe.
</Warning>

#### Permissões Recomendadas de Chave API

Habilite as seguintes permissões para garantir compatibilidade com OneSignal:

<Frame caption="Permissões de Chave API">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/73b2f9f-5bc4cf3-Mandrill.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=15c97adef93b1485366a2559fd3bd762" width="772" height="1185" data-path="images/docs/73b2f9f-5bc4cf3-Mandrill.png" />
</Frame>

***

### 3. Habilitar mensagens de email no OneSignal

1. No painel do OneSignal, vá para **Settings > Platforms > Email**.

<Frame caption="Habilitar Mensagens de Email">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/02aa869-Screen_Shot_2020-10-22_at_4.24.33_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=36b376df2149cb8b3cbf8e9c91141dba" width="1106" height="283" data-path="images/docs/02aa869-Screen_Shot_2020-10-22_at_4.24.33_PM.png" />
</Frame>

2. Selecione **Mailchimp** como seu provedor e insira a chave API e o nome de usuário SMTP.

<Frame caption="Selecionar Mailchimp e inserir credenciais">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c033759-mailchimp.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=fac5599a343ea954012ff4aa64b5eaa8" width="1549" height="651" data-path="images/docs/c033759-mailchimp.png" />
</Frame>

<Frame caption="Configurar configurações de email do Mailchimp">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/8bad403-mailchimp_configure.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=915a7960852f0c28dc9063fd0b461766" width="1548" height="668" data-path="images/docs/8bad403-mailchimp_configure.png" />
</Frame>

3. Defina seu **nome de remetente padrão** e **endereço de email**.

<Frame caption="Configurar informações padrão do remetente">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/386301e-mailchimp_additional_settings.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=ef2289538cbe81374271ffc84610104f" width="1548" height="601" data-path="images/docs/386301e-mailchimp_additional_settings.png" />
</Frame>

***

### 4. Enviar um email de teste

Vá para **OneSignal > Messages > Email** e clique em **New Email**.

* Adicione uma linha de assunto
* Clique em **Send Test Email**
* Insira seu endereço de email e clique em **Send Test Message**

<Frame caption="Enviar Email de Teste">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=5d3969be38e8e9caea691fdb094a54c7" width="1806" height="598" data-path="images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png" />
</Frame>

Você deve receber seu email de teste em breve.

<Info>
  Tendo problemas? Consulte o [FAQ de Email](./email-troubleshooting) ou envie email para `support@onesignal.com`.

  Para assistência mais rápida, inclua:

  * Seu OneSignal App ID
  * Descrição detalhada do problema, logs e capturas de tela
  * Passos para reproduzir
</Info>

***

## Opcional: Gerar chave API do Painel do Mailchimp

Se você está gerando uma chave API do painel principal da conta Mailchimp:

1. Clique em seu avatar no canto superior direito.

<Frame caption="Abrir menu de perfil">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/8f26003-step-1-50.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=639dec38e9f52f847410e268e6c7c87b" width="1616" height="1365" data-path="images/docs/8f26003-step-1-50.png" />
</Frame>

2. Vá para **Account & Billing**.

<Frame caption="Navegar até Account & Billing">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b99a7d1-step-2-50.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=71ff7d282c3218d0b4d357d449f54516" width="1616" height="1365" data-path="images/docs/b99a7d1-step-2-50.png" />
</Frame>

3. Clique em **Extras > API Keys**.

<Frame caption="Acessar seção de Chaves API">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/efb165b-step-3-50.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=a3eaef5b5c0324d33c17f1a5cb276f7b" width="1616" height="1365" data-path="images/docs/efb165b-step-3-50.png" />
</Frame>

4. Clique em **Create A Key**.

<Frame caption="Criar uma nova chave API">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/49c865f-step-4-50.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=71142924179b022dec01acf3e9596b4f" width="1616" height="1365" data-path="images/docs/49c865f-step-4-50.png" />
</Frame>

5. Nomeie sua chave e clique em **Generate Key**.

<Frame caption="Gerar chave">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/09a6003-step-5-50.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=18bbd9d72dfe14424a7b121cfabfba28" width="1616" height="1365" data-path="images/docs/09a6003-step-5-50.png" />
</Frame>

6. Copie a chave API com segurança.

<Frame caption="Copiar chave para a área de transferência">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/ca6d67b-step-6-50.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=515a654329b0f92030b88c3c0fd99a3e" width="1616" height="1365" data-path="images/docs/ca6d67b-step-6-50.png" />
</Frame>

***

<Check>
  ✅ Configuração de email concluída!

  **Próximos passos:**

  * Retorne ao [guia de Configuração de Email](./email-setup) para explorar mais recursos de Email do OneSignal.
</Check>

***