Navegar na CentralConectar o seu WhatsApp

Conectar o seu WhatsApp

Escolha o WhatsApp, aceite a política de mensagens da Meta, autorize o número na janela oficial da Meta, com o app no celular ou só pelo BotoZap, e conte sobre a sua empresa.

Atualizado em

Conectar é ligar o número de WhatsApp da empresa ao BotoZap pela conexão oficial da Meta, a dona do WhatsApp. Você não instala nada no computador: a autorização acontece numa janela da própria Meta, com a conta do Facebook que administra a empresa. O BotoZap nunca vê a sua senha do Facebook.

A conexão guiada segue esta ordem: escolher o WhatsApp, aceitar a política de mensagens e autorizar o número na janela da Meta, na mesma tela, escolher quanto das conversas antigas trazer (só com o app no celular) e contar sobre a empresa. Depois vem a primeira conversa de teste, que confirma que tudo funciona.

Antes de começar

  • Tenha uma conta do Facebook com permissão para administrar a empresa. Se a empresa ainda não tem cadastro na Meta, a janela da Meta pode oferecer a criação durante a conexão.
  • Tenha por perto o celular com o número que você vai conectar.
  • Se você atende várias empresas, escolha no seletor do topo qual cliente vai receber o número. Com mais de um cliente e nenhum escolhido, a tela pergunta Para qual negócio é a conexão? e lista os negócios: clique no certo e a conexão segue para ele.

Com o app no celular ou só pelo BotoZap

O número pode ficar de dois jeitos depois da conexão. Você não precisa escolher antes: na janela da Meta, você digita o número e ela reconhece o caso.

  • Com o app no celular. Você continua usando o aplicativo WhatsApp Business no celular, com o mesmo número, e passa a atender também pelo BotoZap. É o caminho para quem já atende pelo app e não quer abrir mão dele. A Meta confere se o número pode funcionar nos dois lugares e orienta, na própria janela, sobre o histórico de conversas e os aparelhos conectados. (Na Meta, esse modo se chama coexistência.)
  • Só pelo BotoZap. O número passa a funcionar só pelo BotoZap, sem o aplicativo no celular. Vale para um número que ainda não está no WhatsApp: o código de confirmação chega por SMS ou ligação. Não use um número que já atende em outra plataforma sem desconectá-lo de lá antes.

Os dois modos aparecem com esses nomes em Canais, depois da conexão, e em Links de setup, onde você pode limitar o link a um deles. Um link limitado a um modo mostra só aquele modo na página que o seu cliente abre.

Passo a passo

1. Escolha o WhatsApp

Abra Configurações › Conectar. A tela pergunta Qual canal você quer conectar? e mostra dois cartões: WhatsApp e Instagram. Clique em WhatsApp. O outro canal pode ser conectado depois. Para começar pelo Instagram, veja Conectar e atender pelo Instagram.

2. Aceite a política e abra a janela da Meta

A tela Conectar o WhatsApp mostra, em miniatura, as três telas que a janela da Meta exibe, nesta ordem: Entrar, Confirmar e Número.

  1. Marque a caixa Li a Política de Mensagens do WhatsApp e não vou usar para os fins proibidos. O link Ver os usos proibidos abre a lista. Na primeira conexão, o botão só libera depois da caixa marcada.
  2. Clique em Abrir a janela da Meta. O painel mostra Continue na janela da Meta enquanto ela estiver aberta. Se a janela sumiu, ela pode estar atrás da página do BotoZap.

Sem Facebook? Clique em Não tenho Facebook. Aparecem duas saídas: Criar um Facebook, que pode ser um perfil pessoal (o cadastro da empresa na Meta é feito depois, dentro da janela), ou Conectar o Instagram, que não precisa de Facebook. O WhatsApp fica para depois.

Por que existe a política de mensagens

A Meta proíbe alguns usos do WhatsApp Business, como campanhas eleitorais, candidatos ou partidos, jogos de azar onde eles são restritos, conteúdo para adultos, armas de fogo e drogas ilícitas, além de qualquer outro uso que a Política de Mensagens da Meta proíba. Um número usado para esses fins pode ser bloqueado pela Meta. O BotoZap registra a sua declaração antes de qualquer conexão e não conecta números sem ela.

A declaração vale para o workspace. Quando a Meta muda o texto da política, a próxima conexão pede um novo aceite.

O que preparar em cada caso

  • Meu número está no app WhatsApp Business: atualize o app (o WhatsApp comum não funciona), remova no app a Página e a conta do Instagram vinculadas, em Configurações → Facebook e Instagram, e tenha o celular por perto. Nunca apague nem desconecte a conta do WhatsApp para liberar o número.
  • É um número novo, sem WhatsApp: tenha o aparelho por perto para receber o código por SMS ou ligação (para número fixo, escolha ligação).

Se algo der errado, o painel pergunta o que aconteceu e mostra a orientação daquele caso.

3. Autorize na janela da Meta

Na janela da Meta, você:

  1. Se este navegador não estiver logado no Facebook, a janela começa em Entrar no Facebook. Entre com o seu Facebook, que pode ser o pessoal, o mesmo do Instagram. Nada é publicado. Depois de entrar, feche essa janela e clique em Tentar de novo no BotoZap: a janela que pediu o login não devolve a conexão, mesmo que você vá até o fim nela. A janela nova já abre logada.
  2. Em Conecte sua conta facilmente a Bytecraft, clica em Continuar. Bytecraft é a empresa do BotoZap, aprovada pela Meta para conectar o WhatsApp de outras empresas.
  3. Em Adicione seu número de telefone do WhatsApp, escolhe um número que já está na sua conta da Meta ou Insira um novo número de telefone. Para um número novo, informe o país e o número e escolha como receber o código: SMS ou ligação.
  4. Escolhe o Portfólio empresarial e a Conta do WhatsApp Business, ou cria novos, e clica em Avançar.
  5. Revisa o que o BotoZap vai poder acessar e clica em Confirmar.
  6. Confirma o número. Um número novo recebe um código por SMS ou ligação: digite-o e avance. Um número do aplicativo WhatsApp Business é confirmado pelo próprio app: a Meta mostra um QR code para escanear no celular. Mantenha o app aberto alguns minutos depois de conectar.
  7. Na tela que diz que a conta está conectada, clica em Concluir. A forma de pagamento da Meta, oferecida ali, pode ser cadastrada depois.

A janela fecha sozinha no fim. No painel aparece Conectando seu WhatsApp, com quatro passos que avançam sozinhos: Autorização recebida da Meta, Conferir sua conta e o número, Salvar a conexão e Ativar o recebimento de mensagens. Costuma levar menos de um minuto: não feche nem atualize a página.

Dica: com um número do aplicativo WhatsApp Business, a etapa na Meta pode levar vários minutos, porque você alterna entre a janela e o celular. Não feche a janela no meio. Se o painel mostrar Ainda aguardando a Meta, siga pela janela até ela fechar sozinha.

4. Escolha quanto das conversas antigas trazer

Só aparece quando o número fica com o app no celular. A tela Trazer as conversas antigas? oferece Não trazer, Último mês (já marcado, é o padrão) e Últimos 6 meses. Clique em Confirmar e depois em Continuar. Depois de confirmar, só dá para mudar conectando o número de novo. Veja Conversas antigas do app WhatsApp Business.

5. Conte sobre a sua empresa

Na primeira conexão, a tela seguinte se chama Agora conte sobre sua empresa.

  1. Confira o Nome da empresa. O BotoZap sugere o nome do perfil do WhatsApp que acabou de ser conectado.
  2. Em O que você quer fazer primeiro?, escolha Atender meus clientes, Enviar avisos e campanhas ou Integrar ao meu sistema.
  3. Clique em Continuar para o teste.

A escolha define o teste que vem a seguir: Integrar ao meu sistema leva à tela Vamos fazer sua primeira entrega., para enviar pela API; as outras levam à tela Vamos fazer a primeira conversa. Se você já respondeu essa pergunta antes, o BotoZap pula esta etapa.

O que acontece depois

  • O BotoZap confere o número com a Meta e abre o teste: Vamos fazer a primeira conversa. ou, para quem escolheu Integrar ao meu sistema, Vamos fazer sua primeira entrega. Veja Primeira conversa de teste.
  • O número passa a aparecer em Configurações › Canais, com a situação de cada etapa.
  • No modo Com o app no celular, o BotoZap pede à Meta, logo depois da conexão, os contatos do app e, conforme a sua escolha, as conversas do último mês ou dos últimos 6 meses (sem resposta, vale o último mês). As conversas antigas chegam aos poucos em Conversas, já como lidas, e não acionam agentes nem follow-ups. Fotos, vídeos, áudios e documentos vêm só das mensagens dos últimos 14 dias antes da conexão; os mais antigos aparecem sem o arquivo.
  • Para as conversas antigas virem, o compartilhamento do histórico precisa estar ligado no app WhatsApp Business. Se estiver desligado, a Meta não envia nada e Configurações › Canais mostra o aviso Não importamos as conversas antigas do número…. Para importar, ative o compartilhamento no app e conecte o número de novo: a pergunta das conversas antigas volta, e o BotoZap pede o histórico dentro das 24 horas que a Meta dá para isso.
  • Se a autorização foi salva mas a conexão ainda não terminou, aparece Autorização salva. Ainda falta concluir a conexão. Clique em Ver o que falta para conectar para ver a pendência e o botão que resolve.

Enquanto a conexão guiada não termina, quem já autorizou e volta para Configurações › Conectar segue direto para a conversa de teste; na tela Conectar o WhatsApp, o link Retomar minha conexão faz o mesmo.

Conectar outro número

Depois da primeira conversa de teste, Configurações › Conectar serve para conectar mais canais: a tela abre em Qual canal você quer conectar?, para o cliente escolhido no seletor do topo. Clique em WhatsApp para conectar outro número. O botão Conectar meu WhatsApp, em Configurações › Canais, faz a mesma conexão. Veja Canais.

Problemas comuns

Aparece "Conexão cancelada. Você pode tentar de novo quando quiser." A janela da Meta foi fechada antes do fim. Clique em Tentar de novo.

Aparece "A janela pediu para entrar no Facebook". A janela da Meta abriu na tela de login do Facebook, e uma janela que passa pelo login não devolve a conexão ao BotoZap, mesmo que você continue até o fim nela. Entre no Facebook, feche a janela da Meta e clique em Tentar de novo: a janela nova já abre logada. O painel mostra essa tela e dois caminhos: Não tenho Facebook: criar conta e Esqueci a senha do Facebook. Em Configurações › Conectar, aparece também Conectar o Instagram, para começar pelo Instagram, que não precisa de Facebook.

Aparece "Em qual tela a janela fechou?". A janela fechou depois do login, e a Meta não informa em qual tela. Toque na imagem da tela onde você parou, ou em Depois do número ou Não lembro: o painel mostra o que fazer naquela tela, e a resposta ajuda o suporte a chamar você.

Aparece "Não foi possível concluir" logo depois de clicar em Abrir a janela da Meta. A janela da Meta não carregou. Extensões que bloqueiam rastreadores costumam impedir a janela de abrir. Libere o site do BotoZap na extensão e clique em Tentar de novo.

Aparece "Uma conexão está sendo concluída. Aguarde antes de tentar novamente." Existe uma autorização terminando. Espere alguns instantes e atualize a página.

Aparece "O negócio selecionado mudou. Reabra a conexão." O cliente escolhido no topo mudou no meio da conexão. Confira o cliente e comece de novo.

Aparece "Esta conta ainda não tem um negócio para receber a conexão." Cadastre um cliente em Configurações › Clientes. Veja Clientes.

Não sei se o meu número pode ficar com o app no celular. Quem confere é a Meta, durante a janela. Se ela recusar (veja Erros da Meta), conecte outro número, que ainda não esteja no WhatsApp, ou fale com o suporte pelo link Fale com a gente no WhatsApp, no rodapé da tela.

Aparece "O WhatsApp Business do celular saiu da conexão". No modo Com o app no celular, reinstalar o WhatsApp Business, trocar de aparelho ou registrar o número de novo no app faz a Meta pausar o número no BotoZap. Abra o WhatsApp Business no celular e termine o registro, deixando marcada a opção de continuar conectado. Em alguns minutos o número volta sozinho e o aviso some. Não desconecte o número no BotoZap: desconectar obriga a fazer a conexão de novo.

A janela da Meta mostrou um erro com um código, como (#2388091). Veja Erros da Meta, logo abaixo.

Erros da Meta

Estes avisos aparecem dentro da janela da Meta, não no painel do BotoZap. A maioria termina com um código entre parênteses, como (#2388091). Procure o código abaixo e siga o que fazer.

Atenção: nunca passe a ninguém o código que chega por SMS ou ligação, nem a senha do Facebook. O suporte do BotoZap não pede esses dados.

"Request code failed" ou "unknown" (#2388091)

A mensagem completa costuma ser Request code failed: Our servers are temporarily unavailable. Please wait 1 hour before trying again. Apesar do texto, a Meta não está fora do ar: depois de várias tentativas de receber o código de confirmação, ela bloqueia novos códigos para o número por cerca de 1 hora. Se você tentar de novo antes disso, a mensagem pode virar só unknown (#2388091).

  1. Veja se o número já foi cadastrado antes na Meta, por exemplo no Gerenciador de Anúncios ou numa conta do WhatsApp criada direto na Meta. Esse cadastro antigo trava o código: exclua o número de lá e tente de novo.
  2. Se o número usa o aplicativo WhatsApp Business, ele não precisa de código por SMS. Clique em Abrir a janela da Meta, digite o número e a Meta oferece a confirmação pelo próprio app, com um QR code.
  3. Se o número é fixo, ele não recebe SMS. Na hora de receber o código, escolha Ligação telefônica.
  4. Espere 1 hora antes de pedir outro código.

"Esse número de telefone já está registrado em uma conta do WhatsApp" (#2494064)

O número já está em uso em outro lugar: no aplicativo WhatsApp ou WhatsApp Business do celular, ou em outra plataforma que usa a conexão oficial da Meta. O que fazer depende de onde ele está:

  • No aplicativo WhatsApp Business, e você quer continuar usando o app: no celular, abra o WhatsApp Business, vá em Configurações, abra a opção que liga o app ao Facebook e remova esse vínculo. Ele costuma impedir a Meta de oferecer a conexão junto com o app. Depois, volte ao BotoZap e clique em Abrir a janela da Meta: a Meta reconhece o número do app.
  • Em outra plataforma ou provedor: peça a quem atende o número hoje para desconectá-lo ou migrá-lo para fora da conta dele. Depois, tente de novo.
  • No aplicativo e você quer usar o número só pelo BotoZap: o número precisa sair do app antes, apagando a conta do WhatsApp nele. Depois, conecte de novo.

Importante: apagar a conta do WhatsApp tira o número do aplicativo e apaga o histórico de conversas do celular. Se você quer manter o app ou as conversas, conecte o número junto com o app, como no primeiro item.

"Número não qualificado" (#3441045)

Aparece ao conectar um número do aplicativo WhatsApp Business, com a frase mais atividades no app WhatsApp Business são necessárias. A Meta só libera usar o número no app e no BotoZap ao mesmo tempo quando ele tem uso frequente no aplicativo WhatsApp Business. Ela não informa quanto uso é preciso.

Continue atendendo pelo app normalmente e tente de novo em alguns dias. Se não puder esperar, conecte outro número, que ainda não esteja no WhatsApp.

O seu número já aparece na lista da Meta

Na etapa Adicione seu número de telefone do WhatsApp, a janela pode listar números que já estão na sua conta da Meta, por exemplo se você cadastrou o número antes no Gerenciador de Anúncios ou começou um cadastro direto na Meta. Se o seu número está na lista, selecione o número em vez de Insira um novo número.

Se a Meta pedir o código e ele não chegar, ou aparecer o erro #2388091, o cadastro antigo pode estar travando. Exclua o número de onde ele foi cadastrado antes na Meta e conecte de novo.

Um item chamado Test Number, com número que começa em +1 555, é um número de teste da própria Meta. Ele não serve para atender clientes: não escolha esse.

A janela da Meta fica em branco ou fecha sem concluir

  • Abra o BotoZap no Chrome ou no Safari. Quando você toca num link dentro do Facebook, do WhatsApp ou de outra rede social, a página abre num navegador do próprio app, que costuma travar a janela da Meta.
  • Permita cookies e janelas pop-up no navegador.
  • Desligue extensões que bloqueiam anúncios ou rastreadores, ou libere o site do BotoZap nelas.

Depois, clique em Tentar de novo.

O erro continua ou não está aqui

Fale com o suporte pelo link Fale com a gente no WhatsApp, no rodapé da tela, e mande um print da janela da Meta com a mensagem de erro.