> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimento-waba-api-oficial.md).

# Atendimento WABA (Api Oficial)

O canal **WhatsApp Business API (WABA)** possui recursos exclusivos na tela de atendimento. A API Oficial não permite iniciar conversas com mensagens aleatórias — a plataforma recebe as mensagens e você pode respondê-las dentro da **janela de 24 horas** a partir da última interação do cliente.

Após esse período, a janela se fecha e só é possível iniciar uma nova conversa enviando um **template pré-aprovado**.

{% hint style="info" %}
**Onde criar templates?** Os templates WABA são criados e enviados para aprovação da Meta em **Configurações → Integrações Meta → Templates**. Consulte [Templates — Integrações Meta](/configuracao-administrador/configuracao/integracoes-meta/templates-integracoes-meta.md) para o passo a passo.
{% endhint %}

***

#### Opções exclusivas WABA

Na barra inferior da conversa, clique em **⋯ (três pontos)** para acessar as opções exclusivas do canal WABA, divididas em dois grupos:

<figure><img src="/files/ilm2TyvuU6bNKq2sF1rr" alt=""><figcaption></figcaption></figure>

***

### Grupo WABA

#### Templates

<figure><img src="/files/ZtvcFEjePXOiY5uIZj17" alt=""><figcaption></figcaption></figure>

Abre o seletor de templates aprovados. Pesquise por nome, filtre por categoria e selecione o template desejado para enviar ao cliente.

A listagem mostra: nome, idioma, status (`APPROVED`, `PENDING`) e categoria (MARKETING, UTILITY). Clique em **Enviar Template** para enviar.

{% hint style="warning" %}
Apenas templates com status **APPROVED** podem ser enviados.
{% endhint %}

***

#### Botões

<figure><img src="/files/dV96YL0e1hVMbRnkaqSC" alt=""><figcaption></figcaption></figure>

Envia uma mensagem com até 3 botões de resposta rápida.

| Campo        | Descrição                                 |
| ------------ | ----------------------------------------- |
| **Mensagem** | Texto principal da mensagem (obrigatório) |
| **Botão 1**  | Texto do primeiro botão (obrigatório)     |
| **Botão 2**  | Texto do segundo botão (opcional)         |
| **Botão 3**  | Texto do terceiro botão (opcional)        |

***

#### Lista

<figure><img src="/files/uf6xKr5ABlUcKwd7sTxt" alt=""><figcaption></figcaption></figure>

Envia um menu de lista interativa com seções e itens clicáveis.

| Campo                      | Descrição                                                |
| -------------------------- | -------------------------------------------------------- |
| **Cabeçalho**              | Título da mensagem (obrigatório)                         |
| **Mensagem**               | Texto principal (obrigatório)                            |
| **Texto do botão de ação** | Rótulo do botão que abre a lista                         |
| **Rodapé**                 | Texto complementar abaixo da mensagem                    |
| **Título da seção**        | Nome de cada seção da lista                              |
| **Itens**                  | Título e descrição de cada item — até 10 itens por seção |

Use **+ Adicionar item** para incluir itens e **+ Adicionar seção** para criar novas seções.

***

#### CTA URL

<figure><img src="/files/v78X3wO0gEdbteAJnNYH" alt=""><figcaption></figcaption></figure>

Envia uma mensagem com um botão de link externo (Call to Action).

| Campo                  | Descrição                                         |
| ---------------------- | ------------------------------------------------- |
| **Tipo de cabeçalho**  | Texto, imagem, vídeo ou documento                 |
| **Texto do cabeçalho** | Conteúdo do cabeçalho (quando tipo = Texto)       |
| **Mensagem**           | Texto principal (obrigatório)                     |
| **Texto do botão**     | Rótulo do botão CTA (obrigatório)                 |
| **URL do botão**       | URL de destino (obrigatório — ex.: `https://...`) |
| **Rodapé**             | Texto complementar (opcional)                     |

***

#### Reply Buttons

<figure><img src="/files/38kS1e5zf6217tw7mbMm" alt=""><figcaption></figcaption></figure>

Envia uma mensagem estruturada com cabeçalho e até 3 botões de resposta rápida.

| Campo                 | Descrição                            |
| --------------------- | ------------------------------------ |
| **Tipo de cabeçalho** | Texto, imagem, vídeo ou documento    |
| **Mensagem**          | Texto principal (obrigatório)        |
| **Rodapé**            | Texto complementar (opcional)        |
| **Botões**            | Até 3 botões — Botão 1 é obrigatório |

***

#### Localização

<figure><img src="/files/WHI0JfvVHs8Lz0N5azJP" alt=""><figcaption></figcaption></figure>

Envia um pin de localização no mapa.

| Campo             | Descrição                                          |
| ----------------- | -------------------------------------------------- |
| **Latitude**      | Latitude do local (obrigatório — ex.: `-23.5505`)  |
| **Longitude**     | Longitude do local (obrigatório — ex.: `-46.6333`) |
| **Nome do local** | Nome de exibição (ex.: Escritório Central)         |
| **Endereço**      | Endereço completo (opcional)                       |

***

#### Solicitar Localização

<figure><img src="/files/FcyDvS8fZfJBm0n2xsRl" alt=""><figcaption></figcaption></figure>

Envia uma mensagem solicitando que o cliente compartilhe a localização dele.

| Campo        | Descrição                          |
| ------------ | ---------------------------------- |
| **Mensagem** | Texto de solicitação (obrigatório) |

***

#### Endereço

<figure><img src="/files/pGxkqWlgCmP3GbrOd5zX" alt=""><figcaption></figcaption></figure>

Envia um cartão de endereço estruturado.

| Campo                | Descrição                   |
| -------------------- | --------------------------- |
| **Endereço linha 1** | Logradouro (obrigatório)    |
| **Endereço linha 2** | Complemento (opcional)      |
| **Cidade**           | Cidade (obrigatório)        |
| **Estado**           | Estado (opcional)           |
| **CEP**              | CEP (opcional)              |
| **País**             | País (obrigatório)          |
| **Tipo**             | Residencial, Comercial etc. |

***

#### Flow

<figure><img src="/files/CF17ZMfU3iYIT6RJvNQ8" alt=""><figcaption></figcaption></figure>

Envia um WhatsApp Flow — formulário interativo nativo do WhatsApp.

| Campo                      | Descrição                                                                |
| -------------------------- | ------------------------------------------------------------------------ |
| **Tipo de cabeçalho**      | Texto, imagem, vídeo ou documento                                        |
| **Mensagem**               | Texto principal (obrigatório)                                            |
| **Rodapé**                 | Texto complementar (opcional)                                            |
| **Flow ID**                | ID do Flow criado no Meta Business                                       |
| **Flow Name**              | Nome do Flow                                                             |
| **Texto do botão CTA**     | Rótulo do botão de abertura (obrigatório — ex.: Saiba mais)              |
| **Flow Token**             | Token de autenticação do Flow (opcional)                                 |
| **Ação**                   | Tipo de ação ao abrir o Flow (ex.: `navigate`)                           |
| **Payload da ação (JSON)** | Dados iniciais enviados ao Flow (ex.: `{"screen": "tela1", "data": {}}`) |

***

### Grupo Catálogo

#### Produto Único

<figure><img src="/files/9lgITW6TBQq98FzXuby8" alt=""><figcaption></figcaption></figure>

Envia um único produto do catálogo vinculado à conta WABA.

| Campo              | Descrição                                     |
| ------------------ | --------------------------------------------- |
| **ID do Catálogo** | ID do catálogo no Meta Business (obrigatório) |
| **ID do Produto**  | ID do produto (obrigatório)                   |
| **Mensagem**       | Texto opcional que acompanha o produto        |

***

#### Multi-Produto

<figure><img src="/files/1sMkVc6ivfeJmW127GtM" alt=""><figcaption></figcaption></figure>

Envia múltiplos produtos do catálogo em uma única mensagem.

| Campo               | Descrição                                                    |
| ------------------- | ------------------------------------------------------------ |
| **ID do Catálogo**  | ID do catálogo no Meta Business (obrigatório)                |
| **Cabeçalho**       | Título da mensagem (obrigatório)                             |
| **Mensagem**        | Texto principal (obrigatório)                                |
| **Título da Seção** | Nome da seção de produtos (opcional)                         |
| **ID dos Produtos** | IDs separados por vírgula (obrigatório — ex.: `id1,id2,id3`) |
| **Rodapé**          | Texto complementar (opcional)                                |

***

#### Catálogo

<figure><img src="/files/SHfNpFqFFjAOTWi2uxOr" alt=""><figcaption></figcaption></figure>

Envia o catálogo completo com produto em destaque.

| Campo                | Descrição                                     |
| -------------------- | --------------------------------------------- |
| **ID do Catálogo**   | ID do catálogo no Meta Business (obrigatório) |
| **Produto Destaque** | ID do produto a destacar (opcional)           |
| **Mensagem**         | Texto que acompanha o catálogo (obrigatório)  |

***

#### Template Carrossel

<figure><img src="/files/BstmhjVUwbAhJu4cBb6S" alt=""><figcaption></figcaption></figure>

Envia um template do tipo carrossel com múltiplos cards interativos.

| Campo                | Descrição                                                                         |
| -------------------- | --------------------------------------------------------------------------------- |
| **Nome do Template** | Nome do template carrossel aprovado (obrigatório)                                 |
| **Idioma**           | Idioma do template (ex.: `pt_BR`)                                                 |
| **Cards (JSON)**     | Array JSON com os cards — cada card tem `headerMediaId` e `buttons` (obrigatório) |

***

#### Páginas relacionadas

* [Templates — Integrações Meta — criar e gerenciar templates WABA e Facebook](/configuracao-administrador/configuracao/integracoes-meta/templates-integracoes-meta.md)
* [Contas Meta — WhatsApp — conectar o número WABA](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-app-zpro-com-coexistencia.md)
* [Cobranças da Meta — WhatsApp Business Platform — entender os custos por template e conversa](/api-oficial-waba/cobrancas-da-meta-whatsapp-business-platform.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimento-waba-api-oficial.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.