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

# Formatação de mensagens

> Explicamos como formatar o texto

> Guia rápido para deixar suas mensagens mais claras e profissionais usando a Loce Zap.

## Estilos de texto

**Negrito**\
Use `*` antes e depois do texto.

* Sintaxe: `*texto em negrito*`
* Exemplo: `Olá, *Paulo*!`
* Resultado: Olá, **Paulo**!

***

**Itálico**\
Use `_` antes e depois do texto.

* Sintaxe: `_texto em itálico_`
* Exemplo: `Seu pedido foi _aprovado_.`
* Resultado: Seu pedido foi *aprovado*.

***

**Tachado**\
Use `~` antes e depois do texto.

* Sintaxe: `~texto tachado~`
* Exemplo: `Valor antigo ~R$ 199,90~`
* Resultado: Valor antigo ~~R\$ 199,90~~

***

**Monoespaçado (código)**\
Use três crases (\`\`\`) antes e depois do texto.

* Sintaxe: ` `texto monoespaçado` `
* Exemplo: ` `Código: ABC123` `
* Resultado: fonte de código, bom para tokens, ids, códigos etc.

> Dica: em JSON você precisa escapar as crases e barras normalmente, mas a regra visual é a mesma.

***

## Combinações

Você pode combinar estilos, por exemplo:

* Negrito e itálico: `*_texto_*`
* Negrito e tachado: `*~promoção encerrada~*`

Nem todas as combinações ficam bonitas, então use com moderação.

***

## Quebra de linha

Na API, use `\n` para quebrar a linha.

### Exemplo de texto enviado pela API

```text theme={null}
Olá, *Paulo*\nSeu pedido foi _aprovado_.\n\nObrigado por comprar com a gente!
```

Resultado no WhatsApp:

Olá, **Paulo**\
Seu pedido foi *aprovado*.

Obrigado por comprar com a gente!

### Boas práticas

* Use parágrafos curtos.
* Use uma linha em branco (dois `\n`) para separar blocos de informação.
* Evite textos gigantes em uma única mensagem.

***

## Listas e organização

Você pode criar listas simples usando traços ou emojis:

```text theme={null}
*Resumo do seu pedido*\n
- Produto: Kit Gel UV\n- Quantidade: 2\n- Total: R$ 89,90\n\nPrecisa de ajuda com mais alguma coisa?
```

Ou usando emojis:

```text theme={null}
*Status do pedido*\n
✅ Pagamento aprovado\n📦 Em separação\n🚚 Saiu para entrega
```

***

## Exemplos prontos

**Exemplo 1  atualização de pedido**

```text theme={null}
Olá, *Paulo*!\n\nSeu pedido _#12345_ foi atualizado.\nStatus: *Saiu para entrega* 🚚\n\nQualquer dúvida é só responder esta mensagem.
```

**Exemplo 2  alerta de sistema (SaaS)**

```text theme={null}
*Alerta de login*\n\nDetectamos um novo acesso na sua conta.\n\nDispositivo: `MacBook Air`\nLocal aproximado: _Cuiabá  MT_\nHorário: `14:32`\n\nSe não foi você, responda esta mensagem imediatamente.
```