> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/modo-hibrido-como-conectar.md). # Modo híbrido - Como conectar {% hint style="warning" %} **Disponível para o perfil: Administrador** {% endhint %} {% hint style="warning" %} **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. {% endhint %} *** ### 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. {% content-ref url="/pages/78tc7NxT3WTXgpGtpBaK" %} [Cobranças da Meta — Outubro 2026](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/modo-hibrido-como-conectar/cobrancas-da-meta-outubro-2026.md) {% endcontent-ref %} {% embed url="" %} A META VAI COBRAR TUDO! Como Economizar na API Oficial {% endembed %} *** ### 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) | {% hint style="info" %} O cliente não percebe diferença. Para ele, é o mesmo número de sempre. {% endhint %} *** ### 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 {% hint style="info" %} 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. {% endhint %} *** ### 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/modo-hibrido-como-conectar.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.