# Configuração da plataforma de e-mail

<Aside type="note">
 Observe que a configuração da plataforma é específica do projeto. Configure a plataforma de E-mail para cada projeto que você deseja usar para enviar e-mails. E-mails e domínios verificados estão disponíveis para todos os projetos em sua conta.
</Aside>

Para começar a enviar e-mails através do Pushwoosh, você precisa concluir as etapas de configuração. Essas etapas verificam sua conta, configuram os detalhes do remetente e autenticam seu domínio. Esse processo garante a entrega de e-mails segura e em conformidade, além de permitir o rastreamento preciso das métricas de engajamento.

## Verifique sua conta
O primeiro passo é verificar sua conta. Isso é essencial para garantir a entrega confiável e segura de seus e-mails. A verificação ajuda a prevenir o uso indevido da plataforma para spam ou atividades maliciosas e garante a conformidade com as regulamentações.

Siga estas etapas para concluir o processo de verificação:

1. Navegue até **Settings > Configure platforms**.

2. Localize **Email message** e clique em **Configure**.

<img src="/configure-project-email-verification-1.webp" alt="Interface de configuração da plataforma de e-mail mostrando o botão Configure para as configurações de mensagem de e-mail."/>

3. No formulário que aparece, forneça a URL do site da sua empresa no campo **Your company website URL** (por exemplo, https://example.com).

<img src="/configure-project-email-verification-2.webp" alt="Formulário de verificação de conta mostrando campos para a URL do site da empresa e outras informações necessárias."/> 

4. No campo **Primary technical contact**, insira o endereço de e-mail da pessoa que gerencia os aspectos técnicos da sua integração. Este contato será usado para consultas ou problemas técnicos.

5. No campo **Tell us about how you’ll be using Pushwoosh**, forneça detalhes sobre como você pretende usar o Pushwoosh para suas campanhas de e-mail. Inclua informações como:

- Os tipos de mensagens que você planeja enviar (por exemplo, newsletters, ofertas promocionais, etc.).

- Como seus assinantes se inscrevem para receber essas mensagens (por exemplo, formulário no site, registro no aplicativo móvel).


Depois de preencher todas as informações, clique em **Verify my account** para enviar sua solicitação. O Pushwoosh analisará seus detalhes e responderá o mais rápido possível.

Após a verificação da sua conta, você receberá um e-mail de confirmação. Você poderá então prosseguir para configurar as definições do remetente do seu e-mail.

Para isso: 

1. Vá para **Settings**.  
2. Selecione **Configure platforms**.  
3. Clique em **Continue configuration** ao lado da plataforma de e-mail.

<img src="/configure-project-email-verification-3.webp" alt="Interface de configuração da plataforma mostrando o botão Continue configuration para a plataforma de e-mail."/>

## Configure os detalhes do remetente

### Adicionar um domínio

Para enviar e-mails com o Pushwoosh, adicione e verifique um domínio. 

No campo **Domain**, insira o domínio que você deseja usar para enviar e-mails (por exemplo, suaempresa.com). Este domínio deve ser verificado via DNS na próxima etapa antes de poder ser usado em suas campanhas de e-mail.
 
<img src="/configure-project-email-verification-4.webp" alt="Interface de configuração de domínio mostrando o campo para inserir um domínio de remetente."/>

<Aside type="tip">Você verá o número restante de domínios que pode adicionar no topo da tela. Para aumentar este limite, por favor [entre em contato com nossa equipe de suporte](https://help.pushwoosh.com/hc/en-us/)</Aside>

### Adicionar detalhes do remetente padrão

##### Endereço do remetente

Configure um nome e endereço de e-mail de remetente padrão que aparecerão nas caixas de entrada dos destinatários. Isso ajuda os usuários a reconhecerem o remetente e constrói confiança.

* **Name**: Insira o nome do remetente (por exemplo, João).
* **Email**: Insira o endereço de e-mail do remetente antes do símbolo "@". Por exemplo, para *marketing@suaempresa.com*, insira *marketing*.

<Aside type="caution" title="Como os detalhes do remetente são determinados em jornadas de cliente e e-mails únicos">
Esses detalhes de remetente padrão são usados quando nenhum remetente é definido no [conteúdo do e-mail](/pt/product/content/email-content/set-up-your-email-in-the-editor/#configure-the-sender-settings) ou na etapa da jornada (ou e-mail único). O remetente definido em uma [etapa da Jornada do Cliente](/pt/product/customer-journey/journey-elements/channels/email/#define-sender-details-and-reply-address) ou no [formulário de e-mail único](/pt/product/messaging-channels/emails/sending-emails/send-one-time-emails/#sender-details) substitui tanto o conteúdo do e-mail quanto o padrão da plataforma. O remetente definido no [conteúdo do e-mail](/pt/product/content/email-content/set-up-your-email-in-the-editor/#configure-the-sender-settings) substitui o padrão da plataforma. 
</Aside> 

<img src="/configure-project-email-verification-5.webp" alt="Formulário de configuração de detalhes do remetente padrão mostrando campos para nome e endereço de e-mail do remetente."/>

Selecione a caixa de seleção **Use this as reply-to address to track replies** se desejar que as respostas dos destinatários vão diretamente para o endereço de e-mail do remetente.

##### Endereço de resposta

Para usar um endereço de resposta diferente, deixe a caixa de seleção desmarcada e especifique:

* **Reply-To name**: O nome que aparecerá como o contato para respostas.
* **Reply-To email**: O endereço de e-mail para onde as respostas devem ser enviadas.

<img src="/configure-project-email-verification-6.webp" alt="Formulário de configuração de endereço de resposta mostrando campos para nome e e-mail de resposta."/>

Se ambos os campos forem deixados em branco, as respostas serão enviadas para o e-mail do remetente padrão especificado na seção **From address**.

Após preencher os campos obrigatórios, clique em **Next** para prosseguir com a verificação do domínio.

## Configure os registros DNS

<Aside type="caution" title="Pode ser necessária assistência técnica"> 
****
A adição de registros DNS requer acesso às configurações de DNS do seu domínio. Se você não tiver certeza de como configurá-los, peça ajuda à sua equipe de TI ou ao provedor de domínio. 

</Aside>

Para autenticar seu domínio e habilitar o envio de e-mails para suas campanhas, configure os seguintes registros DNS nas configurações de DNS do seu provedor de hospedagem:

* **DKIM (Obrigatório)**. Este registro assina digitalmente seus e-mails, permitindo que os provedores de e-mail verifiquem se um e-mail se origina do seu domínio e não foi alterado em trânsito.
* **SPF (Obrigatório)**: Este registro especifica quais servidores de e-mail têm permissão para enviar e-mails em nome do seu domínio, ajudando a prevenir a falsificação.
* **DMARC (Obrigatório)**: Este registro fornece instruções para lidar com e-mails não autenticados e reportar de volta para você, aumentando a segurança do e-mail.


### Registros DKIM (obrigatório)

 <details>
  <summary> O que são Registros DKIM? </summary>

DKIM (DomainKeys Identified Mail) é um método de autenticação de e-mail que permite aos servidores de recebimento verificar se um e-mail foi enviado pelo domínio declarado e não foi alterado em trânsito.

Ao adicionar registros DKIM às suas configurações de DNS, você aplica uma assinatura criptográfica aos e-mails de saída. Essa assinatura verifica se o conteúdo da mensagem permanece inalterado e o autentica como uma mensagem legítima do seu domínio.
</details>

Copie os registros CNAME e adicione-os às suas configurações de DNS. 

Para configurar o DKIM, você precisará adicionar **todos os quatro registros CNAME (Canonical Name)** às suas configurações de DNS. Esses registros são essenciais para autenticar seu domínio e confirmar que os e-mails enviados do seu domínio são autorizados.

<img src="/configure-project-email-verification-8.webp" alt="Interface de configuração DKIM mostrando os quatro registros CNAME que precisam ser adicionados às configurações de DNS."/>

<Aside type="note">
 Os provedores de DNS lidam com registros de maneiras diferentes. Alguns exigem que você cole o registro inteiro (nome do host + domínio), enquanto outros precisam apenas da parte da chave única (nome do host sem o domínio). Verifique as instruções do seu provedor de DNS sobre como adicionar os registros.
</Aside>

Depois de adicionar os registros DNS necessários, o processo de verificação do domínio geralmente leva de 5 a 10 minutos, mas pode levar até 24 horas em alguns casos. Durante esse tempo, você não poderá enviar e-mails através do Pushwoosh até que a verificação seja concluída. Enquanto isso, você pode continuar com outras etapas de configuração e retornar mais tarde para verificar o status da verificação.

Clique em **Check DNS Records** para atualizar o status da verificação após adicionar os registros DNS. Assim que a verificação for bem-sucedida, o status de verificação do Domínio mudará para **Verified**.

<img src="/configure-project-email-verification-9.webp" alt="Interface de status de verificação de domínio mostrando o botão Check DNS Records e o status da verificação."/>

#### Enviar um e-mail de teste

Assim que a configuração do seu domínio e a verificação DKIM estiverem concluídas, você pode enviar um e-mail de teste para garantir que suas configurações de e-mail estão funcionando corretamente e que os e-mails serão entregues com sucesso aos usuários assim que sua campanha for ao ar.

Para enviar um e-mail de teste:

1. Na seção **Email Channel Configuration**, clique em **Send test email**.

<img src="/configure-project-email-verification-10.webp" alt="Interface de Configuração do Canal de E-mail mostrando o botão Enviar e-mail de teste."/>

2. No formulário que se abre, insira os detalhes do Remetente e do Destinatário:
* **From**: O endereço de e-mail do remetente que você configurou.
* **Recipient**: Insira o endereço de e-mail para onde você deseja enviar o e-mail de teste. Por padrão, este campo é preenchido com o e-mail do usuário logado, mas você pode alterá-lo se necessário.
3. Selecione o conteúdo do e-mail no menu suspenso para incluir no e-mail de teste.
4. Clique em **Send**.

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-11.webp" alt="Verificação de E-mail" />
</div>

### Registros SPF (obrigatório)

O Pushwoosh requer a configuração de um registro **Sender Policy Framework (SPF)** para autorizar seus servidores de e-mail a enviar e-mails em nome do seu domínio. O SPF é um protocolo de autenticação de e-mail que ajuda a prevenir a falsificação e melhora a entregabilidade de e-mails.

<Aside type="note">
 Antes de adicionar um novo registro SPF, verifique se o seu domínio já possui um, pois a maioria dos provedores de DNS permite apenas um registro SPF por domínio.
</Aside>

#### Adicionando um novo registro SPF

Se o seu domínio não tiver um registro SPF, adicione um novo registro TXT com o seguinte valor.

**Valor SPF**

```
"v=spf1 include:spf.pushwoosh.io ~all"
```

Dependendo do seu provedor de DNS, o nome do registro pode estar em branco ou definido como @.

#### Adicionando a um registro SPF existente

Se o seu domínio já tiver um registro SPF, basta adicionar o seguinte mecanismo SPF ao seu registro existente para autorizar o Pushwoosh.

```
include:spf.pushwoosh.io
```

<img src="/configure-project-email-verification-12.webp" alt="Interface de configuração de registro SPF mostrando o valor SPF e instruções para adicionar registros DNS."/>

### Verificação DMARC (obrigatório)

**DMARC** (Domain-based Message Authentication, Reporting, and Conformance) é um protocolo de autenticação de e-mail. Ele ajuda a proteger seu domínio contra uso não autorizado, como a falsificação de e-mails.

O Pushwoosh exige que o DMARC seja configurado em seu domínio para garantir a entrega de e-mails segura e autenticada. Para mais informações sobre DMARC, consulte a [Documentação do Protocolo DMARC](https://dmarc.org/overview/).

Para configurar o DMARC:

1. Copie o registro TXT do DMARC

<img src="/configure-project-email-verification-13.webp" alt="Interface de configuração DMARC mostrando o registro TXT DMARC que precisa ser adicionado às configurações de DNS."/>


2. Vá para as configurações do seu provedor de DNS e adicione o registro DMARC às configurações de DNS. Por favor, consulte a documentação do seu provedor de DNS se precisar de ajuda para adicionar esses registros.
3. Habilite o relatório (opcional). Para receber relatórios sobre autenticação de e-mail e problemas de segurança, adicione um endereço de e-mail no
campo `rua` dentro do parâmetro **Value**.

### Escolhendo um domínio diferente

Se você perceber que precisa alterar seu domínio nesta etapa, clique em **Choose different domain**. Em seguida, você pode adicionar um novo domínio de remetente.

Lembre-se de que alterar o nome do seu domínio gerará novos registros DNS. Isso garante que o limite de domínios seja rastreado corretamente e exclui quaisquer domínios que você não precise mais.

<img src="/configure-project-email-verification-14.webp" alt="Interface de seleção de domínio mostrando o botão Escolher domínio diferente para alterar os domínios do remetente."/>

## Configurar o rastreamento de links

O rastreamento de links ajuda você a entender como seu público interage com os links em seus e-mails, adicionando **parâmetros UTM**. Com as tags UTM, você pode rastrear o engajamento de e-mails diretamente no Google Analytics ou em qualquer outro sistema de análise que rastreie UTM.

<Aside type="note">
 Se você optar por não configurar o rastreamento de URL do Google Analytics, o Pushwoosh ainda rastreará os cliques nos links e fornecerá estatísticas básicas. Basta deixar o seletor **Google Analytics URL tracking** desativado e clicar em **Complete setup**.
</Aside>

Para habilitar o rastreamento de links, ative o seletor **Google Analytics URL tracking**.

Os seguintes parâmetros UTM serão adicionados aos seus links:

- **utm_source**: Identifica a fonte de tráfego.

- **utm_medium**: Especifica o meio de marketing, que é definido como "email" por padrão.

- **utm_campaign**: Adiciona o código da campanha (por exemplo, ID da campanha). Isso é inserido automaticamente.

- **utm_content**: Rastreia o conteúdo específico dentro do e-mail, como o assunto. Isso é inserido automaticamente.

A **Link Preview** mostra um exemplo de como seus links ficarão com os parâmetros UTM selecionados.

<img src="/configure-project-email-verification-15.webp" alt="Interface de configuração de rastreamento de links mostrando parâmetros UTM e exemplo de pré-visualização de link."/>

3. Depois de configurar os parâmetros UTM, clique em **Complete setup** para salvar suas configurações.

As tags UTM serão adicionadas automaticamente a cada link em seu e-mail, permitindo que você rastreie o desempenho da fonte, meio, campanha e conteúdo diretamente no Google Analytics.

## Revise e gerencie as configurações do seu canal de e-mail

Uma vez que seu canal de e-mail esteja configurado, o painel **Email channel configuration** fornece uma visão geral e permite que você gerencie as principais configurações para o envio de e-mails, incluindo domínios de remetente, detalhes do remetente padrão e opções de rastreamento de links.

### Status da configuração

No topo, você pode visualizar o status da plataforma de e-mail, que indica se ela está configurada. Se a plataforma não estiver configurada, pode ser pelos seguintes motivos:

* Os **Detalhes do remetente padrão** não foram especificados. [Saiba mais sobre os detalhes do remetente padrão](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification#add-default-sender-details).
<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-16.webp" alt="Detalhes do remetente padrão não especificados" />
</div> 

* Um **domínio não verificado** está definido como o remetente padrão. [Saiba mais sobre como verificar seu domínio](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification#configure-dns-records).

<img src="/configure-project-email-verification-17.webp" alt="Status da plataforma de e-mail mostrando mensagem de aviso de domínio não verificado."/>

### Seus domínios de remetente
Na seção **Your sender domains**, você pode visualizar e gerenciar os domínios que usa para enviar e-mails e o status de cada domínio:

* **READY**: O domínio está configurado e pronto para enviar e-mails.
* **NOT READY**: A verificação do domínio está incompleta, geralmente devido à [verificação DKIM](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/#dkim-records-required) pendente, que é necessária. Domínios marcados como **NOT READY** não podem enviar e-mails até que todas as verificações necessárias sejam concluídas. Para concluir a configuração, clique no nome do domínio na lista.

Além disso, esta seção exibe o status de cada registro de verificação (DKIM, SPF, DMARC) como **Verified** ou **Pending**. **Pending** indica que o registro está aguardando verificação ou ainda não foi configurado.

Clique em **Update status** para atualizar o status de verificação de cada domínio.

##### Adicionando um domínio

Para adicionar domínios adicionais, clique em **Add domain**. Para aumentar este limite, por favor [entre em contato com o suporte](https://help.pushwoosh.com/hc/en-us/requests/new).

<img src="/configure-project-email-verification-18.webp" alt="Interface de gerenciamento de domínio mostrando o botão Adicionar domínio para adicionar domínios de remetente adicionais."/>

##### Excluindo um domínio
<Aside type="danger" title="Importante"> 
****
A exclusão de um domínio pode interromper campanhas de e-mail ativas que o utilizam como remetente. Certifique-se de verificar todas as campanhas em andamento antes de excluir o domínio.
</Aside>
Para excluir um domínio:

1. Em **Your Sender Domains**, localize o domínio a ser excluído.
2. Clique no **menu de três pontos** ao lado do nome do domínio e selecione **Delete domain**.
3. Confirme a exclusão ou clique em **Cancel** para manter o domínio.

**Nota**: Se um domínio estiver definido como o endereço ["From"](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/#from-address) padrão em qualquer projeto, você não poderá excluí-lo até que as informações do remetente sejam atualizadas nesses projetos. Uma mensagem de erro aparecerá, juntamente com uma lista de projetos que usam este domínio como remetente padrão. Atualize o endereço "From" em cada projeto para um domínio verificado diferente e tente excluir o domínio novamente.


##### Enviando um e-mail de teste

Na lista de domínios, você também pode enviar um e-mail de teste. 

Para fazer isso, clique no menu de três pontos ao lado do domínio configurado e selecione **Send Test Email**. Note que esta opção está disponível apenas para domínios que foram totalmente configurados.

### Detalhes do remetente padrão

Nesta seção, você pode visualizar e gerenciar os detalhes do remetente padrão, incluindo:

* **From Address**: O nome e o endereço de e-mail que aparecerão como remetente nos e-mails.
* **Reply-To Address**: O nome e o e-mail padrão para respostas.

Para fazer alterações, clique em **Edit default sender details**.

<Aside type="caution" title="Importante"> 
****
O canal de e-mail não será configurado se você não especificar os [detalhes do remetente padrão](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/#add-default-sender-details), e uma mensagem de aviso aparecerá. Para definir os detalhes do remetente padrão, clique em **Set sender details.**
</Aside>

### Rastreamento de URL do Google Analytics

Nesta seção, você pode gerenciar as configurações de [**Rastreamento de Links**](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/#configure-link-tracking). Para habilitar o rastreamento, mude o seletor para **Enable**.

Quando habilitado, os parâmetros UTM são adicionados automaticamente aos links de e-mail, permitindo que você rastreie o engajamento do usuário no Google Analytics. Você também verá uma **Link Preview** exibindo como suas URLs aparecerão com as tags UTM.

## Configurando e-mails via API do Pushwoosh

Você também pode configurar a plataforma de e-mail usando a API do Pushwoosh. Para isso, você precisará da ajuda de sua equipe de desenvolvimento. Por favor, compartilhe [este guia](/pt/developer/api-reference/app-configuration#configureapplication-for-email) com eles para instruções detalhadas.

## Configure a central de preferências de inscrição

Uma vez que a plataforma de e-mail esteja configurada (domínios verificados e detalhes do remetente padrão definidos), você pode configurar a [central de preferências de inscrição](/pt/product/messaging-channels/emails/email-preferences/) para que os usuários possam escolher quais categorias de e-mail eles recebem.



## Configure um domínio de rastreamento personalizado


O **Domínio de Rastreamento de Cliques (CTD)** é a parte do domínio de uma URL de link rastreado exibida em uma mensagem de e-mail. Ele combina um subdomínio com seu domínio principal, por exemplo, `click.seudominio.com`. O subdomínio é criado nas configurações de DNS do seu domínio com seu provedor de domínio, geralmente adicionando um registro CNAME. Com um CTD, você pode encapsular links de e-mail para rastreamento de cliques em seu próprio subdomínio e manter a entregabilidade e os links diretos funcionando como esperado.

Para configurar um domínio de rastreamento personalizado:

1. Decida qual subdomínio você usará como seu CTD (por exemplo, `click.seudominio.com`).
2. No Pushwoosh, abra **Settings**, depois selecione **Configure Platforms**.
3. Na página **Email channel configuration**, role até **Custom tracking domain** e selecione **Enable**.

<Aside type="note" >
A seção **Custom tracking domain** é exibida somente após o canal de e-mail ser configurado para sua aplicação. Se você não a vir, complete a [configuração de e-mail](/pt/product/first-steps/start-with-your-project/configure-platforms/email-verification/) primeiro.
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Painel de Controle do Pushwoosh mostrando Configurações, Configurar Plataformas, Configuração do canal de e-mail e o cartão de Domínio de rastreamento personalizado com o controle Habilitar."/>

4. Insira seu CTD no campo **Domain** e selecione **Next**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Caixa de diálogo para habilitar domínio de rastreamento personalizado com o campo Domínio para inserir o CTD e os botões Cancelar e Próximo."/>

5. Fora do Pushwoosh, abra o serviço onde você gerencia o DNS público para o domínio do seu CTD (geralmente seu registrador de domínio, um host DNS ou sua conta de hospedagem). Em seu editor de DNS ou zona para esse domínio, adicione o **CNAME** que o Pushwoosh mostra nesta etapa para que seu CTD aponte para `api.pushwoosh.com`.

<Aside type="note" title="Propagação de DNS">
As alterações de DNS geralmente entram em vigor em minutos, mas podem levar até 48 horas.
</Aside>

6. No Pushwoosh, selecione **Verify**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Etapa de verificação de DNS do domínio de rastreamento personalizado mostrando o alvo CNAME api.pushwoosh.com e os controles Voltar, Verificar e Salvar."/>

7. Quando a verificação for bem-sucedida, selecione **Save**.
8. Se precisar alterar o **Domain** ou o registro DNS, selecione **Back** e ajuste as etapas anteriores.

9. Depois de clicar em **Save**, seu CTD aparece na lista **Custom tracking domain** em **Email channel configuration**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="Configuração do canal de e-mail com a seção Domínio de rastreamento personalizado mostrando o domínio de rastreamento de cliques salvo na lista."/>

Para desativá-lo mais tarde, selecione `...` ao lado do seu CTD e, em seguida, selecione **Disable custom tracking domain**.