Como conectar o seu número na API oficial do WhatsApp
Para conectar o número, você cria a conta na FlashConnect, abre a tela WhatsApp, escolhe “Junto com o app” (coexistência) ou “API oficial” (número novo) e clica em Conectar WhatsApp. A janela oficial da Meta pede login no Facebook, a empresa e o número; ao terminar, o número aparece como Registrado no painel. Leva poucos minutos e você não passa senha para ninguém.
Atualizado em
O que preciso antes de conectar o número?
- App WhatsApp Business instalado e atualizado (versão 2.24.17 ou mais nova).
- Número em uso no app há pelo menos 7 dias.
- Ser administrador do Facebook da empresa (o portfólio empresarial na Meta).
- Um computador com navegador que permita a janela (pop-up) da Meta.
- O número não pode estar conectado a outro provedor de API. Se estiver, desconecte antes (veja os erros abaixo).
Esses requisitos são da coexistência. Entenda cada um em como funciona a coexistência.
Como conectar o número, passo a passo?
- Crie a contaEm "Criar conta", informe nome, e-mail e senha e confirme o e-mail. No primeiro acesso, finalize o cadastro: tipo (empresa ou desenvolvedor), nome da empresa, nicho e o código de convite. Hoje o acesso é só por convite.
- Abra a tela WhatsAppNo menu do painel, entre em WhatsApp. Escolha "Junto com o app" para manter o número no celular (coexistência) ou "API oficial" para um número novo, que passa a funcionar só pela plataforma.
- Clique em Conectar WhatsAppAbre a janela oficial da Meta (cadastro incorporado, ou Embedded Signup). Faça login com o Facebook de quem administra a empresa.
- Escolha a empresa e o númeroSelecione ou crie o portfólio empresarial e informe o número. Siga as confirmações que a Meta pedir até o fim do fluxo.
- Pronto: número conectadoDe volta ao painel, a conta aparece como conectada, com o selo "Junto com o app do celular" quando for coexistência e o número como "Registrado".
- Acompanhe a importaçãoEm coexistência, a FlashConnect pede à Meta os contatos e o histórico do app. O painel mostra o progresso. O prazo da Meta é de 24 horas depois da conexão.
- Cadastre os cartõesO cartão da assinatura na FlashConnect libera os 5 dias grátis e o envio de mensagens. O cartão na Meta, no WhatsApp Manager, paga as mensagens cobradas pela Meta. O painel tem o passo a passo em Configurações.
- Faça um testeMande uma mensagem de outro celular para o número e veja a conversa chegar na caixa de entrada.
A opção "API oficial" para número novo já aparece no painel, mas o caminho que usamos com clientes até hoje é a coexistência. Se for conectar um número novo, fale com a gente antes.
O que pode dar errado ao conectar e como resolver?
| O que aparece | Causa provável | Como resolver |
|---|---|---|
| A Meta diz que a empresa já compartilha a conta do WhatsApp com um parceiro (erro 2655093) | O número ainda está ligado a outro provedor, às vezes com uma linha de crédito antiga presa | Peça ao provedor anterior para remover o vínculo. Se ele não existir mais, abra um chamado no suporte da Meta. |
| "O número não se qualifica para registro ou migração" (erro 3441034) | O número já está em coexistência com outro app | No app WhatsApp Business, desconecte o parceiro atual e tente de novo. A integração antiga deixa de funcionar. |
| A Meta recusa o número por tempo de uso ou versão do app | Menos de 7 dias de uso ou app desatualizado | Atualize o app e espere completar 7 dias de uso. |
| A janela da Meta não abre | Bloqueador de pop-up do navegador | Permita pop-ups para o painel e clique em Conectar WhatsApp de novo. |
| "Nenhum número foi encontrado na conta do WhatsApp conectada" | O fluxo terminou sem número na conta escolhida | Refaça a conexão escolhendo a conta onde o número está. |
| Número "Não registrado" ou conta com erro no painel | A Meta não concluiu o registro, ou o acesso foi revogado | Conecte de novo pelo botão Conectar WhatsApp. Se persistir, fale com o suporte. |
| Importação de contatos e histórico falhou ou expirou | O pedido não foi aceito dentro das 24 horas | Dentro do prazo, tente de novo pelo painel. Depois dele, só desconectando e conectando o número de novo. |
| Importação "recusada" | O compartilhamento do histórico foi recusado no app | Os contatos e as novas conversas funcionam normalmente; o histórico antigo não vem. |
O que fazer depois de conectar?
- Abra o app no celular pelo menos a cada 13 dias, ou a Meta desliga a conexão.
- Configure o atendimento: caixa de entrada, agentes de IA e templates.
- Confira quanto vai pagar em planos e preços.
Perguntas frequentes
Quanto tempo leva para conectar o número?
Poucos minutos. O fluxo é a janela oficial da Meta: login no Facebook, escolha da empresa e do número e confirmação.
Preciso passar minha senha do Facebook para a FlashConnect?
Não. O login acontece na janela oficial da Meta. A FlashConnect recebe só a autorização para operar o número, e você pode revogar essa autorização na Meta quando quiser.
Meu número continua funcionando no celular?
Sim, se você escolher Junto com o app (coexistência). Na opção API oficial, o número passa a funcionar só pela plataforma.
Posso conectar mais de um número?
Sim. Cada número conectado entra na assinatura pela faixa de preço correspondente, a partir da próxima cobrança.
Meu número está em outro provedor de API. Consigo trazer?
Sim, mas antes é preciso desconectar o provedor atual. Se o número estiver em coexistência com outro app, desconecte o parceiro no próprio app WhatsApp Business; se a Meta acusar vínculo com parceiro, peça ao provedor anterior para remover.
Preciso cadastrar cartão para conectar?
Não para conectar. Sem cartão você conecta o número e vê o painel, mas enviar mensagens, criar templates, gerar chave de API e configurar webhook pedem o cartão, que libera 5 dias grátis.
Quer usar a FlashConnect?
O acesso está sendo liberado por convite. Fale com a gente no WhatsApp.
Pedir convite no WhatsApp