A API oficial do WhatsApp é o caminho da Meta para empresas que precisam de estabilidade, selo oficial e mensagens a quem não escreveu nas últimas 24 horas. Mas ela não é a única opção: muitas imobiliárias começam com o número próprio, conectado por QR code, e depois combinam os dois.
Este guia explica a diferença, quando vale pagar pela API oficial e como a Viniun trabalha com vários números, grupos de envio, rodízio e aquecimento de chip novo.
Qual a diferença entre número próprio (QR code) e API oficial do WhatsApp?
O número próprio é um WhatsApp comum conectado ao sistema pela leitura de um QR code, como no WhatsApp Web. Não há cobrança por mensagem, mas o número pode ser bloqueado pelo WhatsApp se receber denúncias ou mandar muitas mensagens para quem não o tem na agenda.
A API oficial do WhatsApp (WhatsApp Business API, também chamada de Cloud API da Meta) é contratada pelo Gerenciador de Negócios da Meta. É estável e oficial, mas a Meta cobra pelas mensagens e, passadas 24 horas da última mensagem do cliente, só aceita modelo aprovado.
| Número próprio (QR code) | API oficial do WhatsApp | |
|---|---|---|
| Como conecta | Leitura do QR code | App no Gerenciador de Negócios da Meta |
| Custo por mensagem | Sem cobrança por mensagem | Cobrado pela Meta |
| Depois de 24h sem resposta do cliente | Texto livre | Só modelo aprovado pela Meta |
| Risco de bloqueio | Maior em disparos para lista fria | Menor, dentro das regras da Meta |
| Rodízio entre números | Sim, por grupo de envio | Não |
Como conectar a API oficial do WhatsApp na Viniun?
Em Marketing › WhatsApp › Provedores, a Viniun mostra os dois tipos lado a lado. Para a API oficial, o passo a passo é:
- No Gerenciador de Negócios da Meta, crie o app com WhatsApp e gere um token permanente (usuário do sistema);
- Cole o token, o ID da conta do WhatsApp Business, o ID e a chave secreta do app;
- Clique em Conectar número pelo painel: adicione o número, confirme o código por SMS e ligue o webhook, sem voltar ao site da Meta;
- Mande um "oi" do celular para o número. A conversa aparece no inbox com o selo Oficial.
As telas são da conta de demonstração da Viniun, com dados fictícios.
Os modelos de mensagem (templates da Meta) são criados na própria Viniun e enviados para aprovação. Segundo a tela do sistema, a Meta aprova em minutos ou horas. Só depois disso o modelo pode ser usado.
Dá para usar os dois ao mesmo tempo?
Sim. A aba Roteamento decide por qual canal cada mensagem sai. As regras podem valer sempre, dentro ou fora da janela de 24 horas, só em campanhas, só em notificações automáticas ou em determinado horário. Também dá para trocar de canal se o custo por mensagem passar de um valor.
Sem nenhuma regra, vale o padrão: o sistema usa o número próprio enquanto ele estiver no ar e cai para a API oficial quando não estiver. As abas Custos, Estatísticas e Logs mostram quanto saiu por cada canal e por quê.
Como funcionam vários números de WhatsApp na imobiliária?
Uma imobiliária pode ter um número para o atendimento, outro para captação de imóveis e outros para campanhas. Na Viniun, cada número é cadastrado em WhatsApp › Conexão, em três passos: nome, QR code, grupo de envio e aquecimento.
Grupo de envio e rodízio
Números do mesmo grupo de envio (por exemplo, "captacao") se revezam nas campanhas. A cada mensagem, o sistema escolhe o número do grupo que tem mais cota sobrando no dia. Cada número pertence a um grupo só.
O limite de mensagens por dia e por hora é do número, não da campanha. Se um número falha várias vezes seguidas, ele descansa uma hora, sai do rodízio e volta sozinho. A campanha só pausa quando o grupo inteiro está fora do ar. O rodízio vale para números próprios; o canal oficial não entra nele.
Agentes por número
Cada número também escolhe quais agentes de IA atendem por ele. Um número de captação pode ter um agente focado em proprietários, e o número principal, os agentes de vendas. Veja em agentes de IA no WhatsApp da imobiliária.
O que é aquecimento de número de WhatsApp?
Chip novo, ou parado há meses, que começa mandando muitas mensagens tem mais chance de ser bloqueado. O aquecimento faz o número começar devagar e subir aos poucos.
Na Viniun, ao cadastrar o número, você responde se o chip é novo ou ficou meses parado. Com o aquecimento padrão de 21 dias, o teto de mensagens de campanha fica assim:
- até o 3º dia: 10 mensagens por dia;
- até o 7º dia: 15 por dia;
- até o 14º dia: 25 por dia;
- até o 21º dia: 35 por dia;
- depois disso: o limite cheio definido para o número.
Durante o aquecimento, a cota do dia também é espalhada pelas horas, para não sair tudo de uma vez. Dá para mudar a quantidade de dias; a curva encolhe ou estica na mesma proporção. Número que já conversa há meses entra direto com o limite cheio.
Quando vale pagar pela API oficial do WhatsApp?
- Lista fria: para falar com quem nunca conversou com a imobiliária, a própria Viniun recomenda o número oficial com um modelo de Marketing, porque o número próprio pode ser bloqueado por denúncia;
- Avisos depois de 24 horas: lembrete de visita, baixa de preço e imóvel novo só saem pelo oficial com modelo aprovado;
- Estabilidade do atendimento: o número principal da casa não pode cair no meio de um lançamento.
Para o atendimento do dia a dia e para quem já conhece a imobiliária, o número próprio costuma atender bem. A recomendação do sistema é usar um número separado para campanhas, para não arriscar o número do atendimento. Veja como montar o envio em campanhas de WhatsApp para imobiliária e como a equipe atende em CRM com WhatsApp para imobiliária.
Como começar com vários números e a API oficial na Viniun
- Em Marketing › WhatsApp › Conexão, cadastre o número do atendimento e, se precisar, os números de campanha ou captação.
- Coloque os números de campanha no mesmo grupo de envio e ligue o aquecimento para os chips novos.
- Para a API oficial, vá em Provedores › Novo provedor, cole os dados do app da Meta e use Conectar número pelo painel.
- Crie os modelos de mensagem e espere a aprovação da Meta.
- Em Roteamento, defina quando cada mensagem sai pelo número próprio ou pela API oficial.
Mais sobre o módulo em CRM imobiliário com WhatsApp e IA e em integração e marketing. O que entra em cada plano está em Planos e preços.
Quer ver isso funcionando com os seus números e a sua equipe? Peça uma demonstração da Viniun.
Perguntas frequentes
A API oficial do WhatsApp é paga?
Sim. A Meta cobra pelas mensagens da API oficial. Na Viniun, a campanha pelo número oficial mostra o custo estimado por mensagem entregue antes do envio.
O que é a janela de 24 horas?
No WhatsApp oficial, depois de 24 horas da última mensagem do cliente, a empresa só pode retomar a conversa com um modelo aprovado pela Meta. Quando o cliente responde, a conversa livre volta.
Posso usar o número próprio e a API oficial juntos?
Sim. A aba Roteamento define por qual canal cada mensagem sai. Sem regra, o sistema usa o número próprio e cai para o oficial quando o próprio não está no ar.
Quantos números de WhatsApp posso conectar?
A Viniun trabalha com vários números por conta, cada um com limite por dia e por hora. O que entra em cada plano está na página de planos e preços.
Como funciona o aquecimento de chip novo?
O número começa com 10 mensagens de campanha por dia e sobe aos poucos até o 21º dia, quando passa a valer o limite cheio. A quantidade de dias pode ser ajustada.
Equipe Viniun
Time de produto e conteúdo da Viniun
Quem constrói a Viniun — CRM, site, WhatsApp com IA e gestão para imobiliárias, corretores e construtoras — conta aqui cada novidade da plataforma e o que aprende no dia a dia do mercado imobiliário.
Gostou? Receba os próximos no seu e-mail
O que muda na plataforma, explicado para quem usa, e ideias que dá para aplicar no mesmo dia em marketing, atendimento e gestão.
- No máximo 1 e-mail por semana
- Sem spam e sem repassar seus dados
- Cancele quando quiser, com um clique
