Configuração do administrador
Modo híbrido - Como conectar
Modo Híbrido no sistema: 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.
Introdução ao modo híbrido
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.
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 sistema
- Um canal não oficial conectado por QR Code — pode ser Baileys, WhatsMeow, UAZAPI, Z-API, Evolution, wwebjs ou similar
- Versão do sistema 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
- Crie e conecte um canal não oficial por QR Code (Baileys, UAZAPI, etc.) usando o mesmo número da conta WABA
- Vá em Administração → Canais e edite o seu canal WABA
- Abra a seção Modo Híbrido
- Selecione Coexistência (mesmo número)
- Escolha a conexão não oficial criada no Passo 1
- 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
- Conecte um segundo número por QR Code na plataforma
- Vá em Administração → Canais e edite o seu canal WABA
- Abra a seção Modo Híbrido
- Selecione Dois números
- Escolha o segundo número
- Salve
Como usar no atendimento (manual)
- Dentro do atendimento aberto, acesse a aba de gestão do ticket
- Clique em "Continuar em outro número"
- Revise a mensagem de convite que será enviada ao cliente e confirme
- O cliente recebe o link, o atendimento é transferido e a conversa continua no segundo número
Como usar no bot (automático)
- No Chat Flow, adicione o passo "Trocar de Canal" no ponto do fluxo em que deseja mover a conversa
- 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.