Conectar um número na API oficial do WhatsApp é uma sequência curta de telas — e mesmo assim é onde a maior parte das empresas trava. Quase nunca é a plataforma: é um número que ainda tem WhatsApp ativo, uma conta comercial criada em duplicidade, um nome de exibição que a Meta recusa ou uma pessoa sem permissão de administrador tentando autorizar. Este guia é a ordem certa: o que separar antes, o que decidir sobre o número, o que fazer nas primeiras 48 horas e o que faz o canal crescer em vez de ser bloqueado.
Neste artigo
- O que muda quando o número vai para a API
- O que ter antes de começar
- Número novo ou o da empresa?
- O passo a passo da conexão
- As primeiras 48 horas
- Limites, qualidade e aquecimento
- Opt-in: a parte que não é burocracia
- Modelos: o que aprova e o que reprova
- O custo, sem surpresa
- Coexistência: quando faz sentido
- Os sete erros que travam a conexão
- Quando vale a pena — e quando não vale
- Perguntas frequentes
O que realmente muda quando o número vai para a API
Antes de qualquer passo a passo, vale entender o que está sendo contratado, porque quase todo erro de conexão nasce de uma expectativa errada aqui.
- O número deixa de morar num aparelho. Ele passa a viver numa conta da Meta em nome da empresa. Não há celular que precise ficar ligado, não há código de seis dígitos no dia a dia e não há "dispositivo conectado".
- O acesso passa a ser por pessoa. Cada atendente entra com o usuário dele, e desligar alguém é revogar um acesso, não recuperar um telefone.
- Quem inicia conversa passa a seguir regra. Fora da janela de 24 horas, só se fala com o cliente por modelo de mensagem aprovado. Dentro da janela, texto livre.
- Existe custo por conversa. A Meta cobra por conversa iniciada, com valores diferentes conforme a categoria.
- O aplicativo WhatsApp Business normal deixa de ser o lugar do atendimento — ou continua, se você escolher a coexistência, que é um caminho à parte explicado adiante.
O resumo honesto: a API oficial não é uma versão melhorada do aplicativo. É outra coisa. Ela resolve equipe, histórico, automação, volume e segurança, e cobra em troca disciplina de processo e custo por conversa. Empresa com um atendente e vinte mensagens por dia raramente precisa disso.
O que você precisa ter antes de começar
Metade das conexões que travam, travam por falta de algo desta lista. Reúna tudo antes de abrir a tela de conexão:
- Um número de telefone que você controla e que consegue receber SMS ou chamada de voz para a verificação. Pode ser celular ou fixo.
- Uma conta no Facebook Business (Gerenciador de Negócios) da empresa. Se não existir, ela é criada no meio do processo — mas ter antes evita confusão.
- Um perfil pessoal do Facebook com acesso de administrador a essa conta comercial. A Meta exige uma pessoa física logada para autorizar.
- Os dados da empresa: razão social, CNPJ, endereço e site. Eles são usados no cadastro e depois na verificação.
- Uma decisão sobre o número: você vai usar um número novo ou o número que a empresa já usa hoje no WhatsApp?
Essa última pergunta é a mais importante de todas, e é o próximo assunto.
Número novo ou o número que a empresa já usa?
Há três cenários, e cada um tem uma consequência diferente:
- Número novo, sem WhatsApp. O caminho mais simples e sem risco. Em compensação, o número começa do zero: ninguém tem ele salvo, e ele vai precisar ser aquecido antes de qualquer volume.
- O número atual da empresa, migrando de vez. É o caminho que preserva o relacionamento — os clientes já têm esse contato salvo. Mas ele exige apagar a conta do WhatsApp Business naquele número antes de conectar, e o histórico de conversas do aplicativo não vai junto.
- O número atual, em coexistência. Modo em que o número funciona ao mesmo tempo no aplicativo e na API. É o caminho mais confortável para quem tem medo de perder o atendimento no celular, e ele traz para a plataforma parte do histórico e dos contatos recentes.
O erro mais caro dessa etapa: conectar um número novo e disparar para a base no dia seguinte. Número sem histórico, com volume alto e sem opt-in, é o retrato exato do que os sistemas da Meta bloqueiam. Se a decisão for número novo, o aquecimento não é opcional.
O passo a passo da conexão
Na prática, conectar pela plataforma é um fluxo curto. O que costuma levar tempo não é o clique, é a documentação.
- 1. Abrir a tela de conexão e escolher o trilho. Você escolhe entre conectar na nuvem (API oficial) ou pelo QR Code, e entende o risco de cada um antes de decidir.
- 2. Entrar com o Facebook. Abre um pop-up da própria Meta. É ali, e só ali, que os dados são informados — nenhum fornecedor sério pede sua senha do Facebook fora desse pop-up.
- 3. Selecionar ou criar a conta comercial. Se a empresa já tem Gerenciador de Negócios, escolha o existente. Criar um segundo por engano é a origem de metade dos problemas de permissão depois.
- 4. Criar ou escolher a conta do WhatsApp (WABA) dentro desse portfólio.
- 5. Informar o número e o nome de exibição. O nome é o que o cliente vê. Ele passa por análise e precisa ter relação com a empresa — nome genérico como "Atendimento" costuma ser recusado.
- 6. Verificar o número pelo código recebido por SMS ou chamada.
- 7. Aceitar as permissões e concluir. O número aparece conectado na plataforma.
Do clique até aqui, com tudo em mãos, são poucos minutos. O que vem depois é que define se o canal vai funcionar.
O que fazer nas primeiras 48 horas
Número conectado não é canal pronto. A sequência que evita os problemas mais comuns:
- Completar o perfil comercial: foto, descrição, endereço, site, horário de atendimento. Perfil vazio derruba confiança e atrapalha a verificação.
- Iniciar a verificação da empresa no Gerenciador de Negócios. Ela não é obrigatória para começar, mas é o que libera limites maiores e destrava o selo depois.
- Submeter os primeiros modelos de mensagem. Eles levam tempo para serem analisados, e sem modelo aprovado você não consegue iniciar conversa.
- Divulgar o número. Site, redes, assinatura de e-mail, Google Meu Negócio. Conversa recebida é o melhor sinal de qualidade que existe.
- Configurar a equipe e as regras de distribuição antes do volume chegar, não depois.
Limites, qualidade e o começo devagar
Todo número novo começa com um limite baixo de conversas iniciadas por dia, e sobe conforme envia com qualidade e recebe resposta. Esse degrau não se compra e não se apressa — ele é consequência do comportamento.
O que faz o número subir de patamar: conversas respondidas, poucas denúncias, poucos bloqueios e volume crescente de forma gradual. O que derruba: disparo para lista comprada, mensagem que o cliente não esperava, conteúdo que parece propaganda e texto igual enviado para milhares de pessoas ao mesmo tempo.
A leitura correta é tratar a primeira semana como aquecimento deliberado: poucos envios, para quem já conversou com a empresa, com conteúdo que pede resposta. Vale mais do que qualquer configuração.
Continue lendo de graça
Preencha uma vez e libere este e todos os outros artigos do blog. Não cobramos nada — só queremos saber para quem estamos escrevendo.
Leva 20 segundos. Prefere falar direto no WhatsApp?
Opt-in: a parte que não é burocracia
A regra é simples de dizer e cara de ignorar: a empresa só deveria iniciar conversa com quem autorizou receber mensagem dela naquele número. Não é só política da Meta — é o que separa um canal que cresce de um número que é denunciado até morrer.
Formas de opt-in que funcionam e ficam registradas:
- Caixa de aceite no formulário do site, com o texto dizendo claramente que a empresa vai enviar mensagens pelo WhatsApp.
- O próprio cliente iniciando a conversa — botão no site, link, QR code, anúncio que abre o WhatsApp. É o melhor opt-in que existe.
- Aceite no momento da compra ou do cadastro, com registro de data e origem.
- Confirmação na primeira mensagem, com opção de sair, para bases antigas.
E o que não vale: lista comprada, base de outro canal sem aviso, número coletado em evento sem menção a WhatsApp e planilha herdada de um vendedor que saiu.
Modelos de mensagem: o que aprova e o que reprova
Fora da janela de 24 horas, toda conversa começa por um modelo aprovado. Entender a lógica da análise economiza semanas:
- Categoria correta. Utilidade é para algo que o cliente espera, ligado a uma transação ou atualização. Marketing é para promoção e novidade. Autenticação é para código de acesso. Enviar marketing vestido de utilidade é o motivo número um de reprovação e, pior, de reclassificação depois.
- Variáveis com exemplo. Todo campo variável precisa de um exemplo real preenchido, senão reprova.
- Sem texto vago. Mensagem que não deixa claro quem está falando e por quê é recusada.
- Sem promessa e sem apelo excessivo. Caixa alta, excesso de emoji e urgência artificial pesam contra.
- Botões ajudam. Um botão de sair da lista em mensagem de marketing reduz denúncia, que é o que realmente protege o número.
Comece com três: uma confirmação, um aviso de status e uma retomada de conversa. Com esses três, quase toda operação sai do lugar.
O custo, sem surpresa
A cobrança da Meta é por conversa iniciada, com preço diferente por categoria e por país. A conversa aberta pelo cliente e respondida dentro da janela é a mais barata — em muitos casos, sem custo. A iniciada pela empresa por modelo de marketing é a mais cara.
A consequência prática é boa para quem faz as coisas direito: quanto mais o cliente inicia a conversa, menor o custo do canal. Investir em botão no site, link em anúncio e QR code impresso não é só marketing — é redução direta de custo operacional.
Um exemplo para dar escala. Uma empresa que envia 3.000 mensagens de retomada por mês, todas iniciadas por ela em categoria de marketing, paga um valor; a mesma empresa que consegue trazer metade desse contato pelo cliente iniciando a conversa paga sensivelmente menos e ainda tem taxa de resposta maior, porque quem escreveu primeiro está interessado. O canal barato e o canal eficaz, aqui, são o mesmo canal.
Coexistência: quando faz sentido
A coexistência permite que o número continue funcionando no aplicativo WhatsApp Business e, ao mesmo tempo, esteja na plataforma. É o caminho indicado quando:
- A equipe tem medo de perder o atendimento do celular durante a transição.
- Existe um histórico grande no aparelho que a empresa não quer abandonar de uma vez.
- O dono atende pessoalmente e quer continuar respondendo pelo celular, enquanto a equipe usa a plataforma.
E quando não faz sentido: operação com várias pessoas, volume alto ou necessidade de automação desde o primeiro dia. Nesses casos, manter o celular na jogada só mantém a bagunça que motivou a mudança.
Os sete erros que travam a conexão
- Número já em uso no WhatsApp sem ter sido apagado antes, quando a escolha não foi coexistência.
- Criar um Gerenciador de Negócios novo quando a empresa já tinha um, gerando dois portfólios e permissões partidas.
- Nome de exibição genérico ou sem relação com a empresa, que volta reprovado.
- Pessoa sem permissão de administrador tentando autorizar. O pop-up abre, mas não conclui.
- Número que não recebe SMS nem chamada — VoIP e ramal costumam falhar na verificação.
- Bloqueador de pop-up impedindo a janela da Meta de abrir. É banal e trava muita gente.
- Pendência financeira ou de verificação na conta comercial, que impede o envio mesmo com tudo conectado.
Quando a API oficial vale a pena — e quando não vale
Vale quando existe pelo menos um destes: mais de uma pessoa atendendo no mesmo número; necessidade de histórico que não se perca quando alguém sai; automação de primeira resposta e qualificação; envio de confirmação, cobrança ou aviso em volume; integração com CRM, sistema ou loja; e exigência de controle sobre o que é dito em nome da marca.
Não vale quando a empresa tem um atendente, poucas conversas por dia e nenhum plano de crescer o canal. Nesse caso, o aplicativo resolve, e o custo por conversa não se paga.
A pergunta que decide, na prática, não é sobre tecnologia: se a pessoa que atende hoje sair amanhã, a empresa perde as conversas? Se a resposta for sim, o número está no lugar errado — e essa é a razão pela qual a maioria das empresas acaba migrando, mesmo as que não tinham problema de volume.
Perguntas frequentes
Quanto tempo leva para conectar um número na API oficial do WhatsApp?
A conexão em si leva poucos minutos quando tudo está separado: conta comercial no Gerenciador de Negócios, uma pessoa com acesso de administrador, o número que recebe SMS ou chamada, os dados da empresa e o nome de exibição escolhido. O que costuma alongar o processo não é o clique e sim o que vem em volta. O nome de exibição passa por análise e pode voltar reprovado se for genérico ou não tiver relação com a empresa. Os primeiros modelos de mensagem precisam ser submetidos e analisados antes de você conseguir iniciar conversa, e esse prazo não depende de você. A verificação da empresa no Gerenciador de Negócios, que libera limites maiores, envolve documentação e tem prazo próprio. E se a escolha for migrar o número que a empresa já usa, ainda existe a etapa de apagar a conta do aplicativo antes de conectar. Na prática, conte minutos para conectar e alguns dias para o canal estar realmente operando.
Posso usar o mesmo número que a empresa já usa no WhatsApp Business?
Pode, e existem dois caminhos com consequências diferentes. O primeiro é migrar de vez: você apaga a conta daquele número no aplicativo WhatsApp Business e conecta o número à API. Isso preserva o relacionamento, já que os clientes têm esse contato salvo, mas o histórico de conversas que está no aparelho não vai junto para a plataforma. O segundo caminho é a coexistência, em que o número continua funcionando no aplicativo e ao mesmo tempo passa a existir na plataforma, trazendo parte dos contatos e das conversas recentes. A coexistência é confortável para quem tem medo de perder o atendimento do celular durante a transição, ou quando o dono quer continuar respondendo pelo aparelho enquanto a equipe usa o sistema. Ela faz menos sentido em operação com várias pessoas, volume alto ou necessidade de automação desde o primeiro dia, porque manter o celular na jogada mantém justamente a bagunça que motivou a mudança.
Por que a conexão do número falha ou fica travada?
Sete causas respondem pela grande maioria dos casos. O número ainda tem WhatsApp ativo e não foi apagado antes, quando a escolha não foi coexistência. Foi criado um Gerenciador de Negócios novo em vez de usar o que a empresa já tinha, o que parte as permissões entre dois portfólios. O nome de exibição é genérico, como Atendimento ou Vendas, e volta reprovado por não ter relação com a empresa. Quem está tentando autorizar não tem acesso de administrador na conta comercial, então o pop-up abre mas não conclui. O número não recebe SMS nem chamada de voz, o que é comum em VoIP e em ramal de central telefônica. O bloqueador de pop-up do navegador impede a janela da Meta de abrir, que é uma causa banal e frequente. E, por fim, existe pendência financeira ou de verificação na conta comercial, situação em que o número conecta mas o envio continua barrado.
A conexão é o começo. O canal é o que vem depois.
O VeyloCRM conecta seu número à API oficial do WhatsApp com a conta no nome da sua empresa, organiza equipe e histórico, cuida dos modelos de mensagem e acompanha qualidade e limites do número para você não descobrir problema pelo bloqueio.