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.
- 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.
- 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ê:
- 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.
- 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.
- 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.
- Escolhe o Portfólio empresarial e a Conta do WhatsApp Business, ou cria novos, e clica em Avançar.
- Revisa o que o BotoZap vai poder acessar e clica em Confirmar.
- 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.
- 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.
- Confira o Nome da empresa. O BotoZap sugere o nome do perfil do WhatsApp que acabou de ser conectado.
- Em O que você quer fazer primeiro?, escolha Atender meus clientes, Enviar avisos e campanhas ou Integrar ao meu sistema.
- 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).
- 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.
- 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.
- Se o número é fixo, ele não recebe SMS. Na hora de receber o código, escolha Ligação telefônica.
- 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.
