> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/usuario/ferramentas-do-atendimento/atendimento-waba-api-oficial.md). # Atendimento WABA (Api Oficial) ## 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 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: *** #### Grupo WABA **Templates** 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** 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** 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** 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** 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** 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** Envia uma mensagem solicitando que o cliente compartilhe a localização dele. | Campo | Descrição | | ------------ | ---------------------------------- | | **Mensagem** | Texto de solicitação (obrigatório) | *** **Endereço** 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** 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** 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** 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** 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** 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 * Contas Meta — WhatsApp — conectar o número WABA * Cobranças da Meta — WhatsApp Business Platform — entender os custos por template e conversa --- # 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.norux.chat/usuario/ferramentas-do-atendimento/atendimento-waba-api-oficial.md?ask=&goal= ``` `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.