Que número usar na Evolution API e na Z-API? Número virtual que recebe o código do WhatsApp
Por NumioPublicado em
A Evolution API (no modo Baileys) e a Z-API não criam conta de WhatsApp: elas se conectam a uma conta que já existe, como um aparelho conectado, igual ao WhatsApp Web, lendo o QR Code ou digitando um código de pareamento. Por isso o número precisa estar ativado antes no app do WhatsApp ou do WhatsApp Business, num celular, e pra isso precisa receber o código de verificação. Serve número de celular, número fixo ou número virtual.
O número fixo virtual da Numio (R$ 25,90/mês, ou R$ 16,90/mês no anual) é ativado pelo "Ligue para mim" do app: o WhatsApp liga, a Numio atende sozinha e o código de 6 dígitos aparece no painel. Com o número ativo no app, você cria a instância na Evolution API ou na Z-API e conecta pelo QR Code. Não precisa de chip nem de aparelho novo: o app pode ficar no celular que você já usa, ao lado do seu WhatsApp pessoal.
Use um número separado do principal da empresa. Conexão não oficial pode levar a conta a ser banida, e o número da Numio não muda essa chance, nem pra mais nem pra menos. Banimento depois da ativação não dá direito a troca de número nem a reembolso. O que o número separado faz é proteger o contato que seus clientes já têm salvo.
Como a Evolution API e a Z-API usam o número?
Depende do tipo de conexão. As ferramentas abaixo são as mais usadas no Brasil; só uma delas, a conexão oficial da Evolution API, coloca o número na plataforma da Meta.
| Ferramenta / conexão | Como conecta | Onde o número precisa estar ativado | Oficial? |
|---|---|---|---|
Evolution API, integração WHATSAPP-BAILEYS | Aparelho conectado, por QR Code ou código de pareamento | No app do WhatsApp ou do WhatsApp Business, num celular | Não |
Evolution API, integração WHATSAPP-BUSINESS | Cloud API da Meta, com token, ID do número e ID da conta do WhatsApp Business | Registrado na Cloud API (sai do app) | Sim |
| Z-API | Sessão de WhatsApp Web, por QR Code ou código pelo número de telefone | No app, num celular | Não |
| Baileys, WPPConnect, whatsapp-web.js (código próprio) | Protocolo ou navegador do WhatsApp Web | No app, num celular | Não |
Em todas as conexões não oficiais o número segue funcionando no celular: a ferramenta é mais um aparelho conectado na conta. A diferença entre oficial e não oficial, ponto a ponto, está em API oficial ou não oficial.
Como ativar o número e conectar na Evolution API ou na Z-API? Passo a passo
1. Contrate o número
Em escolher número, escolha o DDD, pague e valide a identidade do titular. O número fica pronto no mesmo dia.
2. Instale o WhatsApp Business num celular
Pode ser o celular que você já usa: o WhatsApp Business é outro app e convive com o WhatsApp pessoal. Veja dois WhatsApp no mesmo celular.
3. Peça o código por ligação
Informe o número com DDD e, na tela de verificação, escolha "Ligue para mim". Número fixo não recebe SMS. A ligação pode levar alguns minutos.
4. Pegue o código no painel da Numio
A Numio atende a ligação e mostra o código de 6 dígitos no painel, na página do número, e no seu e-mail. Digite no app e termine o cadastro do perfil.
5. Crie a instância na ferramenta
Na Evolution API, crie a instância com a integração
WHATSAPP-BAILEYS(endpoint/instance/create). Na Z-API, crie a instância no painel.6. Conecte como aparelho
No app, abra Aparelhos conectados → Conectar aparelho e leia o QR Code da instância. Se preferir, as duas ferramentas geram um código pra digitar no celular em vez do QR Code.
7. Teste e aponte o webhook
Mande uma mensagem de outro celular pro número, confira se ela chega no webhook da instância e responda pela API.
Faça a ativação no app primeiro e só depois conecte a ferramenta. A Evolution API e a Z-API não pedem o código de verificação do WhatsApp por você.
E na conexão oficial da Evolution API (WHATSAPP-BUSINESS)?
Aqui o caminho é outro. O número não é ativado no app: ele é registrado na Cloud API da Meta, e a Evolution API passa a ser só a camada entre o seu sistema e a Meta. Ao criar a instância com a integração WHATSAPP-BUSINESS, ela pede um token permanente, o ID do número (Phone Number ID, não o número em si) e o ID da conta do WhatsApp Business. Não há QR Code.
O registro na Cloud API também aceita número fixo, verificado por ligação de voz. O passo a passo está em API oficial do WhatsApp e, por chamadas HTTP, em registrar número por API. Nesse caminho, as mensagens são cobradas pela Meta, direto de você.
Funciona com n8n, Chatwoot e Typebot ligados na Evolution API?
Funciona. Nesses arranjos o número é o da instância, e o resto da pilha não muda nada nele: o n8n conversa com a Evolution API por webhook e requisição HTTP, e a Evolution API tem integração própria com Chatwoot e Typebot. A ativação do número é a mesma do passo a passo acima.
Se o fluxo do n8n for falar direto com a API oficial, sem Evolution no meio, o caminho é o de n8n na API oficial do WhatsApp.
O número da Numio corre mais risco de banimento?
Não, e também não corre menos. Pro WhatsApp, ele é um número fixo comum. O que leva ao banimento é o comportamento da conta: os Termos do WhatsApp vedam software não autorizado e mensagens automáticas, e o WhatsApp não publica o padrão que dispara o bloqueio. Quem promete número "à prova de banimento" ou limite seguro de envio está vendendo o que ninguém controla.
| Se acontecer | O que vale |
|---|---|
| A conta do WhatsApp for banida | O pedido de revisão é feito no próprio app, direto com o WhatsApp. O número continua seu e segue recebendo ligações |
| Você quiser outro número por causa do banimento | Banimento depois da ativação não dá direito a troca nem a reembolso (Termos de Uso, item 8.5). Um número novo é uma contratação nova |
| O WhatsApp pedir o código de novo | Enquanto a assinatura estiver ativa, a ligação é atendida e o código aparece no painel, quantas vezes for preciso |
Disparo em massa pra quem não pediu contato é vedado pelos Termos do WhatsApp e pelos Termos de Uso da Numio, na conexão oficial e na não oficial.
Por que a instância desconecta? O que conferir
| Sintoma | Causa mais comum | O que fazer |
|---|---|---|
| A instância caiu depois de alguns dias parada | O celular principal ficou sem abrir o WhatsApp: os aparelhos conectados são desconectados depois de cerca de 14 dias sem uso do celular | Abrir o app no celular de tempos em tempos e reconectar a instância |
| Pede QR Code de novo do nada | Atualização do WhatsApp Web derrubou a sessão da ferramenta | Atualizar a Evolution API ou conferir o status da Z-API e ler o QR Code de novo |
| O app não manda o código | Pedido por SMS: número fixo não recebe SMS | Esperar o tempo da tela e tocar em "Ligue para mim" |
| "Este número não pode ser registrado" | O número já está numa conta da Cloud API ou foi banido | Remover o número da Cloud API, ou pedir revisão do banimento no app |
| O QR Code não aparece na instância da Evolution API | Instância criada sem qrcode: true ou com a integração errada | Recriar a instância com WHATSAPP-BAILEYS e QR Code ligado, ou pedir o código de pareamento |
Preciso de um número por instância?
Sim. Cada instância da Evolution API ou da Z-API é uma conta de WhatsApp, e cada conta é um número. Quem atende vários clientes ou separa operações (atendimento, cobrança, teste) precisa de um número pra cada. Na Numio você contrata até 20 números por pedido, e a instância da Z-API é cobrada à parte, pela Z-API.
Separe também homologação de produção: um número só pra testar fluxos novos evita que um erro de automação derrube o número que está atendendo cliente. Agência ou SaaS que precisa entregar números em escala pode contratar por API; veja API de números pra revenda.
Quanto custa o número?
Preço fixo por mês, sem cobrança por mensagem, sem taxa de ativação e sem fidelidade. O que você paga à Evolution API (servidor próprio ou hospedagem) ou à Z-API (por instância) é à parte.
| Período | Valor cobrado | Equivalente por mês | Economia vs. mensal | Inclui |
|---|---|---|---|---|
| Mensal | R$ 25,90 por mês | R$ 25,90/mês | — | Número exclusivo, suporte humano, 7 dias de garantia |
| Trimestral | R$ 62,70 a cada 3 meses | R$ 20,90/mês | 19% | Número exclusivo, suporte humano, 7 dias de garantia |
| Anual | R$ 202,80 por ano | R$ 16,90/mês | 35% | Número exclusivo, suporte humano, 7 dias de garantia, 1 troca de número grátis |
Perguntas frequentes
Pode. Na conexão Baileys, o número é ativado no app do WhatsApp Business com o código por ligação de voz e a Evolution API se conecta por QR Code. Na conexão oficial (WHATSAPP-BUSINESS), o número é registrado na Cloud API da Meta, que também aceita verificação por ligação.
Pode. A Z-API se conecta a uma conta de WhatsApp que já existe, como um WhatsApp Web. O número é ativado antes no app, com o código por ligação, e depois a instância lê o QR Code.
Não. As duas se conectam a uma conta já ativada. O código chega na ativação do número no app, e com um número da Numio ele aparece no painel depois da ligação do WhatsApp.
Na conexão não oficial, sim: a conta fica ativa no app de um celular e a ferramenta entra como aparelho conectado. Pode ser o celular que você já usa, com o WhatsApp Business ao lado do pessoal. Na conexão oficial da Evolution API, não.
Não. O banimento depende do comportamento da conta, não do tipo de número. Um número separado limita o prejuízo: se a conta cair, o número principal da empresa não é afetado.
Não. Pelos Termos de Uso, banimento depois da ativação não dá direito a troca nem a reembolso. O número continua seu, a revisão é pedida no app do WhatsApp, e você pode cancelar a assinatura quando quiser.
R$ 25,90 por mês no plano mensal, ou R$ 16,90 por mês no anual, sem fidelidade e sem cobrança por mensagem. A Evolution API e a Z-API são cobradas à parte por quem as fornece.