> 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/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-4.0.x-ultima-versao/3.1.4.x.md). # 3.1.4.x ### 3.1.4.9 šŸš€ UPDATE OFICIAL (HOMOLOG) | v3.1.4.9 - 06/01/2026 šŸ›‘ BACKUP OBRIGATƓRIO! Crie um ponto de recuperaĆ§Ć£o ou faƧa backup da VPS/Banco de Dados antes de rodar este update. āš ļø BREAKING CHANGES \- Baileys: Atualize fora do expediente. Pode ser necessĆ”rio reler o QRCode. \- Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora. šŸ†• NOVIDADES: \- NormatizaĆ§Ć£o @lid para Evolution \- NormatizaĆ§Ć£o @lid para WWEBJS \- Loggers do backend removidos, liberados apenas para debug setando credenciais no env do back: LOGGER\_INFO=true LOGGER\_WARN=true LOGGER\_ERROR=true \- AlteraĆ§Ć£o do nome do logo padrĆ£o de zpro.png para logo.png e zpro\_dark.png para logo\_dark.png (disponĆ­vel na pasta public) \- Nova distribuiĆ§Ć£o do menu principal (agrupados e expansĆ­veis)
\- Novas indexaƧƵes e melhoria na performance do banco \- Importar contato com opĆ§Ć£o para adicionar ou sobrescrever etiquetas \- Novas rotas de API (+26) \- OpĆ§Ć£o para configurar infra: heap, logrotate e node args via autoinstalador (pm2)
šŸ›  AJUSTES: \- rota SendMessageAPIFile + evo \- envio de arquivos mensagem rĆ”pida e chatbot + evo \- criaĆ§Ć£o de canal evo + global provider \- distribuiĆ§Ć£o de atendimento na transferĆŖncia da fila com uazapi, zapi, insta/messenger nativos \- auto distribuiĆ§Ć£o do canal sanitizada (superadmin) \- cadastro de grupos para whatsapp-web.js \- remoĆ§Ć£o de Ć­ndices duplicados \- redirect oauth do instagram apĆ³s criaĆ§Ć£o do canal \- removida preferĆŖncia de uso do @lid com whatsapp-web.js \- uso da evolution + global provider em alguns serviƧos ### 3.1.4.8 šŸš€ UPDATE OFICIAL (HOMOLOG) | v3.1.4.8 - 24/12/2025 šŸ›‘ BACKUP OBRIGATƓRIO! Crie um ponto de recuperaĆ§Ć£o ou faƧa backup da VPS/Banco de Dados antes de rodar este update. āš ļø BREAKING CHANGES \- Baileys: Atualize fora do expediente. Pode ser necessĆ”rio reler o QRCode. \- Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora. šŸ†• NOVIDADES: \- Adicionado suporte para Docker \- essa instalaĆ§Ć£o nĆ£o faz parte do escopo do suporte \- arquivos docker-compose.yml, DockerFile disponĆ­veis dentro de zpro.zip \- Facebook e Instagram nativo \- Novo webphone Wavoip (deverĆ” ler o qrcode da wavoip mesmo que usando baileys) \- Provedor global para Z-API, UAZAPI, EVO, WUZAPI, HUB e APPs Meta (superadmin) \- message\_echoes para Coex + WABA šŸ›  AJUSTES: \- recebimento de listas e botƵes com uazapi \- filtro da galeria pĆ³s clicar em carregar mais \- mensagem rĆ”pida com mĆ­dia + uazapi \- migraĆ§Ć£o de tenants entre vps (tabela equipe chat interno) \- webhook create-update-contact + uazapi \- url de origem popup cadastro incorporado para facebook, instagram e waba nativos \- janela de envio de mensagens para instagram quando a mensagem vem de fora da zpro \- tipos (zapi, uazapi, meow e evo) liberados para adiĆ§Ć£o de canal apenas com configuraĆ§Ć£o global ativadas \- listagem de mensagens rĆ”pidas com usuĆ”rio null \- url de origem popup cadastro incorporado para facebook, instagram e waba nativos \- listagem de mensagens rĆ”pidas com usuĆ”rio null
āš ļø DocumentaĆ§Ć£o suporte para instalaĆ§Ć£o em ambiente Docker: docker: traefik: ### 3.1.4.7 šŸš€ UPDATE OFICIAL (HOMOLOG) | v3.1.4.7 - 16/12/2025 šŸ›‘ BACKUP OBRIGATƓRIO! Crie um ponto de recuperaĆ§Ć£o ou faƧa backup da VPS/Banco de Dados antes de rodar este update. āš ļø BREAKING CHANGES * Baileys: Atualize fora do expediente. Pode ser necessĆ”rio reler o QRCode. * Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora. #### šŸ†• Novidades * **contingĆŖncia de APIs nĆ£o oficiais** *Permite manter o mesmo nĆŗmero conectado em mais de uma API. Se inativo, o canal permanece conectado como backup mas nĆ£o recebe mensagens.*
Se ativo: o canal estĆ” ativo e receberĆ” mensagens. Se inativo: o canal permanecerĆ” conectado, mas nĆ£o receberĆ” mensagens. Mantenha o mesmo nĆŗmero conectado em mais de uma API NĆ£o Oficial * **migraĆ§Ć£o de tenants entre VPS (superadmin)** *Nova ferramenta para trazer tenants de outros servidores configurando acesso SSH e banco de dados da origem.* {% embed url="" %} * **Login do Facebook Incorporado (WABA):** AutenticaĆ§Ć£o simplificada para criaĆ§Ć£o de canais WABA utilizando o Login do Facebook, eliminando a manipulaĆ§Ć£o manual de tokens. {% embed url="" %} * **selecionar multiplos tickets no atendimento para aƧƵes em massa** *Nova funcionalidade na listagem de tickets que permite selecionar vĆ”rios atendimentos e executar aƧƵes conjuntas.* * **cadastro incorporado da WABA (coexistĆŖncia)** *Fluxo de "Embedded Signup" para criar contas de WhatsApp Business API diretamente pelo painel.* * **canal instagram nativo (BETA)** *ConexĆ£o de contas do Instagram Direct via API Oficial da Meta (requer configuraĆ§Ć£o de caso de uso no Facebook Developers).* {% embed url="" %} {% embed url="" %} #### šŸ”§ Ajustes e CorreƧƵes * **WABA:** Recebimento de multi-vcard e padronizaĆ§Ć£o no envio de localizaĆ§Ć£o. * **WABA:** CriaĆ§Ć£o de template de autenticaĆ§Ć£o. * **Uazapi:** Controle do `updateName` em grupos e envio de arquivos `.mpeg`. * **Uazapi:** OpĆ§Ć£o para ignorar abertura de ticket se houver apenas reaĆ§Ć£o na mensagem. * **Uazapi + Chatbot:** IntegraĆ§Ć£o ChatGPT agora suporta Ć”udio. * **Mobile:** Ajustes visuais no Chat Interno para dispositivos mĆ³veis. * **VUE3:** CorreĆ§Ć£o no modal Wavoip, importaĆ§Ć£o de JSON do Chatbot, download de relatĆ³rio PDF e duplicaĆ§Ć£o de campanhas com mĆ­dia. * **Geral:** WWebJS com suporte a mensagem rĆ”pida de Ć”udio. * **API:** CorreĆ§Ć£o de CORS na Z-API, bloqueio de resposta de status e nova rota `tenantApiCreateSession`. * **CorreĆ§Ć£o:** Ajuste na exibiĆ§Ć£o do nome do plano ao ser criado. ### 3.1.4.6 šŸš€ UPDATE OFICIAL (HOMOLOG) | v3.1.4.6 - 27/11/2025 šŸ›‘ BACKUP OBRIGATƓRIO! Crie um ponto de recuperaĆ§Ć£o ou faƧa backup da VPS/Banco de Dados antes de rodar este update. āš ļø BREAKING CHANGES * Baileys: Atualize fora do expediente. Pode ser necessĆ”rio reler o QRCode. * Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora. #### šŸ†• Novidades * **Galeria Interna:** Nova funcionalidade para armazenar e enviar arquivos recorrentes. [Detalhamento aqui](https://zpro.passaportezdg.com.br/organizacao-interna/galeria) * **Encaminhamento de Mensagens.** * Encaminhar para outro canal.
* Encaminhar para o chat interno.
* **Visual do Kanban:** Novo ajuste visual com listagem vertical. * **VueFlow:** Integrado ao construtor de fluxos interno. {% embed url="" %} * **Novas Telas de Acesso:** Redesign das pĆ”ginas de Login, Cadastro (Signup) e RecuperaĆ§Ć£o de Senha.
* **CustomizaĆ§Ć£o da Tela de Login:** Agora configurĆ”vel atravĆ©s do menu "Customizar" no Superadmin.
* **Wavoip Expandido:** Suporte adicionado para as APIs WWebJS, Meow, Uazapi e Z-API. * **Seletor de Emojis:** Ajuste visual no "picker" da reaĆ§Ć£o de mensagens. * **HorĆ”rio de Atendimento:** Nova opĆ§Ć£o para ignorar o horĆ”rio de atendimento por canal.
* **Chatbot:** DistribuiĆ§Ć£o sequencial implementada. [Detalhamento Aqui](/configuracao-administrador/automacao/chat-flow/distribuicao-sequencial-chatflow.md) #### šŸ”§ Ajustes e CorreƧƵes * Filtro para mostrar grupos a todos os usuĆ”rios * Ajustes na integraĆ§Ć£o Gemini * Envio de avaliaĆ§Ć£o automĆ”tica com Uazapi * Encaminhamento de mensagens utilizando Uazapi * EdiĆ§Ć£o de mensagem rĆ”pida contendo arquivos (Geral e Vue3) * Disparo de template sem variĆ”vel e botĆ£o de chamada (Call) * Mensagem rĆ”pida WABA (Vue3) * CorreĆ§Ć£o de CORS na Z-API * Ajuste na rota `tenantApiCreateSession` * Bloqueio de resposta de status Z-API * Limite de caracteres liberado na mensagem de ausĆŖncia da fila **DepreciaĆ§Ć£o:** FunĆ§Ć£o de rascunho foi descontinuada. ### 3.1.4.5 << UPDATE v3.1.4.5 - 18/11/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial 2- Frontend VUE3: o suporte a versƵes com VUE2 foi descontinuado #### šŸ†• Novidades * **RestriĆ§Ć£o para usuĆ”rios (Acesso a informaƧƵes de contatos)** *Agora Ć© possĆ­vel ocultar dados sensĆ­veis e o menu de contatos para usuĆ”rios especĆ­ficos.* [Confira a documentaĆ§Ć£o detalhada](https://zpro.passaportezdg.com.br/central-do-assinante/recursos-tecnicos/funcionalidades-z-pro/restricao-de-acesso-a-contatos) * **HorĆ”rio de atendimento por Fila** *Defina horĆ”rios especĆ­ficos por departamento. O sistema agora checa a fila primeiro.* [Confira a documentaĆ§Ć£o detalhada](https://zpro.passaportezdg.com.br/configuracao-inicial-e-estrutural-admin/horarios-de-atendimento) * **AƧƵes para ticket sem resposta (Follow-up AutomĆ”tico)** *AutomaĆ§Ć£o para reengajar clientes que nĆ£o respondem apĆ³s X horas.* [Confira a documentaĆ§Ć£o detalhada](https://zpro.passaportezdg.com.br/funil-de-oportunidades/5.-acoes-em-tickets-follow-up-automatico) * **OpĆ§Ć£o para escutar mensagens enviadas pelo HUB via API** *Nova opĆ§Ć£o disponĆ­vel nas configuraƧƵes gerais.* * **DefiniĆ§Ć£o de padrƵes no Canal** *Agora Ć© possĆ­vel definir Chatbot, Fila e UsuĆ”rio padrĆ£o diretamente no modal de ediĆ§Ć£o do canal.*
* **Mensagem rĆ”pida pĆŗblica** *OpĆ§Ć£o para tornar mensagens rĆ”pidas visĆ­veis para todos os usuĆ”rios.*
* **TĆ­tulo para os Planos** *Novo campo de identificaĆ§Ć£o na criaĆ§Ć£o de planos.* * **Data customizada na opĆ§Ć£o de agendamento** *Permite definir intervalos personalizados de dias para recorrĆŖncia.* * **Compartilhar ticket / contato de grupo** *Facilita o compartilhamento de informaƧƵes de grupos com outros usuĆ”rios durante o atendimento.*
* **BotĆ£o espiar no card de oportunidade** *Recurso adicionado para administradores visualizarem o chat diretamente pelo Funil.*
* **Filtro de tickets no socket (ConfiguraĆ§Ć£o Geral)** *Nova configuraĆ§Ć£o para ativar filtro de tickets no socket. RecomendĆ”vel para operaƧƵes com alto volume (> 1000 atendimentos/dia).* #### šŸ”§ Ajustes e CorreƧƵes * Mensagem rĆ”pida Uazapi + arquivo * Espiar conversas na tela de contatos * CriaĆ§Ć£o de template e ediĆ§Ć£o (Vue3) com suporte a header de vĆ­deo/docs * Disparo em massa + variĆ”vel (Vue3) * Reply de mensagem no dispositivo com Meow (Wuzapi) * Message upsert no Hub Notificame * Fluxo de aƧƵes para oportunidades (necessĆ”rio recriar o fluxo) * Webchat nativo + chatbot * Disparo em massa com WABA (agora fecha o ticket e define usuĆ”rio como null) * HorĆ”rio da campanha (Vue3) * OAuth Gmail (Vue3) * Transbordo humano + ChatGPT (Chatbot) * Disparo em massa selecionando contato + Baileys * TransferĆŖncia chatbot na tela de atendimento (Uazapi) * CriaĆ§Ć£o de filas (correĆ§Ć£o ao salvar horĆ”rio ao criar fila no Vue3) * Iniciar conversa via Kanban com etiqueta * AvaliaĆ§Ć£o + mensagem de despedida WWebJS (correĆ§Ć£o na reabertura) * AvaliaĆ§Ć£o WABA + fechamento automĆ”tico * Rotear atendimento para atendimento pendente via mensagem avulsa ### 3.1.4.4 << UPDATE v3.1.4.4 - 04/11/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial 2- Frontend VUE3: o suporte a versƵes com VUE2 foi descontinuado #### šŸ†• Novidades * Limitado mensagens rĆ”pidas (uso/criaĆ§Ć£o/ediĆ§Ć£o) por usuĆ”rio (liberado no painel User, removido do painel Admin / Supervisor) * Limitado listagem de tarefas para User comum #### šŸ”§ Ajustes e CorreƧƵes * Chatbot + PDF com Uazapi * Caption (legenda) no envio de documentos com Uazapi * Caption (legenda) na api SendMessageAPITextBase64 com Uazapi * Dify + Uazapi * Mensagens via API para grupos com MEOW * Mensagem rĆ”pida com MEOW + arquivo (Vue3) * Modal WhatsApp (Vue3) * Avatar e nome no "bubble" da mensagem enviada / recebida ### 3.1.4.3 << UPDATE v3.1.4.3 - 30/10/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial 2- Frontend VUE3: o suporte a versƵes com VUE2 foi descontinuado #### šŸ†• Novidades * Ativar/desativar validaĆ§Ć£o de contato (nono dĆ­gito) com WABA * Escutar mensagens enviadas pela api do hub notificame #### šŸ”§ Ajustes e CorreƧƵes * Deletar notas vue3 * Data relatĆ³rios vue3 * BotƵes adicionar em aƧƵes em massa para grupos vue3 * Recebimento de mensagens via hub notificame * PĆ”gina de pagamentos no superadmin vue3 * Editar / criar template vue3 * Encaminhar mensagem vue3 * Zapi envio e recebimento de Ć”udio * Sendclose uazapi + api * Status sended ao enviar mensagem via api wwebjs ### 3.1.4.2 << UPDATE v3.1.4.2 - 24/10/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial #### Frontend VUE3: o suporte a versƵes com VUE2 foi descontinuado #### šŸ†• Novidades * Disparo de Ć”udio gravado em ligaƧƵes com Wavoip (Vue3) * Nome para fechamento personalizado de ticket * NĆ³ N8N adicionado ao chatbot * OpĆ§Ć£o para repetir a mensagem de ausĆŖncia na metade do tempo no chatbot * Listar etiquetas, kanbans e demandas por ordem alfabĆ©tica * OpĆ§Ć£o para pular mensagem na campanha #### šŸ”§ Ajustes e CorreƧƵes * SincronizaĆ§Ć£o de contatos / grupos para Uazapi * ValidaĆ§Ć£o de contato ao iniciar conversa avulsa com Uazapi e Z-API * BotĆ£o adicionar / editar tutoriais (Vue3) * Selecionar colunas na tela de contatos (Vue3) * Envio de protocolo com Waba (Vue3) * Listagem de contatos para marcaĆ§Ć£o em grupos com Baileys * Chatbot + arquivo Hub Notificame (Vue3) * InserĆ§Ć£o de emoji nas configuraƧƵes do chatbot (Vue3) * AƧƵes no fluxo do funil (Vue3) * HorĆ”rio de atendimento do usuĆ”rio (Vue3) ### 3.1.4.1 << UPDATE v3.1.4.1 - 20/10/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial #### šŸ†• Novidades * Tempo para recebimento de avaliaĆ§Ć£o {% embed url="" %} * Deletar mensagem com Uazapi * ImportaĆ§Ć£o de contatos por arquivo com Uazapi e Z-API * Recebimento de localizaĆ§Ć£o Z-API * Envio de vCard Uazapi * Webhook geral no envio de mensagens Uazapi e Z-API #### šŸ”§ Ajustes e CorreƧƵes * Busca de mensagem nos tickets Vue3 * ValidaĆ§Ć£o de data no formulĆ”rio de oportunidade Vue3 * Visual da pĆ”gina API no PWA Vue3 * Visual do modal de QR Code Vue3 * BotĆ£o "Atualizar LID e Nome" no modal de contato Vue3 * VariĆ”veis de aniversĆ”rio / despedida no modal do canal Vue3 * ValidaĆ§Ć£o de vCard Z-API * Agendamento com mĆ­dias e WWebJS * Abertura de ticket no PWA Vue3 ### 3.1.4.0 << UPDATE v3.1.4.0 - 14/10/2025 >> CRIE UM PONTO DE RECUPERAƇƃO OU FAƇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE Para usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root āš ļø BREAKING CHANGE! 1- Para usuĆ”rios BAILEYS: Atualize fora do horĆ”rio de expediente, versĆ£o da Baileys atualizada. Pode ser necessĆ”rio reler o QRCode ou recriar o canal. Nessa versĆ£o alteramos o pacote da Baileys, portanto, instabilidades poderĆ£o acontecer nos primeiros momentos com essa API NĆ£o Oficial #### šŸ†• Novidades * Padronizada a versĆ£o Vue3 no frontend * ConfiguraĆ§Ć£o para controle de atualizaĆ§Ć£o de nomes com Uazapi e Z-API * Controle de grupos e bloqueios com Uazapi e Z-API * ReaĆ§Ć£o, ediĆ§Ć£o, localizaĆ§Ć£o, recebimento de link, responder mensagem, mensagens enviadas pelo dispositivo com Uazapi * OpĆ§Ć£o para usar proxy na Evolution * Criptografia de senha no frontend * SeparaĆ§Ć£o das pastas de mĆ­dias para: chatbot, mensagem rĆ”pida e mensagem de aniversĆ”rio #### šŸ”§ Ajustes e CorreƧƵes * Encaminhamento de mensagens com Uazapi * Mensagem rĆ”pida da Meow (Wuzapi) + PDF * Chatbot + Ć”udio com Meow (Wuzapi) * Chatbot inativo nĆ£o aciona palavra gatilho * Mensagem de aniversĆ”rio com arquivo * Darkmode, mensagem rĆ”pida e scroll na tela de atendimento Vue3 * PĆ”gina de Masterkey Vue3 * Envio de contato Vue3 * Disparo em massa com Meow (Wuzapi) --- # 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/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-4.0.x-ultima-versao/3.1.4.x.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.