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ê?.
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).
1. Crie o app na Meta
Tudo aqui acontece no painel de desenvolvedor da Meta — ainda não no Attende. 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).
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).
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.
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.
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.
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.
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”.
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.
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.
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.
▸ 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.
▸ 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.
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.
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.
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.
▸ Selecione a sua Conta do WhatsApp e ative Gerenciar Contas do WhatsApp Business em Controle total.
▸ Clique em Atribuir ativos.
▸ 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.
4
Gere o token com as permissões certas
business_management, whatsapp_business_messaging e whatsapp_business_management.
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.
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
▸ **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
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.
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.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.
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”.
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.
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.
Não está dando certo?
O número que escolhi já tem WhatsApp
O número que escolhi já tem WhatsApp
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.
A verificação do webhook falhou na Meta
A verificação do webhook falhou na Meta
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.
Conecto, mas não recebo as mensagens dos clientes
Conecto, mas não recebo as mensagens dos clientes
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.
O token parou de funcionar / mensagens deixaram de sair
O token parou de funcionar / mensagens deixaram de sair
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.
O canal aparece no Attende mas não envia nem recebe
O canal aparece no Attende mas não envia nem recebe
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).
A WABA está “Pendente” há horas
A WABA está “Pendente” há horas
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.
Recebi o erro #131037 ao tentar enviar
Recebi o erro #131037 ao tentar enviar
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.
Empaquei e quero ajuda de gente de verdade
Empaquei e quero ajuda de gente de verdade
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.