# Criar conteúdo de e-mail com o editor de código HTML

<YouTube id="DryThwJHYxk" params="start=258&end=355" playlabel="Vídeo do YouTube: Crie o conteúdo do seu e-mail do zero com HTML"/>

Se você é proficiente em HTML e prefere escrever seu próprio código, pode criar e-mails usando o editor de código HTML da Pushwoosh.

<Aside type="note">
Não tem habilidades de codificação? Use o editor Arrastar e soltar para criar conteúdo de e-mail sem esforço. Nenhuma habilidade de codificação é necessária. [Saiba mais](/pt/product/content/email-content/drag-and-drop-email-editor)
</Aside>

<Aside type="caution" title="Importante">
Antes de começar a criar o conteúdo do e-mail, é essencial configurar corretamente seu e-mail no editor de e-mail que você escolher. Isso envolve configurar idiomas, especificar a linha de assunto, fornecer informações do remetente e muito mais. [Aprenda como fazer](/pt/product/content/email-content/set-up-your-email-in-the-editor)
</Aside>


## Criar conteúdo de e-mail

Para começar a criar o conteúdo do e-mail, cole seu código HTML na aba HTML. O editor fornece pré-visualizações do e-mail em tempo real enquanto você trabalha neles.

<video src="/emails-html-code-editor-1.webm" title="Interface do editor de código HTML mostrando a pré-visualização do e-mail em tempo real enquanto o código é digitado" autoplay loop muted playsinline />

Alternativamente, você pode carregar um arquivo HTML clicando em **Carregar Arquivo HTML** localizado no painel inferior.

Para adicionar um toque personalizado aos seus e-mails, use tags personalizadas. Para isso:

1. Clique no ícone de **Tag** localizado na parte inferior do editor.
2. Selecione a Tag desejada e seu modificador, e forneça um valor padrão se necessário.
3. Clique em **Inserir** para incluir a tag personalizada no conteúdo do seu e--mail.

<img src="/emails-html-code-editor-2.webp" alt="Interface de inserção de tag personalizada mostrando seleção de tag e opções de valor padrão"/>

Para incluir um emoji no seu e-mail, clique no ícone de **Emoji** localizado na parte inferior do editor.

### Adicionar imagens

Para adicionar uma imagem ao seu e-mail, inclua uma tag `<img>` no seu HTML e defina o atributo `src` para a URL da imagem.

Para reutilizar uma imagem da sua [Galeria de mídia](/pt/product/content/media-store/), copie sua URL de lá e cole-a no atributo `src`. Veja [Copiar uma URL de imagem](/pt/product/content/media-store/#copy-an-image-url) para os passos.

```
<img src="SUA-URL-DA-GALERIA-DE-MÍDIA" alt="Banner de liquidação de verão" width="600" style="display:block;max-width:100%;height:auto;" />
```

Substitua `SUA-URL-DA-GALERIA-DE-MÍDIA` pela URL que você copiou da Galeria de mídia.

## Usar localização

A localização permite que você entregue experiências personalizadas para usuários em diferentes idiomas.

No editor de código HTML, você pode usar a localização definindo um idioma padrão e adicionando várias opções de idioma. Por exemplo, você pode definir uma mensagem padrão em inglês e depois incluir traduções em alemão e espanhol. Isso garante que o conteúdo do seu e-mail se adapte às preferências de idioma de cada usuário.

Abaixo está um exemplo de como estruturar seus dados de localização. Este exemplo usa o inglês como idioma padrão e traduções em alemão e espanhol.

```json
{
  "default": {
    "button": "Shop now",
    "description": "For a limited time, you can enjoy a 20% discount on all our premium coffee blends",
    "subtitle": "Don't miss it",
    "title": "☕ Coffee Promotion Alert!"
  },
  "de": {
    "button": "Jetzt einkaufen",
    "description": "Für kurze Zeit erhalten Sie einen Rabatt von 20% auf alle unsere Premium-Kaffeemischungen",
    "subtitle": "Verpassen Sie es nicht",
    "title": "☕ Kaffee-Promotion Benachrichtigung!"
  },
  "es": {
    "button": "Comprar ahora",
    "description": "Por tiempo limitado, puedes disfrutar de un descuento del 20% en todas nuestras mezclas de café premium",
    "subtitle": "No te lo pierdas",
    "title": "☕ ¡Alerta de Promoción de Café!"
  }
}
```

Uma vez que seus dados de localização estejam estruturados e adicionados na **Aba de Localização** do editor, incorpore-os ao seu conteúdo HTML usando placeholders. Os placeholders inserem dinamicamente o texto localizado em seu conteúdo, com base na preferência de idioma do usuário. Veja como implementá-lo em seu HTML

```
{{title|text|}}
{{subtitle|text|}}
{{description|text|}}
{{button|text|}}
```

Considere este cenário: você está anunciando um desconto por tempo limitado em misturas de café. Usando a estrutura de localização mencionada acima, você pode comunicar sua mensagem promocional de forma eficaz para usuários que falam diferentes idiomas. Seu código HTML para a promoção pode se parecer com isto:

```html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>☕ Coffee Promotion Alert</title>
<style>
  body {
    font-family: Arial, sans-serif;
    margin: 0;
    padding: 20px;
    background-color: #f4f4f4;
  }
  .container {
    background-color: #fff;
    padding: 20px;
    margin: 10px auto;
    max-width: 600px;
    border-radius: 8px;
    box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
  }
  .button {
    display: inline-block;
    padding: 10px 20px;
    margin-top: 20px;
    background-color: #ff6f61;
    color: white;
    text-decoration: none;
    border-radius: 5px;
  }
  .button:hover {
    background-color: #ff5733;
  }
  .footer {
    text-align: center;
    margin-top: 20px;
    font-size: 0.8em;
    color: #888;
  }
</style>
</head>
<body>
  <div class="container">
    <h1>{{title|text|}}</h1>
    <p>{{description|text|}}</p>
    <a href="https://www.example.com/promotion" class="button">{{button|text|}}</a>

  </div>
</body>
</html>
```

Com esta configuração, se o idioma de um usuário for alemão, ele verá o e-mail em alemão. Usuários que optaram por receber e-mails em inglês o verão em inglês. Aqueles que optaram por recebê-lo em espanhol o receberão em espanhol. Isso garante que todos os destinatários recebam sua mensagem em seu idioma preferido.

<video src="/emails-html-code-editor-3.webm" title="Demonstração de localização mostrando o conteúdo do e-mail em diferentes idiomas" autoplay loop muted playsinline />

## Inserir e combinar blocos de conteúdo de e-mail

A Pushwoosh permite que você combine conteúdo de e-mail inserindo um trecho de conteúdo de e-mail em outro. Isso facilita a reutilização de elementos como cabeçalhos, rodapés ou blocos de conteúdo específicos em diferentes e-mails.

Por exemplo, se você tem o **Conteúdo de e-mail A** (um cabeçalho) e o **Conteúdo de e-mail B** (uma newsletter), você pode inserir o **Conteúdo de e-mail A** no **Conteúdo de e-mail B** sem copiar manualmente o conteúdo a cada vez.

### Sintaxe

Para inserir um trecho de conteúdo em outro, use a seguinte sintaxe:

```
{% email_content "AAAAA-BBBBB" %}
```

Onde "AAAAA-BBBBB" é o ID do conteúdo de e-mail que você deseja inserir. Você pode encontrar o ID localizado abaixo do nome do conteúdo na sua lista de conteúdos de e-mail.

<img src="/emails-html-code-editor-4.webp" alt="Exibição do ID do conteúdo do e-mail mostrando o nome do conteúdo e o identificador único"/>

<Aside type="caution" title="Importante">
* Você pode inserir conteúdo recursivamente, o que significa que um bloco de conteúdo pode incluir outro, até uma profundidade máxima de 3 níveis. Por exemplo:
  * O **Conteúdo A** pode inserir o **Conteúdo B**.
  * O **Conteúdo B** pode inserir o **Conteúdo C**.
  * No entanto, o **Conteúdo C** não pode inserir outro bloco.
* **Inserções cíclicas** (por exemplo, onde o **Conteúdo A** insere o **Conteúdo B** e o **Conteúdo B** tenta inserir o **Conteúdo A**) não são permitidas e resultarão em um erro.
</Aside>  

**Exemplo**

Digamos que você tenha dois trechos de conteúdo:

* **Conteúdo do cabeçalho** (ID: "AAAAA-BBBBB") com um design de cabeçalho predefinido.
* **Conteúdo da newsletter**, onde você deseja incluir o cabeçalho.

Para inserir o cabeçalho na newsletter, você usaria o seguinte:

```

{% email_content "AAAAA-BBBBB" %}
```

Isso permite que você reutilize facilmente um cabeçalho predefinido em várias campanhas de e-mail. Economiza tempo e garante a consistência em seus e-mails.


## Adicionar um link de cancelamento de inscrição

Inclua um link de cancelamento de inscrição no seu e-mail para que os destinatários possam optar por sair, de acordo com as regulamentações e suas preferências. A Pushwoosh fornece três variáveis que você pode usar no seu HTML.

### Link de cancelamento de inscrição 

Adicione este link para que os usuários possam optar por não receber mais a mensagem que receberam:

```
<a href=%%PW_EMAIL_UNSUBSCRIBE%%> Cancelar inscrição </a>
```

A variável é substituída pela URL de cancelamento de inscrição da Pushwoosh quando você envia o e-mail.

- Quando a central de preferências de inscrição está ativada, os destinatários cancelam a inscrição apenas da categoria atribuída a esse e-mail (por exemplo, *Newsletter*). Uma tela de confirmação aparece onde eles podem **Reinscrever-se** nessa categoria ou **Gerenciar preferências** para ajustar todas as categorias de e-mail. [Saiba mais](/pt/product/messaging-channels/emails/email-preferences/#default-behavior-unsubscribe-from-a-category)

- Quando a central de preferências de inscrição não está ativada, os destinatários cancelam a inscrição de todos os e-mails de marketing.

Os cliques são contados na taxa de cancelamento de inscrição para essa mensagem no [Histórico de Mensagens](/pt/product/statistics-and-analytics/message-history).

### Cancelar inscrição de todas as categorias 

Adicione um link que cancela a inscrição do usuário de todas as categorias de e-mail de uma só vez:

```
<a href=%%PW_EMAIL_UNSUBSCRIBE_ALL%%> Cancelar inscrição de todos os e-mails </a>
```

<Aside type="note">
Para permitir que você entregue e-mails importantes aos seus clientes, não excluímos usuários que cancelaram a inscrição da sua base de usuários. Para usuários que optaram por sair completamente (por exemplo, através do link de cancelamento de inscrição padrão quando a central de preferências não está ativada, ou através do link Cancelar inscrição de todos), a [tag padrão **E-mails com Inscrição Cancelada**](/pt/product/audience-data-and-segmentation/user-data-tags) é definida como 'true'. 

Considere criar um [segmento](/pt/product/audience-data-and-segmentation/segmentation/) de usuários que não cancelaram a inscrição (valor da tag 'false') para continuar a enviar mensagens para eles. Para evitar reclamações, não envie e-mails para usuários que cancelaram a inscrição.
</Aside>

### Link da central de preferências 

Adicione um link direto para a [central de preferências](/pt/product/messaging-channels/emails/email-preferences/#optional-setup-full-preference-center) onde os usuários gerenciam quais categorias eles recebem:

```
<a href=%%PW_EMAIL_PREFERENCE_CENTER_LINK%%> Gerenciar preferências </a>
```
[Aprenda como a central de preferências funciona](/pt/product/messaging-channels/emails/email-preferences/#how-to-let-users-unsubscribe-from-a-category-or-manage-preferences)

A captura de tela abaixo mostra um rodapé que usa todos os três tipos de link.

<img src="/emails-html-code-editor-6.webp" alt="Exemplo de rodapé de e-mail com os três links de cancelamento de inscrição: Cancelar inscrição, Gerenciar preferências, Cancelar inscrição de todos os e-mails"/>

<Aside type="caution">
Se você usar seu próprio link de cancelamento de inscrição em vez das variáveis da Pushwoosh, os usuários que optarem por sair através do seu link não serão incluídos na taxa de cancelamento de inscrição no [Histórico de Mensagens](/pt/product/statistics-and-analytics/message-history). Apenas os usuários que seguiram o link da Pushwoosh são contados nas estatísticas para esse e-mail.
</Aside>

## Salvar conteúdo do e-mail

Depois de terminar de criar seu e-mail, clique no botão **Salvar** localizado na parte superior do editor.

<img src="/emails-html-code-editor-5.webp" alt="Caixa de diálogo para salvar conteúdo do e-mail mostrando os campos de nome e rótulo"/>

Na nova janela que aparece, dê ao seu e-mail um nome claro, que pode ser o mesmo da sua linha de Assunto. Além disso, crie um rótulo para ajudá-lo a encontrá-lo facilmente na sua lista de e-mails.

Se você ainda não [configurou os detalhes do remetente](/pt/product/content/email-content/set-up-your-email-in-the-editor), certifique-se de fazer isso também. Em seguida, clique em **Salvar.**

Agora que o conteúdo do seu e-mail está pronto, ele pode ser usado em campanhas de e-mail. [Saiba mais](/pt/product/messaging-channels/emails/sending-emails)

## Enviar um e-mail de teste

Antes de enviar sua campanha de e-mail, você pode enviar um e-mail de teste para pré-visualizar como o conteúdo aparecerá nas caixas de entrada dos destinatários. Isso permite que você revise o layout, o conteúdo e quaisquer elementos personalizados para garantir a precisão antes de finalizar a campanha. Se necessário, ajuste o conteúdo com base nos resultados do teste.

<Aside type="note">
Se o KYC **(Conheça Seu Cliente)** não estiver concluído, você ainda pode enviar e-mails de teste verificando um endereço de e-mail de teste. Para fazer isso, vá para a seção [Dispositivos de Teste](/pt/developer/first-steps/test-your-integration/test-devices/), adicione o endereço de e-mail que deseja usar para testes e conclua o processo de verificação.
</Aside>

Para enviar um e-mail de teste, clique em **E-mail de teste** no editor de e-mail.

<img src="/shared-14.webp" alt="Botão de e-mail de teste na interface do editor de e-mail"/>

 Na janela que se abre:

1. No campo **Endereço de e-mail**, insira o endereço de e-mail onde deseja receber o e-mail de teste.

Se o KYC não foi concluído, você precisará selecionar um endereço de e-mail verificado da lista de endereços de teste em vez de inserir um e-mail.

<img src="/shared-50.webp" alt="Menu suspenso de seleção de endereço de e-mail de teste verificado"/>

2. Se o seu e-mail contiver conteúdo dinâmico (placeholders para dados personalizados), adicione valores de amostra para fins de teste.

Por exemplo:

* **Idade (inteiro)**: Insira um número para representar o placeholder de idade (por exemplo, `21`).
* **PrimeiroNome (string)**: Insira um nome de amostra (por exemplo, `David`).

Esses valores substituirão os dados reais do destinatário no e-mail de teste, permitindo que você verifique como o conteúdo dinâmico aparece.

3. Depois de preencher os detalhes necessários, clique em **Enviar e-mail de teste** para enviar a mensagem de teste para o endereço de e-mail fornecido.

<img src="/shared-34.webp" alt="Caixa de diálogo de confirmação de envio de e-mail de teste com campos de dados de amostra"/>