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

# Criar um modelo

> Passo a passo para criar um modelo de e-mail ou de WhatsApp no Pombo, incluindo formatação com HTML no e-mail e o que fazer se o WhatsApp recusar o modelo.

Em **Modelos**, use **Criar novo modelo**. O formulário muda conforme o canal, então essa é a
primeira escolha.

## Passo a passo

<Steps>
  <Step title="Canal de envio">
    **WhatsApp** ou **E-mail**. Tudo o que vem depois depende disso.
  </Step>

  <Step title="Tipo de mensagem (só WhatsApp)">
    **Somente Texto**, **Com Imagem** ou **Com Documento**.

    Para envio em lote, escolha **Somente Texto**: é o único aceito lá.
  </Step>

  <Step title="Nome do modelo">
    Só para você encontrar depois. Use algo descritivo: *Cobrança de aluguel*, não *Modelo 3*.

    Se já existir um modelo com esse nome, o Pombo salva com um nome ajustado e avisa qual ficou.
  </Step>

  <Step title="Mensagem">
    O conteúdo que vai ser enviado. Use **Adicionar campo** para os dados que mudam a cada envio.
    Veja [Variáveis](/modelos/variaveis).

    No e-mail há também **Inserir HTML**, para tabelas e blocos formatados.
  </Step>

  <Step title="Criar">
    **Criar Modelo**. No e-mail ele já está pronto para uso; no WhatsApp vai para aprovação.
  </Step>
</Steps>

<Tip>
  A pré-visualização ao lado mostra a mensagem como o destinatário vai receber, com os valores de
  exemplo das variáveis. É a melhor forma de perceber um erro antes de salvar.
</Tip>

## Regras da mensagem

Algumas restrições existem por exigência do WhatsApp e valem a pena conhecer antes de escrever:

Duas são exclusivas do WhatsApp e pegam muita gente de surpresa:

* **Sem tabulações**, e no máximo 4 espaços seguidos.
* **Links para `wa.me` ou `api.whatsapp.com` não são permitidos.**

As regras de posicionamento das variáveis (não começar com uma, não colocar duas lado a lado)
estão em [Variáveis](/modelos/variaveis).

O Pombo também revisa o conteúdo antes de salvar e pode bloquear o modelo por política de
conteúdo, apontando o que precisa mudar.

## HTML no e-mail

Modelos de e-mail aceitam formatação, e o caminho é **Inserir HTML**: você cola a marcação ali e o
bloco entra no editor já do jeito que o destinatário vai receber.

<Warning>
  Marcação **digitada direto no campo da mensagem é descartada ao salvar**. Ela não vira
  formatação e também não chega como texto: as tags simplesmente desaparecem do modelo. Enquanto
  você digita, a pré-visualização ainda mostra as tags, então não use essa tela para concluir que
  funcionou.
</Warning>

Para formatar, então, use **Inserir HTML** para os blocos e a barra do editor para o texto corrido.
A aba **Código** da pré-visualização mostra a marcação final, com um botão **Copiar HTML**.

Como a mensagem fica em cada canal está em
[O que é um modelo](/modelos/o-que-e-um-modelo).

**Marcações permitidas**

| Para quê            | Marcações                                                                 |
| ------------------- | ------------------------------------------------------------------------- |
| Texto e ênfase      | `p` `br` `strong` `b` `em` `i` `u` `s` `small` `sub` `sup` `pre` `code`   |
| Títulos             | `h1` a `h6`                                                               |
| Listas              | `ul` `ol` `li`                                                            |
| Citação e separador | `blockquote` `hr`                                                         |
| Blocos              | `div` `span` `center`                                                     |
| Links               | `a`                                                                       |
| Tabelas             | `table` `thead` `tbody` `tfoot` `tr` `td` `th` `caption` `colgroup` `col` |
| Imagens             | `img` `figure` `figcaption`                                               |
| Fonte               | `font`                                                                    |

Atributos aceitos incluem `href`, `target`, `src`, `alt`, `width`, `height`, `align`, `valign`,
`colspan`, `rowspan`, `cellpadding`, `cellspacing`, `border`, `bgcolor`, `color` e **`style`**,
então cores, alinhamento e espaçamento em linha funcionam.

<Warning>
  O que **não** está nessa lista é **removido em silêncio**: sem aviso, sem erro e sem aparecer na
  mensagem. Scripts, formulários e folhas de estilo (`<style>`) estão entre os removidos, por
  segurança. Confira sempre a pré-visualização: é ali que você percebe o que sobrou.
</Warning>

**Limites de tamanho**

| Limite                             | Valor                          |
| ---------------------------------- | ------------------------------ |
| Corpo do e-mail                    | **10 000 caracteres visíveis** |
| Exemplo de uma variável (e-mail)   | 1 000 caracteres visíveis      |
| Exemplo de uma variável (WhatsApp) | 100 caracteres                 |
| Corpo do modelo de WhatsApp        | cerca de **800 caracteres**    |

A contagem no e-mail é do **texto visível**, não das marcações: uma tabela com muito HTML e pouco
texto ocupa pouco do limite.

## Depois de criar um modelo de WhatsApp

O modelo entra em revisão e você vê **Modelo enviado para análise**: *o WhatsApp revisa cada
modelo para garantir que não seja spam ou conteúdo indevido*. O botão de envio fica desativado até
a aprovação.

Situações possíveis:

| Situação                 | O que fazer                               |
| ------------------------ | ----------------------------------------- |
| **Em revisão pela Meta** | Esperar; volte em alguns minutos          |
| **Aprovado**             | Nada, pode enviar                         |
| **Recusado pela Meta**   | Criar um modelo novo com o texto ajustado |

Outras situações aparecem em **Requer sua atenção** na página de Modelos: sinalizado, pausado por
baixa qualidade, desabilitado. Em todas, o caminho é o mesmo: ajustar o texto e criar um modelo
novo.

<Note>
  Recusa costuma ser por **linguagem promocional**. Uma notificação extrajudicial deve informar,
  não vender: sem "aproveite", sem "oferta", sem urgência artificial. Texto seco e objetivo passa
  com mais facilidade.
</Note>

## Modelos não podem ser editados

<Warning>
  **Não existe edição de modelo.** Criado é criado: não há como alterar o texto, nem o nome, nem
  as variáveis. Inclusive nos recusados: o caminho é sempre **criar um novo modelo**.
</Warning>

Isso é coerente com o produto: um modelo é o que foi enviado em notificações que já geraram laudos.
Mudar o texto depois tornaria esses documentos inconsistentes com o modelo que os originou.

Excluir é possível, e é reversível apenas no sentido de que os envios já feitos não são afetados.
O modelo sai da lista e não pode mais ser usado. Modelos da Biblioteca Pombo não podem ser
excluídos.

## Usar o modelo

<CardGroup cols={2}>
  <Card title="Enviar uma notificação" icon="send" href="/envios/envio-unitario">
    Escolher este modelo e enviar.
  </Card>

  <Card title="Enviar em lote" icon="table" href="/envios/envio-em-massa">
    O mesmo modelo para uma planilha de destinatários.
  </Card>
</CardGroup>