> Conectar o canal oficial da Meta — credenciais mascaradas, perfil do negócio, saúde/qualidade/tier do número e templates para falar fora das 24h. # WhatsApp Cloud API (oficial) Para a maioria dos provedores, este é o canal mais importante. O WhatsApp Cloud API é o canal **oficial da Meta** — regulado, seguro, com suporte a templates, mídia e webhook de eventos. É por aqui que a IA atende o cliente final. ## Onde fica Menu **Configuração › Integrações › WhatsApp Cloud API** — rota `/config/integracoes/whatsapp-cloud`. A página tem **5 abas**: Visão geral, Credenciais, Perfil, Saúde do número e Templates. > **Nota.** > O registro do número na Cloud API e o **PIN de 2 fatores** são feitos no Business Manager da Meta, fora do painel. O conecta/ai recebe as credenciais já provisionadas — ele não cria a conta na Meta por você. ## Aba Visão geral Lista os números já conectados como cards de canal. O botão **Adicionar número** abre o formulário de credenciais. Sem nenhum número, mostra "Nenhum número WhatsApp Cloud conectado ainda." ## Aba Credenciais Onde você informa as credenciais do app Meta. Campos: | Campo | O que é | |-------|---------| | **Nome do canal** * | Rótulo interno (ex. "WhatsApp Principal") | | **App ID** * | ID do app Meta | | **Business Account ID** * | O WABA ID da conta | | **Phone Number ID** * | ID do número que vai operar | | **Access Token (permanente)** * | Token do System User (campo protegido, com olho) | | **App Secret** * | Segredo do app (protegido) | | **Verify Token** * | Token do handshake do webhook | > **Atenção.** > **Nunca mostramos segredos em claro.** Access Token, App Secret e Verify Token chegam ao navegador **mascarados** (`4chars••••4chars`). Ao editar, deixar um campo mascarado em branco **mantém o valor atual** — você não precisa redigitar o token só para trocar outro campo. 1. **Preencha e teste.** Ao criar, o conecta/ai **valida as credenciais com a Meta antes de salvar**. Se algo estiver errado, o canal volta com erro e a mensagem exata da Meta aparece. 2. **Teste a conexão.** Depois de salvo, o botão **Testar conexão** confirma o número e o nome verificado direto na Meta. 3. **Cadastre o webhook na Meta.** Use a Callback URL do número (ela carrega o `phoneNumberId`, então é única por número) e o Verify Token, e faça **Subscribe** ao campo `messages`. Com tudo certo, o agente responde em 1 a 3 segundos. O estado do canal aparece como badge (**Conectado / Erro / Desconectado**) com o número e, em caso de falha, a mensagem de erro. ## Aba Perfil Edita o **perfil de negócio** que os clientes veem no WhatsApp. Ao salvar, publica direto na Meta. Campos: **Sobre** (até 139 caracteres), **Descrição** (até 512), **E-mail**, **Vertical** (categoria do negócio), **Endereço** e até dois **sites**. A foto de perfil atual aparece na tela — a troca da foto, por enquanto, é feita pelo WhatsApp Manager. ## Aba Saúde do número Mostra dados **ao vivo da Meta** (com fallback ao cache do webhook se a chamada falhar). É onde você acompanha se o número está saudável: | Indicador | O que informa | |-----------|---------------| | **Nome verificado / Número** | Identidade do canal na Meta | | **Qualidade** | 🟢 GREEN, 🟡 YELLOW ou 🔴 RED | | **Limite de envio (Tier)** | Quantas conversas você pode iniciar por dia (250 / 1K / 10K / 100K / Ilimitado) | | **Throughput** | Capacidade de mensagens por segundo | | **Status do nome** | Aprovado / Em revisão / Recusado / Expirado | | **Verificação OTP / Plataforma** | Detalhes de conformidade do número | Se a Meta não responder mas houver dados guardados do webhook, a tela avisa que está mostrando o valor em cache ("Qualidade (cache)" / "Limite (cache)"). > **Atenção.** > **Qualidade baixa derruba o seu limite diário.** A nota (GREEN/YELLOW/RED) reflete como os clientes reagem às suas mensagens. Envie só para quem deu opt-in, evite disparos em massa irrelevantes e a qualidade se mantém alta — o que sobe o tier de envios. ## Janela de 24 horas e templates Depois que um cliente te escreve, você tem **24 horas** para responder com texto livre. Para iniciar conversa fora dessa janela — cobrança proativa, confirmação de visita, lembrete — é preciso um **template HSM aprovado pela Meta**. A aba **Templates** é a mesma tela descrita em [Templates HSM](/configuracoes/integracoes/templates-hsm). ## Veja também - [Templates HSM](/configuracoes/integracoes/templates-hsm) - [Atendimento](/comunicacao/atendimento) — onde as conversas acontecem - [Campanhas](/operacoes/campanhas) — disparos proativos com template - [Status e diagnóstico](/configuracoes/integracoes/status)