Modo híbrido - Como conectar

Modo Híbrido no Z-PRO: como rotear mensagens de conversa pela API não oficial para reduzir custos da API Oficial WABA a partir de outubro de 2026.

Disponível para o perfil: Administrador

Funcionalidade em Beta. O Modo Híbrido está disponível para testes a partir da versão 4.0.2.1. Avalie o comportamento na sua operação antes de aplicar em produção.

---

Por que isso existe

A partir de 1º de outubro de 2026, a Meta passa a cobrar cada mensagem enviada pela API Oficial do WhatsApp — inclusive respostas do atendente e do bot dentro da janela de 24 horas, que hoje são gratuitas. O valor inicial é de R$ 0,035 por mensagem entregue, sem desconto por volume para mensagens do tipo serviço.

O Modo Híbrido é a estratégia para reduzir esse custo: as mensagens de conversa do dia a dia (respostas do atendente, menus do bot, confirmações) passam a sair por uma conexão não oficial — que não tem cobrança por mensagem — enquanto o número oficial continua fazendo o que só ele faz bem.

Cobranças da Meta — Outubro 2026

A META VAI COBRAR TUDO! Como Economizar na API Oficial

---

O que cada conexão faz

Tipo de mensagem	Sai por
Resposta do atendente ou bot (conversa ativa)	Conexão híbrida (não oficial)
Templates de marketing, utility e autenticação	Canal oficial WABA
Disparos em massa e campanhas	Canal oficial WABA
Mensagens quando a conexão híbrida cai	Canal oficial WABA (fallback automático)
Mensagens recebidas do cliente	Canal oficial WABA (sempre)

O cliente não percebe diferença. Para ele, é o mesmo número de sempre.

---

Pré-requisitos

• Canal WABA ativo (API Oficial) conectado no Z-PRO

• Um canal não oficial conectado por QR Code — pode ser Baileys, WhatsMeow, UAZAPI, Z-API, Evolution, wwebjs ou similar

• Versão do Z-PRO 4.0.2.1 ou superior

---

Forma 1 — Mesmo número (coexistência)

O número oficial recebe as mensagens e responde pela conexão não oficial, sem que o cliente perceba qualquer diferença. São duas leituras de QR Code feitas pelo mesmo celular que tem o WhatsApp da empresa.

Como configurar

1. Crie e conecte um canal não oficial por QR Code (Baileys, UAZAPI, etc.) usando o mesmo número da conta WABA

2. Vá em Administração → Canais e edite o seu canal WABA

3. Abra a seção Modo Híbrido

4. Selecione Coexistência (mesmo número)

5. Escolha a conexão não oficial criada no Passo 1

6. Salve

O que acontece

• Mensagens de conversa (respostas do atendente, passos do bot, agendamentos) saem automaticamente pela conexão sem cobrança enquanto a conversa está ativa (dentro da janela de 24 horas)

• Templates, disparos em massa e campanhas continuam saindo pelo número oficial

• Se a conexão não oficial cair, o sistema faz fallback automático para o canal oficial e notifica a equipe

---

Forma 2 — Dois números (handoff)

O número oficial funciona como porta de entrada. Quando a conversa vira um atendimento mais longo, o cliente é transferido para um segundo número conectado por QR Code, onde o restante da conversa não tem cobrança por mensagem.

Como configurar

1. Conecte um segundo número por QR Code na plataforma

2. Vá em Administração → Canais e edite o seu canal WABA

3. Abra a seção Modo Híbrido

4. Selecione Dois números

5. Escolha o segundo número

6. Salve

Como usar no atendimento (manual)

1. Dentro do atendimento aberto, acesse a aba de gestão do ticket

2. Clique em "Continuar em outro número"

3. Revise a mensagem de convite que será enviada ao cliente e confirme

4. O cliente recebe o link, o atendimento é transferido e a conversa continua no segundo número

Como usar no bot (automático)

1. No Chat Flow, adicione o passo "Trocar de Canal" no ponto do fluxo em que deseja mover a conversa

2. Quando o bot chegar nesse passo, ele envia a mensagem-convite e faz a transferência automaticamente

Use o passo "Trocar de Canal" como o último do bloco — a partir dele, a conversa segue no outro número e os passos seguintes não são executados no canal original.

---

Como identificar mensagens híbridas

• Canais configurados em modo híbrido exibem um ícone específico de híbrido na lista de canais

• Em cada mensagem enviada, o sistema indica por qual conexão ela foi roteada

• Quando a conexão híbrida cai e o fallback entra em ação, a equipe recebe uma notificação automática

---

Onde acompanhar a economia

Acesse Configurações → Integrações Meta → WhatsApp → Custos. A tela exibe quantas mensagens saíram pela conexão híbrida e permite simular o custo equivalente caso tivessem saído pela API oficial.

---

O que continua igual

• Mensagens recebidas do cliente nunca são cobradas pela Meta

• O número oficial continua responsável por templates, campanhas e notificações transacionais

• O modo híbrido pode ser desativado a qualquer momento em Administração → Canais → editar canal WABA → Modo Híbrido → Desativado

---

Perguntas frequentes

O cliente percebe alguma diferença? Na Forma 1 (mesmo número), não — é o mesmo número de sempre. Na Forma 2 (dois números), ele recebe um convite e passa a falar com um segundo número.

E se a conexão não oficial cair? O sistema faz fallback automático para o canal oficial. A mensagem nunca deixa de ser entregue e a equipe recebe uma notificação.

Quais canais não oficiais são suportados como rota híbrida? Baileys, WhatsMeow, UAZAPI, Z-API, Evolution API, wwebjs — qualquer canal não oficial conectado na plataforma.

Posso usar o modo híbrido e depois desligar sem risco? Sim. Enquanto desativado, nada muda no funcionamento normal. Ao reativar, basta selecionar novamente a conexão desejada.