## Visão geral

Cada estágio produzido da recuperação de vendas (carrinho abandonado, pagamento pendente, pagamento
recusado e em atraso) envia um **card** ao cliente. Nesta tela você personaliza o **texto** desse
card **por estágio e por idioma**, sem depender de nenhuma automação de IA. O que você não personalizar
continua usando a mensagem embutida da Conversa Labs — ou seja, você mexe só no que quiser.

`Vence em breve` continua reservado para compatibilidade com dados históricos, mas ainda não tem um
produtor de eventos e não é oferecido para configuração nem automação.

Além do corpo, você edita os **rótulos auxiliares** do card e configura, **para cada estágio e cada
idioma**, o **modelo aprovado do WhatsApp** usado quando a janela de 24h está fechada.

## Pré-requisitos

- A Recuperação de vendas precisa estar habilitada na conta.
- Permissão de administrador para alterar as configurações.
- Para configurar o envio fora da janela: uma caixa de entrada de **WhatsApp Cloud** com modelos
  aprovados na Meta.

## Passo a passo

1. Abra **Recuperação de vendas → Mensagens**.
2. Escolha o **idioma** no seletor do topo. Ele abre no **idioma da conta** e lista **todos os idiomas
   habilitados na instalação** (até 40), mostrando quantos já têm texto seu ("N de M idiomas com
   conteúdo").
3. Em cada estágio, escreva o corpo da mensagem em **Markdown**. Deixe vazio para usar a mensagem
   padrão daquele idioma — o selo **Padrão** indica que o estágio está herdando o texto embutido.
4. Use o botão de **variáveis** (`{x}`) para inserir dados como `{{contact.name}}`, o valor e o link de
   pagamento do último evento do cliente. O seletor oferece **apenas as variáveis que realmente
   resolvem** naquela mensagem.
5. Abra o bloco **Rótulos auxiliares** para ajustar as **6** legendas e textos de botão do card.
6. O bloco **Fora da janela de 24h (WhatsApp Cloud)** aparece **aberto, logo abaixo de cada estágio**.
   Escolha o modelo aprovado daquele estágio **naquele idioma**, mapeie os parâmetros `{{1}}`, `{{2}}`…
   e, se o modelo tiver botão de link, informe o valor do botão. Se ainda não houver um modelo, use
   **Criar a partir do meu texto** para gerá-lo a partir do corpo que você escreveu.
7. Confira a **prévia** por canal e, se quiser, use **Enviar teste** para mandar a mensagem a uma
   conversa real.
8. **Salvar mensagens** — inclusive depois de criar um modelo, porque **criar o modelo não grava a
   configuração**. Para voltar um estágio ao padrão, use **Restaurar padrão** — a personalização é
   removida **no servidor**, não apenas na tela.

## Configurações & opções

### Idiomas e fallback

O idioma não é mais um trio fixo de abas: é um **seletor** com todos os idiomas que a instalação
habilita. Na hora do envio, a Conversa Labs procura o texto nesta ordem:

1. o idioma do **contato**;
2. o mesmo idioma-base (por exemplo, `pt_BR` ↔ `pt`);
3. o **idioma da conta**;
4. a mensagem **padrão embutida**.

### Rótulos auxiliares

O card não é só o corpo da mensagem: ele tem legendas e textos de botão. Os **6 rótulos auxiliares**
ficam num bloco recolhível abaixo do corpo e seguem as mesmas regras de idioma e de restauração.

### Fora da janela de 24h (WhatsApp Cloud)

O bloco aparece **aberto e embutido logo abaixo de cada tipo de mensagem** — não é uma seção que você
precisa expandir. O modelo é **por tipo de mensagem e por idioma** — cada estágio tem o seu, em vez de um
único modelo para o módulo inteiro. Nele você tem:

- **Escolher o modelo aprovado** entre os do catálogo.
- **Sincronizar da Meta** e **Criar a partir do meu texto** ficam **sempre visíveis**. Quando a ação não
  está disponível, o botão aparece **desabilitado com o motivo escrito ao lado**: a caixa não é WhatsApp
  Cloud, a conta não tem o **WhatsApp Inbox Suite**, ou o seu perfil não gerencia caixas de entrada.
- **Sincronizar da Meta** atualiza a lista de modelos aprovados.
- **Criar a partir do meu texto** gera o modelo **a partir do texto daquele estágio naquele idioma**,
  enviando-o à Meta como modelo **UTILITY**, convertendo cada `{{ variável }}` em `{{1}}`, `{{2}}`… e já
  deixando o mapeamento pronto. Sem texto para gerar, o botão fica desabilitado e a tela pede para
  **escrever o texto primeiro**.
- Depois do envio, o modelo **ainda não está aprovado**: ele aparece no seletor marcado como
  **aguardando aprovação** e só passa a entregar quando a Meta aprovar e você sincronizar. Enviar de novo
  com o **mesmo nome substitui o rascunho pendente**, em vez de falhar.
- **Criar o modelo não salva a configuração** — clique em **Salvar mensagens** para gravar o mapeamento.
- **Mapeamento dos parâmetros `{{n}}`** e o campo do **botão de link**, quando o modelo tiver um.
- **Entrega**: escolhe de **qual caixa do WhatsApp** o catálogo de modelos aprovados é consultado. O
  envio em si continua saindo pela caixa da própria conversa. Tudo que depende dessa caixa — por que
  sincronizar/criar está indisponível, quantos modelos ficaram de fora, o link para gerenciá-los e o botão
  **Sincronizar da Meta** — aparece **uma vez** aqui, e não repetido embaixo de cada mensagem.
- **Botões nativos**: por padrão o link de pagamento sai como **botão** no WhatsApp, em vez de uma URL
  solta no texto. Você desliga por tipo de mensagem em **Entrega → Botões nativos**. No WhatsApp Cloud a
  Meta entrega **um único botão**, então o código PIX continua no corpo; no WhatsApp Web saem os dois.

Modelos cujo **cabeçalho exige mídia ou uma variável** não entram nesta lista — este envio não tem como
preencher esse cabeçalho — e a tela informa **quantos ficaram de fora**. Eles continuam utilizáveis pela
aba **Modelos** da própria caixa de entrada, com link direto a partir desta tela.

Observações importantes:

- **WhatsApp Web (WazMeow) não tem janela de 24h** — para essas caixas o bloco de modelo nem aparece.
- **360dialog** pode **selecionar** um modelo, mas **não criar** — a criação é exclusiva do Cloud.
- A Meta casa **nome + idioma + aprovado**. Um modelo no idioma errado é sinalizado na tela e seria
  recusado no envio.

### Prévia e envio de teste

A prévia é **renderizada no servidor**, por canal, e mostra apenas os canais que a conta realmente tem.
Ela também exibe o **modelo resolvido para fora da janela**, com os valores que cada parâmetro vai
carregar. O **Enviar teste** manda a mensagem para uma conversa escolhida, respeitando a janela de 24h:
se a janela estiver fechada e não houver modelo configurado, o teste é **pulado com o motivo escrito na
tela**.

### Variáveis

O seletor lista só o que resolve naquele contexto. Dados de **contato**, **conta**, **conversa**,
**caixa de entrada**, **agente**, **CRM** e **organização** agora renderizam de verdade (antes saíam em
branco), além dos dados do **evento de comércio** que originou o card.

## Dicas, limites e boas práticas

- Os corpos são **Markdown** e cada canal mostra o que suporta: anexos são descartados em LINE, TikTok
  e X; HTML bruto some no e-mail e no widget; `*negrito*` no WhatsApp aparece como um par de asteriscos.
  A prévia deixa isso explícito para você não escrever algo que só funciona num canal.
- Personalize primeiro o idioma principal do seu público e só depois os demais — o contador "N de M"
  ajuda a acompanhar a cobertura.
- Configure o modelo fora da janela **no mesmo idioma** do corpo: são pares, não uma configuração única.
- Depois de "Criar a partir do meu texto", o modelo fica **aguardando aprovação** na Meta — use
  **Sincronizar da Meta** para ver quando ele for aprovado e passar a entregar.

## Solução de problemas

- **A mensagem saiu no texto padrão:** o estágio estava com o selo **Padrão** (vazio) naquele idioma, ou
  o contato está num idioma sem texto e o fallback caiu no padrão embutido.
- **Fora da janela não enviou:** confirme que há um **modelo aprovado** configurado **para aquele estágio
  e aquele idioma**.
- **O modelo aparece sinalizado:** ele está num idioma diferente do card — troque por um modelo aprovado
  no idioma certo.
- **"Criar a partir do meu texto" está desabilitado:** o motivo aparece escrito ao lado do botão — a
  caixa não é WhatsApp Cloud (em 360dialog você escolhe um modelo já aprovado), a conta não tem o
  WhatsApp Inbox Suite, seu perfil não gerencia caixas de entrada, ou não há texto naquele estágio e
  idioma para gerar o modelo.
- **Criei o modelo, mas ele não aparece / não é usado:** logo após o envio ele fica **aguardando
  aprovação** — só entrega depois que a Meta aprovar e você usar **Sincronizar da Meta**. E confirme que
  clicou em **Salvar mensagens**: criar o modelo não grava a configuração.
- **Não encontro um modelo na lista:** modelos com **cabeçalho de mídia ou com variável no cabeçalho**
  não são listados aqui; use-os pela aba **Modelos** da própria caixa de entrada.
- **O envio de teste foi pulado:** a conversa estava fora da janela de 24h e o card não tinha modelo
  configurado — a tela informa o motivo.

## Veja também

- Ciclo de vida de e-commerce: webhooks Kiwify/Hotmart/Nuvemshop/Shopify
- [WhatsApp Inbox Suite: Templates, Flows e Chamadas](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-pt-br)