Skip to main content

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.

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 — 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.

Eu mesmo conecto

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.

A gente faz por você

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 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ê?.
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). 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).
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 → Configurações da empresa. (Não tem isso pronto? É exatamente onde a implementação assistida entra.)
A criação segue o assistente da Meta, na ordem oficial abaixo (validado na documentação da Meta, atualizada em outubro de 2025).
1

Abra o painel de apps e clique em “Criar app”

Acesse o painel de apps da Meta, faça login com a conta do Facebook do responsável pela empresa e clique em Criar app (Create App).
Whatsapp1
2

Informe nome e e-mail do 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).
Whatsapp2
3

Selecione o caso de uso “Conectar-se com clientes pelo WhatsApp”

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.
Whatsapp4
4

Selecione (ou crie) o portfólio empresarial

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 (Configurações da empresa) e volte.
Whatsapp5
5

Passe pela tela de requisitos de publicação

A Meta lista requisitos de publicação. Nesse momento você provavelmente não terá nenhum — é normal. Clique em Avançar.
Whatsapp6
6

Confirme e crie o app

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.
Whatsapp7
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.

​
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.
1

No menu lateral, clique em “Casos de uso”

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”.
Whatsapp8
2

Abra “Configuração da API” no submenu

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.
Whatsapp9
3

Copie a “Identificação da conta do WhatsApp Business”

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.
Whatsapp10
4

Adicione o número PRÓPRIO da empresa

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.
Whatsapp11

▸ 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.
Whatsapp12

▸ 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.
Whatsapp13

▸ Verificar número — digite o código que a Meta enviar.
5

Selecione o número e copie a “Identificação do número de telefone”

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.
Whatsapp14
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:
1

Vá em Configurações da empresa → Usuários do sistema

Acesse business.facebook.com/latest/settings e, na barra lateral, clique em Usuários do sistema (System users).
2

Crie um Usuário do Sistema

Clique em Adicionar (Add+), no canto superior direito, e siga os passos para criar o usuário do sistema.
Whatsapp15
3

Atribua os ativos (Assign Assets)

Selecione o usuário criado e clique em Atribuir ativos (Assign Assets):
▸ Selecione o seu app e ative Gerenciar app em Controle total.
Whatsapp16

▸ Selecione a sua Conta do WhatsApp e ative Gerenciar Contas do WhatsApp Business em Controle total.
Whatsapp17

▸ Clique em Atribuir ativos.
4

Gere o token com as permissões certas

Whatsapp18
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.
Whatsapp20
5

Copie e guarde o token

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.

​
3. Cole as informações no Attende

Agora sim, no Attende:
1

Vá em Configurações → Canais → Adicionar canal

No painel do Attende, Configurações → Caixas de entrada e clique em **Adicionar Caixa de Entrada **no canto superior direito.
2

Escolha WhatsApp

Selecione Cloud do WhatsApp na lista de tipos de canal.
3

Selecione o modo de configuração manual

Se o sistema perguntar como conectar, escolha a opção de configuração manual (informar os dados da API).
4

Preencha os campos

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
Whatsapp19
5

Salve

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.
Whatsapp21
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.

​
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.
1

Abra WhatsApp → Configuração no painel do app

No painel de desenvolvedor da Meta, na seção do WhatsApp, vá em Configuração (Configuration), na área de Webhook.
2

Cole o webhook URL e o token de verificação

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.
3

Assine o campo “messages”

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.
Whatsapp22

​
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.
1

Abra as Configurações do portfólio

Em 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.
2

Vá em Configurações da Empresa → Informações da Empresa → Detalhes da empresa

É onde ficam os dados do seu Portfólio de Negócios.
Whatsapp23
3

Preencha tudo — principalmente o site

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.
4

Salve e atualize a página

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.
5

Se continuar pendente, recrie a WABA

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.

​
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:
1

Verifique o status do nome

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”.
Whatsapp24
2

Se “Revisão pendente”, aguarde

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.
3

Se “Rejeitado”, reenvie o nome

Clique em Editar nome de exibição e mande um nome que represente claramente a empresa ou marca. Consulte as diretrizes da Meta antes de reenviar.
Whatsapp25
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.
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. 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 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.
Fale com a gente pelo suporte. 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 resumoO 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.