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

# Visão Geral

> Templates de mensagem do WhatsApp Business (Meta/Gupshup)

## O que são Templates?

Templates são modelos de mensagem pré-aprovados pela Meta para envio via WhatsApp Business API (Gupshup). São obrigatórios para iniciar conversas ou reengajar leads após a janela de 24 horas.

<CardGroup cols={2}>
  <Card title="Marketing" icon="bullhorn">
    Promoções, novidades e campanhas
  </Card>

  <Card title="Utility" icon="wrench">
    Notificações transacionais, confirmações, lembretes
  </Card>
</CardGroup>

## Como funciona

<Steps>
  <Step title="Crie o template no Gupshup">
    Configure o template no painel da Gupshup com os componentes desejados (header, body, footer, botões).
  </Step>

  <Step title="Aguarde aprovação da Meta">
    Templates precisam ser aprovados pela Meta antes do uso. Status possíveis: `APPROVED`, `PENDING`, `REJECTED`.
  </Step>

  <Step title="Sincronize com o Leavo">
    O meta-service sincroniza automaticamente os templates aprovados com o Leavo.
  </Step>

  <Step title="Use em cadências e follow-ups">
    Associe templates a steps de cadências ou configure follow-ups com templates oficiais.
  </Step>
</Steps>

## Modelo do Template

```json theme={null}
{
  "id": "uuid",
  "tenant_id": "uuid",
  "gupshup_app_id": "app_12345",
  "template_name": "boas_vindas_v1",
  "template_id": "gupshup_template_id",
  "language": "pt_BR",
  "status": "APPROVED",
  "category": "MARKETING",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Bem-vindo, {{1}}!"
    },
    {
      "type": "BODY",
      "text": "Olá {{1}}, obrigado por se cadastrar na {{2}}. Estamos prontos para ajudá-lo!"
    },
    {
      "type": "FOOTER",
      "text": "Leavo - Automação inteligente"
    }
  ],
  "last_synced_at": "2024-01-15T10:00:00Z",
  "created_at": "2024-01-15T10:00:00Z"
}
```

## Status do Template

| Status     | Descrição                              |
| ---------- | -------------------------------------- |
| `APPROVED` | Aprovado pela Meta, pronto para uso    |
| `PENDING`  | Aguardando revisão da Meta             |
| `REJECTED` | Rejeitado pela Meta (necessita ajuste) |

<Warning>
  Apenas templates com status `APPROVED` podem ser usados em cadências e follow-ups.
</Warning>

## Categorias

| Categoria        | Uso                                   |
| ---------------- | ------------------------------------- |
| `MARKETING`      | Promoções, ofertas, engajamento       |
| `UTILITY`        | Confirmações, lembretes, atualizações |
| `AUTHENTICATION` | Códigos de verificação, login         |

## Endpoints

| Método   | Endpoint                  | Descrição                        |
| -------- | ------------------------- | -------------------------------- |
| `GET`    | `/backend/templates`      | Listar templates                 |
| `GET`    | `/backend/templates/{id}` | Obter template                   |
| `DELETE` | `/backend/templates/{id}` | Excluir template                 |
| `POST`   | `/backend/templates/sync` | Sincronizar templates do Gupshup |