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

# WhatsApp Oficial

> O que o app mostra e permite para conectar e acompanhar um número do WhatsApp Oficial.

## Para que serve

O WhatsApp Oficial é um número aprovado pela Meta. O STChat mostra dois tipos de WhatsApp, **QR Code** e **Oficial**. Quando os dois trabalham juntos na mesma caixa, o tipo aparece como **Fusão**.

Como o próprio sistema explica:

* **QR Code**: conecta escaneando o código, usando o WhatsApp do aparelho. Responde a qualquer hora.
* **WhatsApp Oficial**: número aprovado pela Meta. Depois de 24 h sem resposta do cliente, só com modelo aprovado.
* **Fusão**: uma caixa só, com o melhor de cada um.

## Quem pode

Quem atribui a caixa é a agência. A conexão é feita por Dono ou Admin. Se a caixa é gerenciada pela agência, o painel mostra "API Oficial · gerenciada pela agência" e "Gerenciado pela agência", e a reconexão fica com ela.

Aparece se a agência liberou o módulo WhatsApp Oficial para a organização.

## Onde clicar

Em **Ajustes › Canais**, na linha do WhatsApp Oficial. O botão **Conectar canal**, no alto da tela, também lista a caixa Oficial quando ela ainda não está conectada.

## Passo a passo

**1. Abra Ajustes › Canais**

Clique em **Conectar canal** e escolha a caixa do WhatsApp Oficial. Ou abra o canal pela linha dele.

**2. Conecte pela Meta**

No painel da caixa, use **Reconectar** (ou **Conectar WhatsApp Oficial**). Uma janela própria abre para concluir o cadastro do número. Se o navegador bloquear janelas, libere.

**3. Volte ao STChat**

Ao terminar aparece "WhatsApp Oficial conectada! Atualizando…".

Se não houver caixa Oficial atribuída, o sistema avisa: "Não há caixa Oficial atribuída. Peça à agência para atribuir uma."

## O que acontece depois

Abra o canal com **Gerenciar**. O painel do Oficial tem as abas **Visão geral**, **Configuração**, **Oficial** e **Histórico**. Na aba **Oficial** há o botão **Ver modelos**. Na **Visão geral** aparecem, quando existem dados, **Qualidade**, **Limite de envio** e **Risco de bloqueio**.

O botão **Reiniciar** fica desligado em caixa Oficial, e o **Aquecimento do número** não aparece nela.

## Erros comuns

* "O onboarding do WhatsApp Oficial não foi concluído.": o cadastro na janela da Meta não terminou. Tente de novo.
* "Não foi possível gerar o link de conexão." ou "Link de conexão inválido.": tente de novo; se continuar, fale com a agência.
* "Falha ao iniciar onboarding.": tente de novo.
* "Esta caixa é da API Oficial: reconecte pela Meta em Ajustes › Canais.": o QR não serve para ela.

> [!WARNING]
>
> Na Fusão, o STChat envia pela conexão não oficial quando a janela de 24 h do WhatsApp Oficial está fechada. O uso é de responsabilidade da empresa e pode levar ao bloqueio do número pelo WhatsApp.

## Próximo passo

* [Como conectar o WhatsApp por QR code](https://docs.stchat.app/subcontas/conectar-whatsapp-por-qr.md)
* [A tela de Canais](https://docs.stchat.app/subcontas/tela-de-canais.md)
* [Canal desconectado](https://docs.stchat.app/subcontas/canal-desconectado.md)
* [Instâncias e canais (para a agência)](https://docs.stchat.app/agencias/instancias-e-canais.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.