> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.attende.online/llms.txt
> Use this file to discover all available pages before exploring further.
# WhatsApp Oficial
> Passo a passo para conectar o WhatsApp Oficial (API da Meta) no Attende: criar o app na Meta, pegar os IDs e o token, colar no Attende, devolver o webhook — e deixar a conta aprovada para enviar.
O WhatsApp Oficial é o canal mais importante para a maioria das empresas no Brasil. É a conexão profissional pela **API Oficial da Meta** — estável, sem risco de banimento e com recursos que só existem no caminho oficial (templates, campanhas, selo de verificação).
Para liberar tudo isso, a Meta exige um cadastro do seu negócio antes de soltar o número. É um caminho com algumas etapas e umas telas da própria Meta que pedem atenção — mas calma: **você não vai programar nada.** É seguir um passo a passo e copiar e colar algumas informações de um lugar para o outro. Este guia mostra cada clique.
Antes de começar, vale ler [Visão geral dos canais](https://ajuda.attende.online/visao-geral-dos-canais) — lá explicamos por que o WhatsApp aqui é só o Oficial (e nunca por leitura de QR Code).
***
## Dois caminhos: você decide
Antes de pôr a mão na massa, escolha como quer fazer. Não existe certo ou errado — existe o que faz sentido para o seu momento.
Você segue este guia do começo ao fim, no seu ritmo. Funciona — milhares de empresas fazem. Reserve uma hora tranquila e vá com calma. O passo a passo está logo abaixo.
Nossa equipe **agenda uma sessão** e faz o processo inteiro junto com você: cria o Meta Business, conecta e verifica o número, cuida da aprovação e ainda **deixa o Attende configurado** pra você só atender.
**Quer a opção assistida?** Fale com a gente pelo [suporte](https://ajuda.attende.online/planos-e-assinatura/como-funciona-o-suporte-do-attende) e peça a **implementação assistida do WhatsApp Oficial**. A gente cuida da parte chata; você só atende. Detalhes no fim desta página, em [Prefere que a gente faça por você?](#prefere-que-a-gente-faca-por-voce).
Sem certeza de qual escolher? Se "criar um app na Meta" já soou como uma tarde inteira de dor de cabeça, a implementação assistida foi feita exatamente pra você. Se você curte resolver as coisas no seu tempo, siga em frente — o guia foi escrito pra te levar pela mão.
A partir daqui, o guia é para quem escolheu **conectar por conta própria**.
***
## Antes de começar: o que você vai precisar
Tenha tudo isto à mão **antes** de sentar para conectar:
* **Uma conta no Facebook** do responsável pela empresa (não a conta pessoal de um atendente qualquer).
* **Um Meta Business / portfólio empresarial já criado** (o "Gerenciador de Negócios" da Meta, em [business.facebook.com](https://business.facebook.com/)). Crie-o **antes** — a criação do app vai pedir esse portfólio no meio do caminho, e se não houver um disponível você não consegue avançar. O ideal é que ele esteja **verificado**.
* **Um número de telefone que ainda NÃO esteja em uso no app do WhatsApp** — nem WhatsApp comum, nem Business. Se o número já tem WhatsApp, desvincule antes. A Meta não deixa um número viver nos dois mundos.
* **Acesso para receber SMS ou ligação nesse número** — a Meta envia um código para confirmar que o número é seu.
* **O site da sua empresa** (ou o link da página comercial no Facebook/Instagram). A Meta usa isso para validar o negócio — sem isso a conta trava em "Pendente".
* **Ser Administrador no Attende.** Conectar canal é função de Administrador. Sem o menu **Configurações**, peça ao Administrador da empresa (ver [Convidando sua equipe](https://ajuda.attende.online/primeiros-passos/convidando-sua-equipe)).
Separe o número **antes**. O erro mais comum é descobrir no meio do caminho que o número escolhido já tinha WhatsApp instalado. Resolva isso primeiro e o resto flui.
***
## 1. Crie o app na Meta
Tudo aqui acontece no painel de desenvolvedor da Meta — **ainda não no Attende**.
**Tenha o portfólio empresarial pronto antes.** No meio da criação do app, a Meta vai pedir para conectar um **portfólio empresarial** (seu Meta Business). Se não houver nenhum verificado na sua conta, vai aparecer *"Nenhuma empresa disponível"* e você trava ali. Crie e verifique seu Meta Business **antes** de começar este passo, em [business.facebook.com](https://business.facebook.com/) → Configurações da empresa. (Não tem isso pronto? É exatamente onde a [implementação assistida](#prefere-que-a-gente-faca-por-voce) entra.)
A criação segue o **assistente da Meta**, na ordem oficial abaixo (validado na documentação da Meta, atualizada em outubro de 2025).
Acesse o [painel de apps da Meta](https://developers.facebook.com/apps), faça login com a conta do Facebook do responsável pela empresa e clique em **Criar app** (*Create App*).
Preencha o **nome do app** (uso interno — o cliente nunca vê; algo como "Atendimento \[sua empresa]") e o **e-mail de contato** (um e-mail que você consulte de verdade — a Meta usa para falar sobre o app).
Na lista de casos de uso, marque **"Conectar-se com clientes pelo WhatsApp"** (*Connect with customers through WhatsApp*) — não as de anúncios ou login do Facebook — e clique em **Avançar**.
Escolha um **portfólio empresarial existente** ou crie um novo. Se aparecer *"Nenhuma empresa disponível"*, é porque não há portfólio na conta — resolva isso em [business.facebook.com](https://business.facebook.com/) (Configurações da empresa) e volte.
A Meta lista *requisitos de publicação*. **Nesse momento você provavelmente não terá nenhum** — é normal. Clique em **Avançar**.
Revise os detalhes, o caso de uso e o portfólio. Use **Anterior** para ajustar algo ou **Criar app** (*Create app*) para concluir. O app é criado.
Ao terminar, você cai no **Painel** do app. A Meta **não tem mais** um item "WhatsApp" no menu lateral nem te leva direto para uma tela de configuração. O próximo passo começa pelo menu lateral **Casos de uso** — é por ali que se chega na Configuração da API. O passo 2 mostra o caminho exato.
{/* IMG: lista de casos de uso com "Conectar-se com clientes pelo WhatsApp" selecionado */}
***
## 2. Abra a Configuração da API e pegue as três informações que o Attende pede
Aqui é onde a Meta mudou as telas. O antigo "Início rápido" com um botão mágico não te leva mais direto pra lugar nenhum. O caminho real hoje é pelo **menu lateral**.
No painel do app, na barra lateral esquerda, clique em **Casos de uso** (*Use cases*). Na página que abrir, clique em **Personalizar** no caso de uso **"Conectar-se com os clientes pelo WhatsApp"**.
Agora aparece um submenu à esquerda (Permissões e recursos, Início rápido, Configuração da API, Configuração...). Clique em **Configuração da API** (*API Setup*). É nessa única tela que está quase tudo que o Attende precisa.
Na seção **Enviar e receber mensagens › Etapa 1**, ao lado do campo **De**, aparece **Identificação da conta do WhatsApp Business** seguida de um número longo e um ícone de copiar. É o que o Attende chama de **Business Account ID**. Clique no ícone de copiar e guarde.
O campo **De** já vem com um **número de teste da Meta** (válido 90 dias, **não é o da sua empresa** — não use ele em produção). Para usar o número real: \
▸ Clique no dropdown **De** e, no rodapé da lista, em **+ Adicionar telefone**.
\
▸ **Perfil do WhatsApp Business** — preencha **Nome de exibição** (o nome que o cliente vê no topo da conversa — use o nome real da marca, nada genérico; a Meta revisa isso, ver erro #131037 na etapa 5), **Fuso horário**, **Categoria** e descrição (opcional). Clique em **Avançar**.
\
▸ **Adicionar número** — informe o telefone com o código do país e escolha verificar por **SMS** ou **Ligação telefônica**. Clique em **Avançar**.
\
▸ **Verificar número** — digite o código que a Meta enviar.
De volta à Configuração da API, no dropdown **De**, selecione o **número da empresa** que você acabou de adicionar (não o de teste). Ao lado aparece **Identificação do número de telefone** com um ícone de copiar — é o **Phone Number ID** (um identificador numérico longo, **não** o número em si). Copie e guarde.
**Forma de pagamento.** Nessa mesma tela costuma aparecer *"Está faltando uma forma de pagamento"* / *"Você só pode iniciar mensagens em contas vinculadas a uma forma de pagamento"*. Sem forma de pagamento na conta, o canal **recebe** mensagens, mas você **não consegue iniciar** conversa (campanhas, primeiro contato). Clique em **Adicionar forma de pagamento** e cadastre um cartão antes de depender de envio ativo. **Os custos são da Meta, não do Attende.**
O botão **Gerar token de acesso** que aparece nessa tela cria um token **temporário**, só para teste — ele expira rápido e **não serve** para o Attende em produção. O token definitivo vem no passo seguinte.
### 2.1. Gere o token permanente (Usuário do Sistema)
O token que o Attende usa precisa ser **permanente**. Ele é gerado por um **Usuário do Sistema** no Meta Business — este é o procedimento oficial da Meta:
Acesse [business.facebook.com/latest/settings](https://business.facebook.com/latest/settings) e, na barra lateral, clique em **Usuários do sistema** (*System users*).
Clique em **Adicionar** (*Add+*), no canto superior direito, e siga os passos para criar o usuário do sistema.
Selecione o usuário criado e clique em **Atribuir ativos** (*Assign Assets*): \
▸ Selecione o seu **app** e ative **Gerenciar app** em **Controle total**.
\
▸ Selecione a sua **Conta do WhatsApp** e ative **Gerenciar Contas do WhatsApp Business** em **Controle total**.
\
▸ Clique em **Atribuir ativos**.
Clique em **Gerar token** (*Generate token*) e siga os passos. Adicione ao token estas três permissões: **`business_management`**, **`whatsapp_business_messaging`** e **`whatsapp_business_management`**.
Copie o token e guarde em local seguro — ele não aparece de novo. É esse token que vai no Attende.
Trate o token como uma senha. Quem tem ele consegue enviar mensagens pela sua conta. Não cole em e-mail, chat público nem prints. Se vazar, revogue no Meta Business e gere outro.
Anote os três (Phone Number ID, Business Account ID e o token permanente) num bloco de notas — você vai colar tudo no Attende no próximo passo.
{/* IMG: submenu da Personalização (Permissões e recursos, Início rápido, Configuração da API, Configuração...) com "Configuração da API" selecionado */}
{/* IMG: dropdown "De" aberto com a lista de números e o botão "+ Adicionar telefone" no rodapé */}
{/* IMG: Configurações da empresa → Usuários do sistema, com "Adicionar" destacado */}
{/* IMG: tela "Gerar token" com as permissões business_management, whatsapp_business_messaging e whatsapp_business_management marcadas */}
***
## 3. Cole as informações no Attende
Agora sim, no Attende:
No painel do Attende, **Configurações →** Caixas de entrada e clique em \*\*Adicionar Caixa de Entrada \*\*no canto superior direito.
Selecione **Cloud do WhatsApp** na lista de tipos de canal.
Se o sistema perguntar como conectar, escolha a opção de **configuração manual** (informar os dados da API).
Informe: \
▸ \*\*Nome da Caixa de Entrada \*\*— um nome interno (ex.: "WhatsApp Vendas") \
▸ **Número de telefone** — o número, com código do país (ex.: +55...) \
▸ **ID do número de telefone** — o que você copiou no passo 2 \
▸ **ID da conta do WhatsApp Business** — o que você copiou no passo 2 \
▸ **Chave da API** — o token permanente do passo 2
Ao salvar, o Attende gera um **endereço de webhook** e um **token de verificação**. Copie os dois — você vai usá-los no próximo passo, de volta na Meta.
O endereço de webhook tem o formato `https://.../webhooks/whatsapp/{seu-numero}`. Junto dele vem um **token de verificação** gerado pelo Attende. São essas duas coisas que conectam a Meta de volta ao Attende para as mensagens chegarem.
{/* IMG: tela do Attende após salvar, exibindo o webhook URL e o token de verificação para copiar */}
***
## 4. Devolva o webhook para a Meta
Volte ao painel da Meta para fechar o circuito — é isso que faz as mensagens recebidas chegarem no Attende.
No painel de desenvolvedor da Meta, na seção do WhatsApp, vá em **Configuração** (Configuration), na área de **Webhook**.
No campo de **Callback URL**, cole o endereço de webhook que o Attende gerou. No campo de **Verify token** (token de verificação), cole o token que o Attende gerou. Clique em **Verificar e salvar**.
Ainda na configuração do webhook, em **Gerenciar / Webhook fields**, ative a assinatura do campo **messages**. É isso que faz cada mensagem do cliente entrar na sua fila do Attende. Sem assinar `messages`, você até envia, mas não recebe.
{/* IMG: lista de webhook fields da Meta com o campo "messages" assinado/ativo */}
***
## 5. Deixe a conta aprovada na Meta (a etapa que mais trava)
A ligação técnica está feita. O que costuma demorar é a **Meta aprovar** sua conta. Enquanto ela não aprova, o canal aparece no Attende mas **não envia nem recebe de verdade**. Dois pontos para acompanhar — os dois acontecem **no Meta Business Manager**, não dentro do Attende.
### 5.1. WABA presa em "Pendente"
Se a Conta do WhatsApp Business (WABA) ficar **Pendente**, quase sempre é **informação incompleta no Portfólio de Negócios** — em especial o **site da empresa**. A Meta usa o site como prova de que o negócio é legítimo.
Em [business.facebook.com](http://business.facebook.com), confirme no topo da página qual portfólio empresarial está aberto (ele aparece com o nome ao lado de "Portfólio empresarial"). No menu lateral, clique no **ícone de engrenagem** (no canto inferior esquerdo) para abrir **Configurações**.
É onde ficam os dados do seu Portfólio de Negócios.
Nome da empresa, nome legal, categoria, descrição, endereço, telefone e, o mais importante, o **site da empresa**. Sem site? Use o link da página comercial do Facebook ou Instagram.
Vá em **Contas do WhatsApp → Visão Geral** e atualize a página. Na maioria dos casos o status muda de **Pendente → Aprovado** em poucos minutos.
Remova a WABA e crie uma nova — agora a Meta valida já com os dados completos. Resolve quase todos os casos persistentes. Se mesmo assim ficar horas pendente, acione o Suporte Comercial da Meta informando que atualizou o Portfólio com um site válido.
{/* IMG: formulário de detalhes da empresa com o campo "Site" destacado */}
### 5.2. Nome de exibição "Em revisão" (erro #131037)
Mesmo com a WABA aprovada, **cada número** precisa do **nome de exibição aprovado** antes de enviar. Se tentar enviar antes disso, aparece:
> **(#131037)** O número fornecido do WhatsApp precisa de aprovação do nome de exibição antes que a mensagem possa ser enviada.
É normal em número novo. O que fazer:
No Meta Business Manager, em **Configurações da Empresa → Contas → Contas do WhatsApp**, abra sua WABA e veja a aba de **Números de telefone**. O número mostra: "Revisão pendente", "Aprovado" ou "Rejeitado".
A revisão da Meta costuma levar de **24 a 48 horas**. Não há atalho. Quando aprovar, o erro some sozinho e o envio libera.
Clique em **Editar nome de exibição** e mande um nome que represente claramente a empresa ou marca. Consulte as [diretrizes da Meta](https://www.facebook.com/business/help/757569725593362) antes de reenviar.
Trocou de provedor recentemente? A revisão do nome pode reiniciar no novo Business Manager. Confira o status de aprovação antes de tentar enviar.
***
## 6. Pronto: o canal está no ar
Com a WABA **Aprovada** e o nome de exibição **Aprovado**, o canal funciona de verdade. A partir daí, dentro do Attende é igual a qualquer outro canal:
* As conversas do WhatsApp caem na mesma caixa de entrada, na mesma fila.
* Os mesmos status valem: **Aberto**, **Pendente**, **Resolvido**.
* Quem atende é quem você adicionou como **Colaborador** do canal.
Lembre de dar acesso ao canal para a equipe. Cadastrar a pessoa **não** faz ela ver as conversas — é preciso adicioná-la como colaboradora deste canal. Passo a passo em [Convidando sua equipe](https://ajuda.attende.online/primeiros-passos/convidando-sua-equipe).
O WhatsApp Oficial tem regras próprias da Meta que não existem nos outros canais — a janela de 24 horas, os templates, os limites de envio e os custos da Meta. Tem uma seção inteira sobre isso: comece pela [regra das 24 horas](https://ajuda.attende.online/5-whats-app-api-oficial-regras-da-meta/a-regra-das-24-horas-por-que-o-whats-app-bloqueia-a-conversa-e-como-resolver). Vale ler antes de disparar a primeira campanha.
***
## Prefere que a gente faça por você?
Esse processo tem várias etapas na Meta — e a gente sabe que app, token e webhook não é a praia de todo mundo. Se preferir não fazer sozinho, existe a **implementação assistida do Attende**:
* A nossa equipe **agenda uma sessão** com você.
* A gente faz **junto, ao vivo**: criação do Meta Business, conexão e verificação do número, criação do app e das credenciais, e a devolução do webhook.
* E ainda deixa o **Attende configurado** para você já começar a atender — canais, equipe e o básico no lugar.
Quer contratar? Fale com a gente pelo [suporte](https://ajuda.attende.online/planos-e-assinatura/como-funciona-o-suporte-do-attende) e peça a **implementação assistida do WhatsApp Oficial**. A gente cuida da parte chata para você só atender. Ponto.
***
## Não está dando certo?
A Meta não aceita um número já ativo no app do WhatsApp (comum ou Business). Desvincule o WhatsApp desse número primeiro, ou use um número novo dedicado ao atendimento. Depois recomece.
Confira se o **Callback URL** e o **Verify token** foram colados exatamente como o Attende gerou (sem espaço sobrando, sem cortar o final). Gere-os de novo no Attende se tiver dúvida e cole novamente na Meta.
Quase sempre é o campo **messages** não assinado no webhook da Meta. Volte em WhatsApp → Configuração → Webhook fields e ative **messages**. Envio funciona sem isso; recebimento, não.
Provavelmente você usou o token **temporário** (expira em 24h). Gere um token **permanente** via Usuário do Sistema no Meta Business e atualize-o no canal, em Configurações → Canais → (seu canal) → editar.
Confira a etapa 5: a **WABA** precisa estar **Aprovada** (não "Pendente") e o **nome de exibição** do número precisa estar **Aprovado** (não "Em revisão" / erro #131037).
Confirme que o **site da empresa** está preenchido no Portfólio de Negócios — é o motivo nº 1. Sem site, use o link da página do Facebook/Instagram. Salve, atualize, e se não destravar, **recrie a WABA**. Persistindo, acione o Suporte da Meta.
O nome de exibição do número ainda não foi aprovado. Veja o status no Business Manager: "Revisão pendente" → aguarde 24–48h; "Rejeitado" → reenvie um nome que represente a empresa claramente.
Conectar canal é função de Administrador. Se você entrou como Agente, peça ao Administrador da empresa para conectar ou te promover. Veja [Convidando sua equipe](https://ajuda.attende.online/primeiros-passos/convidando-sua-equipe).
Fale com a gente pelo [suporte](https://ajuda.attende.online/planos-e-assinatura/como-funciona-o-suporte-do-attende). E se preferir não passar por nada disso, peça a **implementação assistida** — a gente faz o processo inteiro junto com você. A gente resolve. Ponto.
***
**Em resumo**
O WhatsApp Oficial conecta pelo fluxo manual: crie o app na Meta, copie **Phone Number ID, Business Account ID e o token permanente**, cole no Attende, e devolva o **webhook + token de verificação** para a Meta (assinando o campo `messages`). Depois é só esperar a Meta aprovar — a **WABA** precisa sair de "Pendente" (preencha o site!) e o **nome do número** precisa ser aprovado (24–48h). Não quer fazer sozinho? A gente faz por você na implementação assistida. Profissional desde o primeiro contato. Ponto.