Instalação: Evolution API\n\n{% hint style="warning" %}\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\n\nA Evoluiton API é uma solução de software de código aberto.\n\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\n\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\n{% endhint %}\n\n#### 1. Prepare o Ambiente\n\nAntes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:\n\n Git: Essencial para executar nosso script. Faça o download aqui.\n Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.\n\nApós instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.\n\n#### 2. Baixe o Script de Instalação\n\nPara facilitar sua vida, preparamos um pacote com tudo que você precisa.\n\n Baixe aqui o arquivo evolution.rar.\n Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo: C:\\Evolution).\n\n#### 3. Execute os Comandos no Terminal\n\nAgora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.\n\n1. Navegue até a pasta onde você descompactou os arquivos.\n2. Clique com o botão direito do mouse dentro da pasta e selecione a opção "Abrir no Terminal" ou "Open in Terminal".\n3. O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:\n\n \n & "C:\\Program Files\\Git\\bin\\bash.exe"\n\n4. Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:\n\n \n ./evolution.sh\n\n\nPronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.\n\n#### 4. Acessando e Conectando sua API\n\nCom tudo instalado, é hora de acessar o painel de controle.\n\n1. Abra seu navegador e acesse: http://localhost:8081\n2. Clique em "Manager". O sistema pedirá uma Chave Global (Global API Key).\n3. Para encontrá-la, abra o arquivo evolution.sh com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.\n4. Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.\n5. Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.\n\n#### 5. Integração com Z-PRO\n\nO último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.\n\n1. No painel Admin, navegue até Configurações > Integrações > Evolution.\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\_IP\\\\_DE\\\\_SERVIDOR:5555).\n3. Preencha a Chave Global com o APP\_ADMIN\_TOKEN definido no seu arquivo .env.\n4. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Evoluiton".\n5. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\n\n### Tutorial:\n\n{% embed url="https://www.youtube.com/watch?v=cQewqCSez5I" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n · Ajuda SAC
Início
Api Oficial Waba
API Oficial WABA\n\n## Integração ZPRO e API Oficial da Meta (WhatsApp)\n\nO ZPRO possui integração nativa com a API Oficial da Meta (WABA). Este documento explica os termos técnicos, as opções de conexão e responde às dúvidas frequentes sobre o funcionamento do serviço.\n\n### 1. Vocabulário da Meta\n\n App (Facebook Developers): Aplicativo na plataforma de desenvolvedores da Meta que faz a comunicação entre o WhatsApp e o sistema ZPRO.\n Gerenciador de Negócios (Business Manager - BM): Painel administrativo da Meta onde a empresa gerencia contas, ativos de negócios e métodos de pagamento.\n Tech Provider (Provedor de Tecnologia): Status concedido a uma empresa com App aprovado pela Meta para fornecer soluções de WhatsApp a terceiros. O ZPRO é um Tech Provider certificado.\n OAuth (Cadastro Incorporado / Embedded Signup): Tecnologia de conexão onde o usuário faz login com o Facebook para vincular o número de WhatsApp de forma visual e direta, sem a necessidade de configurar um App próprio.\n Coexistência: Funcionalidade que permite operar o número na API Oficial (conectada ao ZPRO) e no aplicativo WhatsApp Business do smartphone simultaneamente. Esse recurso utiliza a arquitetura de "Dispositivos Conectados" da Meta, ou seja, é preciso ler o QR Code no celular, assim como faz no WhatsApp Web.\n\n**\n\n### 2. Opções de Integração no ZPRO\n\n#### Opção 1: Login Incorporado com coexistência pelo APP do ZPRO (Recomendada)\n\nO usuário utiliza o App nativo da própria ZPRO para realizar a conexão.\n\n Como funciona: No painel do ZPRO, selecione "WhatsApp OAuth" e escolha o aplicativo da ZPRO. Uma janela da Meta será aberta para efetuar o login com o Facebook. O usuário seleciona a conta do WhatsApp Business e, no aplicativo do celular, acessa \'Dispositivos Conectados\' para escanear o QR Code gerado no painel. Isso vincula o ZPRO como um dispositivo adicional, permitindo a coexistência\n Aviso sobre Instagram e Facebook: É possível utilizar este mesmo método de login incorporado (OAuth) para integrar contas do Instagram e Facebook Messenger de forma nativa, conectando os canais por meio do seu gerenciador de negócios.\n\nTutorial Oauth (login incorporado) com coexistência\n\n#### Opção 2: Tornar-se um Tech Provider\n\nO assinante ZPRO cria um App no Facebook Developers e submete à Meta para análise e aprovação.\n\n Indicação: Para revendas (SaaS) que desejam oferecer o processo de login incorporado para seus clientes utilizando a própria marca (White-label) na tela de autenticação.\n\nTutorial Tech Provider\\nTutorial API manual\n\n**\n\n### 3. Perguntas Frequentes (FAQ)\n\nÉ melhor coexistência ou número direto da Meta? Qual a diferença de escolha? \n\nA coexistência permite manter o aplicativo WhatsApp Business ativo no celular e responder as mensagens simultaneamente pelo painel do ZPRO. A conexão de um número direto na API Oficial (sem coexistência) exige um número exclusivo, essa escolha pode ter uma estabilidade maior por não ter dois locais utilizando o mesmo número. A escolha depende da operação da empresa.\n\nComo usar esse recurso na minha revenda? \n\nPara oferecer o login incorporado com coexistência para seus clientes sob a sua marca, você deve criar um App no Facebook Developers e aprová-lo como Tech Provider. Caso não queira ou não tenha o status de Tech Provider, seus clientes podem utilizar o App oficial do ZPRO para realizar a autenticação.\n\nNão estou conseguindo habilitar minha coexistência para meus clientes, o que fazer? \n\nPara habilitar a coexistência em contas de terceiros, o seu aplicativo precisa estar verificado e aprovado pela Meta no processo de "Análise do App" (App Review) para obter o status de Tech Provider. Esse processo exige o envio de documentos da empresa e vídeos demonstrando o uso das permissões no sistema. O suporte do ZPRO não realiza esse serviço, mas fornece uma lista de profissionais indicados que prestam essa assessoria.\n\nO ZPRO cobra taxa por mensagem na API Oficial? \n\nNão. O ZPRO cobra o valor fixo da licença do software. As taxas de envio e de uso da infraestrutura do WhatsApp são cobradas e pagas diretamente à Meta. \n\nComo funciona a cobrança das mensagens na Meta? O pagamento é gerenciado na Business Manager (BM) da Meta, através do cartão de crédito cadastrado. Mensagens recebidas de clientes abrem uma janela de 24 horas para resposta gratuita. Mensagens ativas ou notificações (templates) enviadas fora desta janela são cobradas de acordo com a categoria da mensagem (utilidade, marketing, etc.) e cotação do dólar. Detalhamento da cobrança na Meta aqui\n\nA API Oficial bloqueia o número? O uso da API Oficial é o método homologado pela Meta, o que elimina bloqueios causados pelo uso de sistemas não oficiais. No entanto, o número ainda está sujeito a bloqueios se houver envio de spam, violação das políticas de uso do WhatsApp ou acúmulo de denúncias por parte dos destinatários.\n\nExplicação sobre a diferença da API Oficial e as APIs não oficiais\n\n*\n\n#### Documentação detalha o processo para conectar os canais do Facebook Messenger e do Instagram ao Z-PRO utilizando o Login Incorporado (OAuth) com o aplicativo nativo da ZDG:\n\nTutorial Instagram e Facebook via Oauth\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/api-oficial-waba.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
API Oficial - Cadastro Incorporado e Coexistência WABA (BETA)\n\n{% embed url="https://www.loom.com/share/e033654ae7494e4881a416c83899a32b" %}\n\n#### Parte 1: Configurações no Facebook Developers\n\nAntes de cadastrar no ZPRO, é necessário ajustar as configurações do seu aplicativo na Meta e gerar os dados necessários.\n\n1. Domínios do Aplicativo\n\n1. Acesse as Configurações Básicas do seu App.\n2. Adicione os domínios da sua instalação: Subdomínio do Front, Subdomínio do Back e o Domínio do Site.\n3. Caso necessário, adicione também no campo "URL do Site" na parte inferior.\n\n2. Gerar Token de Sistema (Business Manager)\n\n1. No seu Business Manager, vá em Usuários do Sistema.\n2. Adicione o seu Aplicativo aos ativos.\n3. Gere um novo Token selecionando o app e marcando as seguintes permissões obrigatórias:\n business\_management\n whatsapp\_business\_messaging\n whatsapp\_business\_management\n4. Copie o Token gerado (ele será usado no Superadmin).\n\n3. Configuração do Cadastro Incorporado (Config ID)\n\n1. No painel do App, vá em WhatsApp > Configuração.\n2. Em "Configuração de Login", clique em Criar Configuração.\n3. Selecione os produtos: Cloud API e API de mensagens de marketing.\n4. Em permissões, selecione todas (Set) e garanta que as 3 permissões do passo anterior estejam marcadas, mais a permissão:\n whatsapp\_business\_management\_events\n5. Salve e copie o número da "ID da configuração" (Config ID).\n\n*\n\n#### Parte 2: Configuração no Superadmin\n\nCom os dados em mãos, vamos configurar o aplicativo dentro do sistema.\n\n1. Acesse o painel Superadmin > App Waba.\n2. Clique em Adicionar e preencha os campos:\n * App ID: Encontrado no cabeçalho do Facebook Developers.\n * Versão da API: Utilize a versão atual (ex: v24.0).\n * Token: Cole o Token de Sistema gerado na Parte 1.\n * Config ID: Cole o ID da configuração gerado na Parte 1.\n * App Secret: Encontrado nas configurações básicas do App (clique em "Mostrar").\n3. Importante: Copie a URL de Redirecionamento (Redirect URI) que o sistema exibe nesta tela.\n4. Volte ao Facebook Developers > Facebook Login > Configurações e cole essa URL no campo "URIs de redirecionamento do OAuth válidos".\n5. Salve o cadastro no Superadmin.\n\n*\n\n#### Parte 3: Utilizando a Integração (Tenant)\n\nAgora que o app está configurado, o cliente final pode conectar as contas.\n\n1. No painel do cliente, vá em Integrações > Meta.\n2. Clique no botão Cadastro Incorporado.\n3. Uma janela do Facebook se abrirá. Siga o fluxo de login ("Continuar como...").\n\nCenário A: Criar/Adicionar Novo Número\n\n1. Siga o passo a passo para criar uma nova conta de WhatsApp Business ou selecionar uma existente.\n2. Após concluir, o número aparecerá na lista de integrações.\n3. Atenção: Se for um número novo, ele aparecerá como "Não Registrado". Clique em Registrar Telefone, insira um PIN de 6 dígitos e conclua a ativação para poder enviar mensagens.\n\nCenário B: Modo Coexistência (Requer App Aprovado)\n\n1. No fluxo do pop-up, selecione a opção de usar um número existente.\n2. O sistema identificará se o número é elegível para coexistência (deve ser uma conta Business).\n3. Se já estiver conectado no WhatsApp Business App, o fluxo pulará a verificação de SMS e conectará automaticamente.\n4. Ao finalizar, o canal será criado e você poderá ver o status "Conectado".\n5. O número funcionará tanto no painel (API) quanto no celular (App Business) simultaneamente.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/api-oficial-waba/api-oficial-cadastro-incorporado-e-coexistencia-waba-beta.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Cobranças da Meta (WhatsApp Business Platform)\n\nEsta página detalha como funciona o modelo de precificação do WhatsApp Business Platform (WABA). É fundamental compreender que estes custos são cobrados diretamente pela Meta através da sua conta de faturamento no Gerenciador de Negócios.\n\n{% hint style="info" %}\nO Z-PRO possui integração nativa com a API oficial (WABA), facilitando a gestão das suas mensagens, porém, todos os valores relativos ao tráfego de mensagens são pagos diretamente à Meta, sem intermediação financeira da nossa plataforma nessas taxas específicas.\n{% endhint %}\n\n### Perguntas Frequentes \n\n#### 1. Como a Meta cobra pelas mensagens?\n\nA partir de 1º de julho de 2025, a precificação será baseada em cada mensagem entregue. A cobrança ocorre apenas quando a mensagem chega ao destinatário.\n\n#### 2. Quais fatores influenciam o preço de uma mensagem?\n\nO valor cobrado por cada mensagem depende de dois fatores principais:\n\n País de destino: O preço varia de acordo com o código de área (DDI) do número de telefone do destinatário.\n Categoria da mensagem: As mensagens são classificadas em quatro categorias: Marketing, Utilidade, Autenticação ou Serviço. Cada par "mercado-categoria" possui uma tarifa específica.\n\n#### 3. Quais são as categorias de mensagens?\n\n Marketing: Mensagens promocionais, ofertas ou novidades.\n Utilidade (Utility): Mensagens relacionadas a uma transação específica, como confirmações de pedidos ou atualizações de entrega.\n Autenticação: Códigos de acesso de uso único para verificação de identidade.\n Serviço (Service): Mensagens de formato livre iniciadas por empresas para responder a dúvidas de clientes dentro de uma janela específica.\n\n#### 4. O que é a Janela de Atendimento ao Cliente?\n\nÉ um período de 24 horas que se inicia toda vez que um usuário envia uma mensagem para a sua empresa. Essa janela é reiniciada a cada nova mensagem enviada pelo usuário.\n\n#### 5. Existem mensagens gratuitas?\n\nSim, a Meta oferece as seguintes isenções dentro da Janela de Atendimento:\n\n Respostas de Serviço: Mensagens de texto livre (não baseadas em modelos/templates) enviadas pela empresa em resposta a um usuário não possuem custo.\n Modelos de Utilidade em resposta: O envio de modelos de utilidade em resposta a uma mensagem de usuário dentro da janela de 24 horas também passará a ser gratuito a partir de 1º de julho de 2025.\n\n#### 6. Como funcionam os "Pontos de Entrada Gratuitos"?\n\nQuando um usuário inicia uma conversa com a empresa através de um Anúncio de Clique para o WhatsApp ou um Botão de Ação na Página do Facebook, a primeira resposta da empresa abre uma janela de 72 horas (3 dias). Durante este período, nenhuma mensagem enviada pela empresa (seja marketing, utilidade ou serviço) será cobrada.\n\n#### 7. Existe desconto para grandes volumes de mensagens?\n\nSim. Para as categorias de Utilidade e Autenticação, a Meta oferece níveis de volume (Tiers). À medida que o volume de mensagens em um mercado específico aumenta, a empresa pode desbloquear preços mais atrativos automaticamente para as mensagens dentro daquele nível.\n\n#### 8. Onde posso consultar os valores exatos por mensagem?\n\nOs valores detalhados por país e categoria, bem como as faixas de volume, são publicados oficialmente pela Meta e podem ser encontrados em:\n\n Central de Desenvolvedores da Meta - Precificação\n Calculadora Meta\&category=Marketing)\n\n*\n\nNota: As informações acima referem-se às políticas da Meta com atualizações previstas para 1º de julho de 2025.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/api-oficial-waba/cobrancas-da-meta-whatsapp-business-platform.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Exemplo de fluxo no N8N + API Z-PRO + WABA\n\n{% embed url="https://youtu.be/jfF7h_7q8tY" %}\n\n{% content-ref url="/pages/JQZg61Z9gRqvsdj2eh6S" %}\nN8N - Tutorial de integração\n{% endcontent-ref %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/api-oficial-waba/exemplo-de-fluxo-no-n8n-+-api-z-pro-+-waba.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Atualizacoes Antigas
Atualizações antigas\n\n- 3.0.0.x ~ 3.0.5.x: Controle de versões\n- 3.0.6.x: Controle de versões\n- 3.0.7.x: Controle de versões\n- 3.0.8.x: Controle de versões\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/atualizacoes-antigas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.0.0.x \~ 3.0.5.x\n\n### 3.0.5.9\n\n<< UPDATE v3.0.5.9 - 02/10/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n Adicionado: integração com Wavoip para Baileys (Beta)\n Adicionado: opção para definir mensagem de resposta inválida no Typebot\n Adicionado: rota adicional para o recebimento de webhooks de arquivos waba (filename)\n Adicionado: botão para reverificar webhook do Hub na página de Canais\n Adicionado: ignorar story para o Hub\n Ajuste: interação do ChatGPT para o chatbot interno com Waba\n Ajuste: envio em massa de arquivo por URL e adição de participantes em massa para grupos disponíveis apenas para WWebJS\n Removido: agent do Dify\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.8\n\n<< UPDATE v3.0.5.8 - 26/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado: tratamento número 9 no envio via API\n Adicionado: limitação no tamanho máximo do nome do usuário\n Adicionado: liberado demais canais do notificame\n Adicionado: ao importar arquivo csv, todos os campos do usuário são atualizados\n Ajuste: correção no update de contatos do hub notificame\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.7\n\n<< UPDATE v3.0.5.7 - 18/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: descrição das campanhas usando Baileys\n Ajuste: ignoradas reações e comentários no Facebook e Instagram\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.6\n\n<< UPDATE v3.0.5.6 - 17/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado: atualização de versão via superadmin (Opção: Atualizar)\n Adicionado: envio de múltiplos arquivos no chat interno\n Adicionado: mensagem avulsa da Baileys gerando ticket e sendo carregada no histórico\n Adicionado: filtro de etiqueta e kanban (atendimento) e filtro de carteira (contato)\n Ajuste: integrações externas não interagem mais se fora do horário de atendimento\n Ajuste: reduzido o volume da notificação\n Ajuste: ao fazer busca por ticket, a listagem permanece fixa no recebimento de novas mensagens\n Removido: caption das mídias enviadas pela Baileys\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.5\n\n<< UPDATE v3.0.5.5 - 11/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado Hub NotificaMe (Instagram e Facebook - Beta)\n Adicionado: endpoint para criação de contato (postman)\n Adicionado: variáveis na mensagem (firstname, lastname, businessname)\n Adicionado: suporte para chatgpt-4omini\n Adicionado: suporte para arquivos DWG, KML, PSD\n Adicionado: organizar lanes do kanban por posição (configurações)\n Ajuste: correção de quoted e edição de mensagem no envio rápido\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.4\n\n<< UPDATE v3.0.5.4 - 06/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado: webhook configurações gerais liberado para WABA\n Ajuste: correção fechamento forçado ignorando despedida\n Ajuste: correção uuid para vídeos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.3\n\n<< UPDATE v3.0.5.3 - 04/09/2024>>\n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nBREAKING CHANGE! 1- Após atualizar de uma versão anterior a 3.0.5.0, você deverá obrigatoriamente recriar o seu redis 2- Caso haja campanhas, deverão ser reagendadas 3- A partir da versão 3.0.5.3 agende um evento de pm2 restart all uma ou duas vezes ao dia, no crontab do deployzdg\n\n Adicionado: rotina de auto limpeza do redis\n Adicionado: opção para reprocessar filas do bull no superadmin (Filas e Tarefas)\n Adicionado: adicionado uuid na nomeclatura de mídias recebidas\n Ajuste: correção no encaminhamento de mensagens para Baileys\n Ajuste: correção no envio rápido de mensagens para grupos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.2\n\n<< UPDATE v3.0.5.2 - 03/09/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nBREAKING CHANGE! \n\n1- Após atualizar de uma versão anterior a 3.0.5.0, você deverá obrigatoriamente recriar o seu redis\n\n2- Caso haja campanhas, deverão ser reagendadas\n\n Adicionado: opção de desligar o Redis em configurações (Beta)\n Adicionado: opção de enviar mensagens pendentes (Beta)\n Adicionado: opção de filtro para usuários e conexões na tela de atendimento (Beta)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.1\n\n<< UPDATE v3.0.5.1 - 30/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nBREAKING CHANGE! 1- Após atualizar de uma versão anterior a 3.0.5.0, você deverá obrigatoriamente recriar o seu redis (rotina 7) 2- Caso haja campanhas, deverão ser reagendadas\n\n Ajuste: correção Redis para novas conexões\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.5.0\n\n<< UPDATE v3.0.5.0 - 28/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nBREAKING CHANGE! 1- Após atualizar para 3.0.5.0 você deverá obrigatoriamente recriar o seu redis (rotina 7) 2- Caso haja campanhas, deverão ser reagendadas\n\n Ajuste: melhoria no redis (filas separadas para cada canal)\n Acesso ao bullboard: http://bakcendUrl/admin/queues/ (user: admin, senha: padrão do Redis)\n Ajuste: melhoria cores hover (css)\n Ajuste: melhoria métricas para supervisor (igualado ao admin)\n Adicionado: controle de filas e tarefas do redis no superadmin\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.5.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.9\n\n<< UPDATE v3.0.4.9 - 23/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: melhoria abrir foto de perfil na tela de atendimentos\n Ajuste: melhoria abrir foto de perfil na tela de contatos\n Ajuste: melhoria scroll to bottom limitado ao usuário logado\n Ajuste: melhoria consulta via api para o endpoint ticket\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.8\n\n<< UPDATE v3.0.4.8 - 22/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado: reações WABA\n Ajuste: melhoria socket das reações de canais não oficiais\n Ajuste: melhoria comportamento do modal etiqueta, carteira, kanban na tela de atendimento (fixados)\n Ajuste: melhoria customização logo, icon e nome no painel do superadmin\n Ajuste: melhoria socket CONTACT:UPDATE\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.7\n\n<< UPDATE v3.0.4.7 - 21/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: melhoria na lógica de avaliação automática\n Ajuste: fechamento forçado (avaliação automática habilitada)\n Ajuste: melhoria interação do bot e fechamento automático\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.6\n\n<< UPDATE v3.0.4.6 - 20/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: padronização das mensagens de localização para Waba, WWebJS e Baileys\n Ajuste: suporte para gifs no typebot e baileys\n Ajuste: renderização de vídeos/imagens/áudios no frontend para typebot e baileys\n Ajuste: evento de ack de waba corrigido no frontend\n Ajuste: adicionado a compatibilidade no formato de string para api de setar filas (melhoria para uso no typebot)\n Ajuste: adicionado avisos no disparo em massa referente a compatibilidade de api\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.5\n\n<< UPDATE v3.0.4.5 - 19/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: correção Kanban (usuário comum)\n Ajuste: melhoria no processo de download de imagem para disparo em massa e integração com Typebot\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.4\n\n<< UPDATE v3.0.4.4 - 18/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: correção Dify (Beta)\n Ajuste: configuração para definir se ao voltar para o pendente o usuário deverá ser resetado\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.3\n\n<< UPDATE v3.0.4.3 - 16/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: melhoria no carregamento do vcard\n Ajuste: aumento do número de caracteres na mensagem de aniversário\n Ajuste: listagem no evento de reabertura de tickets\n Ajuste: configuração \'Mostrar atendimentos em filas ou usuários atribuidos\'\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.2\n\n<< UPDATE v3.0.4.2 - 14/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: correção nos filtros da tela de atendimentos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.1\n\n<< UPDATE v3.0.4.1 - 12/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: interação chatbot interno com telegram\n Ajuste: chatgpt + áudio para Baileys\n Ajuste: encerramento automático do ticket (configurações gerais)\n Ajuste: marcando como lida no evento de reação para Baileys\n Adicionado: alterar todos os ícones e nome da plataforma pelo painel do superadmin\n Adicionado: definição do limite tickets no front (configurações gerais)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.4.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. npm install d. npx sequelize db:migrate e. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.4.0\n\n<< UPDATE v3.0.4.0 - 09/08/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Ajuste: mudança no controle de versionamento para facilitar a distribuição de hotfix (3.0.4.0)\n Ajuste: supervisor pode listar contatos na campanha\n Ajuste: tratamento de mensagem de ausência para Chatbot Interno\n Ajuste: listagem de contatos por etiqueta no disparo em massa (otimização)\n Ajuste: ao abrir tickets de dentro da ZPRO, não serão mais ativados as integrações externas (Chatgpt, Typebot, Diagloflow, N8N e Dify)\n Ajuste: notificação para todos os tenants\n Ajuste: campanhas com Baileys\n Ajuste: reação e edição de mensagem para Baileys\n Ajuste: sincronização de histórico com Baileys\n Ajuste: salvamento e sincronização das pré-keys para Baileys\n Ajuste: posicionamento botão de darkmode no front\n Ajuste: controle de tarefas pelo redis\n Ajuste: melhoria nas indexações de banco\n Ajuste: listagem de tickets na página de atendimentos\n Ajuste: validação de importação do JSON no Chatbot\n Adicionado: controle velocidade para áudio\n Adicionado: integração Dify (Beta)\n Adicionado: transferir mensagem para chatbot\n Adicionado: kanban para visualização de etiquetas\n Adicionado: opção para destruir mensagem ao apagar\n Adicionado: endpoint consulta mensagens do ticket e para criar tickets (postman)\n Adicionado: envio de msg pro aniversariante\n Adicionado: primeiro nome, sobrenome, cpf, empresa e data de aniversário para usuário\n Removido: ultimaMensagem removida das variáveis do typebot\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\=============================================\n\n### 3.0.0.3\n\n<< UPDATE v3.0.0.3 - 22/07/2024>>\n\n CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado integração com a API Não Oficial BAILEYS\n Adicionado método de checagem de números em massa em configurações\n Adicionado transferência de atendimento em massa no painel (filas e usuarios)\n Adicionado agendamento para grupo\n Adicionado kanban no bot interno (beta)\n Adicionado chatgpt no bot interno (beta)\n Adicionado envio de template com variáveis para waba (mostrando variáveis no front)\n Adicionado vídeo conferência no chat interno\n Adicionado download do áudio recebido\n Adicionado saudação no privado para partricipantes de grupos\n Adicionado disparo em massa por etiquetas\n Adicionado chatgpt interagindo com áudio, pdf, docx, xlsx e imagem\n Adicionado avalição automática quando reabre envia de novo\n Adicionado transcrição de áudio em texto com Google Speech to Text\n Adicionado áudio mensagem rápida baileys\n Adicionado proxy conexão baileys\n Adicionado envio em massa de imagem com descrição baileys\n Adicionado botão ativar n8n como é no typebot e chatgpt (se media, envio do base64)\n Adicionado ajustes de sockets do android e ios\n Adicionado Botão "Esqueci Minha Senha"\n Adicionado ajuste no scroll no atendimento\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\=============================================\n\n### 3.0.0.2\n\n<< UPDATE v3.0.0.2 - 01/07/2024>>\n\n CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Adicionado customização de logos e cores no Superadmin\n Adicionado interface de terminal no Superadmin\n Adicionar opção trial para tenant no Superadmin\n Adicionado módulo extra de cadastro de tenants e controle de pagamentos\n Adicionado suporte a templates com variáveis e mídias no atendimento Waba\n Adicionado compatibilidade com qualquer template no envio do atendimento Waba\n Adicionado definição da versão da api da Waba\n Adicionado limite de envio de arquivos para 50mb\n Adicionado notificação do chat interno para equipes\n Adicionado autodistribuir por canal\n Adicionado correção na importação dos contatos (validação para saber se o contato existe)\n Adicionado mensagem interna\n Adicionado palavra proibida em grupos agora é rastreada dentro de toda mensagem enviada\n Adicionado remoção de carteiras ao deletar usuário\n Adicionado transbordo de carteira, caso usuário esteja online o ticket é distribuido para os demais usuários online\n Adicionado cadência na reconexão\n Adicionado suporte a MPEG\n Removido suporte webcache para api nãoo oficial (versões 2.24xxx expiradas em 30/06)\n Removido permissão de inativaçãoo do tenant 1\n Melhoria no socket mobile\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND (alterações significativas para receber o módulo de cores dinâmicas) substituir pasta src completamente frontend/package.json\n\n\=============================================\n\n### 3.0.0.1\n\n<< UPDATE v3.0.0.1 - 17/06/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\n Método de espiar mensagem modernizado\n Método para listar contatos no Kanban modernizado\n Adicionado endpoint na API para trazer informações dos canais (showChannel)\n Adicionado permissão para deletar agendamentos com mais de 2 horas\n Adicionado opção da WABA para trabalhar com listas ou botões com Typebot\n Adicionado opção de marcar como não lido no atendimento\n Adicionado filtros de mensagens no atendimento\n Adicionado envio de mensagem avulsa ao lado do botão de notificações\n Adicionado opção de definir a mensagem de avaliação de atendimento\n Adicionado configuração para mostrar para todos os usuários os atendimentos sem usuário ou fia atribuída\n Adicionado a opção de chamar o Typebot dentro do Chatbot interno da ZPRO, como interação\n Adicionado webhook para escutar criação e atualização de contatos na ZPRO\n Adicionado barra de carregamento na tela de tickets e desabilitado os botões de home e chat interno enquanto todos os tickets não forem carregados\n Adicionado aviso de sincronização para WhatsApp WEB com evolução em porcentagem\n Adicionado Pairing Code para WhatsApp WEB (Beta)\n Adicionado identificador de Tenant (CPF/CNPJ/Codigo Interno)\n Adicionado agendamento fora do atendimento\n Adicionado endpoint para ativar ou desativar Tenant (controle de pagamento por outros gateways)\n Adicionado botão para criar tarefas no atendimento\n Adicionado escuta de evento de delete de mensagem por parte do cliente\n Adicionado botão para exportar conversas em PDF\n Removida obrigatriedade de enviar resposta rápida usando texto (pode enviar apenas arquivo)\n Adicionado compatibilidade com extensão .PFX e P2K\n Adicionado opção de usar proxy com API Não Oficial\n Adicionado opção de webversion e remotepath com API Não Oficial\n Adicionado opção para deletar tenant\n Adicionado captura do protocolo inicial na tabela de protocolos\n Adicionado carteiras e tags atualizadas em tempo real assim que definidas no atendimento\n* Adicionado restart da API Não Oficial em configurações\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nsubstituir pasta dist completamente backend/package.json\n\nfrontend/public/instagram-logo.png frontend/public/POSTMAN\_v2.json frontend/src/App.vue frontend/src/components/ccFlowBuilder/delayField.vue frontend/src/components/ccFlowBuilder/mediaField.vue frontend/src/components/ccFlowBuilder/node\_form.vue frontend/src/components/ccFlowBuilder/panel.vue frontend/src/components/ccFlowBuilder/tagField.vue frontend/src/components/ccFlowBuilder/typebotField.vue frontend/src/layouts/MainLayout.vue frontend/src/layouts/socketInitial.js frontend/src/pages/Login.vue frontend/src/pages/agendamentos/DialogAgendamentoMensagem.vue frontend/src/pages/agendamentos/Index.vue frontend/src/pages/agendamentos/InputMensagem.vue frontend/src/pages/atendimento/MensagemRespondida.vue frontend/src/pages/agendamentos/RecordingTimer.vue frontend/src/pages/agendamentos/mixinCommon.js frontend/src/pages/api/Index.vue frontend/src/pages/atendimento/Index.vue frontend/src/pages/atendimento/InforCabecalhoChat.vue frontend/src/pages/atendimento/InputMensagem.vue frontend/src/pages/atendimento/ItemTicket.vue frontend/src/pages/atendimento/MensagemChat.vue frontend/src/pages/atendimento/mixinAtualizarStatusTicket.js frontend/src/pages/atendimento/mixinCommon.js frontend/src/pages/atendimento/mixinSockets.js frontend/src/pages/avaliacoes/ConfigurarAvaliacao.vue frontend/src/pages/avaliacoes/Index.vue frontend/src/pages/avaliacoes/ListarAvaliacao.vue frontend/src/pages/campanhas/ContatosCampanha.vue frontend/src/pages/chatPrivado/index.vue frontend/src/pages/chatInterno/index.vue frontend/src/pages/configuracoes/ConfiguracoesGerais.vue frontend/src/pages/configuracoes/ConfiguracoesVariaveis.vue frontend/src/pages/configuracoes/ConfiguracoesWebhooks.vue frontend/src/pages/contatos/Index.vue frontend/src/pages/dashboard/DashTicketsFilas.vue frontend/src/pages/dashboard/Index.vue frontend/src/pages/equipes/Index.vue frontend/src/pages/fechamento/Index.vue frontend/src/pages/grupo/massa/MassaGrupos.vue frontend/src/pages/grupo/massa/MassaUsuarios.vue frontend/src/pages/kanban/Cards.vue frontend/src/pages/kanban/Index.vue frontend/src/pages/massa/MassaSMS.vue frontend/src/pages/massa/MassaTexto.vue frontend/src/pages/massa/MassaTextoVariavel.vue frontend/src/pages/sessaoTenants/Index.vue frontend/src/pages/sessaoWhatsapp/Index.vue frontend/src/pages/sessaoWhatsapp/ItemStatusChannel.vue frontend/src/pages/sessaoWhatsapp/ModalQrCode.vue frontend/src/pages/sessaoWhatsapp/ModalWhatsapp.vue frontend/src/pages/tenantApi/Index.vue frontend/src/pages/tenants/Index.vue frontend/src/pages/tenants/ModalTenant.vue frontend/src/router/routes.js frontend/src/service/chatPrivado.js frontend/src/service/contatos.js frontend/src/service/empresas.js frontend/src/service/equipes.js frontend/src/service/massa.js frontend/src/service/pm2.js frontend/src/service/tenants.js frontend/src/service/tickets.js frontend/src/service/user.js frontend/src/service/waba.js frontend/src/store/getters.js frontend/src/store/index.js frontend/src/store/modules/atendimentoTicket.js frontend/src/store/modules/chatPrivado.js frontend/src/store/modules/user.js\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/atualizacoes-antigas/3.0.0.x-3.0.5.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.0.6.x\n\n### 3.0.6.9\n\n<< UPDATE v3.0.6.9 - 18/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 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. Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: relatório de contatos para Kanban e Carteira\n Adicionado: adicionado desafio e limitador de tentativas de login\n Adicionado: variáveis para templates waba\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.8\n\n<< UPDATE v3.0.6.8 - 15/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 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. Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: novas rotas para API\n mudar status typebot, chatgpt, n8n, dialogflow, dify do ticket no SetTicketInfo\n criar notas via CreateNotes\n atualizar contatos via UpdateContact\n desconectar sessão em via DisconnectSession\n Adicionado: ativar/desativar transbordo de atendimentos (configurações Admin)\n Adicionado: melhoria no controle da janela de conversas Waba\n Adicionado: ao realizar disparos de template com Waba o status do ticket (se aberto) será mantido\n Adicionado: disparo em massa para Kanban\n Removido: descrição de mídia (nome do arquivo) no envio com WWEBJs\n Ajuste: variáveis primeiroNome, ultimoNome e empresa nas campanhas\n Ajuste: correção disparo em massa com variáveis + arquivos via upload para grupos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.7\n\n<< UPDATE v3.0.6.7 - 13/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 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. Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: envio dos dados do ticket no webhook de escuta de notas\n Adicionado: envio do caption do arquivo para a rota SendMessageAPITextBase64\n Adicionado: integração do n8n liberada para Grupos\n Removido: descrição de mídia (nome do arquivo) no envio com WwEBJs\n Ajuste: mudança no layout do item ticket (temporizador na linha de baixo, aumento de altura)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.6\n\n<< UPDATE v3.0.6.6 - 11/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 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. Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: listagem das ids dos grupos no gestor de grupos\n Adicionado: adiciona transferência entre canais no chatbot e no atendimento (BETA)\n Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n Adicionado: suporte ao recebimento de arquivos com extensão .CRM\n Adicionado: botão para remover mídia em mensagens ráidas\n Ajuste: correção no botão resolver atendimento (correção 3.0.6.5)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.5\n\n<< UPDATE v3.0.6.5 - 07/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! Para usuários BAILEYS: Atualize fora do horário de expediente, versão da Baileys atualizada. Pode ser necessária reler o QRCode ou recriar o canal.\n\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: opção para definir o canal padrão\n Adicionado: #ID do canal na tela de Canais\n Adicionado: visão geral/rápida dos canais nas configurações do admin\n Adicionado: opção para usar mais de um token do Wavoip por canal\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.4\n\n<< UPDATE v3.0.6.4 - 27/10/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! Antes de realizar a atualização é obrigatório a realização de um backup da pasta public do backend. Para usuários BAILEYS: Atualize fora do horário de expediente, versão da Baileys atualizada. Pode ser necessária reler o QRCode ou recriar o canal.\n\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: variáveis mensagens rapidas\n Adicionado: variáveis no disparo em massa de templates (WABA)\n Adicionado: limitação de ação de abertura de tikcet em andamento por usuário comum (se configuração ativa - Não visualizar Tickets já atribuidos à outros usuários)\n Ajuste: download de mídia no Typebot e Baileys\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.3\n\n<< UPDATE v3.0.6.3 - 23/10/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! Antes de realizar a atualização é obrigatório a realização de um backup da pasta public do backend.\n\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: criação de planos e página de Signup\n Adicionado: nota de transferência\n Adicionado: paginação na listagem dos aniversariantes\n Adicionado: retorno do ack e caption para vídeos com Baileys\n Adicionado: recebimento e envio de arquivos AI, EPS, e PSD\n Ajuste: interação chatbot (mensagem de ausência com Baileys)\n Ajuste: interação chatbot (condição respeitando maiúscula e minúsucla)\n Ajuste: arquivos mensagens rápidas\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.2\n\n<< UPDATE v3.0.6.2 - 18/10/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! Antes de realizar a atualização é obrigatório a realização de um backup da pasta public do backend.\n\n Breaking Change: Pastas public separadas para empresas\n Adicionado: rotas para criação de api e gestão de conexões\n Adicionado: rotas para api interna Waba (Criação de mensagens/tickets)\n Adicionado: calcular arquivos, deletar arquivos e migrar arquivos para empresas (superadmin)\n Adicionado: webhook enviando dados kanban, etiqueta, carteira e notas\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.1\n\n<< UPDATE v3.0.6.1 - 14/10/2024>>\n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n Adicionado: opção para escolher atualização do nome do contato\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.6.0\n\n<< UPDATE v3.0.6.0 - 07/10/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n Adicionado: mostrar histórico agrupado sem limitar por fila (configurações)\n Adicionado: opção consultar contatos por cpf, primeiro nome, sobrenome e nome de empresa\n Adicionado: opção consultar tickets por cpf, primeiro nome, sobrenome e nome de empresa\n Adicionado: aumento do limite de listagens de mensagens do chatinterno\n Ajuste: correção de encaminhamento de mensagens quando existir tickets com canais nulos\n Ajuste: envio de txt e csv pelo envio rápido\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.6.0 =================\n\n* USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/atualizacoes-antigas/3.0.6.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.0.7.x\n\n### 3.0.7.9\n\n<< UPDATE v3.0.7.9 - 06/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! \n\n1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. \n\n2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. \n\n3- 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.\n\n Adicionado: componente de delay aleatório no envio da campanha (sistema)\n Adicionado: botão para mutar as notificações (beta)\n Adicionado: canais limitados a usuários (beta)\n Adicionado: verificar de BM WABA em configurações\n Adicionado: gráfico de atendimento por canais (nome e tipo)\n Ajuste: sanitização de contatos com foto expirada\n Ajuste: sanitização na adição de contatos\n Ajuste: sanitização criação de canais Evolution (remoção de espaços e caracteres especiais)\n Ajuste: sanitização envio/recebimento pdf Evolution\n Ajuste: sanitização checagem de grupos\n Ajuste: remoção de interações externas quando carteirizada (chatgpt, typebot e outros)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.8\n\n<< UPDATE v3.0.7.8 - 28/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 2- 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.\n\n Adicionado: compatibilidade com mídias para Evolution API 2.2.0\n Adicionado: compatibilidade campanhas para Evolution API 2.2.0\n Adicionado: opção remover demanda atendimento\n Adicionado: opção kanban demanda atendimento\n Adicionado: listar dispositivos wavoip\n Ajuste: responsividade na tela de configurações (novo layout)\n Ajuste: interação de áudio para Instagram (Hub)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.7\n\n<< UPDATE v3.0.7.7 - 27/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 2- 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.\n\n Adicionado: rotinas de webhook para Evolution API\n Adicionado: rotinas para grupo Evolution API\n Adicionado: rotinas de webhook para Meow\n Adicionado: rotinas de webhook para Baileys\n Adicionado: sanitização rotina de atualização do contato\n Adicionado: melhoria para relatórios de atendimento\n Adicionado: melhoria para relatórios de resumo de usuários\n Adicionado: opção para mudança na versão do socket\n Adicionado: debug wavoip\n Ajuste: responsividade na tela de campanhas\n Ajuste: interação de áudio para Instagram (Hub)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.6\n\n<< UPDATE v3.0.7.6 - 26/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 2- 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.\n\n Adicionado: Evolution API\n Adicionado: aviso sobre banimentos para disparo em massa, gestão de grupos em massa e campanhas\n Adicionado: opção para remover privilégios de visualização do supervisor\n Adicionado: demanda no atendimento\n Adicionado: valor no atendimento\n Adicionado: opção para bloquear o wavoip no usuário\n Adicionado: opção para marcar todas as mensagens como lidas no painel de atendimento\n Adicionado: recorrência de tarefas\n Ajuste: responsividade na tela de campanhas\n Ajuste: interação de áudio para Instagram (Hub)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.5\n\n<< UPDATE v3.0.7.5 - 17/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Nessa versão o APP.vue será substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 2- 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.\n\n Adicionado: paginação na página de protocolos, usuários e notificações\n Adicionado: conversa avulsa na página de atendimento\n Adicionado: opção para inverter a ordem dos tickets na página de atendimento\n Adicionado: melhoria significativa na exportação de mensagens na página de atendimento\n Adicionado: mudança na exibição da mensagem editada\n Adicionado: extensão .key e .cdr (beta)\n Adicionado: palavra chave para fechar atendimento na página de canais\n Adicionado: fechar todos os atendimentos abertos/pendentes na página de canais\n Adicionado: opção para desligar interações externas ao abrir o ticket na página de canais\n Adicionado: horário de envio e imagem a mensagem de aniversário\n Adicionado: desligar interações externas quando carterizado ao receber o atendimento\n Adicionado: aviso de tarefa na barra de ferramentas\n Adicionado: contador envio de mensagens em massa para WABA\n Adicionado: acesso ao registro de ligações do wavoip\n Adicionado: maxUser e maxConnections a api de update do tenant\n Adicionado: webhook no envio de mensagens de dentro da zpro para baileys e whatsapp-web.js\n Ajuste: correções whatsapp meow\n Ajuste: melhoria no comportamento de carregamento das cores\n Removido: encaminhar Vcard\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.4\n\n<< UPDATE v3.0.7.4 - 10/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ UPDATE DE SEGURANÇA! 1- Correção de permissão do superadmin (Update Crítico)\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 2- 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. 3- Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: envio de SMS com Conecta Startup\n Adicionado: relatório de atendimento e usuários\n Adicionado: corpo ao envio de arquivos via API Waba\n Adicionado: recebimento de email Hub Notificame\n Ajuste: adição de contatos\n Ajuste: correção na api de envio para grupos com id -\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.3\n\n<< UPDATE v3.0.7.3 - 05/12/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ UPDATE DE SEGURANÇA! 1- Correção de permissão do superadmin (Update Crítico)\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 2- 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. 3- Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: tradução para a cabeçalho das opções de botões Typebot + WABA\n Adicionado: disparo em massa de templates + variáveis para WABA\n Adicionado: permissão para adicionar contato quando houver apenas o telegrama na plataforma\n Adicionado: rota para deletar api\n Adicionado: redimensionado captcha (IPhones)\n Adicionado: estilo darkmode no pairing code\n Adicionado: opção bloquear contato/bloquear chatbot na tela de contatos\n Adicionado: filtro para colunas na tela de contatos\n Adicionado: redimensionamento email tela de atendimento\n Adicionado: validações de segurança quanto a perfil no backend\n Adicionado: validações de segurança quanto a perfil no frontend\n Adicionado: remoção do case sensitive em palavras chave para desligar e reiniciar Typebot, Chatgpt e Dify\n Removido: rota disconnectSession depreciada\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.2\n\n<< UPDATE v3.0.7.2 - 28/11/2024>>\n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ UPDATE DE SEGURANÇA! 1- Correção de permissão do superadmin (Update Crítico)\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 2- 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. 3- Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: limite de conversas no chat interno\n Adicionado: opção de trial no signup\n Removido: delete automático para tenants com trial vencido\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.1\n\n<< UPDATE v3.0.7.1 - 27/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ UPDATE DE SEGURANÇA! \n\n1- Correção de permissão do superadmin (Update Crítico)\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! \n\n1- A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip \n\n2- 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. \n\n3- Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: filtro de etiquetas na tela de contatos\n Adicionado: opção para desativar a API Não Oficial para o tenant (Superadmin)\n Adicionado: auto distribuir considerando filas e excluindo o admin da distribuição\n Adicionado: rota API showContact, showChannelById e tenantApiShowTenant (postman atualizado)\n Adicionado: botão para duplicar/reordenar campanhas\n Adicionado: relatório detalhado por campanha\n Adicionado: filtro em tarefas\n Adicionado: opção para selecionar fila/usuário na abertura do atendimento (mobile)\n Adicionado: bloquear chatbot para contato\n Ajuste: recebimento do socket edição da mensagem\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.7.0\n\n<< UPDATE v3.0.7.0 - 20/11/2024>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma. Para isso, você deve subir o autoinstalador completo novamente na sua VPS e não apenas o arquivo update.zip 2- 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. 3- Transferência entre canais deverá ser usada apenas entre canais de mesmo tipo - Whatsapp para Whatsapp\n\n Breaking Change: A atualização automática passa a preservar customização de cores, logos, favicon e nome da plataforma.\n Breaking Change: Pastas public separadas para empresas a partir da 3.0.6.2\n Adicionado: licenciamento da assinatura no superadmin\n Adicionado: variáveis na mensagem rápida para WABA\n Adicionado: download de .xml e .txt no atendimento\n Adicionado: criação do objeto PDF no frontend quando usado o chatbot interno com Baileys\n Adicionado: melhoria no retorno dos webhooks evitando travamento no recebimento de mensagens\n Adicionado: Baileys ignorando por padrão status, newsletters e broadcasts\n Adicionado: método de carregamento de tickets para quando não houverem mais tickets a serem carregados no atendimento\n Ajuste: abertura de atendimento para mobile\n Ajuste: correção no método CreateAPI para tenants diferentes do 1\n Removido: update rápido no super admin\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.7.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/atualizacoes-antigas/3.0.7.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.0.8.x\n\n### 3.0.8.9\n\n<< UPDATE v3.0.8.9 - 05/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: processamento cadenciado das mensagens com integrações externas (Typebot, ChatGPT, Dify e outros)\n o sistema irá processar uma mensagem apenas, no caso de envio de múltiplas mensagens antes da resposta da interação (DEBOUNCE)\n Adicionado: integração com LM Studio (DeepSeek, Qwen 2.5, Llama, Mistral, Phi, Gemma)\n Adicionado: alerta de erro no cadastro do usuário\n Adicionado: alerta de erro no cadastro do contato\n Adicionado: atualização da tela de contatos ao adicionar etiquetas ou demais informações\n Ajuste: compatibilização no salvamento de contatos usando MEOW\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.8\n\n<< UPDATE v3.0.8.8 - 31/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: notificação para o APP Pwa\n Adicionado: suporte ao recebimento de OFX\n Adicionado: filtro de acesso às conexões nas mensagens avulsas\n Adicionado: aviso de e-mail já cadastrado na tela de usuário\n Adicionado: acionar chatbot dentro do atendimento com Evolution\n Adicionado: limpeza do storage ao acionar o botão Reiniciar (limpar cookies)\n Ajuste: validação contatos evolution\n Ajuste: distribuição balanceada/aleatória no chatbot interno\n Ajuste: associação do usuário no envio da mensagem avulsa\n Ajuste: escuta da mensagem deletada usando Meow\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.7\n\n<< UPDATE v3.0.8.7 - 28/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: opção para liberar o campo de envio de mensagem após envio de template (Waba)\n Adicionado: opção isClosed para API no formData\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.6\n\n<< UPDATE v3.0.8.6 - 27/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: distribuição balanceada no chatbot\n Adicionado: setar userId na criação do ticket por API\n Adicionado: setar closed no envio da mensagem por API para fechar o ticket aberto\n Adicionado: status offline/online na tela de usuários\n Adicionado: link para atendimento na página de notas\n Ajuste: correção interpretação de arquivos no chatgpt\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.5\n\n<< UPDATE v3.0.8.5 - 23/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: número do contato Waba (HubNotificame) na tela de contatos\n Adicionado: iniciar conversa pela Evolution no Vcard\n Adicionado: conversa avulsa associa ticket ao usuário\n Ajuste: compatibilização salvar contatos com Evolution\n Ajuste: tratamento ligação e envio de mensagens externas não acionando o chatbot para Evolution\n Ajuste: compatibilização importação de contatos via CSV com Evolution\n Ajuste: adicionado answered ao atendimento Meow e Evolution\n Ajuste: correção recebimento / envio de arquivos Meow\n Ajuste: correção recebimento / envio de áudios Waba (HubNotificame)\n Ajuste: ajustes tradução\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.4\n\n<< UPDATE v3.0.8.4 - 18/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: buscar ticket por mensagem (atendimento)\n Adicionado: escolha idioma na tela de login\n Adicionado: escuta de envio de mensagens pela API da Evolution\n Adicionado: navegação para os tickets na tela de protocolos/avaliação\n Ajuste: correção horário de atendimento Evolution\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.3\n\n<< UPDATE v3.0.8.3 - 17/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: tradução espanhol\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.2\n\n<< UPDATE v3.0.8.2 - 15/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: tradução inglês (perfil)\n Adicionado: agendamento recorrente (página de agendamentos)\n Ajuste: envio de reação evolution\n Ajuste: layout de envio de mensagem no desktop\n Ajuste: layout de envio de mensagem no mobile\n Ajuste: nome dos contatos na wwebjs\n agendamento recorrente (page agendamento)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.1\n\n<< UPDATE v3.0.8.1 - 10/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: opção para setar versão do socket da baileys no .env\n Adicionado: transferência para evo e meow\n Adicionado: checagem de perfis\n Ajuste: sanitização de traduções\n Ajuste: recebimento de mídias para WABA (Hub Notificame)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.8.0\n\n<< UPDATE v3.0.8.0 - 09/01/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 2- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 3- 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.\n\n Adicionado: botão para reiniciar sessão (limpa cookies e cache do navegador)\n Adicionado: suporte para envio de áudios nas campanhas\n Adicionado: opção para ligar/desligar interação externa (chatgpt, typebot e outros) quando carteirizado\n Ajuste: correção nas traduções\n Ajuste: correção caption de mídias para wwebjs, baileys e evo\n Ajuste: sanitização nome de grupos evolution\n Ajuste: sanitização mensagem encaminhada evolution\n Ajuste: sanitização interpretação de áudio do chatgpt\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.8.0 =================\n\n* USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/atualizacoes-antigas/3.0.8.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Avancado Recursos Tecnicos
Banco de dados - Como acessar\n\nEsta documentação orienta o usuário sobre como se conectar ao banco de dados PostgreSQL do Z-PRO. Esse acesso é importante para momentos em que você precise visualizar, manipular, exportar, baixar ou importar dados diretamente nas tabelas do sistema (como mensagens, contatos, etc.).\n\n#### 🛠️ Ferramenta Necessária\n\nPara realizar este procedimento, utilizaremos o software PGAdmin.\n\n O que é: Um programa gratuito e com interface gráfica para gerenciamento de bancos de dados PostgreSQL.\n Onde encontrar: Baixe e instale gratuitamente na sua máquina local (consulte o link oficial de download do PGAdmin).\n\n\n\n### Passo a Passo para Conexão\n\n#### Passo 1: Localizar as Credenciais de Acesso\n\nAntes de abrir o PGAdmin, você precisará do Usuário (Username) e da Senha (Password*) do seu banco de dados. Você pode encontrar essas informações de duas formas:\n\n1. Sumário de Instalação: Os dados são entregues no resumo gerado no final da instalação do sistema Z-PRO.\n2. Arquivo .env: Caso não tenha salvo o sumário, acesse o servidor (VPS) onde o Z-PRO está hospedado, navegue até a pasta do back-end e abra o arquivo .env. Lá constarão o username e o password do banco de dados.\n\n#### Passo 2: Configurar o Servidor no PGAdmin\n\nCom o PGAdmin instalado e aberto em seu computador, siga os passos abaixo para criar a conexão:\n\n1. Na tela inicial do PGAdmin, clique com o botão direito sobre a opção de servidores.\n2. Selecione Registrar > Servidor (Register > Server).\n3. Na aba Geral (General):\n * Nome: Dê um nome de sua preferência para identificar a conexão (Exemplo: ZPRO ou ZPRO - Produção).\n4. Na aba Conexão (Connection):\n * Endereço/Host: Insira o IP da sua VPS (Atenção: utilize localhost apenas se o sistema estiver rodando fisicamente no seu próprio computador).\n * Username (Nome de usuário): Insira o usuário localizado no Passo 1.\n * Password (Senha): Insira a senha localizada no Passo 1.\n5. Salve as configurações. O PGAdmin se conectará automaticamente ao servidor.\n\n#### Passo 3: Navegando pelas Tabelas do Z-PRO\n\nCom a conexão estabelecida com sucesso:\n\n1. Expanda a conexão recém-criada no menu lateral.\n2. Localize a opção Bancos de Dados (Databases) e abra o banco correspondente à sua instalação (nas instalações atuais, procure pelo banco com nome Zepro ou equivalente; em versões muito antigas, o nome era izing).\n3. Para encontrar as informações do sistema, navegue pelo seguinte caminho:\n * Esquemas (Schemas) > Tabelas (Tables).\n\n✅ Pronto!** Agora você tem acesso a todas as tabelas da solução Z-PRO (como a tabela de mensagens, por exemplo). Através dessa interface, você pode visualizar e manipular todas as informações conforme a necessidade da sua operação.\n\n### Vídeo aula no portar do assinante:\n\nhttps://portal.zdg.com.br/270021-sistema-zpro/5179470-acessando-o-banco-de-dados \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/banco-de-dados-como-acessar.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Boas práticas de Infraestrutura\n\n- Guia para Instalação com Docker: Este guia explica como instalar e configurar o ZPRO Passaporte usando Docker Compose\n- Configuração do Traefik com Nginx: Prepara o ambiente para usar Traefik sem dar conflito com o Nginx\n- Como extrair Logs do Sistema\n- Infra - Recriação do Redis: Redis é a aplicação utilizada pelo Z-PRO para armazenar memória rápida (de curto prazo) e gerenciar a execução dos processos do sistema\n- Otimização de Nginx para Alta demanda de mensagem\n- Proxy IPv4 no Proxy-Seller: Como comprar um proxy IPv4 no Proxy-Seller e obter URL, porta, usuário e senha\n- Migração Z-PRO entre servidores\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como extrair Logs do Sistema\n\n{% hint style="warning" %}\nIMPORTANTE: OS LOGS SÃO INDISPENSÁVEIS PARA O SUPORTE\n\nOs logs são o "caixa-preta" do sistema. Eles registram exatamente o que aconteceu no momento de um erro.\n\nSem o envio dos logs, nossa equipe não consegue analisar o que está ocorrendo na sua infraestrutura. Antes de abrir um chamado relatando falhas, por favor, extraia os logs seguindo os passos abaixo. Isso agiliza (e muito) a solução do seu problema.\n{% endhint %}\n\nExistem dois tipos principais de logs que podem ser solicitados:\n\n1. Backend (Terminal): Para erros de conexão, API, WhatsApp, envio de mensagens e banco de dados.\n2. Frontend (Navegador): Para erros visuais, tela branca ou botões que não respondem.\n\n*\n\n### Método 1: Logs do Backend (Via Terminal / SSH)\n\n#### Pré-requisito: habilitar os logs no seu servidor\n\nAntes de tudo, você precisa ativar o registro de logs no seu servidor.\\n\\nAbra o terminal do sistema e edite o arquivo .env:\n\n\nnano /home/deployzdg/zpro.io/backend/.env\n\n\nAdicione os seguintes parâmetros:\n\n\nLOGGER_INFO=true\nLOGGER_WARN=true\nLOGGER_ERROR=true\n\n\nSalve a edição com ctrl + O\\nSaia do arquivo com ctrl + X\n\n{% embed url="https://www.loom.com/share/4a0c7e73e71e41b19b30999b8b806237" %}\n\n#### Como acessar os logs\n\nEste é o método universal, válido tanto para quem usa o terminal da Hostinger quanto para quem acessa via SSH (PuTTY, etc.).\n\nPasso a Passo:\n\n1. Acesse a VPS: Entre no terminal da sua máquina.\n2. Acesse o usuário do sistema: As aplicações rodam dentro do usuário deployzdg. É obrigatório entrar nele primeiro:\n\n bash\n su - deployzdg\n\n3. Liste os Processos (Importante): Antes de abrir o log, você precisa saber qual é o ID do processo. O backend geralmente é o 0, mas se você tiver múltiplas instâncias, isso pode mudar. Digite:\n\n bash\n pm2 list\n\n\n Veja na coluna id qual número corresponde ao processo que você quer verificar (geralmente chamado de backend ou zpro-backend).\n4. Abra o Log: Supondo que o ID do seu backend seja 0 (o mais comum), digite:\n\n bash\n pm2 log 0\n\n\n (Se o ID for outro, substitua o número. Ex: pm2 log 2).\n5. Analise e Capture: O terminal mostrará os registros em tempo real.\n * Tente provocar o erro: Com o log aberto, vá no seu sistema Z-PRO e tente fazer a ação que está dando erro.\n * Texto Vermelho: Indica falhas. Tire um print ou copie as linhas vermelhas para enviar ao suporte.\n6. Sair do Log: Para parar a exibição e liberar o terminal, pressione as teclas: CTRL + C\n\n### Vídeo Logs do Backend para Usuários Hostinger (Via Navegador)\n\n{% embed url="https://www.loom.com/share/96b6d501567f4dcc9add470f1740b1e4" %}\n\n### Vídeo Logs do Backend via SSH\n\n{% embed url="https://www.loom.com/share/8ae6aa13ecf34530a28bd09f72e85cb2" %}\n\n*\n\n### Método 2: Logs do Frontend (Console do Navegador)\n\nSe o erro parece ser visual, tela branca ou no carregamento da página, o erro não está no servidor, mas sim no navegador.\n\nPassos para Acessar o Console:\n\n1. Abra o Navegador: Visite a página do Z-PRO onde o problema está acontecendo.\n2. Abra as Ferramentas do Desenvolvedor: Use um dos métodos abaixo:\n Botão Direito: Clique com o botão direito em qualquer lugar da página e selecione "Inspecionar".\n Atalhos (Windows/Linux): Pressione F12 ou Ctrl + Shift + J.\n Atalhos (Mac): Pressione Cmd + Option + I.\n3. Selecione a Aba "Console": Dentro da janela que abriu, clique na aba escrita "Console".\n\nO que analisar no Console:\n\n Erros (Vermelho): Erros de execução no código front-end (JavaScript) serão exibidos em vermelho. Tire um print desses erros para o suporte.\n *Avisos (Amarelo): Mensagens de alerta que geralmente não impedem o funcionamento.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/como-extrair-logs-do-sistema.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configuração do Traefik com Nginx\n\n### Opção 1: Desabilitar configurações do nginx (Recomendado)\n\nExecute na VPS:\n\nbash\n# 1. Verificar quais configurações do nginx estão ativas\nls -la /etc/nginx/sites-enabled/\n\n# 2. Verificar se há configurações para os domínios\ngrep -r "dockerapp.comunidadezdg.com.br" /etc/nginx/sites-enabled/\ngrep -r "dockerapi.comunidadezdg.com.br" /etc/nginx/sites-enabled/\n\n# 3. Desabilitar as configurações antigas (se existirem)\nsudo rm /etc/nginx/sites-enabled/zpro-frontend\nsudo rm /etc/nginx/sites-enabled/zpro-backend\n\n# 4. Testar configuração do nginx\nsudo nginx -t\n\n# 5. Recarregar nginx\nsudo systemctl reload nginx\n\n\n### Opção 2: Configurar nginx para fazer proxy para Traefik\n\nSe você quiser manter o nginx na porta 443 fazendo proxy para o Traefik:\n\nbash\n# Criar configuração do nginx para fazer proxy para Traefik\nsudo nano /etc/nginx/sites-available/zpro-traefik-proxy\n\n\nOPÇÃO A: Gerar certificados via Certbot (Recomendado)\n\nPrimeiro, gere os certificados. Como a porta 80 está em uso pelo nginx, use uma das opções abaixo:\n\nMétodo 1: Parar nginx temporariamente (Mais simples)\n\nbash\n# Instalar certbot (se não tiver)\nsudo apt update\nsudo apt install certbot python3-certbot-nginx -y\n\n# Parar nginx temporariamente\nsudo systemctl stop nginx\n\n# Gerar certificados para os domínios\nsudo certbot certonly --standalone -d dockerapp.comunidadezdg.com.br -d dockerapi.comunidadezdg.com.br\n\n# Reiniciar nginx\nsudo systemctl start nginx\n\n\nMétodo 2: Usar modo webroot (sem parar nginx)\n\nbash\n# Instalar certbot (se não tiver)\nsudo apt update\nsudo apt install certbot python3-certbot-nginx -y\n\n# Criar diretório para validação (se não existir)\nsudo mkdir -p /var/www/html/.well-known/acme-challenge\n\n# Garantir que nginx serve esse diretório (adicionar ao server block na porta 80)\n# O nginx já deve estar configurado para servir arquivos estáticos\n\n# Gerar certificados usando webroot\nsudo certbot certonly --webroot -w /var/www/html -d dockerapp.comunidadezdg.com.br -d dockerapi.comunidadezdg.com.br\n\n\nMétodo 3: Usar plugin do nginx (Mais automático)\n\nbash\n# Instalar certbot (se não tiver)\nsudo apt update\nsudo apt install certbot python3-certbot-nginx -y\n\n# Criar configuração básica do nginx na porta 80 primeiro (se não existir)\n# O certbot vai modificar automaticamente\n\n# Gerar certificados usando plugin do nginx\nsudo certbot --nginx -d dockerapp.comunidadezdg.com.br -d dockerapi.comunidadezdg.com.br\n\n\nRecomendação: Use o Método 1 (parar nginx temporariamente) - é o mais simples e rápido.\n\nIMPORTANTE: Antes de criar a configuração, verifique se há conflitos de domínio:\n\nbash\n# Verificar quais configurações estão ativas\nsudo ls -la /etc/nginx/sites-enabled/\n\n# Verificar se há configurações antigas para esses domínios\nsudo grep -r "dockerapp.comunidadezdg.com.br" /etc/nginx/sites-enabled/\nsudo grep -r "dockerapi.comunidadezdg.com.br" /etc/nginx/sites-enabled/\n\n# Se houver configurações antigas para os mesmos domínios, você pode:\n# 1. Desabilitá-las temporariamente: sudo rm /etc/nginx/sites-enabled/nome-antigo\n# 2. Ou comentar os server blocks conflitantes dentro dos arquivos\n\n\nDepois, crie o arquivo de configuração com um nome diferente (para não conflitar com configurações existentes):\n\nbash\nsudo nano /etc/nginx/sites-available/zpro-traefik-proxy\n\n\nCole este conteúdo no arquivo:\n\nnginx\n# Frontend - dockerapp.comunidadezdg.com.br\nserver {\n listen 443 ssl http2;\n server_name dockerapp.comunidadezdg.com.br;\n\n # Certificados SSL gerados via certbot\n ssl_certificate /etc/letsencrypt/live/dockerapp.comunidadezdg.com.br/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/dockerapp.comunidadezdg.com.br/privkey.pem;\n\n # Configurações SSL\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers HIGH:!aNULL:!MD5;\n ssl_prefer_server_ciphers on;\n\n location / {\n proxy_pass https://localhost:8443;\n proxy_ssl_verify off; # Desabilita verificação SSL para o Traefik\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection "upgrade";\n }\n}\n\n# Backend - dockerapi.comunidadezdg.com.br\nserver {\n listen 443 ssl http2;\n server_name dockerapi.comunidadezdg.com.br;\n\n # Certificados SSL gerados via certbot (mesmo certificado, pois foram gerados juntos)\n ssl_certificate /etc/letsencrypt/live/dockerapp.comunidadezdg.com.br/fullchain.pem;\n ssl_certificate_key /etc/letsencrypt/live/dockerapp.comunidadezdg.com.br/privkey.pem;\n\n # Configurações SSL\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers HIGH:!aNULL:!MD5;\n ssl_prefer_server_ciphers on;\n\n location / {\n proxy_pass https://localhost:8443;\n proxy_ssl_verify off; # Desabilita verificação SSL para o Traefik\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection "upgrade";\n }\n}\n\n\nOPÇÃO B: Usar certificados auto-assinados temporários (apenas para teste)\n\nPrimeiro, gere certificados auto-assinados:\n\nbash\n# Criar diretório para certificados\nsudo mkdir -p /etc/nginx/ssl\n\n# Gerar certificado auto-assinado para dockerapp\nsudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \\\n -keyout /etc/nginx/ssl/dockerapp.key \\\n -out /etc/nginx/ssl/dockerapp.crt \\\n -subj "/CN=dockerapp.comunidadezdg.com.br"\n\n# Gerar certificado auto-assinado para dockerapi\nsudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \\\n -keyout /etc/nginx/ssl/dockerapi.key \\\n -out /etc/nginx/ssl/dockerapi.crt \\\n -subj "/CN=dockerapi.comunidadezdg.com.br"\n\n\nDepois, use esta configuração:\n\nnginx\n# Frontend - dockerapp.comunidadezdg.com.br\nserver {\n listen 443 ssl http2;\n server_name dockerapp.comunidadezdg.com.br;\n\n # Certificados auto-assinados (temporários)\n ssl_certificate /etc/nginx/ssl/dockerapp.crt;\n ssl_certificate_key /etc/nginx/ssl/dockerapp.key;\n\n # Configurações SSL\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers HIGH:!aNULL:!MD5;\n ssl_prefer_server_ciphers on;\n\n location / {\n proxy_pass https://localhost:8443;\n proxy_ssl_verify off;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection "upgrade";\n }\n}\n\n# Backend - dockerapi.comunidadezdg.com.br\nserver {\n listen 443 ssl http2;\n server_name dockerapi.comunidadezdg.com.br;\n\n # Certificados auto-assinados (temporários)\n ssl_certificate /etc/nginx/ssl/dockerapi.crt;\n ssl_certificate_key /etc/nginx/ssl/dockerapi.key;\n\n # Configurações SSL\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers HIGH:!aNULL:!MD5;\n ssl_prefer_server_ciphers on;\n\n location / {\n proxy_pass https://localhost:8443;\n proxy_ssl_verify off;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection "upgrade";\n }\n}\n\n\nDepois:\n\nbash\n# Habilitar configuração\nsudo ln -s /etc/nginx/sites-available/zpro-traefik-proxy /etc/nginx/sites-enabled/\n\n# Testar\nsudo nginx -t\n\n# Recarregar\nsudo systemctl reload nginx\n\n\n### Opção 3: Acessar diretamente o Traefik (sem nginx)\n\nSe você quiser acessar diretamente o Traefik sem passar pelo nginx:\n\n1. Acesse via porta 8443:\n https://dockerapp.comunidadezdg.com.br:8443\n https://dockerapi.comunidadezdg.com.br:8443\n2. Ou configure o DNS para apontar diretamente para o Traefik (não recomendado se você já tem nginx rodando)\n\n### Verificação\n\nApós aplicar uma das soluções:\n\nbash\n# Verificar se o Traefik está rodando\ndocker ps | grep traefik\n\n# Verificar logs do Traefik\ndocker logs zpro-traefik\n\n# Testar acesso direto ao Traefik\ncurl -k https://localhost:8443 -H "Host: dockerapp.comunidadezdg.com.br"\n\n\n#### Nota Importante\n\nSe você escolher a Opção 1 (desabilitar nginx), certifique-se de que:\n\n O Traefik está acessível na porta 8443\n O firewall permite conexões na porta 8443\n Os certificados SSL estão sendo gerados corretamente pelo Traefik\n\nSe você escolher a *Opção 2 (nginx como proxy), o nginx gerencia o SSL na porta 443 e faz proxy para o Traefik na 8443.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/configuracao-do-traefik-com-nginx.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Guia para Instalação com Docker\n\n### 📋 Pré-requisitos\n\n Docker instalado (versão 20.10 ou superior)\n Docker Compose instalado (versão 2.0 ou superior)\n Acesso root/sudo (para Linux) ou permissões de administrador (para Windows)\n Domínio configurado com DNS apontando para o servidor (para produção com SSL)\n\n### 🚀 Instalação Rápida\n\n1. Clone o repositório (se ainda não tiver):\n\nbash\ncd zpro.io\n\n\n2. Configure as variáveis de ambiente (opcional, pode definir no docker-compose.yml):\n\nbash\ncp .env.example .env # Se existir um arquivo .env.example\n# Edite o arquivo .env com suas configurações\n\n\n3. Construa as imagens e inicie os serviços:\n\nbash\n# Opção 1: Build e start em um único comando (recomendado)\ndocker-compose up -d --build\n\n# Opção 2: Build primeiro, depois start\ndocker-compose build\ndocker-compose up -d\n\n\n> ⚠️ Importante: Como os serviços backend e frontend precisam ser construídos a partir dos Dockerfiles, é necessário fazer o build das imagens antes de iniciar. Use --build no comando up ou execute build separadamente.\n\n4. Verifique os logs:\n\nbash\ndocker-compose logs -f\n\n\n### ⚙️ Configuração de Portas e Subdomínios\n\n#### 📍 Onde Configurar Portas\n\nAs portas são configuradas diretamente no arquivo docker-compose.yml ou através de variáveis de ambiente no arquivo .env.\n\n1. Traefik (Reverse Proxy)\n\nLocalização no docker-compose.yml:\n\n12:20:docker-compose.yml\n - "--entrypoints.web.address=:81"\n - "--entrypoints.websecure.address=:8443"\n ports:\n - "81:81" # HTTP\n - "8443:8443" # HTTPS (porta alternativa para não conflitar com nginx na 443)\n - "8080:8080" # Dashboard do Traefik\n\n\nConfiguração:\n\n Porta HTTP: 81 (linha 12 e 18) - Para alterar, modifique ambas as linhas\n Porta HTTPS: 8443 (linha 13 e 19) - Para alterar, modifique ambas as linhas\n Dashboard Traefik: 8080 (linha 20) - Interface de gerenciamento do Traefik\n\n2. PostgreSQL (Banco de Dados)\n\nLocalização no docker-compose.yml:\n\n42:43:docker-compose.yml\n ports:\n - "${DB_PORT:-7544}:5432"\n\n\nConfiguração:\n\n Porta Externa: Configurada via variável DB_PORT (padrão: 7544)\n Porta Interna: 5432 (porta padrão do PostgreSQL, não alterar)\n Para alterar, defina DB_PORT=PORTA_DESEJADA no arquivo .env\n\n3. Backend\n\nLocalização no docker-compose.yml:\n\n66:66:docker-compose.yml\n PORT: ${PORT:-7563}\n\n\n121:122:docker-compose.yml\n ports:\n - "${PORT:-7563}:7563"\n\n\nConfiguração:\n\n Porta Externa: Configurada via variável PORT (padrão: 7563)\n Porta Interna: 7563 (porta interna do container, não alterar)\n Para alterar, defina PORT=PORTA_DESEJADA no arquivo .env\n\n4. Frontend\n\nLocalização no docker-compose.yml:\n\n172:173:docker-compose.yml\n ports:\n - "7564:4444"\n\n\nConfiguração:\n\n Porta Externa: 7564 (porta do host)\n Porta Interna: 4444 (porta interna do container)\n Para alterar a porta externa, modifique 7564 na linha 173\n\n#### 🌐 Onde Configurar Subdomínios\n\nOs subdomínios são configurados através de variáveis de ambiente e labels do Traefik no docker-compose.yml.\n\n1. Backend (API)\n\nLocalização no docker-compose.yml:\n\n70:70:docker-compose.yml\n BACKEND_URL: ${BACKEND_URL:-https://dockerapi.comunidadezdg.com.br}\n\n\n138:143:docker-compose.yml\n - "traefik.http.routers.backend.rule=Host(`${BACKEND_DOMAIN:-api.localhost}`)"\n - "traefik.http.routers.backend.entrypoints=web"\n - "traefik.http.routers.backend.service=backend"\n - "traefik.http.services.backend.loadbalancer.server.port=7563"\n # HTTPS ativo na porta 8443 (para não conflitar com nginx na 443)\n - "traefik.http.routers.backend-secure.rule=Host(`${BACKEND_DOMAIN:-dockerapi.comunidadezdg.com.br}`)"\n\n\nConfiguração:\n\n Variável: BACKEND_DOMAIN (padrão: dockerapi.comunidadezdg.com.br para HTTPS, api.localhost para HTTP)\n URL Completa: BACKEND_URL (deve incluir o protocolo https://)\n Para alterar, defina no arquivo .env:\n\n env\n BACKEND_DOMAIN=api.seudominio.com.br\n BACKEND_URL=https://api.seudominio.com.br\n\n\n2. Frontend (Aplicação Web)\n\nLocalização no docker-compose.yml:\n\n71:71:docker-compose.yml\n FRONTEND_URL: ${FRONTEND_URL:-https://dockerapp.comunidadezdg.com.br}\n\n\n182:187:docker-compose.yml\n - "traefik.http.routers.frontend.rule=Host(`${FRONTEND_DOMAIN:-localhost}`)"\n - "traefik.http.routers.frontend.entrypoints=web"\n - "traefik.http.routers.frontend.service=frontend"\n - "traefik.http.services.frontend.loadbalancer.server.port=4444"\n # HTTPS ativo na porta 8443 (para não conflitar com nginx na 443)\n - "traefik.http.routers.frontend-secure.rule=Host(`${FRONTEND_DOMAIN:-dockerapp.comunidadezdg.com.br}`)"\n\n\nConfiguração:\n\n Variável: FRONTEND_DOMAIN (padrão: dockerapp.comunidadezdg.com.br para HTTPS, localhost para HTTP)\n URL Completa: FRONTEND_URL (deve incluir o protocolo https://)\n Para alterar, defina no arquivo .env:\n\n env\n FRONTEND_DOMAIN=app.seudominio.com.br\n FRONTEND_URL=https://app.seudominio.com.br\n\n\n3. Dashboard do Traefik\n\nLocalização no docker-compose.yml:\n\n29:29:docker-compose.yml\n - "traefik.http.routers.traefik.rule=Host(`${TRAEFIK_DASHBOARD_DOMAIN:-traefik.localhost}`)"\n\n\nConfiguração:\n\n Variável: TRAEFIK_DASHBOARD_DOMAIN (padrão: traefik.localhost)\n Para alterar, defina no arquivo .env:\n\n env\n TRAEFIK_DASHBOARD_DOMAIN=dashboard.seudominio.com.br\n\n\n### 📝 Arquivo .env de Exemplo\n\nCrie um arquivo .env na raiz do projeto com as seguintes variáveis:\n\nenv\n# Ambiente\nNODE_ENV=production\n\n# Portas\nPORT=7563\nDB_PORT=7544\nPROXY_PORT=8443\n\n# Domínios e URLs\nBACKEND_DOMAIN=api.seudominio.com.br\nBACKEND_URL=https://api.seudominio.com.br\nFRONTEND_DOMAIN=app.seudominio.com.br\nFRONTEND_URL=https://app.seudominio.com.br\nTRAEFIK_DASHBOARD_DOMAIN=dashboard.seudominio.com.br\nADMIN_DOMAIN=zpro.io\n\n# Banco de Dados\nPOSTGRES_USER=postgres\nPOSTGRES_PASSWORD=sua_senha_segura_aqui\nPOSTGRES_DB=postgres\nDB_DIALECT=postgres\nDB_PORT=5432\nPOSTGRES_HOST=postgres\n\n# JWT Secrets (gere novos secrets para produção)\nJWT_SECRET=seu_jwt_secret_aqui\nJWT_REFRESH_SECRET=seu_jwt_refresh_secret_aqui\n\n# Let\'s Encrypt\[email protected] \n\n# Outras configurações\nIMAGE_SOURCE=https://zdg.dev.br/\n\n\n### 🔧 Configuração de DNS\n\nPara que os certificados SSL funcionem corretamente, você precisa configurar os registros DNS:\n\n1. Registro A ou CNAME apontando para o IP do servidor:\n api.seudominio.com.br → IP do servidor\n app.seudominio.com.br → IP do servidor\n dashboard.seudominio.com.br → IP do servidor (opcional)\n2. Portas abertas no firewall:\n 81 (HTTP)\n 8443 (HTTPS)\n 8080 (Dashboard Traefik - opcional, apenas para acesso interno)\n\n### 🔐 Certificados SSL\n\nO Traefik está configurado para obter certificados SSL automaticamente via Let\'s Encrypt usando o desafio TLS.\n\nConfiguração no docker-compose.yml:\n\n14:16:docker-compose.yml\n - "--certificatesresolvers.letsencrypt.acme.tlschallenge=true"\n - "--certificatesresolvers.letsencrypt.acme.email=${ACME_EMAIL:[email protected] }"\n - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"\n\n\nPara alterar o email:\n\n Defina [email protected] no arquivo .env\n\n### 🎯 Comandos Úteis\n\n#### Construir as imagens\n\nbash\n# Build de todas as imagens\ndocker-compose build\n\n# Build forçando reconstrução completa (sem cache)\ndocker-compose build --no-cache\n\n# Build de um serviço específico\ndocker-compose build backend\ndocker-compose build frontend\n\n\n#### Iniciar os serviços\n\nbash\n# Iniciar sem build (usa imagens já construídas)\ndocker-compose up -d\n\n# Iniciar com build automático (recomendado na primeira vez)\ndocker-compose up -d --build\n\n# Iniciar e ver logs em tempo real\ndocker-compose up\n\n\n#### Parar os serviços\n\nbash\n# Parar os serviços (mantém containers e volumes)\ndocker-compose stop\n\n# Parar e remover containers (mantém volumes)\ndocker-compose down\n\n# Parar, remover containers e volumes (⚠️ apaga dados)\ndocker-compose down -v\n\n\n#### Ver logs\n\nbash\n# Todos os serviços\ndocker-compose logs -f\n\n# Serviço específico\ndocker-compose logs -f backend\ndocker-compose logs -f frontend\ndocker-compose logs -f postgres\ndocker-compose logs -f traefik\n\n# Últimas 100 linhas de um serviço\ndocker-compose logs --tail=100 backend\n\n\n#### Reiniciar um serviço específico\n\nbash\ndocker-compose restart backend\ndocker-compose restart frontend\n\n# Reiniciar com rebuild\ndocker-compose up -d --build backend\n\n\n#### Reconstruir as imagens\n\nbash\n# Reconstruir tudo do zero (sem cache)\ndocker-compose build --no-cache\ndocker-compose up -d\n\n# Reconstruir um serviço específico\ndocker-compose build --no-cache backend\ndocker-compose up -d backend\n\n\n#### Verificar status dos containers\n\nbash\ndocker-compose ps\n\n\n#### Acessar o shell de um container\n\nbash\ndocker-compose exec backend sh\ndocker-compose exec postgres psql -U postgres\n\n\n### 🔍 Verificação da Instalação\n\nApós iniciar os serviços, verifique:\n\n1. Backend: Acesse https://SEU_BACKEND_DOMAIN:8443 ou http://SEU_BACKEND_DOMAIN:81\n2. Frontend: Acesse https://SEU_FRONTEND_DOMAIN:8443 ou http://SEU_FRONTEND_DOMAIN:81\n3. Dashboard Traefik: Acesse http://SEU_TRAEFIK_DOMAIN:8080 ou http://SEU_TRAEFIK_DOMAIN:81\n4. PostgreSQL: Conecte-se em localhost:PORTA_DB (padrão: 7544)\n\n### ⚠️ Troubleshooting\n\n#### Porta já em uso\n\nSe uma porta estiver em uso, altere a configuração no docker-compose.yml ou no arquivo .env.\n\n#### Certificado SSL não funciona\n\n Verifique se os DNS estão apontando corretamente\n Certifique-se de que as portas 81 e 8443 estão abertas no firewall\n Verifique os logs do Traefik: docker-compose logs traefik\n\n#### Container não inicia\n\n Verifique os logs: docker-compose logs [nome-do-servico]\n Verifique se todas as variáveis de ambiente estão configuradas\n Certifique-se de que o Docker tem permissões suficientes\n\n#### Erro de conexão com banco de dados\n\n Verifique se o PostgreSQL está rodando: docker-compose ps postgres\n Verifique as credenciais no arquivo .env\n Verifique se a porta do banco está acessível\n\n### 📚 Estrutura do Projeto\n\n\nzpro-passaporte/\n├── docker-compose.yml # Configuração dos serviços\n├── .env # Variáveis de ambiente (criar)\n├── backend/ # Código do backend\n├── frontend/ # Código do frontend\n└── README.md # Este arquivo\n\n\n### 🆘 Suporte\n\nPara mais informações ou problemas, consulte a documentação do projeto ou entre em contato com a equipe de suporte. https://suporte.zdg.com.br/\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/guia-para-instalacao-com-docker.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Infra - Recriação do Redis\n\n#### As Funções do Redis no Z-PRO\n\n1. Gerenciamento de Estado (State) e Sessões da API\n\n O Problema: No Z-PRO, como você pode ter dezenas de conexões do WhatsApp e centenas de usuários ativos, o sistema precisa saber instantaneamente quem está logado, qual o estado da conexão e em qual ponto de um fluxo de chatbot o cliente parou.\n A Solução com Redis: O Redis armazena a "sessão" de cada conexão de WhatsApp e o "estado" atual de cada conversa.\n\n2. Cache de Dados Frequentes\n\n O Problema: Buscar configurações, permissões de usuário, ou a definição de um fluxo de chatbot do banco de dados principal é lento.\n A Solução com Redis: Os dados acessados constantemente (como as regras de um chatbot ou a licença de um cliente) são copiados do banco de dados para o Redis. Dessa forma, o Z-PRO consegue acessá-los de forma muito mais rápida, refletindo em um melhor desempenho e velocidade para os usuários do sistema.\n\n\n\n## Vídeo tutorial:\n\n{% embed url="https://youtu.be/EasbF99OWB8" %}\n\n## OPÇÃO 1: Recriar Redis pelo terminal\n\n#### 1 - Acessar o terminal do seu servidor\n\nCaminho para servidores hospedados na hostinger:\n\n{% embed url="https://hpanel.hostinger.com/" %}\n\n\n\n#### 2 - Executar o zpro\n\n\nsudo chmod +x ./zpro_passaporte_shell/zpro\ncd ./zpro_passaporte_shell\nsudo ./zpro\n\n\n\n\n#### 3 - Digitar 8\n\nO sistema irá listar as instâncias instaladas e pedir para digitar o número da instância em que quer recriar o redis, na maioria dos casos, vai aparecer apenas uma instância, nesse caso, digite 1 para continuar o processo\n\nApós a finalização do processo, aperte crtl + c para voltar na página inicial do terminal\n\n#### 4 - Reiniciar o sistema \n\na) Entre no terminal do seu servidor\n\nb) Faça login com o usuário deployzdg\n\n\nsu deployzdg\n\n\nc) Execute os comandos abaixo\n\n\npm2 flush \npm2 restart all \npm2 log\n\n\nExemplo de resposta após o pm2 flush\n\n\n\nExemplo de resposta após o pm2 restart all\n\n\n\nExemplo de resposta após o pm2 log\n\n\n\n## OPÇÃO 2: Recriar Redis pelo Portainer\n\n#### 1 - Acessar o portainer pelo navegador\n\nhttp\://\[seu\_endereco]:9000\n\nFazer login com usuário e senha\n\n\n\nusuário: admin ( esse é o padrão para todas as instalações, caso você não tenha alterado)\n\nsenha: (a que foi informada no dia da instalação do zpro, se precisar, é possível redefinir a senha pelo terminal)\n\n> OPCIONAL - CASO PRECISE REDEFINIR A SENHA\n>\n> Para alterar a senha, volte ao terminal com o usuário raiz (root) e execute os comandos abaixo\n>\n> docker ps\n>\n> Procure por um contêiner com a imagem portainer/portainer-ce (ou similar) e anote o nome do contêiner. Exemplo: \[portainer-x] \n>\n> Execute os comandos abaixo, substituindo o \[portainer-x] pelo nome que você anotou\n>\n> docker stop [portainer-x]\n>\n> docker run --rm -v portainer_data:/data portainer/helper-reset-password\n\n> Verifique a Saída:\n>\n> Se for bem-sucedido, o terminal mostrará uma mensagem como esta, fornecendo a nova senha:\n>\n> \n> 2020/06/04 00:13:58 Password successfully updated for user: admin\n> 2020/06/04 00:13:58 Use the following password to login: Aqui_EstA_a_Senha\n>\n>\n> Reinicie o container novamente (substituindo o \[portainer-x] pelo nome que você anotou)\n>\n> docker start [portainer-x]\n\nApós fazer o login, entre dentro do docker onde está instalado o zpro\n\n\n\nAcesso o menu "containers" e clique no container em que está instalado o redis\n\n\n\nClique em "Recreate"\n\n\n\nMarque a opção e "Re-pull image" e confirme o processo clicando no botão "Recreate"\n\n\n\nApós esse processo, o portainer efetuará a recriação do redis para a última versão disponível.\n\nReinicie seu zpro pelo terminal, seguindo o passo-a-passo:\n\n{% content-ref url="#id-4-reiniciar-o-sistema" %}\n#id-4-reiniciar-o-sistema\n{% endcontent-ref %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/infra-recriacao-do-redis.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Migração Z-PRO entre servidores\n\nEste guia detalha o processo recomendado para migrar sua instalação completa do Z-PRO de um servidor (VPS Antiga) para outro (VPS Nova). Este é um procedimento técnico que envolve acesso root e manipulação do banco de dados.\n\n{% hint style="danger" %}\nAVISO CRÍTICO: FAÇA UM SNAPSHOT DO SERVIDOR\n\nAntes de iniciar qualquer procedimento de migração, crie um ponto de restauração (snapshot) da sua VPS antiga e da nova VPS. Esta é sua única garantia para reverter o sistema em caso de qualquer imprevisto.\n{% endhint %}\n\n### Visão Geral\n\nA migração consiste em mover os três componentes essenciais da sua instalação:\n\n1. Banco de Dados: Todos os dados do PostgreSQL (mensagens, usuários, tickets, etc.).\n2. Arquivos de Mídia: A pasta public do backend (imagens, áudios, documentos enviados).\n3. Arquivo de Configuração: O arquivo .env do backend (chaves de API, senhas, etc.).\n\n*\n\n### Pré-Requisitos\n\n1. Nova VPS Pronta: Uma nova VPS provisionada, seguindo os requisitos de uso (Ubuntu 22.04 LTS).\n2. Z-PRO Instalado (Mesma Versão): Você deve instalar o Z-PRO na nova VPS usando o autoinstalador. A versão instalada na nova VPS deve ser exatamente a mesma da sua VPS antiga.\n3. Acesso Root/SSH: Acesso de superusuário (root) a ambas as máquinas.\n\n*\n\n## Passo a Passo da Migração\n\n### Fase 1: Backup na VPS Antiga\n\nExecute todos os comandos a seguir no terminal SSH da sua VPS antiga.\n\n#### 1. Parar os Serviços do Z-PRO (Como usuário deployzdg)\n\nbash\nsu - deployzdg\npm2 stop all\n\n\n\n#### 2. Backup do Banco de Dados (Como usuário root)\n\n\n# Volte para o usuário root\nexit\n\n# Execute o dump do banco de dados\ndocker exec -t postgresql pg_dump -U zpro postgres > /root/backup.sql\n\n# Compacte o arquivo para facilitar a transferência\nzip -r /root/backup.zip /root/backup.sql\n\n\n#### 3. Backup dos Arquivos de Mídia (Pasta Public) (Como usuário root)\n\n\n# Acesse a pasta do backend\ncd /home/deployzdg/zpro.io/backend\n\n# Compacte a pasta \'public\'\nzip -r /root/public.zip public/\n\n\n#### 4. Backup do Arquivo de Configuração (.env) (Como usuário root)\n\n\n# Na mesma pasta, faça o backup do .env\n# (Este arquivo contém suas chaves de API e segredos)\nzip -r /root/env.zip .env\n\n\n### Fase 2: Transferência dos Backups\n\n1\. Mover os Backups para a Nova VPS Use o comando scp (ou seu método preferido, como SFTP) para mover os três arquivos .zip que você criou (backup.zip, public.zip, env.zip) da VPS antiga para o diretório /root/ da VPS nova.\n\nExemplo de comando (executado da VPS antiga):\n\n\n# (Pode ser necessário configurar chaves SSH antes, se ainda não o fez)\nscp /root/backup.zip root@IP_DA_NOVA_VPS:/root/\nscp /root/public.zip root@IP_DA_NOVA_VPS:/root/\nscp /root/env.zip root@IP_DA_NOVA_VPS:/root/\n\n\n### Fase 3: Restauração na VPS Nova\n\nExecute todos os comandos a seguir no terminal SSH da sua VPS nova.\n\n1\. Mudar os Apontamentos de DNS Neste momento, vá ao seu provedor de domínio e altere os registros de DNS de todos os seus subdomínios (app, api, etc.) para que apontem para o IP da VPS nova.\n\n2\. Parar os Serviços do Z-PRO (na Nova VPS) (Como usuário deployzdg)\n\n\nsu - deployzdg\npm2 stop all\n\n\n3\. Restaurar o Banco de Dados (Como usuário root)\n\n\n# Volte para o usuário root\nexit\ncd /root/\n\n# Descompacte o backup do banco\nunzip backup.zip\n\n# Copie o arquivo SQL para dentro do container Docker\ndocker cp backup.sql postgresql:/backup.sql\n\n# Acesse o container\ndocker exec -i postgresql bash\n\n# Conecte-se ao psql\npsql -U zpro\n\n# Execute os comandos SQL para preparar o banco\nSELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = \'postgres\';\nDROP DATABASE postgres;\nCREATE DATABASE postgres WITH OWNER zpro ENCODING \'UTF8\' TEMPLATE zpro;\n\n# Saia do psql\n\\q\n# Saia do container\nexit\n\n# Execute a restauração do banco\ndocker exec -it postgresql psql -U zpro -d postgres < backup.sql\n\n# Remova o arquivo de backup (opcional, para limpeza)\nrm -rf backup.sql\n\n\n4\. Restaurar os Arquivos de Mídia (Pasta Public) (Como usuário root)\n\n\ncd /root/\nunzip public.zip\n\n# Mova os arquivos para a pasta de produção\nmv /root/public/* /home/deployzdg/zpro.io/backend/public/\n\n# Ajuste as permissões da pasta (CRÍTICO)\nchown -R deployzdg:deployzdg /home/deployzdg/zpro.io/backend/public/\n\n\n5\. Restaurar o Arquivo de Configuração (.env) (Como usuário root)\n\n\ncd /root/\nunzip env.zip\n\n# Sobrescreva o .env da nova instalação pelo seu .env antigo\nmv /root/.env /home/deployzdg/zpro.io/backend/.env\n\n# Ajuste a permissão\nchown deployzdg:deployzdg /home/deployzdg/zpro.io/backend/.env\n\n\n### Fase 4: Finalização e Verificação\n\n1\. Iniciar os Serviços do Z-PRO (Como usuário deployzdg)\n\n\nsu - deployzdg\npm2 start all\n\n\n2\. Testar o Acesso Aguarde a propagação do DNS (pode levar de alguns minutos a algumas horas) e tente acessar sua plataforma. Faça login e verifique se seus atendimentos e mídias estão visíveis.\n\n{% hint style="warning" %}\nAutorizar o IP no Asaas Se você usa a integração com o Asaas, lembre-se de acessar seu painel do Asaas, ir para "Mecanismos de Segurança" e adicionar o IP da sua nova VPS na lista de permissões. Caso contrário, os pagamentos e a exibição de tenants falharão.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/migracao-z-pro-entre-servidores.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Otimização de Nginx para Alta demanda de mensagem\n\nEsta documentação técnica é destinada a usuários com alto volume de mensagens (próximo ou superior a 10.000 atendimentos por dia). As configurações de Nginx abaixo são otimizadas para melhorar a performance e a estabilidade da plataforma sob alta carga.\n\n\nvim /etc/nginx/sites-available/zpro-backend\n\nserver {\n server_name api.zpro.com.br;\n\n location / {\n# Remova CORS do upstream para evitar duplicidade\n proxy_hide_header Access-Control-Allow-Origin;\n proxy_hide_header Access-Control-Allow-Credentials;\n proxy_hide_header Access-Control-Allow-Headers;\n proxy_hide_header Access-Control-Allow-Methods;\n\n # Preflight\n if ($request_method = OPTIONS) {\n add_header Access-Control-Allow-Origin $cors_origin always;\n add_header Access-Control-Allow-Methods "GET, POST, PUT, PATCH, DELETE, OPTIONS" always;\n add_header Access-Control-Allow-Headers $http_access_control_request_headers always;\n add_header Access-Control-Allow-Credentials "true" always;\n add_header Access-Control-Max-Age "600" always; # <-- 10 minutos\n add_header Vary "Origin" always;\n return 204;\n }\n\n # Demais respostas\n add_header Access-Control-Allow-Origin $cors_origin always;\n add_header Access-Control-Allow-Credentials "true" always;\n add_header Vary "Origin" always;\n\n proxy_pass [http://127.0.0.1:3000](http://127.0.0.1:3000);\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection "upgrade";\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n\n proxy_read_timeout 3600s;\n proxy_send_timeout 3600s;\n proxy_connect_timeout 60s;\n client_max_body_size 800M;\n\n proxy_buffering on; #off\n proxy_buffers 8 16k; #del\n proxy_busy_buffers_size 64k; #del\n\n add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0" always;\n add_header Pragma "no-cache" always;\n add_header Expires "0" always;\n}\n listen 443 ssl http2; # managed by Certbot\n ssl_certificate /etc/letsencrypt/live/api.zpro.com.br/fullchain.pem; # managed by Certbot\n ssl_certificate_key /etc/letsencrypt/live/api.zpro.com.br/privkey.pem; # managed by Certbot\n include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot\n ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot\n}\n\nserver {\n if ($host = api.zpro.com.br) {\n return 301 https://$host$request_uri;\n } # managed by Certbot\n\n server_name api.zpro.com.br;\n listen 80;\n return 301 https://$host$request_uri;\n}\n\n\n-------------------------------------------------------------------------------------\nvim /etc/nginx/sites-available/zpro-frontend\n\nserver {\n server_name app.zpro.com.br;\n\n location / {\n proxy_pass [http://127.0.0.1:4444](http://127.0.0.1:4444);\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \'upgrade\';\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_cache_bypass $http_upgrade;\n\n proxy_read_timeout 3600s;\n proxy_send_timeout 3600s;\n proxy_connect_timeout 60s;\n client_max_body_size 800M;\n proxy_buffering off;\n\n add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0" always;\n add_header Pragma "no-cache" always;\n add_header Expires "0" always;\n }\n\n listen 443 ssl http2; # managed by Certbot\n ssl_certificate /etc/letsencrypt/live/app.zpro.com.br/fullchain.pem; # managed by Certbot\n ssl_certificate_key /etc/letsencrypt/live/app.zpro.com.br/privkey.pem; # managed by Certbot\n include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot\n ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot\n}\n\nserver {\n if ($host = app.zpro.com.br) {\n return 301 https://$host$request_uri;\n } # managed by Certbot\n\n server_name app.zpro.com.br;\n listen 80;\n return 404; # managed by Certbot\n}\n\n\n-------------------------------------------------------------------------------------\nvim /etc/nginx/conf.d/cors_vars.conf\nmap $request_method $cors_methods {\n default "GET, POST, PUT, PATCH, DELETE, OPTIONS";\n}\n\nmap $http_access_control_request_headers $cors_req_headers {\n default $http_access_control_request_headers;\n}\n\n-------------------------------------------------------------------------------------\nvim /etc/nginx/conf.d/cors_map.conf\n# Aceita http/https, com ou sem porta, para *.zpro.com.br e zpro.com.br\nmap $http_origin $cors_origin {\n default "";\n "~^https?://([a-z0-9-]+\\.)*zpro\\.com\\.br(:\\d+)?$" $http_origin;\n}\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/otimizacao-de-nginx-para-alta-demanda-de-mensagem.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Proxy IPv4 no Proxy-Seller\n\n### Passo 1: Criação de Conta no Proxy-Seller\n\n1\. Acesse o Proxy-Seller.\n\n2\. No canto superior direito, clique em "Sign Up".\n\n3\. Preencha os campos necessários para criar sua conta e clique em "Create an Account".\n\n4\. Verifique seu e-mail e confirme seu cadastro.\n\n### Passo 2: Escolhendo e Comprando um Proxy IPv4\n\n1\. Faça login na sua conta do Proxy-Seller.\n\n2\. No menu superior, clique em "Buy proxy".\n\n3\. Escolha o tipo de proxy como "IPv4".\n\n4\. Selecione o país e a cidade do proxy desejado.\n\n5\. Defina a quantidade de proxies que deseja comprar.\n\n6\. Escolha o período de tempo pelo qual deseja alugar o proxy (por exemplo, 1 mês).\n\n7\. Clique em "Add to Cart".\n\n### Passo 3: Finalizando a Compra\n\n1\. Após adicionar o proxy ao carrinho, clique no ícone do carrinho no canto superior direito e depois em "Checkout".\n\n2\. Escolha o método de pagamento preferido e complete as informações necessárias.\n\n3\. Clique em "Pay" para finalizar a compra.\n\n### Passo 4: Obtendo as Informações do Proxy\n\n1\. Após a compra ser confirmada, vá para o menu superior e clique em "My Proxies".\n\n2\. Você verá uma lista de proxies que comprou. Clique no ícone de detalhes (geralmente representado por um ícone de olho ou similar) para visualizar as informações do proxy.\n\n3\. Aqui você encontrará a URL (endereço IP), porta, usuário e senha do seu proxy.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/boas-praticas-de-infraestrutura/proxy-ipv4-no-proxy-seller.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Customização do Frontend\n\n### Introdução e Avisos Importantes\n\nO código do frontend do Z-PRO é aberto e permite customizações para adequá-lo à sua marca.\n\n{% hint style="danger" %}\nAVISO: CONHECIMENTO TÉCNICO NECESSÁRIO\n\n As alterações descritas nesta documentação exigem conhecimento técnico em desenvolvimento Vue.js e administração de servidores Linux.\n Antes de iniciar qualquer procedimento, crie um ponto de restauração (snapshot) completo do seu servidor VPS. Alterações incorretas podem comprometer o funcionamento da sua plataforma.\n Todas as alterações devem ser feitas logado na VPS com o usuário deployzdg. Não realize os procedimentos se estiver logado como root.\n O Z-PRO não se responsabilza com alterações no frontend e suporte para essas personalizações.\n {% endhint %}\n\n### Procedimento Obrigatório Após Alterações\n\nApós realizar qualquer modificação nos arquivos do frontend, você precisa "compilar" o código para que as mudanças apareçam na sua aplicação. Siga os passos abaixo:\n\nmarkup\n1. navegar até a pasta do frontend pelo terminal\n2. cd zpro.io\n3. cd frontend\n4. export NODE_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa\n5. pm2 restart all\n6. limpar os cookies/cache do navegador\n\n\n\n\n### Guia de Customização por Elemento\n\n#### Ícones\n\n Local: frontend/public/icons\n* Ação: Gere e substitua os arquivos de ícone nos tamanhos disponíveis nesta pasta.\n\n#### Logos e Favicon\n\n* Local: frontend/public/\n* Ação: Substitua os seguintes arquivos pelos seus:\n frontend/public/zpro.png\n frontend/public/favicon.ico\n\n#### Vídeos e Sons\n\n* Local: frontend/src/assets\n* Ação: Substitua os seguintes arquivos:\n frontend/src/assets/110694.mp4 (Vídeo da tela de login)\n frontend/src/assets/sound.mp3 (Som de notificação)\n frontend/src/assets/sound.ogg (Som de notificação)\n\n#### Nomes da Aplicação\n\n Ação: Altere o nome "Z-PRO" para o nome da sua marca nos seguintes arquivos e locais:\n * Arquivo: frontend/quasar.conf.js\n\n javascript\n name: "Z-PRO",\n short_name: "Z-PRO",\n appId: "Z-PRO",\n\n * Arquivo: frontend/src/App.vue\n\n javascript\n name: \'Z-PRO\',\n\n * Arquivo: frontend/src/index.template.html\n\n html\n Z-PRO \n\n\n#### Cores\n\n* Ação: Altere os códigos hexadecimais de cor (#5c67f2, etc.) nos seguintes arquivos:\n * Arquivo: frontend/src/css/app.sass (Estilos e Fontes)\n * Arquivo: frontend/src/css/quasar.variables.sass (Cores Básicas)\n\n sass\n $primary: #5c67f2\n $secondary: #f5f5f9\n // ...e outras variáveis de cor\n\n * Arquivo: frontend/src/pages/dashboard/Index.vue (Cores Dashboard)\n\n css\n background-color: #5c67f2;\n\n * Arquivo: frontend/src/components/EssentialLink.vue (Borda Esquerda do Menu)\n\n css\n border-left: 4px solid #5c67f2\n\n * Arquivo: frontend/src/pages/relatorios/ccListaRelatorios.vue (Bordas dos Relatórios)\n\n css\n border-left: solid #5c67f2 3px\n\n * Arquivos: frontend/src/pages/atendimento/ModalLayout.vue e frontend/src/layouts/ModalLayout.vue (Borda do Modal de Atendimento)\n\n css\n background-color: #5c67f2 !important;\n\n * Arquivos do Construtor de Chatbot (frontend/src/components/ccFlowBuilder/):\n panel.vue: paintStyle: { strokeWidth: 3, stroke: \'#5c67f2\' }\n node.vue: border-left: 5px solid #5c67f2 !important;\n mixins.js: stroke: \'#5c67f2\' e HoverPaintStyle: { stroke: \'#5c67f2\', ... }\n jsplumb.js: EndpointStyle: { fill: "#5c67f2" } e PaintStyle: { ..., stroke: "#5c67f2" }\n defaultFlow.js: paintStyle: { strokeWidth: 3, stroke: \'#5c67f2\' }\n index.css: Altere as variáveis CSS como --primary-color: #5c67f2;\n\n*\n\n### Precisa de Ajuda Profissional?\n\nComo mencionado, a customização do frontend requer a ajuda de um desenvolvedor com experiência em Vue.js.\n\nSe precisar de indicações, temos uma lista de profissionais e parceiros externos que podem te auxiliar. Para isso, por favor, abra um chamado no departamento "Preciso de indicação de profissional para manutenção e desenvolvimento".\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/customizacao-do-frontend.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Integração Google Calendar\n\n### Vídeo Tutorial\n\n{% embed url="https://www.loom.com/share/f08623ed364b40c9a4d4951a7502223e" %}\n\n{% embed url="https://www.loom.com/share/cf7d7b090d3d454e85733ab331997bd3" %}\n\n### Etapa 1: Criação do Projeto no Google Cloud\n\nPara começar, precisamos criar um projeto no Google e ativar a API de calendário.\n\n1. Acesse o Google Cloud Console: Faça login com sua conta Google em console.cloud.google.com.\n2. Crie um Novo Projeto:\n No topo da página, clique no seletor de projetos e selecione "Novo Projeto".\n Dê um nome ao projeto (ex: "Integração ZPRO Calendar") e clique em Criar.\n3. Ative a API:\n No menu lateral, vá em "APIs e Serviços" > "Biblioteca".\n Na barra de pesquisa, digite Google Calendar API.\n Selecione o resultado e clique no botão "Ativar".\n\n**\n\n### Etapa 2: Configurando a Tela de Permissão OAuth\n\nAntes de gerar as chaves de acesso, é necessário configurar como o aplicativo aparecerá para o usuário.\n\n1. No menu lateral de "APIs e Serviços", clique em "Tela de permissão OAuth".\n2. Selecione o tipo de usuário como "Externo" e clique em Criar.\n3. Preencha as informações do App:\n Nome do App: Ex: "Calendar ZPRO".\n E-mail para suporte do usuário: Selecione seu e-mail.\n Dados de contato do desenvolvedor: Insira seu e-mail novamente.\n4. Clique em Salvar e Continuar nas próximas etapas (Escopos e Usuários de Teste) até finalizar.\n5. Publicar o App:\n Na tela de resumo (Visão Geral), clique no botão para "Publicar Aplicativo" (ou tirar do modo de teste). Isso é importante para evitar limitações de expiração do token.\n\n*\n\n### Etapa 3: Criando as Credenciais de Acesso\n\nAgora vamos gerar o ID e o Segredo que conectam o Z-PRO ao Google.\n\n1. No menu lateral, clique em "Credenciais".\n2. Clique em "Criar Credenciais" e selecione "ID do cliente OAuth".\n3. Configuração da Credencial:\n * Tipo de aplicativo: Selecione "Aplicativo da Web".\n * Nome: Ex: "Conexão ZPRO".\n4. URIs de Redirecionamento Autorizados (Passo Crítico):\n * Role até a seção "URIs de redirecionamento autorizados" e clique em "Adicionar URI".\n * Você deve inserir a URL do seu sistema Z-PRO seguida do caminho de callback.\n\n{% hint style="warning" %}\nATENÇÃO À URL DE REDIRECIONAMENTO\n\nA URL deve seguir estritamente o formato abaixo, substituindo pelo domínio do seu sistema:\n\nhttps\://seu-subdominio-zpro.com.br/google-callback.html\n\nExemplo: Se você acessa seu painel em https://app.minhaempresa.com, a URI será https://app.minhaempresa.com/google-callback.html\n{% endhint %}\n\n1. Clique em Criar.\n2. Uma janela abrirá com o "ID do cliente" e a "Chave secreta do cliente". Copie essas informações ou mantenha a janela aberta.\n\n*\n\n### Etapa 4: Conectando no Z-PRO\n\nCom as credenciais em mãos, vamos finalizar a configuração dentro do Z-PRO.\n\n1. Acesse o painel do Z-PRO e vá em Configurações > Integrações.\n2. Localize a opção Google Calendar e clique em Adicionar.\n3. Preencha os campos:\n Nome da Sessão: Dê um nome para identificar (ex: Minha Agenda).\n ID do Cliente: Cole o código gerado na Etapa 3.\n Secret (Segredo): Cole o código gerado na Etapa 3.\n4. Clique em "Obter Token" ou "Salvar".\n\n\n\n#### Autorizando o Acesso\n\nAo salvar, o sistema abrirá uma janela pop-up do Google para você fazer login:\n\n1. Selecione a conta Google que deseja integrar.\n2. Tela de Aviso do Google: Como seu app não foi verificado pela Google (processo normal para apps internos), aparecerá um aviso de segurança.\n Clique em "Avançado".\n Clique em "Acessar \[Nome do seu App] (não seguro)".\n3. Marque as caixas de permissão para que o Z-PRO possa ver, editar e criar eventos na sua agenda.\n4. Clique em Continuar.\n\nSe tudo der certo, o sistema retornará a mensagem de "Conexão Estabelecida".\n\n**\n\n### Etapa 5: Utilizando a Integração\n\nApós conectado, você pode utilizar o calendário diretamente no seu funil de vendas.\n\n#### 1. Criando Eventos no Kanban\n\nDentro do menu Kanban (CRM):\n\n1. Abra ou crie uma Oportunidade.\n2. Na criação da oportunidade, localize a opção de Agendamento.\n3. Selecione a Conexão (a conta do Google que você acabou de integrar).\n4. Defina a data, hora e detalhes do evento.\n5. Ao salvar, o evento será criado automaticamente na sua Google Agenda.\n\n\n\n#### 2. Visualizando a Agenda\n\nNo menu lateral do Z-PRO, acesse a aba Calendário.\n\n Selecione a conexão desejada.\n Clique em Buscar para visualizar todos os seus compromissos sincronizados.\n Você também pode criar novos eventos clicando diretamente nas datas deste calendário.\n\n\n\n#### 3. Automatizando no Chatbot \n\nVocê pode criar agendamentos automáticos durante uma conversa do bot com seu cliente.\n\n1. Acesse o menu Chatbot e edite o fluxo desejado.\n2. Na barra de ferramentas, clique no ícone de Calendário (Google Agenda) para adicionar o elemento ao fluxo.\n\n\n\n3. Configure o elemento com as seguintes informações:\n\n Configuração: Selecione a conta do Google Calendar que você integrou anteriormente.\n Tipo de Data: Defina quando o evento será marcado (ex: "Hoje", "Amanhã" ou uma data específica).\n Título do Evento: Digite o nome que aparecerá na agenda (Ex: Reunião com Cliente).\n Descrição: Detalhes adicionais sobre o agendamento.\n Local: Onde ocorrerá o evento\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracao-google-calendar.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Integrações terceiras\n\n- N8N - Tutorial de integração\n- API do Google Speech-to-Text: Como usar a API do Google Speech-to-Text e baixar o JSON de autenticação\n- API do site Comtele (SMS): Como comprar créditos e obter a API do site Comtele (SMS)\n- Como criar uma API Key ChatGPT: Como criar uma API Key e obter o Organization ID do ChatGPT\n- Projeto no Dialogflow: Como criar um projeto no Dialogflow, obter o ID do projeto, definir a linguagem e baixar o JSON de autenticação\n- Typebot autohospedado: Como criar um bot no Typebot autohospedado e obter a URL de compartilhamento e o nome do bot\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
API do Google Speech-to-Text\n\n### Passo 1: Criação do Projeto no Google Cloud\n\n1. Acesse o Google Cloud Console.\n2. Faça login com sua conta do Google.\n3. Clique no ícone de seleção de projeto no topo da página e depois clique em\\n "Novo Projeto".\n4. Dê um nome ao seu projeto e clique em "Criar".\n\n### Passo 2: Ativando a API Speech-to-Text\n\n1. No Google Cloud Console, certifique-se de que você está no projeto criado.\n2. No menu lateral, vá para "API e Serviços" > "Biblioteca".\n3. Pesquise por "Cloud Speech-to-Text API" e clique nela.\n4. Clique no botão "Ativar".\n\n### Passo 3: Criando Credenciais de API\n\n1. No menu lateral, vá para "API e Serviços" > "Credenciais".\n2. Clique em "Criar Credenciais" e selecione "Chave de conta de serviço".\n3. Na janela que aparece, selecione "Nova conta de serviço".\n4. Dê um nome à sua conta de serviço e, opcionalmente, atribua um papel, como\\n "Administrador de Projeto".\n5. Clique em "Criar" e depois em "Concluir".\n6. Após a conclusão da etapa anterior, acesse a seção "Chaves".\n7. Clique em "Adicionar chave" e selecione a opção "Criar nova chave".\n8. No campo "Tipo de chave", certifique-se de que a opção "JSON" esteja selecionada.\n9. Clique em "Criar". Um arquivo no formato JSON será automaticamente baixado para o seu computador. Este arquivo contém suas credenciais de autenticação.\n10. Abra o arquivo JSON que foi baixado.\n11. Copie todo o conteúdo do arquivo JSON.\n12. Cole o conteúdo copiado no campo apropriado para "Habilitar transcrição de áudio" dentro das configurações do canal desejado.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/api-do-google-speech-to-text.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
API do site Comtele (SMS)\n\n### Passo 1: Criação de Conta no Comtele\n\n1\. Acesse o Comtele.\n\n2\. No canto superior direito, clique em "Criar Conta".\n\n3\. Preencha os campos necessários para criar sua conta e clique em "Cadastrar".\n\n4\. Verifique seu e-mail e confirme seu cadastro.\n\n### Passo 2: Fazendo Login e Acessando a Área do Cliente\n\n1\. Acesse o Comtele e clique em "Entrar" no canto superior direito.\n\n2\. Insira seu e-mail e senha para fazer login na sua conta.\n\n### Passo 3: Comprando Créditos\n\n1\. Após fazer login, você será direcionado ao painel de controle.\n\n2\. No menu lateral, clique em "Financeiro" e depois em "Comprar Créditos".\n\n3\. Escolha o valor de créditos que deseja comprar e clique em "Adicionar ao Carrinho".\n\n4\. Revise sua compra e clique em "Finalizar Compra".\n\n5\. Escolha o método de pagamento preferido (por exemplo, cartão de crédito, boleto) e complete as informações necessárias.\n\n6\. Clique em "Pagar" para finalizar a compra.\n\n### Passo 4: Obtendo a API Key\n\n1\. No painel de controle, vá para o menu lateral e clique em "Configurações".\n\n2\. Clique em "API".\n\n3\. Aqui você encontrará sua API Key. Copie esta chave, pois você precisará dela para autenticação nas chamadas da API.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/api-do-site-comtele-sms.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como criar uma API Key ChatGPT\n\n### Passo 1: Criando uma Conta no OpenAI\n\n1\. Acesse o site da OpenAI.\n\n2\. Clique em "Sign Up" para criar uma nova conta ou "Log In" se você já tiver uma conta.\n\n3\. Complete o processo de cadastro, verificando seu e-mail e fornecendo as informações necessárias.\n\n### Passo 2: Acessando a Área de APIs\n\n1\. Após fazer login, vá para o Dashboard do OpenAI.\n\n2\. No menu lateral, clique em "API" para acessar a área de APIs.\n\n### Passo 3: Criando uma API Key\n\n1\. No Dashboard do OpenAI, clique em "API Keys".\n\n2\. Clique no botão "Create API Key".\n\n3\. Dê um nome para sua chave e clique em "Create".\n\n4\. Sua nova API Key será gerada. Copie e salve esta chave em um local seguro, pois você não poderá visualizá-la novamente.\n\n### Passo 4: Obtendo o Organization ID\n\n1\. No Dashboard do OpenAI, clique em "Organization".\n\n2\. O Organization ID estará listado na seção de informações da organização. Copie este ID, pois você precisará dele para autenticação em algumas chamadas de API.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/como-criar-uma-api-key-chatgpt.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
N8N - Tutorial de integração\n\nO N8N é uma ferramenta de automação de fluxos de trabalho (workflows). Ao integrá-lo ao Z-PRO, você pode centralizar processos e conectar a plataforma a múltiplos sistemas externos, como CRMs, planilhas, agendas e agentes de Inteligência Artificial.\n\nAbaixo está o passo a passo da integração nativa, que é a forma mais simples e recomendada de conectar as duas ferramentas.\n\n*\n\n## Passo 1: Habilitar o N8N no Z-PRO\n\nO primeiro passo é ativar o módulo do N8N dentro do painel administrativo.\n\n1. Acesse o Painel Admin.\n2. Vá em Configurações Gerais > aba Bots e IA.\n3. Localize a seção do N8N e ative a opção Ativar integração com N8N.\n\n{% hint style="info" %}\n O campo para inserir a URL no seu canal (descrito no Passo 3) só aparecerá se esta chave de integração estiver ativada nas Configurações Gerais.\n{% endhint %}\n\n\n\n\n\n*\n\n## Passo 2: Criar o fluxo e obter a URL no N8N\n\nPara que o Z-PRO consiga enviar os dados para o N8N, você precisa criar um fluxo para receber o Webhook.\n\n### Acessando o n8n\n\n1\. Acesse o n8n no navegador em http://localhost:5678 ou no endereço configurado na sua instalação.\n\n2\. Faça login com o usuário e senha configurados (se aplicável).\n\n### Criando um Workflow no n8n\n\n1\. No painel do n8n, clique em "New" para criar um novo workflow.\n\n2\. No painel de nós (nodes), procure por "Webhook" e arraste o nó "Webhook" para o espaço de trabalho.\n\n### Configurando o Nó Webhook\n\n1\. Selecione o nó "Webhook" que você adicionou ao espaço de trabalho.\n\n2\. Configure as seguintes opções: o Method: POST o Path: /meu-webhook\n\n3\. O nó "Webhook" deve aparecer semelhante a este: o Method: POST o Path: /meu-webhook\n\n### Adicionando um Nó de Resposta\n\n1\. No painel de nós (nodes), procure por "Set" e arraste o nó "Set" para o espaço de trabalho.\n\n2\. Conecte a saída do nó "Webhook" à entrada do nó "Set".\n\n3\. Configure o nó "Set" para definir uma resposta simples:\n\n Clique em "Add Field".\n Selecione "String".\n No campo "Name", digite message.\n No campo "Value", digite Webhook received!.\n\n\n\n### Salvando e Executando o Workflow\n\n1\. Clique em "Save" para salvar o workflow.\n\n2\. Com o nó "Webhook" selecionado, clique em "Execute Node" para iniciar a escuta do webhook.\n\n3.Você verá a URL do webhook gerada, algo como http://localhost:5678/webhook-test/meu-webhook.\n\n4\. Copie essa URL.\n\n*\n\n## Passo 3: Adicionar a URL no Canal do Z-PRO\n\nCom a URL do N8N copiada e a opção ativada no admin, você fará a integração diretamente no canal.\n\n1. No Z-PRO, vá em Canais e edite a conexão desejada.\n\n\n\n2. Role a janela de configurações até localizar a área Configurações do N8N.\n3. No campo URL do N8N, cole o endereço do Webhook que você gerou no passo anterior.\n4. Clique em Salvar.\n\n\n\n*\n\n## Como acionar o N8N durante a operação?\n\nO Z-PRO permite que o N8N atue nos seus atendimentos de diferentes formas:\n\n Ativação Global: Você pode marcar a opção "Ativar integração com N8N para todos os atendimentos por Padrão" nas Configurações Gerais. Assim, o N8N escutará e interagirará com todos os novos tickets.\n\n\n\n Pelo Chatbot (Flowbuilder): É possível direcionar o contato para o N8N em uma etapa específica da sua automação interna, adicionando a interação "Nó N8N" ou "Adicionar Webhook" no construtor de fluxo. (Lembre-se: integrações externas devem ser a última ação do bloco)\n\n\n\n Manualmente no Atendimento: Na tela de chat, o atendente pode ativar ou desativar a chave do N8N individualmente para aquele contato usando o menu lateral direito em "Detalhes do contato" aba "Integr."\n\n\n\n Desligamento Automático: Para evitar que o fluxo automatizado atrapalhe o operador, você pode habilitar a opção "Habilitar desligamento automático das integrações externas". Com isso, o N8N é desligado no momento em que um atendente humano assume a conversa. Configuração realizada dentro do canal:\n\n\n\n*\n\n{% hint style="warning" %}\n Escopo do Suporte Técnico\n\nA Z-PRO fornece os pontos de conexão para a integração com o N8N\n\nNão faz parte do nosso escopo de suporte:*\n\n A criação, lógica, depuração (debug) ou otimização de fluxos dentro do N8N.\n* A configuração, manutenção e estabilidade do servidor ou conta onde o N8N do cliente está hospedado.\n {% endhint %}\n\n#### Exemplo de fluxo n8n para agendamento\n\n{% embed url="https://www.youtube.com/watch?t=407s&v=0I-52eP61ng" %}\n\n#### Exemplo de fluxo no N8N + API Z-PRO + WABA\n\n{% embed url="https://www.youtube.com/watch?v=jfF7h_7q8tY" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/n8n-tutorial-de-integracao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Projeto no Dialogflow\n\n### Passo 1: Criação do Projeto no Google Cloud\n\n1\. Acesse o Google Cloud Console.\n\n2\. Faça login com sua conta do Google.\n\n3\. Clique no ícone de seleção de projeto no topo da página e depois clique em "Novo Projeto".\n\n4\. Dê um nome ao seu projeto e clique em "Criar".\n\n### Passo 2: Ativando a API Dialogflow\n\n1\. No Google Cloud Console, certifique-se de que você está no projeto criado.\n\n2\. No menu lateral, vá para "API e Serviços" > "Biblioteca".\n\n3\. Pesquise por "Dialogflow API" e clique nela.\n\n4\. Clique no botão "Ativar".\n\n### Passo 3: Criando um Agente no Dialogflow\n\n1\. Acesse o Dialogflow Console.\n\n2\. Clique em "Criar Agente".\n\n3\. Preencha os detalhes do agente:\n\no Nome do Agente\n\no Projeto do Google Cloud (selecione o projeto criado anteriormente)\n\no Idioma Padrão (por exemplo, "Português (Brasil)")\n\no Fuso Horário\n\n4\. Clique em "Criar".\n\n### Passo 4: Obtendo o ID do Projeto\n\n1\. No Google Cloud Console, vá para o menu "IAM e Administração" > "Configurações".\n\n2\. O ID do Projeto estará listado na seção "Informações do Projeto". Copie este ID.\n\n### Passo 5: Criando Credenciais de API\n\n1\. No Google Cloud Console, vá para "API e Serviços" > "Credenciais".\n\n2\. Clique em "Criar Credenciais" e selecione "Chave de conta de serviço".\n\n3.Na janela que aparece, selecione "Nova conta de serviço".\n\n4.Dê um nome à sua conta de serviço e, opcionalmente, atribua um papel, como "Administrador de Projeto".\n\n5.Clique em "Criar" e depois em "Concluir".\n\n6.Um arquivo JSON será baixado automaticamente para o seu computador. Esse é o seu arquivo de autenticação.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/projeto-no-dialogflow.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Typebot autohospedado\n\n### Passo 1: Acessando o Painel do Typebot\n\n1\. Acesse o painel do Typebot autohospedado no seu navegador. A URL será algo como http://seu-servidor ou o endereço que você configurou.\n\n2.Faça login com suas credenciais administrativas.\n\n### Passo 2: Criando um Novo Bot\n\n1.Após fazer login, você será direcionado ao painel de controle.\n\n2.Clique no botão "New Bot" ou similar (geralmente um botão com o símbolo de "+").\n\n3.No campo "Bot Name", insira o nome do seu bot.\n\n4.Clique em "Create" para criar o bot.\n\n### Passo 3: Configurando o Bot\n\n1.Você será levado para o editor de bots. Aqui, você pode configurar o fluxo de conversa do seu bot.\n\n2.Adicione e configure os blocos de diálogo conforme necessário, utilizando a interface de arrastar e soltar.\n\n3.Certifique-se de salvar suas configurações periodicamente clicando no botão "Save".\n\n### Passo 4: Publicando o Bot\n\n1\. Após configurar o bot, clique no botão "Publish" para publicar o bot.\n\n2\. A URL de compartilhamento do bot será gerada após a publicação. Esta URLserá algo como http://seu-servidor /bot/nome-do-bot.\n\n3.Copie essa URL para usá-la em suas plataformas de comunicação.\n\n### Passo 5: Obtendo o Nome do Bot\n\n1.O nome do bot é o mesmo que você definiu durante a criação do bot.\n\n2.Você pode visualizar e alterar o nome do bot na página de configurações do bot, geralmente acessível através do painel de controle ou das opções de configuração dentro do editor de bots.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integracoes-terceiras/typebot-autohospedado.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Integrando o chat GPT\n\n## PRÉ-REQUISITOS\n\n#### Vídeo configurando a sua conta na Open IA:\n\n{% embed url="https://youtu.be/Ikbd2_8VXAw" %}\n\nPré-requisitos: Configurando sua conta na OpenAI\n\nAntes de iniciar a integração no Z-PRO, é indispensável que você tenha uma conta configurada na plataforma de desenvolvedores da OpenAI.\n\n1. Crie sua Conta: Acesse o site da API da OpenAI em https://openai.com/pt-BR/api/ e crie sua conta.\n2. Adicione Créditos: A utilização da API da OpenAI é um serviço pago. Você precisará adicionar créditos à sua conta para que as requisições funcionem.\n3. Gere sua Chave de API (API Key): Dentro do painel da OpenAI, navegue até a seção de chaves de API e gere uma nova chave. Guarde esta chave em um local seguro, pois você precisará dela para configurar a integração no Z-PRO.\n\nCom a chave de API em mãos, você está pronto para configurar a integração.\n\n## INTEGRAÇÃO NO Z-PRO\n\n#### Vídeo integrando o ChatGPT no Z-PRO:\n\n{% embed url="https://youtu.be/-L7vUILb9Zw" %}\n\nPasso 1: Ativando a Integração no Z-PRO\n\nA primeira etapa é habilitar a funcionalidade do ChatGPT dentro do seu sistema Z-PRO.\n\n1. No menu lateral esquerdo, acesse Configurações.\n2. Clique na aba Bots e IA.\n3. No menu secundário que aparecerá, selecione a opção Chat GPT.\n4. Ative a opção "Ativar integração com ChatGPT".\n\n\n\nOpcional: Você também pode ativar a chave "Ativar integração com ChatGPT para todos os atendimentos por padrão" se desejar que o bot responda em todos os canais automaticamente. Caso contrário, você configurará canal por canal, como mostrado no próximo passo.\n\nPasso 2: Configurando o ChatGPT em um Canal de Comunicação\n\nApós ativar a integração, você precisa configurar sua chave de API e as instruções do seu assistente em cada canal que desejar.\n\n1. No menu principal, acesse Canais de Comunicação.\n2. Localize o canal desejado (ex: WhatsApp, Webchat) e clique no ícone de Configurações (engrenagem).\n3. Caso não tenha nenhum canal criado ainda. Clique no botão + Adicionar Canal. Uma janela de configurações se abrirá. \n\n\n\nPasso 3: Integrando o chat GPT no seu canal\n\nPara conectar o canal do z-pro com sua api da openIA, você precisa inserir:\n\n ChatGPT API Key: Cole a chave de API que você gerou na plataforma da OpenAI.\n ChatGPT Organization Key: Cole a chave de ID da sua organização.\n\nVocê tem duas opções principais para definir como seu assistente de IA irá se comportar:\n\n Opção 1: Prompt direto no Z-PRO (Prompt ChatGPT)\n Use este campo para escrever as instruções do seu assistente diretamente no Z-PRO. Defina sua personalidade, o tom de voz, as regras de negócio e como ele deve interagir com os usuários.\n Opção 2: Usar um Assistant da OpenAI (AssistantId ChatGPT)\n Se você já criou e configurou um "Assistant" na interface (Playground) da própria OpenAI, basta colar o ID do Assistant neste campo. O Z-PRO utilizará todas as configurações que você já definiu por lá.\n Importante: Ao usar um Assistant ID, as instruções do campo "Prompt ChatGPT" serão desconsideradas.\n\nPasso 4: Configurações Adicionais (Opcional)\n\nAinda na mesma janela, você pode refinar a integração:\n\n Palavra para desligar o ChatGPT: Defina um termo específico (ex: "falar com atendente") que, ao ser enviado pelo cliente, desativará o bot e transferirá a conversa para um atendente humano.\n ChatGPT Model: Escolha o modelo de linguagem (LLM) que deseja utilizar (ex: gpt-4, gpt-3.5-turbo).\n ChatGPT Voice Model: Caso opte por respostas em áudio, selecione o modelo de voz desejado (ex: alloy, onyx, nova).\n *Ativar Respostas de Voz (ChatGPT Voice): Ative esta opção para que o bot responda às mensagens com áudios em vez de texto.\n\n\n\nApós preencher as informações, salve as configurações. Seu canal estará pronto para utilizar o ChatGPT nos atendimentos.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/integrando-o-chat-gpt.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Principais erros\n\n## Erros de Apontamento DNS\n\n### Erro ao gerar o certificado HTTPS\n\n Verifique se o apontamento foi prapagado\n Acesse a VPS como root e execute o comando\n\n\nsudo certbot --nginx\n\n\n## Erros de Banco de Dados\n\n## Erro ao acessar Postgres\n\n{% hint style="info" %}\nInternal server error: SequelizeConnectionError: could not open file "global/pg\_filenode.map": Permission denied\n{% endhint %}\n\nAcessar o terminal com root\n\n\ndocker container restart portainer\n\n\nAcessar o portainer, abrir console do postgres e executar o comando\n\nchown -R postgres /var/lib/postgresql\n\n\n### Caso o erro persista, criar uma rotina no crontab\n\nAcessar o terminal com root\n\n\ndocker exec -u root -it postgresql bash -c "chown -R postgres:postgres /var/lib/postgresql/data"\n\n\n## Erros de Frontend\n\n## Customização não são carregadas no front\n\nAcessar a VPS como deployzdg\n\nRealizar as customizações\n\n\ncd ~\ncd zpro.io\ncd frontend\npm2 stop all\nexport NODE_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa\npm2 restart all\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/principais-erros.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Template (WABA) não chega ao destinatário\n\n## Por que um Template (WABA) não chega ao destinatário?\n\nCaso uma mensagem de modelo (Template) seja enviada pela API Oficial (WABA) e o sistema indique o envio com sucesso, mas a entrega não ocorra no dispositivo do destinatário, é provável que a mensagem tenha sido retida nos filtros de qualidade e engajamento da Meta.\n\nO sistema de entrega da Meta é automatizado e segue regras rigorosas para evitar SPAM e garantir a experiência do usuário final, independentemente da plataforma utilizada para o envio.\n\n\n\n### 1. O Filtro Automatizado da Meta\n\nMesmo com o template aprovado, o algoritmo da Meta monitora o comportamento do envio em tempo real. Diversos fatores podem bloquear ou atrasar a entrega, incluindo:\n\n Baixa Taxa de Resposta: Envio de alto volume de mensagens com pouca interação por parte dos destinatários.\n* Frequência de Envio: Disparos repetitivos em curto espaço de tempo.\n* Bloqueios e Denúncias: Índices elevados de bloqueios ou denúncias de spam por parte dos usuários.\n* Qualidade do Número: Um histórico ruim de qualidade (visível no Gerenciador do WhatsApp) impacta diretamente a entrega.\n* Repetição: O envio massivo e repetido do mesmo template para o mesmo número (comum em testes).\n\n### 2. O Novo Sistema de Autorização de Entrega\n\nA Meta implementou camadas de segurança que impactam a entrega baseadas no comportamento do usuário final:\n\n* Pontuação de Engajamento: Avaliação do nível de interação do destinatário específico com a empresa.\n* Janela de Entrega Baseada em Engajamento: Quanto menor o engajamento do cliente, maior pode ser o atraso (delay) ou a restrição de entrega imposta pela Meta.\n* Filtros de Conteúdo: Mecanismos automáticos de Anti-Spam e Anti-Flood para detecção de padrões abusivos.\n\n{% hint style="warning" %}\nAtenção aos Testes em Número Único\n\nUm cenário comum de bloqueio ocorre durante testes, quando o mesmo template é enviado repetidamente para um único número sem haver resposta.\n\nO algoritmo interpreta esse comportamento como falta de interesse do destinatário e cessa a entrega. Para normalizar, recomenda-se responder à última mensagem recebida no WhatsApp de teste, gerando engajamento.\n{% endhint %}\n\n*\n\n### 3. Diagnóstico Técnico (Teste de Isolamento)\n\nPara confirmar se a falha de entrega é sistêmica ou um bloqueio externo da Meta, recomenda-se realizar um teste de envio direto pela API Oficial, isolando o Z-PRO.\n\nO teste pode ser realizado via Postman:\n\n1. Acessar a coleção oficial da Meta: WhatsApp Business Platform Collection.\n2. Configurar a requisição com as credenciais (Token e ID do número) utilizadas no Z-PRO.\n3. Realizar o envio do mesmo template para o mesmo número que apresentou falha.\n\nInterpretação do Resultado:\n\n Mensagem NÃO entregue pelo Postman: Confirma-se que o bloqueio é imposto pela Meta/WhatsApp (devido a regras de negócio, qualidade ou filtro de spam). Nesses casos, o Z-PRO não possui controle sobre a entrega.\n Mensagem entregue pelo Postman: Indica uma possível inconsistência na configuração dentro do Z-PRO. Recomenda-se a abertura de um chamado técnico anexando os logs do teste.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/avancado-recursos-tecnicos/principais-erros/template-waba-nao-chega-ao-destinatario.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Central Do Assinante
Atualizações e Status do Z-PRO\n\n- Changelog (última versão)\n- 4.0.0.X\n- 3.1.5.x: Esta página é o registro oficial e cronológico de todas as atualizações lançadas para a plataforma Z-PRO. As versões mais recentes estão sempre no topo.\n- 3.1.4.x: Esta página é o registro oficial e cronológico de todas as atualizações lançadas para a plataforma Z-PRO. As versões mais recentes estão sempre no topo.\n- 3.1.3.x\n- 3.1.2.x: Controle de versões\n- 3.1.1.x: Controle de versões\n- 3.1.0.x: Controle de versões\n- 3.0.9.x: Controle de versões\n- Validade das versões: Expiração de versão da API\n- Procedimento Padrão de Atualização\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Changelog (última versão)\n\n{% hint style="warning" %}\n\n### Manter seu sistema atualizado é fundamental para a segurança, performance e acesso a novas funcionalidades.\n\n{% endhint %}\n\nConsulte esta seção regularmente para se manter informado sobre novidades e correções. Antes de atualizar, é fundamental ler as notas da versão para a qual você irá migrar.\n\nAula - Atualização Passo a Passo\n\n{% hint style="info" %}\n\n### Para acompanhar as novas versões entre no canal de avisos do Telegram \n\n{% endhint %}\n\n*\n\n## ÚLTIMA VERSÃO: \n\n## v4.0.0 - 04/05/2026: ZPRO v4\n\n{% hint style="danger" %}\nAVISO: FAÇA UM SNAPSHOT DO SERVIDOR\n\nAntes de iniciar qualquer procedimento de atualização, é mandatório criar um snapshot (um ponto de restauração) do seu servidor VPS.\n\nUm snapshot é a sua única garantia de que poderá reverter o sistema ao estado anterior de forma rápida e segura em caso de qualquer falha ou imprevisto durante o processo de atualização.\n{% endhint %}\n\n### Resumo das novidades**\n\n⚛️ Novo front end React Next.js - interface mais rápida e moderna\\n🔗 Integrações nativas com Instagram, Facebook e WhatsApp API oficial - Oauth próprio do Zpro\\n🤖 Copiloto de I.A - Resumos, sugestões de respostas, análises de sentimento...\\n📱 Novos canais - Mercado Livre, Woocommerce, OLX, Tiktok, Youtube, Linkedin, Rocket.Chat\\n📈 Rastreamento de conversões Pixel Meta e Google GA4\\n🎧 Novos recursos de atendimento\\n👤 Perfil personalizado de usuários\\n🔌 Novos Endpoints API\\n🎨 Personalizações\\n☁️ Armazenamento externo (Storage AmazonS3, etc)\\n⚡️ Autoinstalador melhorado\\n💳 Novos gateways de pagamento (stripe, mercadopago, etc)\\n🚀 Modo Cluster - Infraestrutura para escala com múltiplos núcleos de processamento\\n📧 Integração com SMTP para envio e recebimento de email nos tickets\\n✨ Recursos premium baileys / uazapi - botões, listas, etc\n\n### Histórico de Versões Anteriores\n\nNas páginas seguintes você encontra o histórico completo das versões anteriores. \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.0.9.x\n\n### 3.0.9.9\n\n<< UPDATE v3.0.9.9 - 07/03/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: demanda e valor na rota createTicket\n Adicionado: tratamento nono dígito rotas da API\n Adicionado: mudanças de estilo no ticket e mensagem\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.8\n\n<< UPDATE v3.0.9.8 - 06/03/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: socket nas mensagens para Meow e Evo (nome do usuário)\n Adicionado: chamadas múltiplas wavoip\n Adicionado: liberação do microfone após encerramento da gravação\n Adicionado: notificação de áudio suprimida durante gravação do áudio\n Adicionado: melhoria interna na consulta de tickets e contatos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.7\n\n<< UPDATE v3.0.9.7 - 04/03/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: deepseek, claude e qwen nativos\n Adicionado: melhoria na interface do chatbot interno\n Adicionado: melhoria na interface do kanban\n Adicionado: página de avaliação com nome do contato\n Adicionado: listagem de canais com nome da empresa (superadmin)\n Adicionado: listagem dos usuários com nome da empresa (superadmin)\n Adicionado: melhoria interface da página dados internos (superadmin)\n Adicionado: chat interno enviando áudio\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.6\n\n<< UPDATE v3.0.9.6 - 28/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: modelo para ChatGPT\n Adicionado: Gemini e Grok\n Adicionado: mensagem de despedida + avaliação\n Adicionado: sanitização do nono dígito e queueId na rota do createTicket\n Adicionado: notas no relatório de atendimento\n Adicionado: infos extrar no relatório de contatos\n Adicionado: Dify para waba\n Ajuste: vcard Evolution\n Ajuste: listagem participantes para grupos Baileys\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.5\n\n<< UPDATE v3.0.9.5 - 25/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: delimitação no tamanho das colunas de notas\n Adicionado: envio de mensagem de aniversário por multicanais\n Adicionado: botão interagindo no chatbot interno com Waba\n Adicionado: recebimento de botões na WWEBJs\n Adicionado: ignorar stories (configurações)\n Adicionado: kanban e chatbot na rota da api createTicket\n Adicionado: integração ollama\n Ajuste: despedida na API Evolution\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.4\n\n<< UPDATE v3.0.9.4 - 19/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: envio e recebimento de áudio, txt e csv com Meow\n Adicionado: sanitização de contatos na Meow (profilePicture)\n Adicionado: recebimento de caption nas mídias com Meow\n Adicionado: interação com stories do Instagram via Hub\n Adicionado: opção para definir mensagens de avaliação\n Adicionado: adicionado status na rota createTicket\n Adicionado: redimensionamento nos campos do firstName, lastName e businessName no modal dos contato\n Adicionado: alteração no tema do tooltip dos gráficos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.3\n\n<< UPDATE v3.0.9.3 - 17/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: sanitização configuração dify\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.2\n\n<< UPDATE v3.0.9.2 - 14/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: envio de txt e csv pela evolution\n Adicionado: espiar em buscar mensagens, protocolo, notas e avaliação\n Adicionado: tradução avaliação automática\n Adicionado: opção para trocar plugin de gravação de áudio (beta)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.1\n\n<< UPDATE v3.0.9.1 - 11/02/2025>>\n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: desativar processamento cadenciado de mensagens com integrações externas (configuração do canal)\n Adicionado: quoted para Waba\n Adicionado: transferência para os canais evo, meow e waba\n Adicionado: liberar grupos para todos (configurações)\n Adicionado: liberar fechado para todos (configurações)\n Adicionado: trava de segurança ao clicar no envio de mensagem mais de uma vez seguida\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.0.9.0\n\n<< UPDATE v3.0.9.0 - 06/02/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: opção para definir o chatflowId na rota setTicketInfo via API\n Adicionado: tratamento do nono dígito nas rotas ShowContact, CreateContact, UpdateContact (exceto waba) via API\n Adicionado: opção isClosed na rota sendAudio via API\n Adicionado: envio de templates sem variáveis para Waba Hub Notificame\n Adicionado: opção para validar contatos na importação\n Adicionado: suporte a importação de .txt separados por ;\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.0.9.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.0.9.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.0.x\n\n### 3.1.0.9\n\n<< UPDATE v3.1.0.9 - 01/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: filtro salvo no cache para o usuário\n Adicionado: customizar vídeo da home no superadmin\n Adicionado: groqcloud para transcrição de áudios\n Adicionado: adicionado supervisor na distribuição de atendimento do chatbot\n Adicionado: restrição de acesso do usuário por horário\n Ajuste: modal do perfil na barra superior\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.9 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.8\n\n<< UPDATE v3.1.0.8 - 23/04/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: notificação sonora chat interno (som icq)\n Adicionado: enviar arquivos com ctrl+c no chat interno\n Adicionado: acesso ao histórico dos atendimentos na tela de contatos (apenas admins)\n Adicionado: adicionar monitor de uso do servidor (superadmin)\n Adicionado: opção para corrigir as conversas importadas no histórico para WWEBJS e Baileys (configurações)\n apenas para novas mensagens importadas a partir da versão 3108\n Ajuste: correções chatbot waba\n Ajuste: correção envio mensagem de horário de funcionamento Evo\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.7\n\n<< UPDATE v3.1.0.7 - 15/04/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: controle de módulos por tenant (página Tenants - SuperAdmin)\n Adicionado: controle de páginas por usuário (página Usuário - Admin)\n Adicionado: envio de webhook na mudança de status da conexão (Webhook Atualizar canal/conexão)\n Adicionado: configuração para ativar o módulo de áudio com ondas\n Adicionado: tratar nono dígito de contatos BR (página Contatos)\n Adicionado: log de chamadas na página do Wavoip\n Ajuste: avaliação mais mensagem de despedida com variáveis\n Ajuste: reações waba (interação com chatbot)\n Ajuste: correção filtro de data no protocolo\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.6\n\n<< UPDATE v3.1.0.6 - 08/04/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: api liberada pra Evolution\n Adicionado: ocultação de licença no painel do superadmin (assinatura)\n Adicionado: controle de expiração das versões no painel do superadmin (assinatura)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.5\n\n<< UPDATE v3.1.0.5 - 02/04/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA\r\\n2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução.\r\\n3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado.\r\\n4- 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.\n\n Adicionado: foto de perfil instagram\n Ajuste: SMTP recuperação de senha\n Ajuste: recebimento de mídias Hub Notificame\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.4\n\n<< UPDATE v3.1.0.4 - 28/03/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA\r\\n2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução.\r\\n3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado.\r\\n4- 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.\n\n Adicionado: tratamento do nono dígito para WABA\n Adicionado: caption ao receber mídias com WABA\n Adicionado: recebimento de templates com Baileys\n Adicionado: gráfico de demandas e valores no dashboard do atendimento\n Adicionado: suporte a multiVcard com WWEBJS\n Adicionado: rota para envio de templates com WABA via ZPRO\n Adicionado: caption adicionado no envio de mídias via API com Baileys na rota SendMessageAPIFileURL\n Adicionado: atualização rápida no superadmin (Beta)\n Ajuste: encaminhar áudio com Evolution\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.3\n\n<< UPDATE v3.1.0.3 - 24/03/2025>>\n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n Adicionado: duplicação de campanha considerando mídia\n Adicionado: tratamento automático do nono dígito no envio de mensagens com Waba\n Adicionado: caption inserido no envio da imagem via API Waba\n Adicionado: mudança no autodistribuir balanceado do chatbot (considera a etapa da fila e não mais a fila padrão do canal)\n\n### 3.1.0.2\n\n<< UPDATE v3.1.0.2 - 17/03/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA\r\\n2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução.\r\\n3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado.\r\\n4- 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.\n\n Adicionado: Chatgpt interpretando imagens pelo Vision\n Adicionado: Chatgpt respondendo em áudio\n Adicionado: mídia do story no recebimento da interação\n Ajuste: setagem do canal padrão\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.1\n\n<< UPDATE v3.1.0.1 - 14/03/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA\r\\n2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução.\r\\n3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado.\r\\n4- 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.\n\n Adicionado: redução na quantidade de logs de back e front\n Adicionado: agente Dify (Stream)\n Adicionado: Dify para evolution\n Adicionado: configuração para desabilitar persistência no download de mídias inválidas para Baileys\n Adicionado: envio de arquivo com WWEBJs (aniversário manual)\n Adicionado: adicionado persistência na validação dos números WWEBJS (rotas de APIS)\n Ajuste: sanitização na ordenação das mensagens carregadas\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.0.0\n\n<< UPDATE v3.1.0.0 - 10/03/2025>> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA! A partir da versão 3.0.7.0 é obrigatório informar o e-mail de compra do passaporte no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE! 1- Na versão 3.0.8.8 a pasta src-pwa foi substituída para o recebimento do WebPush no aplicativo PWA 2- Na versão 3.0.7.9 o quasar.conf foi substituído para recebimento da folha de tradução. 3- Na versão 3.0.7.5 o APP.vue foi substituído sendo necessário a alteração do nome do APP após atualização rápida, caso você use um nome customizado. 4- 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.\n\n Adicionado: mensagem respondida sendo buscada ao clicar\n Adicionado: filtro do admin não é mais carregado como Visualizar todos na tela de atendimento\n Adicionado: nome da fila na mensagem de transferência\n Adicionado: confirmação de leitura da mensagem WABA\n Ajuste: mensagem agendada e encaminhada (arquivos) com WWEBJS + Envio Rápido\n Ajuste: horário de atendimento Baileys\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.0.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.0.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.1.x\n\n### 3.1.1.9\n\n<< UPDATE v3.1.1.9 - 13/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: extensão do suporte para @lid na Baileys\n Adicionado: webhook envio waba\n Ajustes: recebimento áudio telegram\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.8\n\n<< UPDATE v3.1.1.8 - 11/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: suporte para @lid na Baileys\n Adicionado: editar o valor do @lid no contato\n Adicionado: limitação do webpush por fila e whatsapp liberado (supervisor e user, admin continua recebendo tudo)\n Adicionado: botão para cancelar campanha\n Adicionado:\n Ajustes: arredondamento de valor da média do ticket médio (funil)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.8 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.7\n\n<< UPDATE v3.1.1.7 - 05/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: mudança da sessão tutorial e configuração do link do postman para o superadmin (Customizar)\n Ajustes: correção resposta do botão WABA\n Ajustes: configuração SMTP na recuperação de senha\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.6\n\n<< UPDATE v3.1.1.6 - 03/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: seção tutoriais (configuração > crm)\n Adicionado: definir link do postman (configuração > gerais)\n Adicionado: integrações diversas com webchat (chatbot, ias, interação com mídias e mais)\n Obrigatório g erar novo widget!\n Ajustes: encerramento de ligação com SIP\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.5\n\n<< UPDATE v3.1.1.5 - 29/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: nova versão WhiskeySockets/Baileys\n Adicionado: telefonia SIP WEBRTC/WSS (Asterisk, FreeSwitch e outros)\n Adicionado: opção de listar tickets pela última mensagem recebida (configurações gerais)\n Adicionado: opção para forçar definição do campo demanda ao encerrar o atendimento\n Adicionado: melhoria no relatório da campanha\n Adicionado: melhoria no campo de enviar mensagem no atendimento\n Adicionado: enviar arquivo com legenda\n Adicionado: no chatbot ao transferir para um canal, caso existe usuário e fila setado no canal essas informações serão definidas no novo atendimento\n Ajustes: correção de contato bloqueado para WWEBJs\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.4\n\n<< UPDATE v3.1.1.4 - 22/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: adicionado opção para listar participantes da equipe no chat interno\n Adicionado: limitação de notificação sonora apenas para participantes do grupo do chat interno\n Adicionado: aumento do campo do prompt do deepseek, ollama, lm, grok, gemini e claude\n Adicionado: aumento do tamanho da mensagem personalizada de avaliação\n Ajustes: correção mensagem de despedida ao clica em ticket fechado\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.3\n\n<< UPDATE v3.1.1.3 - 20/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: resposta personalizada para cada avaliação\n Adicionado: notificação de transferência (ticket para pendente com notificação enviada)\n Adicionado: feriado mensagem de ausência\n Adicionado: ao espiar, modal rola para ultima mensagem recebida\n Adicionado: palavra gatilho do chatbot interno interagindo com WABA\n Adicionado: estatística de uso de empresa (página tenant no superadmin)\n Adicionado: planos de até 5 reais não são geradas faturar no ASASS (permite criar teste gratuito sem cobrança)\n Ajustes: comportamento enviar e-mail teste na tela de Configs SMTP\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.2\n\n<< UPDATE v3.1.1.2 - 16/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: opção para atualizar status online/offline (tela usuários admin)\n Adicionado: rota para atualizar e deletar oportunidade via API\n Adicionado: removida marcações ZPRO na criação do widget (contabilidade whitelabel)\n Adicionado: campanha liberada para usuário\n Adicionado: mudança na ordem dos itens no menu do usuário\n Adicionado: controle de features do usuário espiar e fechar forçado (configurações admin)\n Ajustes: comportamento do funil na tela de atendimento\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.1\n\n<< UPDATE v3.1.1.1 - 13/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: liberado funil avançado\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.1 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.1.0\n\n<< UPDATE v3.1.1.0 - 08/05/2025>>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ ATENÇÃO CAMPANHAS PENDENTES COM DATA VENCIDA SERÃO PROCESSADAS FORA DO REDIS, CASO ESTEJA USANDO O ENVIO RÁPIDO!\n\n⚠️ CONTROLE DE ASSINATURA!\r\\nA partir da versão 3.0.7.0 é obrigatório informar a chave do ZPRO no painel do Super Admin - Assinatura para validação da sua instalação, assegurando a segurança da sua instalação.\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\n\n Adicionado: webchat nativo\n Adicionado: indexação tabela settings banco de dados\n Ajuste: correção horário de atendimento para novos usuários\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.1.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.1.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.2.x\n\n### 3.1.2.9\n\n<< UPDATE v3.1.2.9 - 17/07/2025 >> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n### Adicionado:\n\n Definição de domínio no Superadmin: Agora é possível configurar o domínio da aplicação diretamente pelo painel do superadmin.\n\n{% embed url="https://youtu.be/NM525hfx6b8" %}\n\n Agrupamento de contato via @lid (Baileys): Na tela de atendimento, foi incluída a opção de agrupar contatos com @lid, localizada acima da função de sanitizar contato.\n Fluxo dentro de Ações: Foi adicionada a capacidade de criar fluxos personalizados dentro do módulo de "Ações" da plataforma.\n\n{% hint style="warning" %}\nImportante sobre a função "Fluxo em Ações"\n\nAo utilizar a nova funcionalidade de Fluxo dentro de Ações, a mudança de etapa da oportunidade deve ser sempre a última ação configurada, pois todas as outras ações do fluxo dependem da etapa atual para serem executadas corretamente.\n{% endhint %}\n\nAjustado:\n\n Duplicação de mensagem do Meet (Evolution): Corrigido o envio duplicado de mensagens do Meet em atendimentos via canais Evolution.\n Autodistribuição de canal WABA: Ajustada a rotina de autodistribuição para definir corretamente o atendente (usuário) ao receber um novo ticket.\n Ocultação do botão "Pausar" no mobile: Realizadas melhorias de layout para a visualização da tela de atendimento em dispositivos móveis.\n Tooltip no modo escuro (Dashboard): Corrigido o contraste do texto das tooltips (dicas de tela) para melhor leitura no dark mode do dashboard.\n Componentes no WABA (Botões / Lista / Flow): Resolvido um problema de loop e renderização que afetava o funcionamento destes componentes em canais WABA.\n Contagem de mensagens não lidas no WABA: A contagem de mensagens pendentes agora exibe o número exato.\n\n### 3.1.2.8\n\n<< UPDATE v3.1.2.8 - 09/07/2025 >> \n\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n Adicionado: adicionado template de catálogo para Cloud API\n Ajuste: visualização dos botões na tela de canais (Mobile)\n Ajuste: correção chatgpt assistant + telegram\n Ajuste: liberação da visualização de todos os atendimentos para o admin/supervisor, mesmo que esteja marcado Não visualizar Tickets já atribuídos à outros usuários\n\n### 3.1.2.7\n\n<< UPDATE v3.1.2.7 - 06/07/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática) > acessar a VPS com deployzdg > alterar o arquivo quasar.conf.js na pasta frontend > cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa > pm2 restart all\n\n Adicionado: limitação para resincronia de mensagens já recebidas com WWEBJS\n Ajuste: liberação da pasta Public + CORS para Webchat nativo (sem necessidade de liberação do parâmetro SECURE\_URL)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.7 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.1.2.6\n\n<< UPDATE v3.1.2.6 - 04/07/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática) > acessar a VPS com deployzdg > alterar o arquivo quasar.conf.js na pasta frontend > cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa > pm2 restart all\n\n Adicionado: permissão para salvar o campo nome e lid sem precisar validar o contato\n Adicionado: temas e personalização do dashboard principal\n Adicionado: limitação do excluir forçado apenas ao admin\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.6 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.1.2.5\n\n<< UPDATE v3.1.2.5 - 01/07/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática) > acessar a VPS com deployzdg > alterar o arquivo quasar.conf.js na pasta frontend > cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa > pm2 restart all\n\n Adicionado: sessão única onde usuários serão desconectados ao fazer login em outro dispositivo (Menu Customizar > Forçar Logout - SUPERADMIN)\n Adicionado: deletar contatos em massa\n Adicionado: remoção forçada de contatos (mesmo que já tenha tickets/mensagens na plataforma)\n Adicionado: listar canal do wavoip para realizar a chamada\n Adicionado: botão para resetar conexão da Baileys quando em loop (Configurações > Sessões > Listar Sessões - ADMIN)\n Ajuste: correção disparo de ação no funil (mudar status)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.5 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.1.2.4\n\n<< UPDATE v3.1.2.4 - 26/06/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática) > acessar a VPS com deployzdg > alterar o arquivo quasar.conf.js na pasta frontend > cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa > pm2 restart all\n\n Adicionado: update versão da WWEBJS\n Ajuste: envio de mensagens rápidas com arquivos\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.4 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.1.2.3\n\n<< UPDATE v3.1.2.3 - 25/06/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO PROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática) > acessar a VPS com deployzdg > alterar o arquivo quasar.conf.js na pasta frontend > cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa > pm2 restart all\n\n Adicionado: otimização no disparo usando etiquetas\n Adicionado: liberação do serviço de ações para oportunidades\n Adicionado: dify + webchat nativo\n Adicionado: integração VAPI\n Adicionado: reescrita com ChatGPT (tela de atendimento)\n Adicionado: parametro no env para liberar acesso a midias por outras urls . Adicionar ao .env do backend o parametro SECURE\_URL com qualquer valor e reiniciar o seu backend . exmeplo: SECURE\_URL=\\n Adicionado: ao salva/editar/adicionar o sistema dará prioridade ao canal setado como padrão\n Adicionado: transferência de fila/usuário/canal na interação fora do horário de atendimento do chatbot irá enviar mensagem apenas se o atendimento estiver na fila/usuário/canal diferente da opção de transferência\n Ajuste: envio de mp4 usando WWEBJS\n Ajuste: envio de mídia para WABA\n Ajuste: seleção de canal na mensagem avulsa (tela de atendimento)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.3 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND a. substituir pasta src b. substituir package.json e babel.config.js c. npm install --force d. export NODE\_OPTIONS=--openssl-legacy-provider e. npx quasar build -P -m pwa\n\n2- PASTA BACKEND a. substituir pasta dist b. substituir package.json c. apagar pasta node\_modules e arquivo package-lock.json d. npm install e. npx sequelize db:migrate f. npx sequelize db:seed:all\n\n3- su deployzdg pm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND substituir pasta dist completamente backend/package.json\n\nFRONTEND substituir pasta src completamente frontend/package.json\n\n### 3.1.2.2\n\n<< UPDATE v3.1.2.2 - 20/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficial\n\n2- Atualizar para 3.1.2.0 ou superior > Atualizar quasar.conf.js (caso realize atualização automática)\r\\n\> acessar a VPS com deployzdg\r\\n\> alterar o arquivo quasar.conf.js na pasta frontend\r\\n\> cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa\r\\n\> pm2 restart all\n\n Adicionado: opção para usar horário de atendimento do usuário (ativar em configurações gerais)\r \\n . ticket sem user, seguirá horário do sistema\r \\n . ticket com user checará os dois horários, se horário permitido para o user, a mensagem não será enviada\n Adicionado: opção para limitar o uso do pausar atendimento (ativar em configurações gerais)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.2 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.2.1\n\n<< UPDATE v3.1.2.1 - 20/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficial\n\n2- Atualizar quasar.conf.js (caso realize atualização automática)\r\\n\> acessar a VPS com deployzdg\r\\n\> alterar o arquivo quasar.conf.js na pasta frontend\r\\n\> cd zpro.io && cd frontend && export NODE\_OPTIONS=--openssl-legacy-provider && npx quasar build -P -m pwa\r\\n\> pm2 restart all\n\n Adicionado: adicionado o pausar atendimento\n Adicionado: histórico de chamadas SIP\n Adicionado: segurança para acesso das mídias (apenas front)\n Adicionado: liberado envio de arquivos com até 1.9gb (Whatsapp Não Oficiais)\n Ajustes: forçar demanda ajustado apenas para fechamento de ticket\n Ajustes: correção visual arrastar card no Kanban\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.0 =================\n\n USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n### 3.1.2.0\n\n<< UPDATE v3.1.2.0 - 17/06/2025 >>\r\\nCRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nVERSÃO DO AUTOINSTALADOR JÁ ESTÁ NESSE FORMATO\r\\nPROCEDIMENTO PARA QUEM QUISER ATUALIZAR\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE!\r\\n1- 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.\r\\nNessa versão alteramos o pacote da Baileys, portanto, instabilidades poderão acontecer nos primeiros momentos com essa API Não Oficia.\n\n Adicionado: melhoria nas interações com @lid para Baileys (captura de dados no evento de notificação)\n Adicionado: envio de vCard para Whatsapp\n Adicionado: filtro para templates aprovados na Waba\n Adicionado: suporte a flows Waba\n Adicionado: ação para funil\n Ajustes: correção listagem de canais Hub\n Ajustes: mensagem de saudação e transferência no chatbot interno (Baileys)\n\n\================= ATUALIZAÇÃO RÁPIDA para 3.1.2.0 =================\n\n* USAR O ZPRO.ZIP DA PASTA zpro\_passaporte\_shell\n\n1- PASTA FRONTEND\r\\na. substituir pasta src\r\\nb. substituir package.json e babel.config.js\r\\nc. npm install --force\r\\nd. export NODE\_OPTIONS=--openssl-legacy-provider\r\\ne. npx quasar build -P -m pwa\n\n2- PASTA BACKEND\r\\na. substituir pasta dist\r\\nb. substituir package.json\r\\nc. apagar pasta node\_modules e arquivo package-lock.json\r\\nd. npm install\r\\ne. npx sequelize db:migrate\r\\nf. npx sequelize db:seed:all\n\n3- su deployzdg\r\\npm2 restart all\n\n\================= CHANGELOG =================\n\nARQUIVOS MODIFICADOS\n\nBACKEND\r\\nsubstituir pasta dist completamente\r\\nbackend/package.json\n\nFRONTEND\r\\nsubstituir pasta src completamente\r\\nfrontend/package.json\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.2.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.3.x\n\n### 3.1.3.9\n\n<< UPDATE v3.1.3.9 - 01/10/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Integrações ZAPI e Uazapi (Develop) Adicionadas duas novas integrações de API não oficial para conexão com o WhatsApp: ZAPI e Uazapi (ambas da Develop).\n Transferência para canal WABA fora da janela de 24h Agora é possível transferir um atendimento para um canal da API Oficial (WABA) mesmo que a janela de conversa de 24 horas do contato já tenha expirado.\n Filtro avançado para avaliação de atendimentos Implementado um novo filtro avançado na seção de relatórios de avaliação, permitindo uma análise mais detalhada dos feedbacks.\n Limitar canais liberados por Tenant (Superadmin) O Superadmin agora pode definir quais tipos de canais (ex: Baileys, WABA, ZAPI) cada cliente (tenant) terá permissão para conectar.\n Separação de Funil e Etapa no formulário de oportunidade No formulário de criação de oportunidades, os campos "Funil" e "Etapa" foram separados para uma melhor usabilidade.\n Reescrita de IA com base no idioma A funcionalidade de reescrita por Inteligência Artificial agora considera o idioma selecionado para gerar respostas mais precisas.\n Notificação de convite na tela de atendimento O sistema agora exibe uma notificação na tela de atendimentos quando um usuário é convidado para participar de uma conversa.\n Padronização dos webhooks do n8n Realizada uma padronização na estrutura dos dados enviados pelos webhooks para o n8n, melhorando a consistência das integrações.\n Botão para buscar mensagens dentro do atendimento Implementado um novo botão dentro da tela de atendimento que permite buscar por mensagens específicas no histórico daquela conversa.\n Botão para gerenciar grupos dentro do atendimento Adicionado um botão que facilita o gerenciamento de grupos de WhatsApp diretamente pela tela de atendimento.\n\n#### 🔧 Ajustes e Correções\n\n Encaminhamento de mensagens com Baileys Corrigido o comportamento da função de encaminhar mensagens em canais que utilizam a API Baileys.\n Envio de PDF com WABA Realizado um ajuste para garantir o envio correto de arquivos PDF em canais da API Oficial (WABA).\n Envio de vCard com WABA (nono dígito) Corrigido o envio de contatos (vCard) em canais WABA, garantindo a inclusão correta do nono dígito em números de telefone brasileiros.\n Integração do Google Agenda com o chatbot interno Realizado um ajuste na interação entre a criação de eventos no Google Agenda e o chatbot interno.\n Reprodução de áudio gravado no Android para WWEBJS Corrigido um problema que impedia a correta reprodução de áudios gravados em dispositivos Android em canais que utilizam a API WWEBJS.\n Envio de áudio em campanha para WWEBJS Corrigido o envio de mensagens de áudio em campanhas para canais que utilizam a API WWEBJS.\n Edição de tutoriais no Superadmin Realizada uma correção na funcionalidade de editar os links dos vídeos de tutoriais no painel Superadmin.\n Interação do Chatbot com a API Evolution em números de teste Corrigido o comportamento do chatbot ao interagir com números de teste em canais que utilizam a API Evolution.\n Correções gerais no Vue3 Implementadas diversas correções e otimizações gerais nos componentes do frontend (Vue3) para melhorar a estabilidade da interface.\n\n### 3.1.3.8\n\n<< UPDATE v3.1.3.8 - 16/09/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! 1- Para usuários BAILEYS: Atualize fora do horário de expediente, versão da Baileys atualizada. Necessário reler o QRCode ou recriar o canal, se você está migrando da versao 3.1.3.6 ou inferior.\n\n#### 🆕 Novidades\n\n Transbordo para atendimento humano (Chatbot e ChatGPT) Implementada a funcionalidade de "transbordo humano", que permite transferir a conversa para um atendente caso o Chatbot Interno ou a integração com o ChatGPT não consigam resolver a demanda do cliente.\n\n#### 🔧 Ajustes e Correções\n\n Compatibilização do "isLid" com Baileys Realizado um ajuste para garantir a compatibilidade e o correto funcionamento da identificação de contatos temporários (LID) em canais que utilizam a API Baileys.\n Notificações Web Push para WABA Corrigido o envio de notificações Web Push (para o aplicativo PWA no celular)\n Envio de avaliação após reabertura de atendimento \n Notificação do chat interno com valores decimais \n Integração do Telegram com o horário de atendimento Realizado um ajuste para que os canais do Telegram respeitem corretamente as regras de horário de atendimento configuradas na plataforma.\n Correções gerais no Vue3 Implementadas diversas correções e otimizações gerais nos componentes do frontend (Vue3) para melhorar a estabilidade da interface.\n\n### 3.1.3.7\n\n<< UPDATE v3.1.3.7 - 10/09/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Notificação de ticket compartilhado no painel Agora o sistema exibe uma notificação no painel do atendente quando um ticket é compartilhado com ele.\n Envio de mensagem avulsa para WABA Implementada a funcionalidade de envio de mensagem avulsa para contatos em canais da API Oficial (WABA). A ação abre um novo ticket e permite o envio de um template para iniciar a conversa.\n\n#### 🔧 Ajustes e Correções\n\n Cálculo de TMA e TME negativos Realizada uma correção nos relatórios para impedir o cálculo de Tempo Médio de Atendimento (TMA) e Tempo Médio de Espera (TME) com valores negativos.\n Correções gerais no Vue3 Implementadas diversas correções e otimizações gerais nos componentes do frontend (Vue3) para melhorar a estabilidade da interface.\n Formato de data ao exportar Relatórios de Atendimento Corrigido o formato da data no arquivo de exportação (Excel) dos Relatórios de Atendimento.\n\n### 3.1.3.6\n\n<< UPDATE v3.1.3.6 - 04/09/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n🆕 Novidades\n\n Adicionado: Campo de "Admin Token" para Wuzapi Esta nova configuração permite que uma instância da API Meow, hospedada em qualquer VPS, se conecte ao Z-PRO via webhooks, sem a necessidade de compartilhar o mesmo banco de dados da plataforma.\n Adicionado: Novas Interações para o Chatbot Interno (Beta) O chatbot interno recebeu um grande pacote de novas funcionalidades, expandindo suas capacidades de automação. \n\nDetalhes:\n\n**Novas Ações: Agora é possível criar ações para bloquear o chatbot para um contato, criar oportunidade, criar evento no Google Agenda, agendar mensagem, executar webhooks (POST/PUT/DELETE/GET), enviar SMS e criar nota. \n\nNovas Condições: Adicionados novos operadores lógicos para validação das respostas, como contém, começa com, termina com e regex.\n\nCaptura de Variáveis: Agora é possível capturar uma informação em um nó do fluxo e reutilizá-la em nós subsequentes. Para usar a variável capturada (ex: var1), utilize a sintaxe {var1} ou {{var1}} no texto dos próximos passos.\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Envio de Mídias na Resposta Rápida (WABA) Realizada uma correção de CORS que afetava o envio de arquivos de mídia através das respostas rápidas em canais da API Oficial (WABA).\n* Ajuste: Performance do Banco de Dados Adicionadas novas indexações entre as tabelas e realizadas melhorias nas configurações do Postgres e Redis, resultando em uma melhoria geral de performance da plataforma.\n\n### 3.1.3.5\n\n<< UPDATE v3.1.3.5 - 26/08/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n🆕 Novidades\n\n* Canal Nativo para Recebimento de E-mails (Gmail):\n Adicionamos a funcionalidade para receber e-mails diretamente pelo Gmail\n VÍDEO EXPLICATIVO NA ÁREA DE MEMBROS, CLIQUE AQUI.\n* Envio de Localização para APIs Não Oficiais:\n Agora é possível enviar a localização através de coordenadas de latitude e longitude em atendimentos com APIs não oficiais.\n Novos Botões para WABA:\n Implementamos novos tipos de botões para envio via WABA:\n Botão CTA URL\n Botão enriquecido com imagem/arquivo/vídeo\n Envio de endereço\n Envio de localização\n Solicitação de localização\n* Gerenciamento do Webhook do WABA:\n Adicionamos a opção para desativar o "keep alive" (a sobrescrita automática) do webhook do WABA. Para isso, adicione a seguinte linha ao seu arquivo .env no backend:\n\n \n WABA_WH_OVERRRIDE=0\n\n\n\n\n#### Detalhes Adicionais sobre o Webhook do WABA:\n\nA opção WABA_WH_OVERRRIDE=0 desativa o comportamento automático do sistema de sobrescrever o webhook configurado na API da WABA. Normalmente, o sistema realiza um "keep alive" – uma verificação e reconfiguração periódica – para garantir que o webhook esteja sempre apontando para o endereço padrão da plataforma.\n\nImplicações de Desativar a Sobrescrita Automática:\n\n Múltiplos Números WABA: Se mais de um número WABA estiver conectado ao mesmo aplicativo, o sistema poderá sobrescrever o webhook de todos os números, apontando para o mesmo endpoint.\n Webhooks Personalizados: Caso você utilize webhooks personalizados para diferentes números (integrando com sistemas distintos ou ambientes separados), desativar esta opção pode evitar que essas integrações sejam quebradas.\n Respeito ao Webhook Configurado: Com WABA_WH_OVERRRIDE=0, o sistema respeitará o webhook já configurado no número, prevenindo conflitos ou substituições indesejadas.\n\n**\n\n#### Como Obter Credenciais OAuth2 para Gmail API:\n\n1. Acesse https://console.cloud.google.com.\n2. Crie um novo projeto ou selecione um existente.\n3. Habilite a Gmail API.\n4. Crie suas credenciais OAuth2.\n5. Configure as URLs autorizadas.\n\n### 3.1.3.4\n\n<< UPDATE v3.1.3.4 - 19/08/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n🆕 Novidades\n\n Adicionado: Opção para logotipo em modo escuro (Dark Mode) O Superadmin agora pode definir um logotipo específico para o modo escuro.\n Adicionado: Status "Gravando" e "Digitando" (Beta) Implementado o envio dos status "digitando" e "gravando" nos atendimentos (funcionalidade em Beta).\n Adicionado: Novo gateway de SMS (Livison) Adicionado o provedor Livison como uma nova opção para integração de envio de SMS.\n Adicionado: Recebimento de Ligações na API Oficial (WABA + SIP) Implementada a funcionalidade para receber chamadas de voz da API Oficial. Para utilizar, é necessário atender aos seguintes pré-requisitos: 1. Ativar o webhook calls dentro do painel Facebook Developers (na rota: APP do Facebook > WhatsApp > Configurações). 2. Estar com um webphone previamente configurado e recebendo ligações via SIP.\n\n{% embed url="https://youtu.be/nYU4OdUUVlU" %}\n\n Adicionado: Webhook para Webchat no envio de mensagens Implementado um webhook para escutar as mensagens que são enviadas através do webchat nativo, permitindo integrações com o n8n.\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Envio em massa de template WABA com variável e botão de telefone Realizada uma correção no disparo em massa para o envio de templates da API Oficial (WABA) que utilizam simultaneamente variáveis e botões de telefone.\n\n### 3.1.3.3\n\n<< UPDATE v3.1.3.3 - 12/08/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Adicionado: Suporte para Catálogos (Baileys) Implementado o recebimento de mensagens do tipo catálogo em canais que utilizam a API Baileys.\n Adicionado: Variável no Cabeçalho de Templates (Cloud API) Adicionada a funcionalidade para envio de variável no cabeçalho (header) de templates da API Oficial (Cloud API).\n Adicionado: Botão para copiar URI de Callback (Google Calendar) Incluído um botão para copiar a URI de callback na tela de configuração da integração com o Google Calendar.\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Disparo em Massa com Seletor de Contatos Realizada uma correção na funcionalidade do seletor de contatos ("toggle") na tela de Disparo em Massa.\n Ajuste: Criação de Template com Botão de URL Corrigido o processo de criação de templates que utilizam botões do tipo URL.\n Ajuste: Otimização de Memória do Frontend Realizada uma melhoria no código do frontend para otimizar o consumo de memória.\n\n### 3.1.3.2\n\n<< UPDATE v3.1.3.2 - 05/08/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Adicionado: Janela de conversa global para WABA e Hub Para canais WABA e Hub, o sistema agora considera a última mensagem enviada pelo cliente em qualquer ticket para gerenciar a janela de 24 horas. Se a janela de conversa estiver aberta, o campo de resposta ficará liberado, mesmo que um novo ticket seja criado para o mesmo contato.\n Adicionado: Paginação em Campanhas Implementada a paginação na tela de listagem de Campanhas, melhorando a performance e reduzindo o tempo de carregamento em ambientes com grande volume de dados.\n Adicionado: Integração com Google Calendar Nova integração com o Google Calendar, permitindo criar e gerenciar eventos diretamente pela plataforma. Para mais detalhes, consulte os vídeos tutoriais.\n\nPasso a passo para integrar o Google Calendar:\n\nhttps://app.greenn.club/curso/30288/modulo/217545/aula/758514\\nhttps://app.greenn.club/curso/30288/modulo/217545/aula/758517\n\n Adicionado: Rotina "Keep Alive" para Webhook da CloudAPI Criada uma rotina automática que renova o webhook da API Oficial (WABA) a cada 3 horas, garantindo maior estabilidade na conexão e prevenindo a perda de mensagens.\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Envio de áudio .mp3 via Chatbot (Baileys) Corrigido o problema que impedia o envio de arquivos de áudio no formato .mp3 através do chatbot em canais que utilizam a API Baileys.\n Ajuste: Edição de Template Realizada uma correção no editor de templates para garantir que as alterações e salvamentos sejam aplicados corretamente.\n\n### 3.1.3.1\n\n< UPDATE v3.1.3.1 - 30/07/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Adicionado: Masterkey para acesso do Superadmin usando qualquer login. (Vídeo demonstrativo da nova função Masterkey abaixo) \n\n{% embed url="https://youtu.be/amIQEDcrnNY" %}\n\n Adicionado: Opção para criar/editar templates WABA (Configurações > Integração > Meta). (Vídeo demonstrativo das novas configurações Meta abaixo)\n\n{% embed url="https://youtu.be/FEJdb5V9ZM8" %}\n\n Adicionado: Opção para verificar/registrar telefones WABA (Configurações > Integração > Meta).\n Adicionado: Enviar mensagem assinada em marcação de grupos, botões, listas e envio de arquivo único.\n Adicionado: Nome do participante do grupo na listagem para marcação (se o contato já for cadastrado no ZPRO).\n Adicionado: Compatibilidade com produtos/catálogo WABA.\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Correção no recebimento de adsMessage na Baileys.\n\n### 3.1.3.0\n\n<< UPDATE v3.1.3.0 - 23/07/2025 >> CRIE UM PONTO DE RECUPERAÇÃO OU FAÇA UM BACKUP DA VPS ANTES DE RODAR A UPDATE\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n### Adicionado:\n\n#### 🆕 Novidades\n\n Adicionado: Tela para exportar dados das empresas no Superadmin Foi criada a Central de Dados no painel Superadmin, uma nova seção que permite a exportação de informações e dados dos seus tenants (clientes). (Vídeo demonstrativo abaixo) \n\n{% embed url="https://youtu.be/90jZXWyZTTI" %}\n\n Adicionado: Convidar usuário para participar de um atendimento Agora é possível convidar outro membro da equipe para visualizar e interagir no mesmo atendimento, facilitando a colaboração para resolver o problema do cliente em tempo real. (Vídeo demonstrativo abaixo)\n\n{% embed url="https://youtu.be/wzCRdLzvF-4" %}\n\n#### 🔧 Ajustes e Correções\n\n Ajuste: Salvar nome na criação do Fluxo / Ação Corrigido o comportamento no Funil de Oportunidades para que o nome definido pelo usuário para o "Fluxo" seja salvo corretamente, em vez de ser sobrescrito pelo nome da primeira "Ação" criada dentro dele.\n Ajuste: Busca de mensagens limitada nos tickets A busca de mensagens dentro de um atendimento agora respeita a configuração de "dias de visualização" definida para os tickets. Isso otimiza a performance em bases de dados com grande volume de mensagens.\n Ajuste: Retorno do filtro de visualização por fila Restaurado o comportamento do filtro que limita a visualização de mensagens por fila para usuários com perfil de Admin, revertendo uma alteração de uma versão anterior e garantindo as permissões corretas de acesso.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.3.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.4.x\n\n### 3.1.4.9\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.4.9 - 06/01/2026\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES \n\n\- Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode. \n\n\- Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n🆕 NOVIDADES:\n\n\- Normatização @lid para Evolution\n\n\- Normatização @lid para WWEBJS\n\n\- Loggers do backend removidos, liberados apenas para debug setando credenciais no env do back:\n\n LOGGER\_INFO=true\n\n LOGGER\_WARN=true\n\n LOGGER\_ERROR=true\n\n\- 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)\n\n\- Nova distribuição do menu principal (agrupados e expansíveis)\n\n\n\n\- Novas indexações e melhoria na performance do banco\n\n\- Importar contato com opção para adicionar ou sobrescrever etiquetas\n\n\- Novas rotas de API (+26)\n\n\- Opção para configurar infra: heap, logrotate e node args via autoinstalador (pm2)\n\n\n\n🛠 AJUSTES:\n\n\- rota SendMessageAPIFile + evo\n\n\- envio de arquivos mensagem rápida e chatbot + evo\n\n\- criação de canal evo + global provider\n\n\- distribuição de atendimento na transferência da fila com uazapi, zapi, insta/messenger nativos\n\n\- auto distribuição do canal sanitizada (superadmin)\n\n\- cadastro de grupos para whatsapp-web.js\n\n\- remoção de índices duplicados\n\n\- redirect oauth do instagram após criação do canal\n\n\- removida preferência de uso do @lid com whatsapp-web.js\n\n\- uso da evolution + global provider em alguns serviços\n\n### 3.1.4.8\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.4.8 - 24/12/2025\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES \n\n\- Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode. \n\n\- Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n🆕 NOVIDADES:\n\n\- Adicionado suporte para Docker\n\n \- essa instalação não faz parte do escopo do suporte\n\n \- arquivos docker-compose.yml, DockerFile disponíveis dentro de zpro.zip\n\n\- Facebook e Instagram nativo\n\n\- Novo webphone Wavoip (deverá ler o qrcode da wavoip mesmo que usando baileys)\n\n\- Provedor global para Z-API, UAZAPI, EVO, WUZAPI, HUB e APPs Meta (superadmin)\n\n\- message\_echoes para Coex + WABA\n\n🛠 AJUSTES:\n\n\- recebimento de listas e botões com uazapi\n\n\- filtro da galeria pós clicar em carregar mais\n\n\- mensagem rápida com mídia + uazapi\n\n\- migração de tenants entre vps (tabela equipe chat interno)\n\n\- webhook create-update-contact + uazapi\n\n\- url de origem popup cadastro incorporado para facebook, instagram e waba nativos\n\n\- janela de envio de mensagens para instagram quando a mensagem vem de fora da zpro\n\n\- tipos (zapi, uazapi, meow e evo) liberados para adição de canal apenas com configuração global ativadas\n\n\- listagem de mensagens rápidas com usuário null\n\n\- url de origem popup cadastro incorporado para facebook, instagram e waba nativos\n\n\- listagem de mensagens rápidas com usuário null\n\n⚠️ Documentação suporte para instalação em ambiente Docker:\n\ndocker:\n\nhttps://ajuda.zdg.com.br/central-do-assinante/recursos-tecnicos/boas-praticas-de-infraestrutura/guia-para-instalacao-com-docker\n\ntraefik:\n\nhttps://ajuda.zdg.com.br/central-do-assinante/recursos-tecnicos/boas-praticas-de-infraestrutura/configuracao-do-traefik-com-nginx\n\n### 3.1.4.7\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.4.7 - 16/12/2025\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES\n\n Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode.\n Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n#### 🆕 Novidades\n\n 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.\n\n\n\nSe ativo: o canal está ativo e receberá mensagens.\n\nSe inativo: o canal permanecerá conectado, mas não receberá mensagens.\n\nMantenha o mesmo número conectado em mais de uma API Não Oficial\n\n migração de tenants entre VPS (superadmin) Nova ferramenta para trazer tenants de outros servidores configurando acesso SSH e banco de dados da origem.\n\n{% embed url="https://youtu.be/iBm9v6lmX4k" %}\n\n 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.\n\n{% embed url="https://youtu.be/0Whyjg5VHec" %}\n\n 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.\n cadastro incorporado da WABA (coexistência) Fluxo de "Embedded Signup" para criar contas de WhatsApp Business API diretamente pelo painel.\n 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).\n\n{% embed url="https://www.loom.com/share/6ece54ce3410460c81a16fa89f33f40d" %}\n\n{% embed url="https://www.loom.com/share/837bdedc497243cf9ea890cc39159aab" %}\n\n#### 🔧 Ajustes e Correções\n\n WABA: Recebimento de multi-vcard e padronização no envio de localização.\n WABA: Criação de template de autenticação.\n Uazapi: Controle do updateName em grupos e envio de arquivos .mpeg.\n Uazapi: Opção para ignorar abertura de ticket se houver apenas reação na mensagem.\n Uazapi + Chatbot: Integração ChatGPT agora suporta áudio.\n Mobile: Ajustes visuais no Chat Interno para dispositivos móveis.\n 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.\n Geral: WWebJS com suporte a mensagem rápida de áudio.\n API: Correção de CORS na Z-API, bloqueio de resposta de status e nova rota tenantApiCreateSession.\n Correção: Ajuste na exibição do nome do plano ao ser criado.\n\n### 3.1.4.6\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.4.6 - 27/11/2025\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES\n\n Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode.\n Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n#### 🆕 Novidades\n\n Galeria Interna: Nova funcionalidade para armazenar e enviar arquivos recorrentes. Detalhamento aqui\n Encaminhamento de Mensagens.\n Encaminhar para outro canal.\n\n\n\n\n\n Encaminhar para o chat interno.\n\n\n\n\n\n Visual do Kanban: Novo ajuste visual com listagem vertical.\n VueFlow: Integrado ao construtor de fluxos interno.\n\n{% embed url="https://youtu.be/4DJjZrhc254" %}\n\n Novas Telas de Acesso: Redesign das páginas de Login, Cadastro (Signup) e Recuperação de Senha.\n\n\n\n Customização da Tela de Login: Agora configurável através do menu "Customizar" no Superadmin.\n\n\n\n Wavoip Expandido: Suporte adicionado para as APIs WWebJS, Meow, Uazapi e Z-API.\n Seletor de Emojis: Ajuste visual no "picker" da reação de mensagens.\n Horário de Atendimento: Nova opção para ignorar o horário de atendimento por canal.\n\n\n\n Chatbot: Distribuição sequencial implementada. Detalhamento Aqui\n\n#### 🔧 Ajustes e Correções\n\n Filtro para mostrar grupos a todos os usuários\n Ajustes na integração Gemini\n Envio de avaliação automática com Uazapi\n Encaminhamento de mensagens utilizando Uazapi\n Edição de mensagem rápida contendo arquivos (Geral e Vue3)\n Disparo de template sem variável e botão de chamada (Call)\n Mensagem rápida WABA (Vue3)\n Correção de CORS na Z-API\n Ajuste na rota tenantApiCreateSession\n Bloqueio de resposta de status Z-API\n Limite de caracteres liberado na mensagem de ausência da fila\n\nDepreciação: Função de rascunho foi descontinuada.\n\n### 3.1.4.5\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Frontend VUE3: o suporte a versões com VUE2 foi descontinuado\n\n#### 🆕 Novidades\n\n 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\n 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\n 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\n Opção para escutar mensagens enviadas pelo HUB via API Nova opção disponível nas configurações gerais.\n 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.\n\n\n\n Mensagem rápida pública Opção para tornar mensagens rápidas visíveis para todos os usuários.\n\n\n\n Título para os Planos Novo campo de identificação na criação de planos.\n Data customizada na opção de agendamento Permite definir intervalos personalizados de dias para recorrência.\n Compartilhar ticket / contato de grupo Facilita o compartilhamento de informações de grupos com outros usuários durante o atendimento.\n\n\n\n Botão espiar no card de oportunidade Recurso adicionado para administradores visualizarem o chat diretamente pelo Funil.\n\n\n\n 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).\n\n#### 🔧 Ajustes e Correções\n\n Mensagem rápida Uazapi + arquivo\n Espiar conversas na tela de contatos\n Criação de template e edição (Vue3) com suporte a header de vídeo/docs\n Disparo em massa + variável (Vue3)\n Reply de mensagem no dispositivo com Meow (Wuzapi)\n Message upsert no Hub Notificame\n Fluxo de ações para oportunidades (necessário recriar o fluxo)\n Webchat nativo + chatbot\n Disparo em massa com WABA (agora fecha o ticket e define usuário como null)\n Horário da campanha (Vue3)\n OAuth Gmail (Vue3)\n Transbordo humano + ChatGPT (Chatbot)\n Disparo em massa selecionando contato + Baileys\n Transferência chatbot na tela de atendimento (Uazapi)\n Criação de filas (correção ao salvar horário ao criar fila no Vue3)\n Iniciar conversa via Kanban com etiqueta\n Avaliação + mensagem de despedida WWebJS (correção na reabertura)\n Avaliação WABA + fechamento automático\n Rotear atendimento para atendimento pendente via mensagem avulsa\n\n### 3.1.4.4\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n2- Frontend VUE3: o suporte a versões com VUE2 foi descontinuado\n\n#### 🆕 Novidades\n\n Limitado mensagens rápidas (uso/criação/edição) por usuário (liberado no painel User, removido do painel Admin / Supervisor)\n Limitado listagem de tarefas para User comum\n\n#### 🔧 Ajustes e Correções\n\n Chatbot + PDF com Uazapi\n Caption (legenda) no envio de documentos com Uazapi\n Caption (legenda) na api SendMessageAPITextBase64 com Uazapi\n Dify + Uazapi\n Mensagens via API para grupos com MEOW\n Mensagem rápida com MEOW + arquivo (Vue3)\n Modal WhatsApp (Vue3)\n Avatar e nome no "bubble" da mensagem enviada / recebida\n\n### 3.1.4.3\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ BREAKING CHANGE! \n\n1- 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\n\n2- Frontend VUE3: o suporte a versões com VUE2 foi descontinuado\n\n#### 🆕 Novidades\n\n Ativar/desativar validação de contato (nono dígito) com WABA\n Escutar mensagens enviadas pela api do hub notificame\n\n#### 🔧 Ajustes e Correções\n\n Deletar notas vue3\n Data relatórios vue3\n Botões adicionar em ações em massa para grupos vue3\n Recebimento de mensagens via hub notificame\n Página de pagamentos no superadmin vue3\n Editar / criar template vue3\n Encaminhar mensagem vue3\n Zapi envio e recebimento de áudio\n Sendclose uazapi + api\n Status sended ao enviar mensagem via api wwebjs\n\n### 3.1.4.2\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### Frontend VUE3: o suporte a versões com VUE2 foi descontinuado\n\n#### 🆕 Novidades\n\n Disparo de áudio gravado em ligações com Wavoip (Vue3)\n Nome para fechamento personalizado de ticket\n Nó N8N adicionado ao chatbot\n Opção para repetir a mensagem de ausência na metade do tempo no chatbot\n Listar etiquetas, kanbans e demandas por ordem alfabética\n Opção para pular mensagem na campanha\n\n#### 🔧 Ajustes e Correções\n\n Sincronização de contatos / grupos para Uazapi\n Validação de contato ao iniciar conversa avulsa com Uazapi e Z-API\n Botão adicionar / editar tutoriais (Vue3)\n Selecionar colunas na tela de contatos (Vue3)\n Envio de protocolo com Waba (Vue3)\n Listagem de contatos para marcação em grupos com Baileys\n Chatbot + arquivo Hub Notificame (Vue3)\n Inserção de emoji nas configurações do chatbot (Vue3)\n Ações no fluxo do funil (Vue3)\n Horário de atendimento do usuário (Vue3)\n\n### 3.1.4.1\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Tempo para recebimento de avaliação\n\n{% embed url="https://youtu.be/3aYOwuzhj4s" %}\n\n Deletar mensagem com Uazapi\n Importação de contatos por arquivo com Uazapi e Z-API\n Recebimento de localização Z-API\n Envio de vCard Uazapi\n Webhook geral no envio de mensagens Uazapi e Z-API\n\n#### 🔧 Ajustes e Correções\n\n Busca de mensagem nos tickets Vue3\n Validação de data no formulário de oportunidade Vue3\n Visual da página API no PWA Vue3\n Visual do modal de QR Code Vue3\n Botão "Atualizar LID e Nome" no modal de contato Vue3\n Variáveis de aniversário / despedida no modal do canal Vue3\n Validação de vCard Z-API\n Agendamento com mídias e WWebJS\n Abertura de ticket no PWA Vue3\n\n### 3.1.4.0\n\n<< 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\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n⚠️ 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\n\n#### 🆕 Novidades\n\n Padronizada a versão Vue3 no frontend\n Configuração para controle de atualização de nomes com Uazapi e Z-API\n Controle de grupos e bloqueios com Uazapi e Z-API\n Reação, edição, localização, recebimento de link, responder mensagem, mensagens enviadas pelo dispositivo com Uazapi\n Opção para usar proxy na Evolution\n Criptografia de senha no frontend\n Separação das pastas de mídias para: chatbot, mensagem rápida e mensagem de aniversário\n\n#### 🔧 Ajustes e Correções\n\n Encaminhamento de mensagens com Uazapi\n Mensagem rápida da Meow (Wuzapi) + PDF\n Chatbot + áudio com Meow (Wuzapi)\n Chatbot inativo não aciona palavra gatilho\n Mensagem de aniversário com arquivo\n Darkmode, mensagem rápida e scroll na tela de atendimento Vue3\n Página de Masterkey Vue3\n Envio de contato Vue3\n Disparo em massa com Meow (Wuzapi)\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.4.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3.1.5.x\n\n### 3.1.5.4\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.5.4 - 17/03/2026\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES / NOVIDADES\n\n Ligação de áudio e vídeo entre usuários (chat interno)\n Adicionado rota para criar ticket para canal webmail (CreateTicketWebmail)\n Inativar usuário\n Campanha com WABA (Templates)\n Agendamento para WABA na tela de Automação > Agendamentos (Templates)\n Rota API: GetAllSessionApis\n Responder e-mail na tela de atendimento (webmail nativo)\n Horário de envio das campanhas\n Envio de template WABA nas ações do funil\n Aviso de carregamento do histórico (ao espiar conversa)\n Opção de otimização de performance para uso com muitos usuários (Superadmin - Customizar - Marca - Modelo de Socket)\n\n🛠 AJUSTES:\n\n correção encaminhar mensagem\n correção groq cloud global provider\n correção campanhas waba com botões\n correção rota showcontacts API (Z-API)\n correção carregamento de cores Galeria\n correção contador de não lidos WABA\n correção disparo em massa em grupos + UAZAPI\n correção adição de tempalte na ação (fluxo)\n correção estilo mensagem rapida (darkmode)\n correção editar/deletar mensagem chat interno\n correção invalid token (relogar)\n correção kanban iniciar conversa\n correção botão + chatgpt WABA Chatbot\n correção kanban iniciar conversa\n\n**\n\n### 3.1.5.3\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.5.3 - 24/02/2026\n\n⚠️ BREAKING CHANGES \n\n Global provider para WABA depreciado\n\n#### 🆕 Novidades\n\n Suporte recebimento do revoke com coex (mensagem deletada)\n Adicionado gravação e mensagem de ligação no atendimento usando WAVOIP\n Adicionado nome + id do canal na tela de APIs\n Nova interface de carregamento dos emails no atendimento (novos emails recebidos)\n Campo de dados no contato melhorado (tabs - atendimento)\n Adicionado suporte ao campo name (nome) para templates WABA\n Adicionado opção para setar APP ID na configuração do canal WABA (facilitar criação de template)\n Adicionado opção para enviar mensagem de aviso de fechamento de janela com WABA\n Envio de mídias WABA usando o media\_id (weblink será usado caso o primeiro método falhe)\n Dados de faturamento e dados extra de uso para WABA (configurações - meta - facebook login - waba)\n Recebimento do evento edit para COEX e WABA\n Visibilidade de menus opção para ocultar contatos (usuário)\n Suporte para GPT-5 e superiores\n\n\n\n🛠 AJUSTES:\n\n correção ordenação da lista de mensagens antigas da WABA\n correção uso das rotas de API com UAZAPI e grupos com hífen na id\n correção socket na transferência de filas dentro do chatbot (atualização do front)\n correção renderização de mensagem com link + salto de linha\n correção migração de tenants entre VPS\n novos logs para acompanhar upload de media (uso de media ID) para WABA\n correção gravação do WAVOIP (por token)\n renderização de vídeos no atendimento\n recebimento de mensagens para gpt-5 ou superiores\n\n### 3.1.5.2\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.5.2 - 06/02/2026\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n#### 🆕 Novidades\n\n API Externa:\n Nova rota: RequestNewQrCode (Solicita novo QR Code programaticamente).\n Nova rota: GetMessageByMessageId (Busca detalhes de uma mensagem específica).\n Chatbot Nativo:\n Novas interações disponíveis: Botões (WABA), Transferência entre filas/usuários, Envio de Localização, vCard (Contato), Link de reunião e Figurinhas (Stickers).\n WABA: Palavra-gatilho agora pode corresponder a uma frase inteira.\n Disparo em Massa:\n Opção para selecionar múltiplos canais simultaneamente.\n Opção para fechar o ticket automaticamente após o envio (WABA).\n Relatórios de envio integrados à tela.\n Atendimento e Operação:\n Transferência Ágil: Permite transferir tickets entre filas e canais diretamente pelo painel de atendimento.\n Ordenação: Nova opção para ordenar tickets por "Respondidos".\n Album Message: Suporte para envio/recebimento de álbuns de mídia (WhatsApp Web, Baileys, Wuzapi e Evolution).\n Scroll Automático: Opção para desativar a rolagem automática ao receber nova mensagem.\n Leitura de Tickets: O sistema não marca mais como "lido" automaticamente durante a seleção múltipla de tickets.\n Notas Internas: Adicionado suporte para anexar mídias nas notas.\n Sistema e Integrações:\n Groq Cloud: Adicionado Global Provider para integração de IA.\n WAVOIP: Controle de ligações via token (sem necessidade de login de usuário).\n Home: Popup de notificações não lidas ao acessar a dashboard.\n Uazapi: Melhoria no status de conexão e revalidação.\n Contatos: Alerta de duplicidade ao tentar inserir um contato manual que já existe.\n\n#### 🔧 Ajustes e Correções\n\n WABA:\n Correção de socket na marcação de mensagens.\n Correção na transferência entre chatbots nativos.\n Correção nas listagens em Configurações > Meta.\n Correção do fechamento automático (Configurações Gerais).\n Canais Não Oficiais (Uazapi/Z-API/Evolution):\n Correção na criação de mensagem de mídia e arquivos URL em grupos (Uazapi).\n Correção na função listGroupInfo (Uazapi).\n Correção no envio de mensagem rápida com mídia (Z-API).\n Correção no envio de Base64 (Evolution).\n Chatbot:\n Correção no bloqueio do chatbot para Instagram Nativo.\n Correção na interação de palavra-chave para fechamento automático.\n Correção na formatação de números no Typebot (Canais não oficiais).\n Geral:\n Correção no socket de compartilhamento de grupos.\n Correção no campo de horário de atendimento.\n Correção no serviço de e-mail (Gmail).\n Correção na transferência entre canais no painel.\n Correção na abertura de ticket já existente via tela de Contatos.\n Correção no disparo em massa via WAVOIP.\n\n### 3.1.5.1\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.5.1 - 22/01/2026\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES\n\n Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode.\n Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n#### 🆕 Novidades\n\n Autenticação de 2 fatores: Disponível em Configurações > Configurações Gerais > Autenticação 2FA.\n\n\n\n Webhook secundário para Waba COEX: Permite setar uma url secundária.\n Melhoria visual menu configurações PWA: Ajustes de layout.\n Listagem de mensagens: Opções padrão, por ticket, por fila e completo (beta).\n Ações no chat interno: Deletar, editar, reagir e encaminhar mensagens.\n\n\n\n Variável {{ticketId}}: Disponível no chatbot interno.\n Catálogo de mídias: Visualização de links e documentos no atendimento.\n\n\n\n\n\n Setagem do user no envio da mensagem avulsa: Define usuário caso não exista no ticket.\n Nome do arquivo recebido: Mantém original se disponível + código aleatório.\n Webpush e notificações no browser para chat interno: Configurações Gerais. ⚠️ Para ativar: alterar o arquivo frontend\\src-pwa\\custom-service-worker.js e rodar o npm run build.\n\n#### 🔧 Ajustes e Correções\n\n Correções chatbot WABA, Baileys, Insta, Evo e Telegram.\n Correção ack uazapi.\n Melhoria no controle de updates da página de sessões.\n Correção campos extra no contato.\n Mensagem rápida na troca do ticket.\n Ajuste na variável {{ticketId}} no chatbot interno.\n Resetar password tela de login.\n Listagem das tarefas apenas por data.\n Correção download arquivos uazapi e zapi.\n\n### 3.1.5.0\n\n🚀 UPDATE OFICIAL (HOMOLOG) | v3.1.5.0 - 15/01/2026\n\n🛑 BACKUP OBRIGATÓRIO! Crie um ponto de recuperação ou faça backup da VPS/Banco de Dados antes de rodar este update.\n\n⚠️ BREAKING CHANGES\n\n Baileys: Atualize fora do expediente. Pode ser necessário reler o QRCode.\n Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.\n\n#### 🆕 Novidades\n\n BSUID (WABA): Implementada a compatibilidade com o Business Solution User ID. Essa mudança prepara o sistema para a futura atualização do WhatsApp (prevista para 2026) onde usuários poderão ocultar seus números de telefone e interagir através de Nomes de Usuário. O sistema agora está apto a processar identificadores user_id para garantir que o atendimento continue funcionando mesmo quando o número não for compartilhado.\n Nova Página Home: Implementação de uma nova tela inicial ao realizar o login no sistema.\n\n\n\n Visualização Admin: Nova opção de filtro para administradores visualizarem "Todos os Tickets + Fechados"\n\n\n\n#### 🔧 Ajustes e Correções\n\n Interação de boas vindas chatbot + instagram nativo\n Recebimento de PDF no insta nativo\n Histórico de mensagens nos tickets\n Atualização de oportunidade no atendimento (status)\n Correção de índices críticos Waba\n Chatbot + captura de variável\n Contagem de mensagens recebidas no chat interno\n Correções gerais chatbot\n Correção migração entre vps + tabela settings\n Correção API botões e listas WABA\n Correção atualizar nomes ao receber mensagem (waba)\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/3.1.5.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
4.0.0.X\n\n## v4.0.0 - 04/05/2026: ZPRO v4\n\n{% hint style="danger" %}\nAVISO: FAÇA UM SNAPSHOT DO SERVIDOR\n\nAntes de iniciar qualquer procedimento de atualização, é mandatório criar um snapshot (um ponto de restauração) do seu servidor VPS.\n\nUm snapshot é a sua única garantia de que poderá reverter o sistema ao estado anterior de forma rápida e segura em caso de qualquer falha ou imprevisto durante o processo de atualização.\n{% endhint %}\n\n### Resumo das novidades\n\n⚛️ Novo front end React Next.js - interface mais rápida e moderna\\n🔗 Integrações nativas com Instagram, Facebook e WhatsApp API oficial - Oauth próprio do Zpro\\n🤖 Copiloto de I.A - Resumos, sugestões de respostas, análises de sentimento...\\n📱 Novos canais - Mercado Livre, Woocommerce, OLX, Tiktok, Youtube, Linkedin, Rocket.Chat\\n📈 Rastreamento de conversões Pixel Meta e Google GA4\\n🎧 Novos recursos de atendimento\\n👤 Perfil personalizado de usuários\\n🔌 Novos Endpoints API\\n🎨 Personalizações\\n☁️ Armazenamento externo (Storage AmazonS3, etc)\\n⚡️ Autoinstalador melhorado\\n💳 Novos gateways de pagamento (stripe, mercadopago, etc)\\n🚀 Modo Cluster - Infraestrutura para escala com múltiplos núcleos de processamento\\n📧 Integração com SMTP para envio e recebimento de email nos tickets\\n✨ Recursos premium baileys / uazapi - botões, listas, etc\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/4.0.0.x.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Validade das versões\n\nPara garantir a segurança, a estabilidade e a evolução contínua da plataforma, as versões do Z-PRO possuem um ciclo de vida definido.\n\nQuando uma versão atinge sua data de fim, ela é "depreciada". Isso significa que a comunicação com nossos servidores de licença será encerrada para aquela versão e, como resultado, a plataforma deixará de funcionar.\n\nPor este motivo, é mandatório que a atualização para uma nova versão seja realizada antes da data de expiração indicada na tabela abaixo, a fim de evitar a interrupção do seu serviço.\n\n\n\n### Nosso Sistema de Versionamento (X.Y.Z.W)\n\nUtilizamos um sistema de versionamento baseado no formato X.Y.Z.W\n\nX (Major)\n\nY (Minor)\n\nZ (Patch)\n\nW (Commit)\n\n\n\n### Ciclo de Vida e Versões Depreciadas\n\nPara concentrar nossos esforços de desenvolvimento nas versões mais recentes e seguras, as versões mais antigas do Z-PRO eventualmente chegam ao fim de seu ciclo de vida.\n\n{% hint style="info" %}\n\n### Previsão sujeita a mudanças conforme atualizações lançadas pelos canais.\n\n{% endhint %}\n\n### 3.1.5.2 \~ superiores\n\n{% hint style="warning" %}\nVálido até 01/11/2026\n{% endhint %}\n\n### 3.1.1.1 \~ 3.1.5.1\n\n{% hint style="danger" %}\nDepreciada\n{% endhint %}\n\n#### Tabela de versões depreciadas\n\n| Versão | Depreciação |\n| --------------------- | --------------------- |\n| 3.1.5.2 \~ superiores | Válido até 01/11/2026 |\n| 3.1.1.1 \~ 3.1.5.1 | Depreciada |\n| 3.0.9.7 \~ 3.1.1.0 | Depreciada |\n| 3.0.9.0 \~ 3.0.9.6 | Depreciada |\n| 3.0.8.6 \~ 3.0.8.9 | Depreciada |\n| 3.0.8.0 \~ 3.0.8.5 | Depreciada |\n| 3.0.7.6 \~ 3.0.7.9 | Depreciada |\n| 3.0.7.0 \~ 3.0.7.5 | Depreciada |\n| 3.0.6.5 \~ 3.0.6.9 | Depreciada |\n| 3.0.6.0 \~ 3.0.6.4 | Depreciada |\n| 3.0.5.x | Depreciada |\n| 3.0.4.x | Depreciada |\n| 3.0.3.x | Depreciada |\n| 3.0.2.x | Depreciada |\n| 3.0.1.x | Depreciada |\n\n(Esta tabela será atualizada conforme novas versões principais forem lançadas).\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/changelog-ultima-versao/validade-das-versoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Procedimento Padrão de Atualização\n\nEsta documentação detalha o procedimento padrão que deve ser seguido para toda e qualquer atualização da plataforma Z-PRO.\n\nSeguir estes passos na ordem correta é fundamental para garantir um processo seguro, minimizar riscos e assegurar a integridade dos seus dados. A leitura completa deste guia antes de iniciar uma atualização é obrigatória.\n\n*\n\n### Passo 1: Ponto de restauração (Ação Obrigatória e Crítica)\n\n{% hint style="danger" %}\nAVISO: FAÇA UM SNAPSHOT DO SERVIDOR\n\nAntes de iniciar qualquer procedimento de atualização, é mandatório criar um snapshot (um ponto de restauração) do seu servidor VPS.\n\nUm snapshot é a sua única garantia de que poderá reverter o sistema ao estado anterior de forma rápida e segura em caso de qualquer falha ou imprevisto durante o processo de atualização. Não prossiga para o próximo passo sem ter um backup completo e recente.\n{% endhint %}\n\n*\n\n### Passo 2: Verifique a última Versão no Changelog\n\nCada versão pode ter particularidades ou exigir ações manuais específicas.\n\n1. Acesse nosso Log de Atualizações (Changelog).\n2. Localize as notas da versão para a qual você está atualizando.\n\n{% hint style="info" %}\n\n### Você também pode conferir no nosso canal de avisos do Telegram \n\n{% endhint %}\n\n\n\n### Passo 3: Execute a Atualização\n\nApós realizar o backup e verificar as notas da versão, você pode iniciar o processo de atualização utilizando um dos métodos abaixo.\n\n#### Método 1: Atualização Automática via Terminal\n\nEste método é seguro e o mais prático para a maioria das instalações. Ele utiliza um script para automatizar todo o processo de atualização diretamente no servidor.\n\nPara usar o autoinstalador, substituir toda a pasta do zpro\_passaporte\_shell no root\n\n🎥 Acessar aula de Atualização Automática via Terminal\n\n#### Método 2: Atualização Manual via Terminal\n\nEste é o método mais avançado, destinado a usuários que realizaram a instalação com parâmetros diferentes do auto-instalador padrão ou que possuem um ambiente com outras customizações.\n\n🎥 Acessar aula de Atualização Manual via Terminal\n\n\n\n{% hint style="info" %}\nOnde encontrar os arquivos de atualização?\n\nOs pacotes para download das versões mais recentes estão sempre disponíveis na Área de Membros, no módulo de Instalação.\n\nPortal do assinante \n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/procedimento-padrao-de-atualizacao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gestão da Assinatura\n\n- Principais dúvidas administrativas\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/gestao-da-assinatura.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Principais dúvidas administrativas\n\nEsta página reúne as dúvidas administrativas mais comuns relacionadas à sua licença, assinatura e acessos. Consulte este guia de solução de problemas antes de abrir um chamado no suporte.\n\n*\n\n## Dúvidas licença\n\n### Minha assinatura aparece como "Validando" ou recebo "License Error" ao fazer login. O que fazer?\n\nAmbos os problemas geralmente estão ligados à validação da sua licença. Siga os passos abaixo para verificar a configuração.\n\n1. Confira as Configurações da Licença no Painel Superadmin\n\n* Chave de Licença: Verifique se a sua chave de licença foi inserida corretamente no menu "Assinatura".\n* Domínio Utilizado: Garanta que o domínio configurado na sua licença é exatamente o mesmo que você está utilizando para acessar a plataforma.\n\nDocumentação com o passo a passo\n\n{% hint style="warning" %}\nAtenção ao configurar o domínio:\n\n* Não adicione subdomínios (ex: app., api.). Coloque apenas o domínio principal (ex: suaempresa.com.br).\n* Garanta que domínios de exemplo como whatsapp.com não estejam no campo.\n {% endhint %}\n\n2. Ações Técnicas Adicionais (para "License Error")\n\nSe o erro persistir, especialmente o "License Error", tente os seguintes passos:\n\n* Atualize o Sistema: Garanta que sua instalação do Z-PRO está na versão mais recente.\n\nSe após todas as verificações o problema continuar, abra um chamado em nosso suporte administrativo no portal: https://suporte.zdg.com.br/\n\n### Onde encontro minha chave de licença?\n\nSua chave de licença (License Key) é enviada automaticamente para o seu e-mail logo após a confirmação da compra.\n\n1. Procure no seu E-mail: Verifique sua caixa de entrada e a pasta de SPAM no dia em que realizou a assinatura.\n2. Busque pelo Remetente: Procure por e-mails enviados por [email protected] .\n3. Solicite o Reenvio: Caso não encontre, abra um chamado em nosso suporte administrativo no portal https://suporte.zdg.com.br/ e solicite o reenvio da sua chave.\n\n### A data de expiração no painel não condiz com a validade da minha assinatura. O que pode ser?\n\nÉ comum haver confusão entre as duas datas de expiração exibidas no painel Superadmin. É importante entender a diferença entre elas:\n\n* Expiração da Licença: Esta é a data de validade da sua assinatura, ou seja, o dia em que sua licença anual expira e precisa ser renovada.\n* Essa versão expira em: Esta data se refere à versão do software que você está utilizando. Ela indica o prazo final para que você atualize sua plataforma para uma versão mais recente, garantindo acesso às novas funcionalidades e correções de segurança.\n\nSempre considere a "Expiração da Licença" como a data de vencimento da sua anuidade.\n\n## Dúvidas acessos\n\n### Estou sem acesso às aulas. Como resolver?\n\nO acesso à nossa área de membros, onde ficam as videoaulas, é válido por um ano a partir da data da sua compra.\n\n1. Tente o Acesso: Acesse o portal através do link: https://portal.zdg.com.br/\n2. Verifique a Validade: Confirme se sua assinatura ainda está dentro do prazo de um ano.\n3. Solicite Ajuda: Caso não consiga acessar mesmo com a assinatura ativa, abra um chamado em nosso suporte administrativo no portal https://suporte.zdg.com.br/\n\n### Estou sem acesso ao Tomticket. O que fazer?\n\nO acesso ao nosso portal de suporte (Tomticket) está diretamente atrelado à validade da sua assinatura.\n\n1. Verifique a Validade: Confirme se sua assinatura anual ainda está ativa. O acesso ao suporte é encerrado após o vencimento da licença.\n2. Entre em Contato: Se sua assinatura estiver ativa e mesmo assim você não conseguir o acesso, ou se precisar de ajuda para renovar, entre em contato conosco através do nosso WhatsApp de atendimento: https://zdg.dev.br/contato.\n\n### Não tenho acesso à Comunidade ZDG. O que fazer?\n\nO acesso à Comunidade ZDG é um produto separado. Siga os passos para verificar seu acesso:\n\n1. Confirme a Compra: Primeiro, verifique nos seus e-mails de compra se você adquiriu o acesso à "Comunidade ZDG" juntamente com sua assinatura Z-PRO.\n2. Acesse a Nova Plataforma: As aulas da comunidade, que antes ficavam na Hotmart, foram migradas para a plataforma Memberkit. Se você tem o acesso garantido, utilize o link direto para a área da comunidade: https://portal.zdg.com.br/ \n\n## Dúvidas renovação\n\n### Como renovar minha assinatura?\n\nPara renovar sua licença anual do Z-PRO, siga os passos abaixo:\n\n1. Acesse a Página de Renovação: Entre no link: https://zpro.zdg.com.br/renovar/ \n2. Informe seu E-mail: Adicione o mesmo e-mail que você utilizou na compra original.\n3. Siga para o Checkout: Você será redirecionado para a página de pagamento para concluir a renovação.\n\n### Quais são as possibilidades e condições de renovação?\n\n* Frequência e Planos: Trabalhamos apenas com a renovação no plano anual. Para conferir as opções e os valores atuais, acesse nossa página oficial: https://zpro.zdg.com.br/renovar/\n* Valor da Renovação: O valor atual reflete todas as melhorias e novas funcionalidades implementadas no Z-PRO ao longo do último ano, além dos avanços planejados para o futuro.\n* Reajustes: Pode haver reajuste nos valores de renovação. Quando isso ocorre, comunicamos antecipadamente a todos os assinantes, oferecendo a oportunidade de renovar pelo valor antigo antes da mudança.\n* Renovação Automática: Não trabalhamos com renovação automática ou recorrência. A renovação deve ser feita manualmente através da nossa página.\n\n### Renovei minha assinatura, o que muda na minha licença?\n\nAo renovar sua assinatura, a nova validade e as configurações podem variar dependendo do seu caso. Entenda o que acontece:\n\n* Prazo de Validade: Serão adicionados 12 meses à data de expiração da sua licença anterior. Por exemplo, se sua licença vencia em 01/11/2025, a nova data de expiração será 01/11/2026.\n* Se você manteve o mesmo plano: Sua chave de licença continua a mesma. A data de expiração no seu painel Superadmin será atualizada automaticamente em algumas horas.\n* Se você mudou de plano: Você receberá uma nova chave de licença por e-mail. É necessário acessar o painel Superadmin e substituir a chave antiga pela nova.\n* Acessos: Caso você perca o acesso ao portal do assinante ou ao Tomticket após a renovação, entre em contato conosco via WhatsApp: https://zdg.dev.br/contato.\n* Verificação: Você pode conferir a nova data de expiração da sua licença a qualquer momento no menu "Assinatura" do seu painel Superadmin.\n\n## Dúvidas gerais\n\n### Como solicito minha nota fiscal?\n\nAs notas fiscais são emitidas automaticamente no dia 20 do mês seguinte à confirmação da sua compra, utilizando os dados que você informou no momento do checkout.\n\nCaso precise da sua nota fiscal, siga o passo abaixo:\n\n1. Abra um Chamado: Acesse nosso portal de suporte (Tomticket).\n2. Crie um novo chamado no departamento "Suporte Administrativo" e selecione a categoria "Nota Fiscal"**.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/gestao-da-assinatura/principais-duvidas-administrativas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Referência da API\n\n- 📅 Agendamentos e Lembretes\n- 📣 Campanhas\n- 🔌 Canais e Sessões\n- 👤 Contatos\n- 🏗️ CRM Pipeline\n- 📊 Dashboard\n- 📤 Envio em Lote\n- 📂 Galeria\n- 👥 Grupos WhatsApp\n- 🏷️ Kanban / Tags / Motivos / Filas\n- 📊 Listagens\n- 🔍 Listagens Utilitárias\n- 📞 Logs de Chamadas\n- 📨 Mensagens\n- 📨 Mensagens Avançadas\n- 👥 Mensagens em Grupo\n- 💼 Oportunidades\n- 📋 Templates WABA\n- 🏢 Tenant API\n- 🎫 Tickets\n- 🎫 Tickets Extras\n- ✅ To Do List\n- 👥 Usuários\n- 🔘 WABA Interativo\n- Models\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/referencia-da-api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
[📅 Agendamentos e Lembretes\n\n## POST /v2/api/external/{ApiID}/appointment/create\n\n> AppointmentCreate\n\n\n\n## POST /v2/api/external/{ApiID}/appointment/delete/{id}\n\n> AppointmentDelete\n\n\n\n## GET /v2/api/external/{ApiID}/appointment/list\n\n> AppointmentList\n\n\n\n## GET /v2/api/external/{ApiID}/appointment/show/{id}\n\n> AppointmentShow\n\n\n\n## POST /v2/api/external/{ApiID}/appointment/update/{id}\n\n> AppointmentUpdate\n\n\n\n## POST /v2/api/external/{ApiID}/scheduleReminder/create\n\n> ScheduleReminderCreate\n\n\n\n## POST /v2/api/external/{ApiID}/scheduleReminder/delete/{id}\n\n> ScheduleReminderDelete\n\n\n\n## GET /v2/api/external/{ApiID}/scheduleReminder/list\n\n> ScheduleReminderList\n\n\n\n## POST /v2/api/external/{ApiID}/scheduleReminder/toggle/{id}\n\n> ScheduleReminderToggle\n\n\n\n## POST /v2/api/external/{ApiID}/scheduleReminder/update/{id}\n\n> ScheduleReminderUpdate\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/agendamentos-e-lembretes.md)
[📣 Campanhas\n\n## POST /v2/api/external/{ApiID}/campaign/cancel/{campaignId}\n\n> CampaignCancel\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/contacts/add/{campaignId}\n\n> CampaignContactsAdd\n\n\n\n## GET /v2/api/external/{ApiID}/campaign/contacts/{campaignId}\n\n> CampaignContactsList\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/contacts/remove/{campaignId}/{contactId}\n\n> CampaignContactsRemove\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/contacts/removeAll/{campaignId}\n\n> CampaignContactsRemoveAll\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/create\n\n> CampaignCreate\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/delete/{campaignId}\n\n> CampaignDelete\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/duplicate/{campaignId}\n\n> CampaignDuplicate\n\n\n\n## GET /v2/api/external/{ApiID}/campaign/list\n\n> CampaignList\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/pause/{campaignId}\n\n> CampaignPause\n\n\n\n## GET /v2/api/external/{ApiID}/campaign/report/{campaignId}\n\n> CampaignReport\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/resume/{campaignId}\n\n> CampaignResume\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/skip/{campaignId}\n\n> CampaignSkip\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/start/{campaignId}\n\n> CampaignStart\n\n\n\n## POST /v2/api/external/{ApiID}/campaign/update/{campaignId}\n\n> CampaignUpdate\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/campanhas.md)
[🔌 Canais e Sessões\n\n## POST /v2/api/external/{ApiID}/showChannel\n\n> ShowChannelInformation\n\n\n\n## POST /v2/api/external/{ApiID}/showChannelById\n\n> ShowChannelInformationById\n\n\n\n## POST /v2/api/external/{ApiID}/listGroupInfo\n\n> ListGroupsInfo\n\n\n\n## POST /v2/api/external/{ApiID}/createtSession\n\n> CreateSession\n\n\n\n## POST /v2/api/external/{ApiID}/deleteSession\n\n> DeleteSession\n\n\n\n## POST /v2/api/external/{ApiID}/startSession\n\n> StartSession\n\n\n\n## POST /v2/api/external/{ApiID}/qrCodeSession\n\n> ShowQrCode\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/canais-e-sessoes.md)
[👤 Contatos\n\n## POST /v2/api/external/{ApiID}/createContact\n\n> CreateContact\n\n\n\n## POST /v2/api/external/{ApiID}/showcontact\n\n> ShowContact\n\n\n\n## POST /v2/api/external/{ApiID}/updateContact\n\n> UpdateContact\n\n\n\n## POST /v2/api/external/{ApiID}/blockContact\n\n> BlockContact\n\n\n\n## POST /v2/api/external/{ApiID}/contacts/search\n\n> SearchContacts\n\n\n\n## POST /v2/api/external/{ApiID}/updateContactKanban\n\n> UpdateContactKanban\n\n\n\n## POST /v2/api/external/{ApiID}/updateContactWallet\n\n> UpdateContactWallet\n\n\n\n## GET /v2/api/external/{ApiID}/getContactExtraInfo\n\n> GetContactExtraInfo\n\n\n\n## POST /v2/api/external/{ApiID}/updateContactExtraInfo\n\n> UpdateContactExtraInfo\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/contatos.md)
[🏗️ CRM Pipeline\n\n## POST /v2/api/external/{ApiID}/pipeline/create\n\n> PipelineCreate\n\n\n\n## POST /v2/api/external/{ApiID}/pipeline/delete/{id}\n\n> PipelineDelete\n\n\n\n## GET /v2/api/external/{ApiID}/pipeline/list\n\n> PipelineList\n\n\n\n## GET /v2/api/external/{ApiID}/pipeline/show/{id}\n\n> PipelineShow\n\n\n\n## POST /v2/api/external/{ApiID}/pipeline/update/{id}\n\n> PipelineUpdate\n\n\n\n## POST /v2/api/external/{ApiID}/stage/create\n\n> StageCreate\n\n\n\n## POST /v2/api/external/{ApiID}/stage/delete/{id}\n\n> StageDelete\n\n\n\n## GET /v2/api/external/{ApiID}/stage/list\n\n> StageList\n\n\n\n## GET /v2/api/external/{ApiID}/stage/show/{id}\n\n> StageShow\n\n\n\n## POST /v2/api/external/{ApiID}/stage/update/{id}\n\n> StageUpdate\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/crm-pipeline.md)
[📊 Dashboard\n\n## GET /v2/api/external/{ApiID}/dash/ticketsAndTimes\n\n> DashTicketsAndTimes\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsChannels\n\n> DashTicketsChannels\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsEvolution\n\n> DashTicketsEvolution\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsEvolutionByValue\n\n> DashTicketsEvolutionByValue\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsEvolutionChannelsName\n\n> DashTicketsEvolutionChannelsName\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsPerUser\n\n> DashTicketsPerUser\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsQueue\n\n> DashTicketsQueue\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsReasons\n\n> DashTicketsReasons\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsStatus\n\n> DashTicketsStatus\n\n\n\n## GET /v2/api/external/{ApiID}/dash/ticketsUser\n\n> DashTicketsUser\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/dashboard.md)
[📤 Envio em Lote\n\n## POST /v2/api/external/{ApiID}/bulkDispatch/incrementProgress/{dispatchId}\n\n> BulkDispatchIncrementProgress\n\n\n\n## GET /v2/api/external/{ApiID}/bulkDispatch/list\n\n> BulkDispatchList\n\n\n\n## GET /v2/api/external/{ApiID}/bulkDispatch/show/{dispatchId}\n\n> BulkDispatchShow\n\n\n\n## POST /v2/api/external/{ApiID}/bulkDispatch/update/{dispatchId}\n\n> BulkDispatchUpdate\n\n\n\n## POST /v2/api/external/{ApiID}/bulkFastMessage\n\n> BulkFastMessage\n\n\n\n## POST /v2/api/external/{ApiID}/bulkIndividual\n\n> BulkIndividual\n\n\n\n## POST /v2/api/external/{ApiID}/bulkSendMessage\n\n> BulkSendMessage\n\n\n\n## POST /v2/api/external/{ApiID}/bulkSendMessageWithVariable\n\n> BulkSendMessageWithVariable\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/envio-em-lote.md)
[📂 Galeria\n\n## POST /v2/api/external/{ApiID}/gallery/delete/{id}\n\n> GalleryDelete\n\n\n\n## GET /v2/api/external/{ApiID}/gallery/list\n\n> GalleryList\n\n\n\n## POST /v2/api/external/{ApiID}/gallery/upload\n\n> GalleryUpload\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/galeria.md)
[👥 Grupos WhatsApp\n\n## POST /v2/api/external/{ApiID}/group/addParticipant\n\n> GroupAddParticipant\n\n\n\n## POST /v2/api/external/{ApiID}/group/changeDescription\n\n> GroupChangeDescription\n\n\n\n## POST /v2/api/external/{ApiID}/group/changePicture\n\n> GroupChangePicture\n\n\n\n## POST /v2/api/external/{ApiID}/group/changeTitle\n\n> GroupChangeTitle\n\n\n\n## POST /v2/api/external/{ApiID}/group/create\n\n> GroupCreate\n\n\n\n## POST /v2/api/external/{ApiID}/group/demote\n\n> GroupDemote\n\n\n\n## POST /v2/api/external/{ApiID}/group/getInviteLink\n\n> GroupGetInviteLink\n\n\n\n## POST /v2/api/external/{ApiID}/group/list\n\n> GroupList\n\n\n\n## POST /v2/api/external/{ApiID}/group/listParticipants\n\n> GroupListParticipants\n\n\n\n## POST /v2/api/external/{ApiID}/group/promote\n\n> GroupPromote\n\n\n\n## POST /v2/api/external/{ApiID}/group/removeParticipant\n\n> GroupRemoveParticipant\n\n\n\n## POST /v2/api/external/{ApiID}/group/setAdminsOnly\n\n> GroupSetAdminsOnly\n\n\n\n## POST /v2/api/external/{ApiID}/group/showById\n\n> GroupShowById\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/grupos-whatsapp.md)
[🏷️ Kanban / Tags / Motivos / Filas\n\n## POST /v2/api/external/{ApiID}/createKanban\n\n> CreateKanban\n\n\n\n## POST /v2/api/external/{ApiID}/createQueueData\n\n> CreateQueueData\n\n\n\n## POST /v2/api/external/{ApiID}/createReason\n\n> CreateReason\n\n\n\n## POST /v2/api/external/{ApiID}/createTag\n\n> CreateTag\n\n\n\n## POST /v2/api/external/{ApiID}/deleteKanban/{id}\n\n> DeleteKanban\n\n\n\n## POST /v2/api/external/{ApiID}/deleteQueueData/{id}\n\n> DeleteQueueData\n\n\n\n## POST /v2/api/external/{ApiID}/deleteReason/{id}\n\n> DeleteReason\n\n\n\n## POST /v2/api/external/{ApiID}/deleteTag/{id}\n\n> DeleteTag\n\n\n\n## GET /v2/api/external/{ApiID}/listKanban\n\n> ListKanban\n\n\n\n## GET /v2/api/external/{ApiID}/listReasons\n\n> ListReasons\n\n\n\n## POST /v2/api/external/{ApiID}/updateKanban/{id}\n\n> UpdateKanban\n\n\n\n## POST /v2/api/external/{ApiID}/updateQueueData/{id}\n\n> UpdateQueueData\n\n\n\n## POST /v2/api/external/{ApiID}/updateReason/{id}\n\n> UpdateReason\n\n\n\n## POST /v2/api/external/{ApiID}/updateTagData/{id}\n\n> UpdateTagData\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/kanban-tags-motivos-filas.md)
[🔍 Listagens Utilitárias\n\n## GET /v2/api/external/{ApiID}/listAutoReplies\n\n> ListAutoReplies\n\n\n\n## GET /v2/api/external/{ApiID}/listChatFlows\n\n> ListChatFlows\n\n\n\n## GET /v2/api/external/{ApiID}/listFastReplies\n\n> ListFastReplies\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/listagens-utilitarias.md)
[📊 Listagens\n\n## GET /v2/api/external/{ApiID}/listChannels\n\n> ListChannels\n\n\n\n## GET /v2/api/external/{ApiID}/listSessions\n\n> ListSessions\n\n\n\n## GET /v2/api/external/{ApiID}/listTickets\n\n> ListTickets\n\n\n\n## GET /v2/api/external/{ApiID}/listOpportunities\n\n> ListOpportunities\n\n\n\n## GET /v2/api/external/{ApiID}/listContacts\n\n> ListContacts\n\n\n\n## GET /v2/api/external/{ApiID}/listTags\n\n> ListTags\n\n\n\n## GET /v2/api/external/{ApiID}/listQueues\n\n> ListQueues\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/listagens.md)
[📞 Logs de Chamadas\n\n## GET /v2/api/external/{ApiID}/callLog/list\n\n> CallLogList\n\n\n\n## GET /v2/api/external/{ApiID}/callLog/show/{id}\n\n> CallLogShow\n\n\n\n## GET /v2/api/external/{ApiID}/wavoip/calls\n\n> WavoipCallList\n\n\n\n## GET /v2/api/external/{ApiID}/wavoip/calls/{id}\n\n> WavoipCallShow\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/logs-de-chamadas.md)
[📨 Mensagens Avançadas\n\n## GET /v2/api/external/{ApiID}/searchMessages\n\n> SearchMessages\n\n\n\n## POST /v2/api/external/{ApiID}/sendLocation\n\n> SendLocation\n\n\n\n## POST /v2/api/external/{ApiID}/sendVcard\n\n> SendVcard\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/mensagens-avancadas.md)
[👥 Mensagens em Grupo\n\n## POST /v2/api/external/{ApiID}/group\n\n> SendGroupMessageAPIText\n\n\n\n## POST /v2/api/external/{ApiID}/groupMediaUrl\n\n> SendMessageAPIFileURLGroup\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/mensagens-em-grupo.md)
[📨 Mensagens\n\n## GET /v2/api/external/{ApiID}/params/\n\n> SendMessageParams\n\n\n\n## POST /v2/api/external/{ApiID}\n\n> SendMessageAPIText\n\n\n\n## POST /v2/api/external/{ApiID}/url\n\n> SendMessageAPIFileURL\n\n\n\n## POST /v2/api/external/{ApiID}/voice\n\n> SendMessageAPIVoice\n\n\n\n## POST /v2/api/external/{ApiID}/base64\n\n> SendMessageAPITextBase64\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/mensagens.md)
Models\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/central-do-assinante/referencia-da-api/models.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
[💼 Oportunidades\n\n## POST /v2/api/external/{ApiID}/createOpportunity\n\n> CreateOpportunity\n\n\n\n## POST /v2/api/external/{ApiID}/deleteOpportunity\n\n> DeleteOpportunity\n\n\n\n## POST /v2/api/external/{ApiID}/updateOpportunity\n\n> UpdateOpportunity\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/oportunidades.md)
[📋 Templates WABA\n\n## POST /v2/api/external/{ApiID}/template\n\n> SendTemplateWaba\n\n\n\n## POST /v2/api/external/{ApiID}/templateBody\n\n> SendTemplateWabaBody\n\n\n\n## POST /v2/api/external/{ApiID}/templateMarketingBody\n\n> SendTemplateWabaMarketing\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/templates-waba.md)
[🏢 Tenant API\n\n## POST /tenantCreateApi\n\n> CreateApi\n\n\n\n## POST /tenantDeleteApi\n\n> DeleteApi\n\n\n\n## POST /tenantApiStoreTenant\n\n> StoreTenant\n\n\n\n## POST /tenantApiCreateSession\n\n> CreateSessionTenant\n\n\n\n## POST /tenantApiShowTenant\n\n> ShowTenant\n\n\n\n## POST /tenantApiUpdateTenant\n\n> UpdateTenant\n\n\n\n## GET /tenantApiListTenants\n\n> ListTenants\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/tenant-api.md)
[🎫 Tickets Extras\n\n## POST /v2/api/external/{ApiID}/ticket/pause/end/{ticketId}\n\n> EndTicketPause\n\n\n\n## GET /v2/api/external/{ApiID}/listTicketEvaluations\n\n> ListTicketEvaluations\n\n\n\n## GET /v2/api/external/{ApiID}/ticket/pause/logs/{ticketId}\n\n> ListTicketPauseLogs\n\n\n\n## POST /v2/api/external/{ApiID}/showTicketById\n\n> ShowTicketById\n\n\n\n## POST /v2/api/external/{ApiID}/ticket/pause/start/{ticketId}\n\n> StartTicketPause\n\n\n\n## POST /v2/api/external/{ApiID}/ticket/share\n\n> TicketShareCreate\n\n\n\n## GET /v2/api/external/{ApiID}/ticket/share/{ticketId}\n\n> TicketShareShow\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/tickets-extras.md)
[🎫 Tickets\n\n## POST /v2/api/external/{ApiID}/createTicket\n\n> CreateTicketWebmail\n\n\n\n## POST /v2/api/external/{ApiID}/updatequeue\n\n> SetQueue\n\n\n\n## POST /v2/api/external/{ApiID}/updatetag\n\n> SetTag\n\n\n\n## POST /v2/api/external/{ApiID}/updateticketinfo\n\n> SetTicketInfo\n\n\n\n## POST /v2/api/external/{ApiID}/showticket\n\n> ShowTicketInformation\n\n\n\n## POST /v2/api/external/{ApiID}/showticketchatbot\n\n> ShowTicketInformationChatBot\n\n\n\n## POST /v2/api/external/{ApiID}/showallticket\n\n> ShowAllTicketInformation\n\n\n\n## POST /v2/api/external/{ApiID}/showAllMessages\n\n> ShowAllMessages\n\n\n\n## POST /v2/api/external/{ApiID}/updateTicketChannel\n\n> UpdateTicketChannel\n\n\n\n## POST /v2/api/external/{ApiID}/createNotes\n\n> CreateNotes\n\n\n\n## POST /v2/api/external/{ApiID}/updateNote\n\n> UpdateNote\n\n\n\n## GET /v2/api/external/{ApiID}/listNotes\n\n> ListNotes\n\n\n\n## POST /v2/api/external/{ApiID}/addTag\n\n> AddTag\n\n\n\n## POST /v2/api/external/{ApiID}/removeTag\n\n> RemoveTag\n\n\n\n## POST /v2/api/external/{ApiID}/sendPresence\n\n> SendPresence\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/tickets.md)
[✅ To Do List\n\n## POST /v2/api/external/{ApiID}/todo/create\n\n> TodoCreate\n\n\n\n## POST /v2/api/external/{ApiID}/todo/delete/{id}\n\n> TodoDelete\n\n\n\n## GET /v2/api/external/{ApiID}/todo/list\n\n> TodoList\n\n\n\n## GET /v2/api/external/{ApiID}/todo/logs/{userId}\n\n> TodoLogs\n\n\n\n## POST /v2/api/external/{ApiID}/todo/update/{id}\n\n> TodoUpdate\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/to-do-list.md)
[👥 Usuários\n\n## POST /v2/api/external/{ApiID}/createUser\n\n> CreateUser\n\n\n\n## POST /v2/api/external/{ApiID}/updateUser\n\n> UpdateUser\n\n\n\n## GET /v2/api/external/{ApiID}/listUsers\n\n> ListUsers\n\n\n\n## GET /v2/api/external/{ApiID}/getUserStatus\n\n> GetUserStatus\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/usuarios.md)
[🔘 WABA Interativo\n\n## POST /v2/api/external/{ApiID}/sendButtonWABA\n\n> SendButtonWABA\n\n\n\n## POST /v2/api/external/{ApiID}/sendListWABA\n\n> SendListWABA\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the query parameter:\n\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n](docs/central-do-assinante/referencia-da-api/waba-interativo.md)
Configuracao Administrador
Administração - Painel Admin\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Canais de comunicação\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e supervisor\n{% endhint %}\n\nA capacidade de centralizar múltiplos canais de comunicação em uma única plataforma é uma das principais funcionalidades do Z-PRO. Esta documentação oferece uma visão geral sobre os tipos de canais que você pode conectar, ajudando você a decidir quais são os mais adequados para a sua operação.\n\n#### Como acessar a página\n\nPara acessar, clique no Menu Administração e selecione a aba Canais.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\n*\n\n### Opções de Conexão- Tipo de Canal\n\nO Z-PRO oferece suporte a múltiplos canais simultâneos. Abaixo, listamos as tecnologias disponíveis para conexão:\n\n#### 1. Meta Oficial\n\n\n\n[WhatsApp Oficial (OAuth): ](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md)Conexão na API oficial via QR-CODE, com coexistência entre Whatsapp business e o zpro, usando o app de integração nativo do ZPRO. É a conexão mais prática e segura disponível. Necessário ter um número WhatsApp business.\n\n[Instagram Direct e Facebook Messenger](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md) via API Oficial (Login do Facebook), sem necessidade de hubs externos (BETA)\n\n[Waba: WhatsApp Oficial - Cloud API](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md): Conexão via app próprio, que deve ser configurado no facebook developers. Não depende de celular ligado e oferece risco reduzido de banimento. Ideal para médias e grandes operações.\n\n#### 2. Whatsapp não oficial\n\n\n\nSimula o WhatsApp Web/Desktop. Depende de um aparelho celular conectado. O Z-PRO disponibiliza diversos "motores" para garantir compatibilidade com diferentes tipos de chip:\n\n* Baileys\n* WebJs\n* Evolution\n* Wuzapi\n* Z-API\n* Uazapi\n\n{% hint style="info" %}\nQual a diferença técnica?\\nPara entender profundamente os prós e contras de cada tipo de conexão e decidir qual é a melhor para o seu negócio, leia nosso artigo comparativo:\\n👉 [API Oficial vs. APIs Não Oficiais: Guia Completo](https://www.google.com/url?sa=E\&q=https%3A%2F%2Fajuda.zdg.com.br%2Fconheca-o-z-pro%2Frecursos-e-integracoes-do-z-pro%2Fapi-oficial-do-whatsapp-vs.-apis-nao-oficiais)\n{% endhint %}\n\n#### 3. Outros\n\n\n\n* Telegram: Conexão via Bot Token oficial. Extremamente estável e funciona 100% na nuvem.\n* WebMail: Conexão via protocolo IMAP/SMTP para transformar e-mails recebidos em tickets de atendimento.\n* WebChat: Widget de chat ao vivo para instalar no seu site institucional.\n* Hub Notificame: API terceira para Instagram Direct e Facebook Messenger.\n\n*\n\n### Ações Gerais da Tela\n\nNo topo da página, você encontra dois botões principais para a organização do seu painel:\n\n1. Alterar Ordem de Visualização: Permite reorganizar a disposição dos cards na tela podendo organizar por: Padrão, A–Z, por tipo, Agrupado, por provedor ou por status\n\n\n\n2. Adicionar Canal: Botão para iniciar uma nova conexão.\n\n 👉 Clique aqui para ver o passo a passo de como conectar um novo canal\n\n**\n\n### Gerenciando um Canal Conectado\n\nApós a ativação de uma conexão, o sistema disponibiliza um menu de ações rápidas para a gestão técnica e operacional do canal. Estas opções permitem o controle de fluxo de mensagens e a manutenção da integridade da comunicação.\n\n\n\nOpções Gerais (Disponíveis para todos os canais)\n\n Editar: Permite alterar o nome de identificação da conexão e ajustar parâmetros técnicos internos.\n Definir como padrão: Estabelece o canal como a conexão prioritária para o envio de mensagens automáticas e notificações do sistema.\n Transferir Canal: Possibilita a migração da gestão do canal entre diferentes estruturas do painel.\n Fechar tickets abertos: Executa o encerramento em lote de todos os atendimentos ativos (status "Aberto") vinculados exclusivamente a este canal.\n Fechar tickets pendentes: Executa o encerramento em lote de todos os atendimentos que aguardam aceite (status "Pendente") nesta conexão.\n Excluir: Remove permanentemente a conexão do sistema.\n\nFunções Específicas e Exclusividades\n\nO sistema exibe ícones e funções adicionais de acordo com a tecnologia do canal conectado:\n\n Revalidar Webhook: Esta função é essencial para restabelecer a sincronia de dados entre a plataforma de origem e o Z-PRO.\n Canais compatíveis: Disponível para Evolution, Hub, Meow, Instagram, Messenger, UAZAPI e Z-API.\n Canais WABA (Meta): Para conexões oficiais, o menu exibe as opções específicas Revalidar Webhook Waba e Revalidar Webhook Secundário Waba, garantindo a redundância e estabilidade do recebimento de mensagens oficiais.\n\n{% hint style="info" %}\nQual a diferença do webhook do aplicativo para o do telefone?\n\nO webhook principal é o do aplicativo, e o secundário é o do telefone.\n\nFunciona assim: imagine que você tem um único aplicativo na Meta e dentro dele conecta 3 números diferentes.\n\nNa Meta, o aplicativo permite apenas 1 webhook principal cadastrado — esse é o chamado webhook de aplicativo.\n\nPorém, cada número pode precisar ser utilizado em um tenant diferente dentro da plataforma.\n\nComo o webhook principal é único, não seria possível direcionar cada número diretamente para tenants diferentes usando apenas ele.\n\nPor isso utilizamos o webhook secundário: ele mantém a assinatura e a validação do webhook principal do aplicativo, mas faz o redirecionamento das mensagens de cada telefone para o tenant correto.\n\nAssim, conseguimos usar vários números do mesmo aplicativo em tenants diferentes sem conflito.\n{% endhint %}\n\n Gerar Widget: Botão exclusivo para conexões do tipo Site. Permite gerar o código de integração para embutir o chat em páginas web externas.\n\n{% hint style="warning" %}\nAtenção: As ações de "Fechar tickets" são irreversíveis e afetam o histórico imediato do dashboard. Utilize estas funções apenas para limpezas de fila ou manutenções operacionais.\n{% endhint %}\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como conectar um canal (sessão/número)\n\nNo menu lateral do seu painel, clique em ADMINISTRAÇÃO, aba Canais.\n\n\n\nVocê verá a seguinte tela:\n\n\n\nAqui é onde você fará a conexão com os números oficiais da sua empresa, para realizar os atendimentos.\n\n## Nova conexão \n\nClique em Adicionar Canal no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\n### 1. Escolha do Tipo de Canal\n\nAo clicar em "Adicionar Canal", a primeira etapa é selecionar a tecnologia de conexão. Cada tipo possui características específicas de estabilidade e recursos.\n\nPara detalhes técnicos e passo a passo de conexão (QR Code ou Token) de cada tipo, consulte as documentações específicas:\n\nWhatsApp Oficial (OAuth)\n\nInstagram Direct e Facebook Messenger\n\nWaba: WhatsApp Oficial - Cloud API\n\nPara essa documentação vamos passar o tutorial para conectar APIs não oficiais\n\n\n\n### 2. Preencha dos dados \n\n#### Código de pareamento\n\n\n\nApenas para o canal tipo BAILEYS, WebJS e Meow\n\nOpção caso não seja possível ler o QR Code\n\n#### Nome\n\n\n\nInsira um nome para identificar esse canal.\n\n Canal padrão: Define se este será o canal principal para envios automáticos do sistema.\n\n#### Atribuições\n\n\n\nEm **ChatFlow você pode escolher o Fluxo (BOT) que usará como padrão para o atendimento desse número. Voce pode atribuir apenas um fluxo para cada número/conexão.\n\nEm Fila você pode escolher uma Fila que usará como padrão para o atendimento desse número.\n\nEm Usuário você pode escolher uma Usuário que usará como padrão para o atendimento desse número.\n\nEssa função você só consegue habilitar depois de criar o canal*\n\n#### Importar mensagem do Aparelho\n\nApenas para o canal tipo BAILEYS (QR CODE)\n\n\n\n### Wavoip\n\n\n\nAtivação da ligação por meio de Chamadas VoIP\n\nDocumentação completa: Wavoip - Ligações pelo WhatsApp\n\n#### Mensagem de Despedida do Atendimento\n\n\n\nMensagem enviada assim que finaliza um atendimento nesse botão:\n\n\n\n#### Informações com IAs\n\nPara integrar ad inteligencias artificiais com o canal que está sendo criado é preciso adicionar as informações específicas de cada IA. Verificar os campos necessários em cada aba abaixo.\n\n{% hint style="warning" %}\nÉ necessário ativar a integração do seu Z-PRO com a IA desejada dentro do Painel do Admin - Configurações gerais para que seja possível ativar dentro do Canal criado\n\nBots e IA\n{% endhint %}\n\n\n\nAssim que habilitar a integração com Bots IA, ela aparecerá na criação do canal para colocar as informações:\n\n\n\n### Webhook do canal\n\nDispara notificações para uma URL exclusiva deste canal, em paralelo ao webhook geral do tenant\n\n\n\n### Pix\n\nConfiguração padrão pré-salva para o botão PIX. Os campos são carregados automaticamente ao abrir o envio e podem ser alterados antes de enviar.\n\n\n\n### Recursos do canal\n\n\n\n\n\n| Opção | Descrição e Funcionamento |\n| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Habilitar avaliação automática | Envio automático de pesquisa de satisfação.Ao resolver um ticket, o sistema envia automaticamente a mensagem de avaliação configurada para o cliente, sem necessidade de ação manual do atendente. |\n| Habilitar transcrição de áudio | Conversão de voz para texto.Os áudios recebidos no chat serão processados e transcritos para texto, facilitando a leitura e a indexação do conteúdo. |\n| Habilitar auto distribuir | Balanceamento de carga entre a equipa.Novos tickets que chegam sem dono definido serão distribuídos automaticamente e de forma equitativa entre os atendentes que estiverem online no sistema. |\n| Habilitar destruição de mensagem | Privacidade e limpeza de dados.Quando uma mensagem é apagada na interface do chat (pelo utilizador ou admin), ela é removida permanentemente da base de dados do sistema, e não apenas ocultada visualmente. |\n| Habilitar envio de mensagem para aniversariantes | Marketing e relacionamento automático.Envia automaticamente uma mensagem de felicitações (definida no campo abaixo desta opção) na data de aniversário do contacto.• Nota: Esta função ignora as configurações de horário de atendimento, garantindo que os parabéns sejam enviados mesmo fora do expediente. |\n| Ignorar Horário de Atendimento | Ignora o horário de atendimento do sistema para este canal. |\n| Redistribuição Automática de Tickets | Redistribui automaticamente tickets de usuários que ficarem offline por mais do que o tempo configurado. |\n| Posição na fila | Quando um novo atendimento entra na fila como pendente, o sistema envia uma mensagem automática informando a posição do cliente e o tempo médio de espera. Herdar: segue a configuração global do tenant. Ativado: sobrescreve o global e usa a configuração deste canal. Desativado: sobrescreve o global e não envia. O gatilho dispara apenas uma vez por ticket, depois que o chatbot/flow termina. Se o ticket for atribuído a um agente automaticamente ou se um chatbot assumir, a mensagem não é enviada. Escopo da posição: contagem na mesma fila (queue) do ticket; se não houver fila, conta pelo canal. Canais suportados: WhatsApp Web, Baileys, WABA, Instagram, Messenger, Webchat, Telegram, Evolution, Z-API, UazAPI, Meow, Hub. |\n| Habilitar desligamento automático das integrações externas | Transição suave de Robô para Humano.Quando um atendente abre ou assume um ticket, o sistema desativa automaticamente as integrações de IA (ChatGPT, Typebot, Dify, N8N, DialogFlow) para aquela conversa, evitando que o robô interrompa o atendimento humano. |\n| Habilitar espera no processamento de mensagens com integrações externas | Fila de processamento para Chatbots.Evita que o bot se confunda quando o cliente envia várias mensagens seguidas. O sistema processará uma mensagem de cada vez, aguardando a resposta da integração (ex: Typebot) antes de processar a frase seguinte do cliente. |\n| Habilitar Web Push | Notificações do Sistema.Ativa o envio de notificações push (alertas de navegador ou PWA) para avisar os utilizadores sobre novas mensagens ou atividades no painel, mesmo quando a aba não está em primeiro plano. |\n| Contingência | Se ativo: o canal recebe mensagens. Se inativo: permanece conectado mas não recebe mensagens. |\n| Palavra-chave para fechamento automático | Ao receber esta palavra-chave o ticket será encerrado automaticamente. |\n\nVocê pode habilitar uma palavra chave para fechamento automático do atendimento. Essa é uma palavra chave que ao ser recebida irá encerrar o ticket automaticamente.\n\n### Configurações adicionais (Proxy)\n\nApenas para o canal tipo BAILEYS, WebJS, Meow, Evolution API, Uazapi**\n\n\n\n{% content-ref url="/pages/vh9IxgE5vP6vALpCouvj" %}\nProxy IPv4 no Proxy-Seller\n{% endcontent-ref %}\n\n### Ações finais\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Distribuição Automática de Atendimentos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e supervisor\n{% endhint %}\n\nA distribuição automática de atendimentos atribui novas conversas aos seus atendentes de forma automática, agilizando o primeiro contato e balanceando a carga de trabalho da equipe.\n\nO Z-PRO oferece duas formas nativas para configurar esta automação: diretamente na configuração de um Canal ou como uma etapa dentro de um Fluxo de Chatbot.\n\n*\n\n#### Método 1: Pela Configuração do Canal\n\nEste método distribui todas as novas conversas que chegam em um canal específico assim que elas são criadas.\n\n* Quando Usar: Ideal para operações de atendimento direto, onde você quer que o cliente fale com um atendente o mais rápido possível.\n* Como Funciona a Lógica: O sistema prioriza a distribuição para um atendente que esteja online e associado à fila principal do canal. Se não houver nenhum atendente online na fila designada, a regra transborda, e o sistema atribui o ticket a qualquer outro atendente que esteja online na plataforma, independentemente da fila dele.\n* Como Configurar:\n 1. No painel Admin, acesse "Canais".\n 2. Edite o canal desejado e ative a opção "Habilitar auto histribuir".\n\n\n\n*\n\n#### Método 2: Pelo Chatbot\n\nEste método permite que a distribuição ocorra em um momento específico do fluxo de conversa do chatbot.\n\n Quando Usar: Perfeito para cenários onde o chatbot primeiro qualifica o cliente (coleta informações) e só depois transfere para um atendente humano.\n Como Funciona a Lógica: Você adiciona uma ação de "Autodistribuir Ticket" em seu fluxo. Ao chegar nesta etapa, o sistema distribui o atendimento para um atendente que pertença à fila em questão (a fila onde o chatbot está operando), utilizando o método que você definir.\n Opções de Distribuição:\n Aleatório (Random): Escolhe um atendente online da fila de forma aleatória.\n Balanceado (Balanced): Escolhe o atendente online com o menor número de atendimentos recebidos no dia.\n Como Configurar:\n 1. Acesse "Chatbot" e edite o fluxo desejado.\n 2. Clique balão "Configurações"\n 3. Encontra a opção "Auto distribuir atendimento"\n 4. Selecionando o método de distribuição.\n\n\n\n*\n\n{% hint style="info" %}\nNota sobre Distribuição Avançada**\n\nPara regras de negócio mais complexas, é possível utilizar uma ferramenta externa como o n8n, que pode receber os dados do ticket via Webhook e utilizar a API do Z-PRO para atribuir o atendente com base na sua lógica personalizada.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como configurar a API Oficial do WhatsApp (WABA)\n\nEsta documentação detalha o processo completo para configurar a API Oficial do WhatsApp (também conhecida como WABA ou Cloud API) e conectá-la à plataforma Z-PRO.\n\nSeguir os passos na ordem correta é fundamental para garantir uma instalação bem-sucedida. \n\n### Live - Criação de App no facebook developers e integração com a API Oficial, Instagram e Facebook\n\n{% embed url="https://youtu.be/MpMQsRT6ba4" %}\n\n## Tutorial passo-a-passo:\n\n### Vídeo 1: Criar número de telefone\n\n{% embed url="https://youtu.be/tS1vTy_x1Oc" %}\n\n### Vídeo 2: Configurando número na Meta\n\n{% embed url="https://youtu.be/F4K-X0-nx7s" %}\n\n### Vídeo 3: Configurando WABA no Z-PRO\n\n{% embed url="https://youtu.be/iTkpUxweMYM" %}\n\n### Vídeo 4: Configurando Webhook de callback\n\n{% embed url="https://youtu.be/w6UL_EEUKKg" %}\n\n### Vídeo 5: Registrar o número e criar templates de mensagens\n\n{% embed url="https://youtu.be/i55tBINrYfw" %}\n\n*\n\n## Documentação das etapas:\n\n## Etapa 1: Pré-requisitos e Preparação\n\nAntes de começar, você precisará de dois itens essenciais:\n\n1. Uma conta no Facebook.\n2. Um número de telefone (pode ser virtual ou um chip físico).\n\n{% hint style="danger" %}\nAVISO SOBRE O NÚMERO DE TELEFONE\n\n* Você não pode usar o mesmo número no aplicativo normal do WhatsApp e na API Oficial.\n* Se você deseja usar um número que já possui uma conta de WhatsApp, é obrigatório excluir permanentemente a conta de WhatsApp associada a ele antes de continuar. Não basta apenas deletar o aplicativo.\n Para testes, recomendamos fortemente a compra de um número virtual.\n {% endhint %}\n\n\n\n## Etapa 2: Criação e Configuração do Aplicativo na Meta\n\nNesta etapa, vamos criar o aplicativo no ambiente da Meta que será responsável por gerenciar a API.\n\n1. Acesse o Facebook for Developers: Faça o login com sua conta do Facebook em https://developers.facebook.com/ \n\n\n\n2. Crie um Novo Aplicativo:\n\n Clique em "Criar Aplicativo".\n\n\n\n Selecione "Outros"\n Selecione o tipo "Business".\n\n\n\n Dê um nome ao seu aplicativo (ex: "Waba Cloud API") e associe-o à sua conta do Gerenciador de Negócios (BM).\n\n3. Adicione o Produto WhatsApp: No painel do seu novo aplicativo, encontre e adicione o produto "WhatsApp".\n\n\n\n4. Configure as Informações Básicas:\n\n Acesse "Configurações do app" > "Básico".\n\n\n\n Preencha os campos "URL da Política de Privacidade" e "URL dos Termos de Serviço".\n\n5. Ative o Aplicativo: No topo da página, mude o status do aplicativo de "Em desenvolvimento" para "Ao vivo".\n\n\n\n*\n\n## Etapa 3: Cadastrando e Verificando seu Número de Telefone\n\nAgora, vamos adicionar e verificar o número de telefone que será usado pela API.\n\n1. No menu do seu aplicativo, vá para "WhatsApp" > "Configuração da API".\n\n\n\n2. Adicione um Número de Telefone: Clique no botão para adicionar um novo número.\n\n\n\n3. Preencha os Dados: Insira as informações da sua empresa e o número de telefone que você preparou na Etapa 1.\n4. Verifique o Número: Escolha receber o código de verificação por SMS ou ligação telefônica e insira o código recebido.\n5. Adicione a forma de pagamento\n\n\n\n6. Registre o Número com PIN (Passo Obrigatório):\n\n Após a verificação, a Meta exige um registro de segurança com um PIN de 6 dígitos. Este passo é realizado via API. (token provisório)\n\n\n\n Utilize uma ferramenta como o Postman e o endpoint "Registrar Fone" (disponível em nossa coleção) para enviar o PIN de 6 dígitos ao seu número. https://www.postman.com/meta/whatsapp-business-platform/request/kkn2spv/register-phone\n Este passo é crucial para que o número seja ativado com sucesso.\n\n{% hint style="info" %}\nA explicação detalhada da etapa do postman está no vídeo https://www.youtube.com/watch?v=sLp5P9Qb50w\n{% endhint %}\n\n\n\n## Etapa 4: Gerando um Token de Acesso Permanente\n\nO token gerado pelo painel do desenvolvedor é temporário e expira em 24 horas. Para uma conexão estável com o Z-PRO, você precisa de um token permanente.\n\n1. Acesse as Configurações do Negócio: Navegue até seu Gerenciador de Negócios (BM).\n2. Vá para "Usuários" > "Usuários do sistema".\n\n\n\n3. Crie um Usuário do Sistema: Adicione um novo usuário do sistema com a função de "Admin".\n4. Atribua Ativos: Com o novo usuário selecionado, clique em "Atribuir Ativos".\n5. Selecione "Aplicativos", escolha o aplicativo que você criou na Etapa 2 e conceda a permissão de "Gerenciar App".\n6. Gere o Token: Ainda com o usuário selecionado, clique em "Gerar novo token".\n Selecione o seu aplicativo.\n Defina a expiração como "Nunca".\n Marque as permissões necessárias (pelo menos whatsapp_business_management e whatsapp_business_messaging).\n Clique em "Gerar Token", copie o código e guarde-o em um local seguro, pois ele não será exibido novamente.\n\n*\n\n## Etapa 5: Conectando a API no Z-PRO e Ativando Webhooks\n\nCom tudo pronto no ambiente da Meta, o passo final é configurar a conexão dentro do Z-PRO.\n\nVídeo detalhado na nossa área de membros: https://portal.zdg.com.br/270021-sistema-zpro/5179477-conectar-api-oficial\n\n1. Conecte o Canal no Z-PRO (Para Enviar Mensagens):\n\n * No painel Admin do Z-PRO, acesse "Canais" e adicione um novo canal do tipo "WABA".\n\n \n\n Preencha os campos com as informações obtidas no painel da Meta: Whatsapp - Configuração da API\n ID do número de telefone\n * ID da conta do WhatsApp Business\n * O Token Permanente que você gerou na Etapa 4.\n * Clique em Salvar. Neste momento, você já estará apto a enviar mensagens.\n2. Ative os Webhooks no Z-PRO (Para Receber Mensagens):\n\n * No painel Admin do Z-PRO, vá para "Configurações" > "Integração Meta".\n * Copie a URL do Webhook e o Token de Verificação.\n * Volte ao painel do seu aplicativo na Meta, em "WhatsApp" > "Configuração da API".\n\n \n\n Clique em "Editar" na seção de Webhooks.\n Cole a URL e o Token copiados do Z-PRO e clique em "Verificar e Salvar".\n * Após verificar, clique em "Gerenciar" e assine (subscribe) todos os eventos de webhook disponíveis (especialmente messages).\n\n \n\n### Encerramento\n\nCom os webhooks ativos, sua plataforma está pronta para enviar e receber mensagens através da API Oficial do WhatsApp. Esta é a conexão mais estável e segura, recomendada para todas as operações.\n\n### Possíveis erros\n\nSolução de Problemas: Evite falhas de comunicação com o Webhook da Meta (Erro ETIMEDOUT)\n\nOs erros AxiosError do tipo "ETIMEDOUT" registrados no log indicam que a comunicação com o servidor da Meta (Webhook) está sofrendo atraso de resposta — geralmente causado por alta latência de rede.\n\nIsso ocorre quando o ping entre sua VPS e o domínio graph.facebook.com ultrapassa 40 ms, resultando em falhas do tipo TIMEDOUT nas requisições.\n\nPara prevenir esse problema, é importante definir uma rota pública estável em sua VPS. Se você utiliza a Hostinger, por exemplo, o caminho é:\n\n1. Acesse o painel da Hostinger.\n2. Vá até Configurações → Rede → DNS.\n3. Defina um DNS fixo recomendado, como:\n 1.1.1.1 (Cloudflare)\n 8.8.8.8 (Google)\n\nEssas configurações ajudam a garantir uma rota mais direta e estável entre a VPS e a infraestrutura da Meta, reduzindo atrasos e eliminando o erro de timeout nos logs.\n\n\n\n## Links de apoio - Meta API\n\nComo configurar a API Oficial do WhatsApp (WABA)\n\n{% embed url="https://ajuda.zdg.com.br/api-oficial-waba/como-configurar-a-api-oficial-do-whatsapp-waba" %}\n\nGuia Verificação do app (tech provider)\n\nhttps://comunidade.zdg.com.br/geral/coexistence-whatsapp/\n\nGuia Configuração coexistência:\n\n{% embed url="https://ajuda.zdg.com.br/api-oficial-waba/api-oficial-cadastro-incorporado-e-coexistencia-waba-beta" %}\n\nConfiguração login incorporado:\n\n{% embed url="https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/facebook-login-incorporado-waba-insta-messenger" %}\n\nConfiguração instagram nativo:\n\n{% embed url="https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/facebook-e-instagram-nativo/canal-instagram-nativo-beta" %}\n\nConfiguração facebook messenger nativo:\n\n{% embed url="https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/facebook-e-instagram-nativo/canal-facebook-messenger-nativo-beta" %}\n\nGuia da Meta para configuração do login incorporado:\\nhttps://developers.facebook.com/docs/facebook-login/facebook-login-for-business/\ Guia da Meta para configuração da coexistência:\\nhttps://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users\n\nCentral de ajuda e suporte técnico meta:**\n\nhttps://developers.facebook.com/support/\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
E-mail (IMAP/SMTP)\n\nA conexão via IMAP/SMTP permite integrar qualquer provedor de e-mail externo (Outlook, Yahoo, Hostgator, Locaweb, servidores próprios, etc.) ao painel de atendimento do Z-PRO. Através desta configuração, o sistema será capaz de receber e-mails como tickets de atendimento e responder aos clientes diretamente pela interface de chat.\n\n#### Passo 1: Informações Iniciais\n\nAo adicionar um novo canal, selecione o tipo Email (IMAP/SMTP).\n\n Nome do Canal: Insira um nome para identificar esta conta (ex: E-mail Comercial).\n Canal Padrão: Defina se esta será a conta principal de envio de e-mails do sistema.\n\n\n\n#### Passo 2: Configuração SMTP (Envio)\n\nEsta seção configura a saída das mensagens. Os dados variam conforme o seu provedor.\n\n Servidor SMTP: O endereço do servidor de saída.\n Exemplos comuns: smtp.seudominio.com.br ou mail.seudominio.com.br.\n Porta SMTP: Geralmente utiliza-se 587 (para conexão TLS) ou 465 (para conexão SSL).\n Conexão Segura (SSL/TLS): Ative este campo caso seu provedor exija uma conexão criptografada.\n Usuário: O endereço de e-mail completo de autenticação (ex: [email protected] ).\n Senha / App Password: A senha da conta de e-mail ou uma "senha de aplicativo" gerada no painel do provedor.\n E-mail remetente (from): O endereço que aparecerá para o cliente ao receber sua mensagem.\n E-mail de resposta (replyTo): O endereço que receberá as respostas caso o cliente responda ao e-mail manualmente.\n\n\n\n#### Passo 3: Configuração IMAP (Recebimento)\n\nEsta seção configura a entrada das mensagens no sistema.\n\n Detecção Automática: Insira seu e-mail e clique em Detectar. O sistema tentará encontrar as configurações de host e porta automaticamente.\n Host IMAP: O endereço do servidor de entrada.\n Exemplos comuns: imap.seudominio.com.br ou mail.seudominio.com.br.\n Porta IMAP: Geralmente utiliza-se 993 (com TLS/SSL ativo) ou 143 (sem segurança).\n TLS/SSL: Ative para garantir a segurança no recebimento.\n Usuário IMAP: Geralmente o mesmo e-mail do SMTP. Você pode clicar no botão Igual ao SMTP para preenchimento rápido.\n Caixa (mailbox): A pasta que o sistema deve monitorar. O padrão é INBOX.\n Intervalo (segundos): Tempo de espera entre cada verificação de novos e-mails. O recomendado é 30 segundos.\n\n\n\n#### Passo 4: Configurações Avançadas\n\n Validar certificado TLS: Mantenha ativo para garantir que o sistema verifique a autenticidade do servidor de e-mail.\n Keepalive / IDLE: Mantém a conexão com o servidor de e-mail sempre "viva", permitindo o recebimento de mensagens quase instantaneamente.\n Assinatura (HTML): Insira aqui o texto de assinatura que será anexado ao final de todos os e-mails enviados. Aceita formatação HTML.\n Exemplo: Atenciosamente,Equipe de Suporte
\n\n\n\n#### Passo 5: Webhook do Canal\n\n Habilitar Webhook do Canal: Se ativado, o sistema disparará notificações para uma URL específica sempre que um novo e-mail for processado por esta conta.\n\n\n\n**\n\n#### Avisos e Observações\n\n1. Firewall: Certifique-se de que o seu servidor de e-mail permite conexões externas para as portas configuradas (587, 465, 993).\n2. Senhas de Aplicativo: Alguns provedores (como Outlook/Office 365) exigem a criação de uma "Senha de Aplicativo" caso a Autenticação de Dois Fatores (2FA) esteja ativa na conta.\n3. Limite de Anexos: O tamanho dos arquivos enviados e recebidos via e-mail respeitará o limite imposto pelo seu provedor de e-mail (geralmente entre 10MB e 25MB).\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/e-mail-imap-smtp.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Hub NotificaMe (Face, Insta, WebChat e Email)\n\nTemos a possibilidade de utilizar a API da plataforma externa Hub NotificaMe A. Para utilizar estes canais, é necessário primeiro criar uma conta e contratar um plano diretamente no site deles, pois o pagamento é feito ao fornecedor do serviço.\n\nAtravés desta integração, você pode conectar e gerenciar os seguintes tipos de canais na sua caixa de entrada do Z-PRO:\n\n Facebook Messenger\n Instagram Direct\n Webchat (oferecido pela Hub NotificaMe)\n E-mail\n\nImportante: Embora a plataforma Hub NotificaMe ofereça outros tipos de canais, apenas os listados acima foram implementados e são suportados oficialmente dentro do Z-PRO.\n\n*\n\n#### Como Configurar a Integração\n\nVídeo de como acessar o hub notificame: https://youtu.be/JfYQaCqcuXE\n\n{% hint style="info" %}\n Como Usar o Cupom de Desconto na Hub NotificaMe\n\nO processo para aplicar nosso cupom de desconto no site da Hub NotificaMe foi atualizado.\n\nAgora, o campo para inserir o cupom aparecerá na tela de checkout, após você selecionar o plano e prosseguir para a página de pagamento.\n\nLembramos que nosso cupom ZDG40 oferece um desconto especial, reduzindo o valor de R$ 120 para R$ 50*.\n{% endhint %}\n\n\n\nApós criar sua conta na Hub NotificaMe, é possível conectar os canais no Z-PRO seguindo estes passos:\n\n### Como conectar no Z-PRO: \n\n Antes de conectar ao hub, você deve contratar o seu plano no Hub Notificame e informar nas configurações\n\n\n\n\n\n\n\nA conexão do Notificame trabalha com a integração com ChatGPT\n\n\n\nA conexão do Notificame trabalha com a integração com TypeBot\n\n\n\n\n\nA conexão com Notificame trabalha com a integração com Dify.\n\n\n\nA conexão com Notificame trabalha com a integração com N8N. \n\n\n\nA conexão com Notificame trabalha com a integração com Ollama.\n\n\n\nA conexão com Notificame trabalha com a integração com LM Studio.\n\n\n\nA conexão com Notificame trabalha com a integração com Grok.\n\n\n\nA conexão com Notificame trabalha com a integração com Gemini.\n\n\n\nA conexão com Notificame trabalha com a integração com Deepseek.\n\n\n\nA conexão com Notificame trabalha com a integração com Qwen.\n\n\n\nA conexão com Notificame trabalha com a integração com Claude.\n\n\n\nA conexão de Notificame trabalha com a integração com Mensagem de Despedida e Variáveis (X)\n\n\n\n\n\nVocê pode habilitar uma palavra chave para fechamento automático do atendimento. Essa é uma palavra chave que ao ser recebida irá encerrar o ticket automaticamente.\n\n\n\nA conexão com Notificame tabalha com integração com a Google-Speech-To-Text para transcrever áudios.\n\n\n\nA conexão de WhatsApp trabalha com a envio de avaliações automáticas\n\n\n\nA conexão de WhatsApp trabalha com auto distribuição de atendimentos (sobrescreve opções de fila)\n\n\n\nVocê pode habilitar desligamento automático das integrações externas ao abrir um ticket no atendimento: habilitando esta opção, ao abrir um atendimento as interações do ChatGPT, Typebot, Dify, N8N e DialogFlow serão desligadas.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/hub-notificame-face-insta-webchat-e-email.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Instagram e Facebook Messenger via OAuth (login)\n\nEssa é a forma mais rápida e recomendada de realizar a integração com Instagram e Facebook Messenger, pois dispensa a necessidade de criar e aprovar um aplicativo próprio no painel de desenvolvedores da Meta.\n\n{% embed url="https://youtu.be/_6SmcZ96_cM" %}\n\n*\n\n### Etapa 0: Liberação no Painel Super Admin (Para ambos os canais)\n\nA liberação da integração via aplicativo nativo precisa ser feita individualmente para cada empresa (Tenant) dentro do painel global. Esta etapa serve tanto para o Messenger quanto para o Instagram.\n\n1. Faça o login no Z-PRO com o seu usuário Super Admin.\n2. Acesse o menu Tenants e clique em Editar na empresa onde deseja ativar os canais.\n\n\n\nRole a página até encontrar a seção de Autenticação (OAuth).\n\n1. Habilite a chave de ativação do OAuth.\n2. Preencha os campos com as informações do aplicativo nativo:\n\n * URL / Domínio: \n\n https://oauth.techprovider.com.br\n\n * Webhook do Messenger:\n\n https://oauth.techprovider.com.br/messenger-webhook/\n\n * Webhook do Instagram: \n\n https://oauth.techprovider.com.br/instagram-wehbhook/\n\n * Chave Secreta (é a mesma tanto para instagram quanto para messenger):\n\n 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\n3. Clique em Salvar.\n\n\n\nObs: Volte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.\n\n\n\nClique em Salvar.\n\n*\n\n### Etapa 1: Permissões de ADM da Página do Facebook (Especificamente para o canal Facebook Messenger)\n\nAntes de ir para a tela de canais fazer a conexão, existe uma regra obrigatória apenas para o Facebook Messenger.\n\n(Se você vai conectar apenas o Instagram, pule para a Etapa 2).\n\n{% hint style="danger" %}\nATENÇÃO: O ACESSO DE ADM VIA GERENCIADOR DE NEGÓCIOS NÃO É SUFICIENTE PARA O MESSENGER\n{% endhint %}\n\nPara conectar o Messenger ao Z-PRO, o seu perfil pessoal do Facebook precisa estar adicionado como Administrador Direto da Página (Com perfil pessoal do facebook).\n\nTer "Acesso Total" através do Portfólio Empresarial (Gerenciador de Negócios / Meta Business Suite) não é suficiente para liberar a conexão. Se houver apenas esse acesso via portfólio / gerenciador, o sistema retornará um erro na hora de conectar.\n\n#### Como corrigir e se adicionar como Administrador da Página do Facebook:\n\nSe você já tem o acesso gerencial da página, siga estes passos no Facebook para se dar a permissão correta:\n\n1. Abra o Facebook e mude para o perfil da Página (Logar como a página).\n2. Acesse as Configurações da página.\n3. No menu lateral, clique em Acesso à Página (ou Configuração da Página > Acesso à Página).\n4. Na primeira seção, chamada "Pessoas com acesso do Facebook", clique em Adicionar novo.\n5. Pesquise pelo seu perfil pessoal (o perfil que você usa para logar no Facebook) e conceda Controle Total.\n6. Volte para o seu perfil pessoal do Facebook, abra suas notificações e Aceite o convite.\n\n\n\n### Etapa 2: Criando as Conexões no Painel Admin\n\nCom o OAuth liberado no Tenant (e as permissões do Facebook ajustadas, caso vá usar o Messenger), vamos realizar a conexão final no painel de atendimento.\n\nAcesse o Z-PRO com o seu usuário Administrador da conta (Tenant) e vá em Administração > Canais > Adicionar Canal.\n\n#### Conectando o Instagram\n\n\n\nO processo do Instagram é extremamente simples e não exige configurações avançadas de página.\n\n1. No tipo de canal, selecione Instagram.\n2. No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração OAuth que liberamos no Super Admin (meta.zdg.com.br).\n3. Clique no botão azul Conectar via Instagram OAuth.\n4. No Pop-up da Meta: Uma janela do Facebook será aberta. Siga as etapas na tela para vincular a conta do Instagram Business.\n Dica: Certifique-se de estar logado na sua conta do Instagram Business em outra aba do mesmo navegador para que o pop-up a reconheça e faça a vinculação automaticamente.\n\n#### Opção B: Conectando o Facebook Messenger\n\n\n\n1. No tipo de canal, selecione Facebook.\n2. No campo "Aplicativo Meta", clique no menu suspenso e selecione a integração Oauth que liberamos no super-admin (meta.zdg.com.br).\n3. Clique no botão azul Conectar via Facebook OAuth.\n4. No Pop-up da Meta: Uma janela do Facebook será aberta.\n Faça o login com o seu perfil pessoal (aquele que colocamos como administrador da página na Etapa 2).\n Clique em Continuar como \[Seu Nome].\n Selecione a Página que você deseja conectar ao ZPRO e conceda as permissões solicitadas.\n\n#### Pronto!\n\nSe tudo estiver correto, a janela pop-up se fechará e o seu canal (Instagram ou Messenger) aparecerá como Conectado na sua lista de canais.\n\nA partir de agora, todas as mensagens e directs dos canais instagram / facebook messenger chegarão diretamente na sua tela de atendimento do ZPRO!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Telegram\n\n### Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### Especificação Telegram:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/telegram.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Wavoip - Ligações pelo WhatsApp\n\n#### Pré-requisitos\n\n Uma conta ativa no Z-PRO.\n Uma conta ativa no Wavoip.\n O celular com o WhatsApp que será conectado em mãos.\n\n#### Passo 1: Criar Dispositivo no Wavoip\n\n1. Acesse o site wavoip.com e faça login (ou crie sua conta).\n2. No painel principal, clique em Adicionar dispositivos.\n3. Escolha o plano desejado (Ex: Whatsapp Desktop Gratuito ou Enterprise) e clique em Criar dispositivo.\n\n\n\n#### Passo 2: Obter o Token de Acesso\n\n1. Após criar o dispositivo, você será direcionado para a Dashboard do dispositivo.\n2. Localize o campo Token no topo da tela.\n3. Clique no ícone de copiar (ou selecione e copie o código manualmente).\n\n\n\n#### Passo 3: Configurar o Canal no Z-PRO\n\n1. Acesse o seu painel do Z-PRO.\n2. Vá até o menu de Canais (ou Conexões).\n3. Localize a conexão de WhatsApp que você deseja habilitar para ligações.\n4. Abra as configurações de edição desta conexão (ícone de engrenagem ou editar).\n5. Role a janela de configurações até encontrar o campo dedicado ao Wavoip.\n6. Cole o Token que você copiou no passo anterior dentro deste campo.\n7. Clique em Salvar.\n\n\n\n#### Passo 4: Conectar o Dispositivo (QR Code)\n\n1. Após salvar, observe que um ícone de telefone (telefone azul) aparecerá no card da sua conexão (geralmente ao lado das opções de configurações).\n2. Clique neste ícone de telefone.\n\n\n\n1. Uma janela se abrirá com um botão para gerar o QR Code ou já exibindo o código diretamente.\n2. Pegue o seu celular, abra o WhatsApp, vá em *Aparelhos Conectados > Conectar um aparelho.\n3. Escaneie o QR Code exibido na tela do Wavoip/Z-PRO.\n\n\n\nApós realizar a leitura o seu Z-PRO está integrado ao Wavoip. Você poderá realizar e receber chamadas de voz utilizando o número de WhatsApp conectado diretamente pela interface do sistema.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/wavoip-ligacoes-pelo-whatsapp.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Webchat\n\nA partir da versão 3.1.10, o Z-PRO oferece uma funcionalidade de Webchat nativo, permitindo que você incorpore uma janela de chat diretamente no seu site ou no site dos seus clientes, com as mensagens chegando diretamente na plataforma.\n\n\n\nPara funcionar, ele requer a instalação de um novo serviço no seu servidor (via autoinstalador) e a configuração de um subdomínio.\n\nDownload example.html para embedar o widget gerado: \n\n{% file src="/files/Z4IQM1DOefM5aazKRQK3" %}\n\n{% hint style="info" %}\nAntes de Começar: Crie um Subdomínio\n\nAntes de rodar o instalador, você DEVE criar um novo subdomínio (ex: chat.meusite.com.br) e apontá-lo (com um registro \'A\') para o IP da sua VPS onde o Z-PRO está instalado.\n{% endhint %}\n\n*\n\n{% embed url="https://www.youtube.com/watch?v=R46iwR5CLvU" %}\n\n### Passo a Passo: Instalação e Configuração\n\nO processo é dividido em duas etapas: criar o canal no Z-PRO e rodar o autoinstalador no servidor.\n\n#### Passo 1: Criar o Canal no Z-PRO\n\nPrimeiro, crie o canal que receberá as mensagens do webchat.\n\n1. Acesse o painel Admin > Canais.\n2. Clique em "Adicionar" e selecione a opção \'Webchat\'.\n3. Dê um nome (ex: "Chat do Site") e salve.\n4. Após salvar, clique no botão "Conectar" para ativá-lo.\n\n#### Passo 2: Rodar o Autoinstalador no Servidor\n\nAgora, vamos instalar o serviço de socket do webchat na sua VPS.\n\n1. Certifique-se de que seu autoinstalador está atualizado (substitua a pasta zpro_passaporte_shell pela mais recente no root da sua VPS).\n2. Acesse o SSH da sua VPS e entre na pasta do autoinstalador.\n3. Execute o autoinstalador (ex: ./zpro).\n4. Escolha a Opção 5 - Instalar Webchat.\n5. O script irá perguntar:\n * Qual instância: Escolha a instância do Z-PRO que usará o webchat (geralmente a \'1\').\n * Porta: Informe uma porta livre na sua VPS (ex: 5431, 5001). Anote esta porta.\n * Domínio: Informe o subdomínio que você criou (ex: chat.meusite.com.br).\n * E-mail: Um e-mail para o certificado SSL (Let\'s Encrypt).\n6. Aguarde o processo. O script irá criar um proxy reverso, configurar o SSL e liberar a porta no firewall.\n\n#### Passo 3: Gerar o Widget (Código de Incorporação)\n\nCom o canal criado e o serviço instalado, volte ao painel Z-PRO para gerar o código do seu chat.\n\n1. Acesse Admin > Configurações > Integrações.\n2. Selecione a aba \'Webchat\'.\n3. O sistema deve exibir a mensagem "Webchat configurado e pronto para uso" com um status verde.\n (Se não aparecer, aguarde alguns instantes e atualize a página. Se persistir, consulte a seção "Solução de Problemas" abaixo).*\n4. Gere um Token de Autenticação: Clique no botão para gerar um token seguro.\n5. Selecione o Canal: No campo abaixo, escolha o canal \'Webchat\' que você criou no Passo 1.\n6. Clique em \'Gerar Widget\'.\n\n#### Passo 4: Incorporar o Webchat no seu Site\n\n1. O sistema irá gerar um código JavaScript ( .\n3. Ao carregar a página, o ícone do chat aparecerá no canto direito, e você já pode testar o envio de mensagens.\n\n*\n\n### Solução de Problemas: Chat não conecta ou Status não fica verde\n\nSe o status em Integrações > Webchat não ficar verde, ou se as mensagens não chegarem, pode ser um problema de firewall ou de comunicação entre os serviços. Siga os passos abaixo no SSH:\n\nExecute no SSH:\n\n# 1. Desative o firewall temporariamente para testar\nsudo ufw disable\nsudo su deployzdg\ncd /home/deployzdg/zpro.io/backend\nnano .env\n\n# 2. Adicione a flag abaixo ao documento .env:\nSECURE_URL=*\n\n# 5. Confirme também se está definido corretamente porta e dominio do chat no mesmo arquivo:\nWSS_URL=[https://webchat.seusiteaqui.com.br](https://webchat.seusiteaqui.com.br)\nWSS_PORT=NUMERO_DA_PORTA\n\n# 6. Salve o documento, feche e reinicie o Z-PRO\npm2 stop all\npm2 flush\npm2 start all\n\n\nApós este processo, faça um novo teste no painel do Z-PRO.\n\n{% hint style="warning" %}\n Lembre-se de reativar seu firewall após o teste.\n\nSe o chat funcionar apenas com o firewall desativado, significa que você precisa liberar a porta que escolheu durante a instalação\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Webmail (Gmail)\n\nA integração de Webmail com o Gmail permite que você centralize sua comunicação por e-mail diretamente no Z-PRO. Com essa configuração, sua equipe poderá receber as mensagens na caixa de entrada unificada e responder aos e-mails diretamente pelo painel de atendimento.\n\nPara que a integração funcione corretamente (tanto para recebimento quanto para envio de respostas), é necessário configurar um aplicativo no Google Cloud Console e gerar uma Senha de App no Gmail. Siga o passo a passo abaixo:\n\n#### Passo 1: Criar o Aplicativo no Google Cloud Console\n\n1. Acesse o Google Cloud Console e faça login com a conta do Google que deseja vincular.\n2. Crie um Novo Projeto e dê um nome a ele (ex: "ZPRO Email").\n3. Na barra de pesquisa superior, busque por "Gmail API" e clique em Ativar.\n4. Antes de criar as credenciais, você precisa configurar a tela de permissão. No menu lateral, vá em Tela de consentimento OAuth.\n5. Selecione a opção "Externo" (se aplicável), clique em Criar e preencha os dados obrigatórios, como o nome do app e o e-mail de suporte.\n6. Após criar a tela de consentimento, é necessário colocar o aplicativo em produção. Clique em Publicar App.\n\n#### Passo 2: Gerar as Credenciais OAuth\n\n1. No menu do Google Cloud, vá até Credenciais e clique em Criar Credenciais -> ID do cliente OAuth.\n2. No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.\n3. Na seção "URIs de redirecionamento autorizados", você deve adicionar a URL do seu frontend acompanhada do callback do Gmail.\n Exemplo: https://app.seudominio.com.br/gmail_callback.html.\n4. Clique em Criar. O Google irá gerar o seu ID do Cliente e o seu Client Secret. Mantenha essa tela aberta para copiar os dados.\n\n#### Passo 3: Configurar o Canal no Z-PRO\n\n1. Acesse o painel Admin do Z-PRO, vá no menu Canais e adicione um novo canal do tipo Webmail.\n2. Dê um nome para o canal (ex: "Suporte Gmail").\n3. Importante: Salve o canal antes de prosseguir para a próxima etapa.\n4. Após salvar, clique para Editar o canal que você acabou de criar e vá na opção Configurar OAuth.\n5. Uma tela do Google será aberta. Selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação.\n6. Ao voltar para a edição do canal, o status deverá constar como "Autenticado". Clique em Conectar.\n\nNeste momento, o Z-PRO já estará apto a receber os e-mails.\n\n#### Passo 4: Configurar o SMTP para Envio de Respostas\n\nPara que você consiga enviar as respostas pelo painel de atendimento, é obrigatório configurar a saída (SMTP) utilizando uma Senha de App do Google.\n\n1. Acesse as configurações da sua Conta do Google (myaccount.google.com).\n2. Vá na aba Segurança e certifique-se de que a Verificação em duas etapas (2FA) está ativada.\n3. Na barra de pesquisa das configurações do Google, busque por "Senhas de app".\n4. Crie uma nova senha (dê um nome como "ZPRO SMTP") e o Google gerará uma senha de 16 letras.\n5. Retorne ao Z-PRO, edite o seu canal de Webmail e preencha a configuração de SMTP:\n Usuário: Seu endereço de e-mail remetente.\n Senha: Cole a Senha de App de 16 letras gerada no Google (certifique-se de remover os espaços entre as letras).\n6. Salve as configurações.\n\n{% hint style="warning" %}\nSe o sistema gerar algum erro de autenticação ou falha na hora de enviar a mensagem, exclua a senha anterior no painel do Google e recrie uma nova Senha de App. Depois, basta atualizar a nova senha nas configurações do canal no Z-PRO e salvar novamente.\n{% endhint %}\n\n{% embed url="https://www.loom.com/share/29429819aae543faacbfb44c2901c31d" %}\n\n**\n\n#### Como Receber e Responder E-mails na Tela de Atendimento\n\nCom a integração finalizada, o fluxo de comunicação via e-mail ocorrerá de forma nativa na sua caixa de entrada unificada:\n\n Recebendo um e-mail: Toda vez que um cliente enviar uma mensagem para a sua conta do Gmail vinculada, ela chegará automaticamente na tela de Atendimentos do Z-PRO, gerando um novo ticket de conversa.\n Enviar um e-mail: Para enviar um e-mail, clicar no icone na tela de atendimento e preencha os dados de envio.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Whatsapp Baileys (Não oficial)\n\n{% hint style="danger" %}\nAtenção: Risco de Banimento\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\n{% endhint %}\n\nA conexão via Baileys é uma solução de integração não oficial baseada em uma biblioteca de código aberto que emula o protocolo do WhatsApp Web. Ao contrário da API Oficial (WABA), a Baileys permite que você conecte um número de telefone comum ao sistema Z-PRO sem a necessidade de aprovação prévia da Meta ou de uma conta empresarial verificada.\n\n## Passo a passo para conexão\n\n### 1. Adicionar um canal Baileys\n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### 2. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal como "Baileys", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 3. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 4. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp Evolution API (Não Oficial)\n\n{% hint style="danger" %}\nAtenção: Risco de Banimento\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\n{% endhint %}\n\nA Evolution API é uma solução de integração não oficial de alto desempenho, que atua como um gateway entre o WhatsApp e o sistema Z-PRO. Diferente das bibliotecas simples, ela oferece uma camada extra de gerenciamento e robustez para as instâncias de WhatsApp conectadas via QR Code, permitindo uma operação mais estável em cenários de grande volume de mensagens\n\nA Evolution API permite que o sistema gerencie as sessões de forma desacoplada. Isso significa que, mesmo que a interface do Z-PRO sofra uma atualização, as instâncias no servidor da API permanecem conectadas, reduzindo a necessidade de novos pareamentos frequentes.\n\n## Passo a passo para conexão\n\n### 1. Instalar Evoluiton API\n\nAntes de qualquer configuração no painel Z-PRO, a Evolution API deve estar devidamente instalada e rodando em seu servidor.\n\n Siga as instruções técnicas contidas na página: Instalação: Evolution API\n\n### 2. Configuração no Painel Administrativo\n\n1. Acesse o menu Configurações > Integrações > Evolution API.\n\n\n\n2. Insira a URL da API (Ex: https://api.seuservidor.com).\n3. Cole a sua Global Key.\n4. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\n\n{% hint style="warning" %}\nAtenção: Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.\n{% endhint %}\n\nObservações Importantes:\n\n Conectando uma Instância Existente: Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o mesmo nome exato da instância. O sistema irá sincronizar e configurar o webhook.\n Nomenclatura: Não utilize caracteres especiais (como \_) no nome da instância, pois isso pode causar falhas na sincronização.\n Nome da Instância: Uma vez criado, o nome da instância não pode ser alterado.\n\n### 3. Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### 4. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 5. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 6. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Instalação: Evolution API\n\n{% hint style="warning" %}\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\n\nA Evoluiton API é uma solução de software de código aberto.\n\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\n\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\n{% endhint %}\n\n#### 1. Prepare o Ambiente\n\nAntes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:\n\n Git: Essencial para executar nosso script. Faça o download aqui.\n Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.\n\nApós instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.\n\n#### 2. Baixe o Script de Instalação\n\nPara facilitar sua vida, preparamos um pacote com tudo que você precisa.\n\n Baixe aqui o arquivo evolution.rar.\n Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo: C:\\Evolution).\n\n#### 3. Execute os Comandos no Terminal\n\nAgora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.\n\n1. Navegue até a pasta onde você descompactou os arquivos.\n2. Clique com o botão direito do mouse dentro da pasta e selecione a opção "Abrir no Terminal" ou "Open in Terminal".\n3. O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:\n\n \n & "C:\\Program Files\\Git\\bin\\bash.exe"\n\n4. Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:\n\n \n ./evolution.sh\n\n\nPronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.\n\n#### 4. Acessando e Conectando sua API\n\nCom tudo instalado, é hora de acessar o painel de controle.\n\n1. Abra seu navegador e acesse: http://localhost:8081\n2. Clique em "Manager". O sistema pedirá uma Chave Global (Global API Key).\n3. Para encontrá-la, abra o arquivo evolution.sh com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.\n4. Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.\n5. Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.\n\n#### 5. Integração com Z-PRO\n\nO último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.\n\n1. No painel Admin, navegue até Configurações > Integrações > Evolution.\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\_IP\\\\_DE\\\\_SERVIDOR:5555).\n3. Preencha a Chave Global com o APP\_ADMIN\_TOKEN definido no seu arquivo .env.\n4. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Evoluiton".\n5. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\n\n### Tutorial:\n\n{% embed url="https://www.youtube.com/watch?v=cQewqCSez5I" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp Oficial OAuth (login)\n\n#### O que é o Modo de Coexistência?\n\nAo utilizar este método, você conecta o seu número à API Oficial da Meta sem precisar desconectá-lo do seu aparelho celular. O WhatsApp passará a funcionar simultaneamente no aplicativo WhatsApp Business do seu smartphone e no painel do Z-PRO. É a união da estabilidade da API Oficial com a praticidade de manter o celular ativo.\n\n{% embed url="https://youtu.be/v-eVzsAwJXQ" %}\n\n{% hint style="danger" %}\nNOVA URL OAUTH: https://oauth.techprovider.com.br\n{% endhint %}\n\n*\n\n### Etapa 0: Ativação do Canal no Painel Super Admin\n\nA liberação do recurso OAuth é feita por empresa (Tenant). Se você é o assinante do ZPRO, siga estes passos. Se você é um cliente ou está usando apenas o acesso demo do sistema, solicite essa liberação ao suporte e pule para a etapa 1.\n\nFaça login no sistema com seu usuário Super Admin.\n\nNo menu lateral, acesse Tenants (Empresas) e clique em Editar na empresa desejada.\n\n\n\nRole a página até encontrar a opção OAuth (Login Incorporado) e ative a chave.\n\n\n\n{% hint style="danger" %}\nNOVA URL OAUTH: [https://oauth.techprovider.com.br**](https://oauth.techprovider.com.br)\n{% endhint %}\n\nVolte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.\n\n\n\n{% hint style="warning" %}\nMetal URL: https://oauth.techprovider.com.br\n\nInstagram Webhook \n\n• URL: https://oauth.techprovider.com.br/instagram-webhook \n\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\n\nMessenger Webhook \n\n• URL: https://oauth.techprovider.com.br/messenger-webhook \n\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\n{% endhint %}\n\nClique em Salvar.\n\n### Etapa 1: Criando a Conexão no Painel Admin\n\nCom o recurso liberado, acesse a conta da empresa (Admin normal) para realizar a conexão.\n\n\n\n1. No menu lateral, acesse Administração > Canais.\n2. Clique no botão Adicionar Canal.\n3. No campo "Tipo de Canal", selecione a opção WhatsApp OAuth.\n4. Selecione o Aplicativo Meta: Você verá um menu suspenso para escolher o aplicativo.\n Selecione o aplicativo nativo fornecido pela plataforma (ex: teste login incorporado tech provider zdg ou ZDG App).\n (Nota: Caso sua empresa seja um Tech Provider aprovado pela Meta, você poderá selecionar seu próprio App configurado previamente).\n5. Clique no botão azul Conectar via WhatsApp OAuth.\n\n### Etapa 2: Autenticação com a Meta e Leitura do QR Code\n\nAo clicar em conectar, uma janela pop-up oficial do Facebook/Meta será aberta. Atenção: Tenha o seu celular com o WhatsApp Business em mãos.\n\n\n\n1. Na janela da Meta, clique em Continuar e faça o login com seu Facebook.\n2. Siga as instruções da tela para selecionar ou criar a sua conta do WhatsApp Business e seu Gerenciador de Negócios.\n3. Insira o Número: Digite o número de telefone exato que está no seu WhatsApp Business.\n4. Aprovação no Celular:\n Abra o aplicativo WhatsApp Business no seu celular.\n Você receberá uma notificação da Meta solicitando a conexão.\n Aceite a notificação. O aplicativo solicitará que você faça a leitura de um QR Code (ou aprove o compartilhamento de conversas) diretamente na tela do computador.\n5. Após confirmar no celular, a janela da Meta será finalizada e o canal aparecerá como Conectado no ZPRO.\n\nPronto! Seu número já está operando em Modo de Coexistência. As mensagens chegarão tanto no seu celular quanto na tela de atendimento do Z-PRO. Como esta é uma conexão via API Oficial, você não sofrerá com bloqueios relacionados ao uso de sistemas de terceiros.\n\n### Etapa 4: Configuração de Pagamento na Meta\n\nEmbora a conexão já esteja funcionando para receber e responder mensagens dentro da janela de 24 horas, há um passo final recomendado pela Meta.\n\nAo conectar seu WhatsApp Business, a Meta realizará uma análise final da sua empresa. Após isso, para que você possa enviar mensagens ativas (templates/campanhas de massa) fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento na Meta.\n\n1. Acesse o seu painel do Gerenciador de Negócios da Meta.\n 1. https://business.facebook.com/billing_hub/accounts\n2. Vá nas configurações de conta do WhatsApp Business.\n3. Encontre a conta de WhatsApp que foi conectada e adicione um *Cartão de Crédito.\n4. A partir desse momento, sua conta estará 100% apta para receber, responder e iniciar novas conversas (disparos) através do ZPRO.\n\nPara testar, envie uma mensagem de outro número para o seu WhatsApp Business. Você verá a mensagem chegando instantaneamente no seu celular e na aba "Pendentes" na tela de atendimento do seu ZPRO!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Whatsapp Uazapi\n\nA Uazapi também é uma solução não oficial paga e gerenciada. https://uazapi.dev/\n\n## Passo a passo para conexão\n\n### 1. Contratar a Uazapi\n\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://uazapi.dev/\n\nPré-requisito na Plataforma Z-API\n\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\n\n### 2. Configuração no Painel Administrativo\n\n1. Acesse o menu Configurações > Integrações > WuzAPI\n\n\n\n1. URL da API: A URL do servidor da sua conta Uazapi.\n2. Chave Global: O "Admin Token" fornecido no painel da sua conta Uazapi.\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\n\n### 3. Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\nA integração com a Uazapi oferece duas possibilidades:\n\n A) Criar uma Nova Instância:\n 1. No painel Admin, vá em Canais > Adicionar Canal e selecione "Uazapi".\n 2. Dê um nome para a nova instância (ex: "Cliente A").\n 3. Deixe os campos ID da Instância e Token em branco.\n 4. Salve. O Z-PRO irá criar a nova instância na sua conta Uazapi e preencherá as credenciais automaticamente.\n B) Conectar a uma Instância Existente:\n 1. Siga os mesmos passos acima, mas desta vez preencha os campos ID da Instância e Token com as informações da instância já existente na sua conta Uazapi.\n\n### 4. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 5. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 6. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp WebJs (Não oficial)\n\n{% hint style="danger" %}\nAtenção: Risco de Banimento\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\n{% endhint %}\n\nA conexão via WebJS é uma solução de integração não oficial baseada na biblioteca whatsapp-web.js. Diferente de outras integrações, ela funciona através da automação e simulação de uma instância real do WhatsApp Web em um navegador interno no servidor. Isso permite que o sistema utilize todas as funcionalidades da interface web original sem a necessidade da API Oficial (WABA).\n\nA biblioteca WebJS opera simulando a navegação de um usuário real no WhatsApp Web. Por rodar um navegador em segundo plano (headless browser), essa conexão pode exigir um pouco mais de processamento do servidor em comparação à Baileys, mas oferece uma fidelidade maior aos recursos disponíveis na versão oficial para navegador do WhatsApp.\n\n## Passo a passo para conexão\n\n### 1. Adicionar um canal\n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### 2. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal como "WebJS", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 3. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 4. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp WUZAPI Meow API\n\n{% hint style="danger" %}\nAtenção: Risco de Banimento\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\n{% endhint %}\n\nA WUZAPI (Meow API) diferencia-se de outras bibliotecas por ser desenvolvida em Go (Golang), uma linguagem de programação conhecida por sua alta performance e eficiência no gerenciamento de concorrência. Tecnicamente, a solução funciona como um serviço headless (sem interface gráfica), o que reduz drasticamente o consumo de memória RAM e processamento no servidor em comparação com emuladores de navegador.\n\n## Passo a passo para conexão\n\n### 1. Instalar WUZAPI (Meow API)\n\nAntes de qualquer configuração no painel Z-PRO, é preciso instalar essa API\n\n Siga as instruções técnicas contidas na página: Instalação: Wuzapi (Meow)\n\nPré-requisito na Instalação do Wuzapi\n\n No arquivo de configuração (.env) da sua instalação do Wuzapi, é obrigatório preencher a variável API\_URL com a URL pública onde sua instância do Wuzapi está acessível.\n\n### 2. Configuração no Painel Administrativo\n\n1. Acesse o menu Configurações > Integrações > WuzAPI\n\n\n\n1. URL da API: A URL base da sua instalação do Wuzapi.\n2. Chave Global: O token de administrador definido na variável APP\_ADMIN\_TOKEN do arquivo .env do seu Wuzapi.\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\n\n### 3. Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### 4. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 5. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 6. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Instalação: Wuzapi (Meow)\n\n{% hint style="warning" %}\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\n\nA Wuzapi (Meow) é uma solução de software de código aberto.\n\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\n\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\n{% endhint %}\n\nEste guia fornece o passo a passo técnico para realizar uma instalação auto-hospedada (self-hosted) da Wuzapi (Meow), uma API de conexão não oficial para WhatsApp.\n\nAo final deste processo, você terá uma instância da Wuzapi funcional em seu próprio servidor, pronta para ser integrada à sua plataforma Z-PRO.\n\n{% hint style="info" %}\nVisão Geral do Processo de Instalação:\n\n1. Preparação do Ambiente: Atualizar o servidor e instalar as dependências (Git, PM2, Go).\n2. Instalação do Wuzapi: Clonar o repositório e compilar a aplicação.\n3. Configuração: Ajustar o arquivo de variáveis de ambiente (.env).\n4. Execução e Gerenciamento: Iniciar a API e configurá-la como um serviço persistente com PM2.\n5. Integração com Z-PRO: Conectar a nova instância ao seu painel.\n {% endhint %}\n\n\\n1. Preparação do Ambiente do Servidor\n\nEstes comandos preparam seu servidor Ubuntu com todas as ferramentas necessárias para a instalação.\n\n1. Atualizar o Servidor e Instalar o Git:\n\n codeBash\n\n \n sudo apt update && sudo apt upgrade -y && sudo apt install git -y\n sudo apt install npm\n\n2. Instalar o PM2:\\n O PM2 é um gerenciador de processos que manterá a API da Wuzapi rodando como um serviço.\n\n codeBash\n\n \n npm install -g pm2\n\n3. Instalar a Linguagem Go (GoLang):\\n A Wuzapi é construída em Go, portanto a linguagem precisa ser instalada no servidor.\n\n codeBash\n\n \n # Baixa o pacote de instalação\n wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz\n\n # Remove instalações antigas (se houver)\n sudo rm -rf /usr/local/go\n\n # Extrai os arquivos para o local correto\n sudo tar -C /usr/local -xzf go1.21.1.linux-amd64.tar.gz\n\n # Adiciona o Go ao PATH do sistema\n echo \'export PATH=$PATH:/usr/local/go/bin\' >> ~/.bashrc\n source ~/.bashrc\n\n # Verifica a instalação\n go version\n\n\n O terminal deve retornar a versão do Go instalada (ex: go version go1.21.1 linux/amd64).\n\n*\n\n#### 2. Instalação da Aplicação Wuzapi\n\nAgora, vamos baixar o código-fonte da Wuzapi e compilá-lo.\n\n1. Clonar o Repositório:\\n Este comando baixa a versão da Wuzapi compatível com o Z-PRO.\n\n codeBash\n\n \n git clone https://github.com/pedroherpeto/wuzapi.git\n\n2. Acessar o Diretório:\n\n codeBash\n\n \n cd wuzapi\n\n3. Baixar Dependências:\n\n codeBash\n\n \n go mod tidy\n\n4. Compilar a Aplicação:\\n Este comando cria o arquivo executável chamado wuzapi.\n\n codeBash\n\n \n go build -o wuzapi\n\n\n*\n\n#### 3. Configuração do Arquivo .env\n\nAntes de iniciar a API, é fundamental configurar as variáveis de ambiente, principalmente as de acesso ao banco de dados.\n\n1. Acesse e edite o arquivo .env.example para criar seu arquivo de configuração. É comum renomeá-lo para .env.\n2. Preencha as variáveis do banco de dados (DB\_HOST, DB\_USER, DB\_PASSWORD, DB\_NAME, DB\_PORT).\n\n{% hint style="success" %}\nDica de Configuração: É uma prática comum utilizar as mesmas credenciais do banco de dados da sua instalação Z-PRO. Ao fazer isso, a Wuzapi criará suas próprias tabelas no mesmo banco de dados, simplificando o gerenciamento.\n{% endhint %}\n\n*\n\n#### 4. Execução e Gerenciamento com PM2\n\nCom a aplicação compilada e configurada, vamos iniciá-la.\n\n1. Execução para Teste (Opcional):\\n Você pode iniciar a API manualmente para um teste rápido. O comando abaixo a iniciará na porta 5555.\n\n codeBash\n\n \n ./wuzapi -port 5555\n\n\n Para confirmar que está funcionando, acesse http://SEU\\\\_IP\\\\_DE\\\\_SERVIDOR:5555 no navegador.\n2. Iniciando como um Serviço com PM2:\\n Este comando iniciará a Wuzapi e garantirá que ela reinicie automaticamente em caso de falhas ou após o boot do servidor.\n\n codeBash\n\n \n # Inicia o serviço\n pm2 start ./wuzapi --name "wuzapi" -- -port 5555\n\n # Salva a lista de processos do PM2\n pm2 save\n\n # Configura o PM2 para iniciar com o sistema\n pm2 startup\n\n3. Verificando os Logs:\\n Para acompanhar os logs da aplicação em tempo real, use o comando:\n\n codeBash\n\n \n pm2 logs wuzapi\n\n\n*\n\n#### 5. Integração com Z-PRO\n\nO último passo é conectar sua nova instância da Wuzapi ao painel do Z-PRO.\n\n1. No painel Admin, navegue até Configurações > Integrações > Wuzapi.\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\_IP\\\\_DE\\\\_SERVIDOR:5555).\n3. Preencha a Chave Global com o APP\_ADMIN\_TOKEN definido no seu arquivo .env.\n\n\n\n1. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Wuzapi".\n\n\n\n1. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\n\n*\n\n#### Tutorial em Vídeo**\n\nPara uma demonstração visual detalhada de todos os passos descritos nesta documentação, assista à gravação completa.\n\n{% embed url="https://www.youtube.com/watch?t=1s&v=s7G1ZuQLw0Y" %}\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Whatsapp Z-API\n\nA Z-API é uma solução não oficial paga e gerenciada por uma empresa externa. https://www.z-api.io/\n\n## Passo a passo para conexão\n\n### 1. Contratar a Z-API\n\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://www.z-api.io/\n\nPré-requisito na Plataforma Z-API\n\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\n\n### 2. Configuração no Painel Administrativo\n\n1. Acesse o menu Configurações > Integrações > WuzAPI\n\n\n\n1. URL da API: A URL padrão do serviço (https://api.z-api.io).\n2. Chave Global: O seu "Token de Segurança" gerado nas configurações da sua conta na Z-API.\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\n\n### 3. Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\nConfiguração adicional para a Z-API: \n\n ID da Instância\n Token da Instância\n\n\n\n### 4. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 5. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 6. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Equipes\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e supervisor\n{% endhint %}\n\nA página de Equipes é o local central para a organização dos agentes de atendimento. Através dela, o administrador segmenta os colaboradores por especialidade, departamento ou função, permitindo uma distribuição de tickets mais eficiente e organizada.\n\n#### Principais funções\n\n Segmentação de Atendimento: Criação de departamentos (ex: Comercial, Suporte, Financeiro).\n Gestão de Membros: Vinculação de usuários específicos a cada equipe.\n Controle de Visibilidade: Ativação ou desativação de equipes conforme a demanda.\n Organização Visual: Personalização de cada equipe com fotos identificadoras.\n\n#### Caso de uso\n\nUma empresa que possui diferentes fluxos de atendimento utiliza a página de Equipes para separar o setor de Suporte Técnico do Setor de Vendas. Assim, ao realizar a transferência de um Ticket, o sistema direciona a demanda apenas para os Usuários vinculados à equipe selecionada, otimizando o tempo de resposta.\n\n#### Como acessar a página\n\nPara acessar, clique no Menu Administração e selecione a aba Equipes.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Campo de Busca: Permite localizar uma equipe específica pelo nome.\n Botão + Nova Equipe: Abre o formulário para criação de um novo grupo de atendimento.\n ID: Identificador único da equipe no banco de dados.\n Nome: Nome atribuído à equipe (ex: Suporte, Vendas).\n Status: Indica se a equipe está Ativa (apta a receber tickets) ou Inativa.\n Membros: Exibe a quantidade de usuários vinculados àquela equipe.\n Ações:\n Ícone Gerenciar Membros (Usuário com +): Abre a tela para adicionar ou remover atendentes da equipe.\n Ícone Editar (Lápis): Permite alterar o nome, foto ou status da equipe.\n Ícone Excluir (Lixeira): Remove a equipe permanentemente do sistema.\n\n*\n\n#### Passo a passo de uso\n\nCriar uma nova equipe\n\n1. Acesse o menu Equipes e clique no botão + Nova Equipe.\n2. Insira o Nome da equipe no campo correspondente.\n3. Mantenha a chave Ativa habilitada para que a equipe fique disponível para uso imediato.\n4. Clique em Salvar.\n\n\n\nGerenciar membros da equipe\n\n1. Na listagem de equipes, identifique a equipe desejada e clique no ícone Gerenciar Membros (ícone de usuário com um sinal de "+").\n2. Selecione os Usuários que farão parte deste time.\n3. Confirme a operação para salvar as alterações.\n\n#### Detalhamento\n\nAs equipes criadas nesta página serão refletidas diretamente no Chat Privado \n\n\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nAtenção: Ao excluir uma equipe, certifique-se de que não existam tickets pendentes vinculados a ela, pois isso pode causar inconsistência na distribuição dos atendimentos em aberto.\n{% endhint %}\n\n{% hint style="info" %}\nA foto da equipe deve respeitar o limite de 5MB**. Formatos recomendados: PNG ou JPG.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/equipes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Usuários\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nA página de Usuários é o centro de gestão de acessos do sistema Z-PRO. Nela, o administrador realiza o cadastro de novos colaboradores, define níveis de hierarquia através de perfis, controla permissões de visibilidade de módulos e estabelece jornadas de trabalho por meio da configuração de horários.\n\n#### Principais funções\n\n Gestão de Identidade: Cadastro e edição de credenciais de acesso (e-mail e senha).\n Hierarquia de Acesso: Atribuição de perfis (Administrador, Supervisor, Atendente ou Personalizado).\n Controle de Módulos: Definição manual de quais menus cada usuário pode visualizar.\n Integração de Telefonia: Configuração de ramais SIP e permissões para chamadas via WaVoIP.\n Jornada de Trabalho: Estabelecimento de horários de atendimento individuais por usuário.\n\n#### Caso de uso\n\nUma empresa contrata um novo colaborador para o setor de suporte. O administrador cria o usuário e, em vez de dar acesso total, seleciona o perfil Atendente. Nas Permissões de Menu, ele habilita apenas "Chat Privado", "Tarefas" e "Contatos". Além disso, configura o Horário de Atendimento para que o sistema impeça o recebimento de novos Tickets fora do expediente do colaborador.\n\n#### Como acessar a página\n\nCaminho clicando no Menu Administração e na aba Usuários.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\nColunas da Tabela:\n\n Nome/E-mail: Identificação do colaborador e sua credencial de login.\n Perfil: Badge que indica o nível de acesso (Admin, Supervisor, Atendente ou Perfis Customizados).\n Status: Indica se o usuário está Ativo ou Inativo no sistema.\n Online: Chave seletora que mostra se o usuário está logado no momento.\n\nAções (Ícones):\n\n Ícone Gerenciar Filas (Vínculo): Permite vincular o usuário às Filas de Atendimento.\n Ícone Canais (Smartphone): Define quais Canais de Comunicação o usuário pode operar.\n Ícone Editar (Lápis): Abre o modal completo de edição de dados e permissões.\n Ícone Equipes (Pessoa com x): Inativa o usuário\n Ícone Excluir (Lixeira): Remove o usuário permanentemente do sistema.\n\n*\n\n#### Passo a passo de uso\n\n1. Criar um novo usuário\n\n1. Clique no botão + Novo Usuário no canto superior direito.\n2. Preencha os dados básicos: Nome, E-mail, Senha e Telefone.\n3. Perfil: Escolha entre as opções fixas ou a opção Personalizado (ver detalhamento abaixo).\n\n\n\nUsuário Restrito: Quando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada. Explicação mais abaixo.\n\nPermissões de Menu: Marque os módulos que o colaborador terá acesso (Ex: Envio em Massa, Kanban, Campanhas).\n\n\n\n2. Configurar Telefonia (Opcional)\n\nBloquear WaVoIP:se desejar impedir que o usuário realize chamadas pela plataforma.\n\n\n\nConfig SIP: habilite a chave se houver integração com telefonia IP.\n\n\n\nPreencha os dados do servidor, usuário e senha fornecidos pelo seu provedor VoIP.\n\n3. Definir Horário de Atendimento\n\n1. Expanda a seção Horário de Atendimento.\n2. Defina para cada dia da semana se o usuário está "Aberto" ou "Fechado".\n3. Configure os turnos (1º e 2º período). O usuário só aparecerá como disponível para novos atendimentos dentro destes intervalos.\n\n\n\n*\n\n### Detalhamento\n\n#### Perfis de Acesso\n\nO Z-PRO permite uma granularidade avançada através dos Perfis de Acesso:\n\n Administrador: Possui acesso total e irrestrito a todas as configurações e dados.\n Supervisor: Nível intermediário, focado em monitoramento e gestão de filas/relatórios.\n Atendente: Focado na operação direta de chats e contatos.\n Personalizado: Ao selecionar esta opção, surge o campo Perfil de Acesso, onde você pode escolher um template de permissões pré-criado.\n\nGerenciar Perfis\n\nAo clicar no botão Gerenciar Perfis no topo da tela, o sistema abre uma área exclusiva para a criação de novos templates de permissões reutilizáveis\n\n### Usuário Restrito\n\nQuando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada da seguinte forma:\n\nMenu de Contatos Oculto: O usuário não terá acesso ao menu "Contatos", impedindo a visualização ou exportação da lista completa de contatos.\n\n\n\nProibido Iniciar Novas Conversas\n\n O botão "Iniciar Conversa Avulsa" na tela de Atendimentos será ocultado.\n\n\n\n#### Na Tela de Atendimento (Chat)\n\nDentro de um ticket, o usuário restrito sofrerá as seguintes limitações visuais e funcionais:\n\n Nome do Contato: Será exibido parcialmente (apenas os 5 primeiros caracteres).\n Foto do Perfil: Receberá um forte efeito de desfoque (blur).\n Dados Sensíveis: Todos os campos de detalhes do contato na barra lateral (como Telefone, E-mail, CPF, etc.) serão ocultados.\n Botão Editar Contato: O ícone de lápis para editar o contato será ocultado.\n Opções de Telefonia: Os botões de telefonia serão desabilitados.\n Ações de Mensagem: As opções "Encaminhar" e "Marcar" serão desabilitadas para impedir o vazamento de dados.\n\n{% hint style="success" %}\nObjetivo da Restrição\n\nEsta funcionalidade é desenhada para proteger os dados sensíveis dos seus clientes, limitando o acesso apenas ao necessário para a função do atendente e alinhando sua operação às melhores práticas de segurança e à LGPD.\n{% endhint %}\n\n**\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nAtenção: Ao inativar um usuário, ele perderá o acesso imediato ao painel, porém seus dados e histórico de atendimentos permanecem salvos no banco de dados para auditoria.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Perfis de Acesso\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nA página de Perfis de Acesso permite a criação de templates de permissões reutilizáveis e granulares. Em vez de configurar cada usuário individualmente, o administrador define um perfil padrão (ex: "Suporte Nível 1") e o atribui a vários colaboradores.\n\n#### Caso de uso\n\nUma empresa deseja criar um perfil específico para estagiários que apenas respondem chats, mas não podem excluir contatos ou exportar relatórios. O administrador cria o perfil "Estagiário", desmarca as opções de "Excluir" e "Exportar", e vincula todos os novos estagiários a este template. Se futuramente a empresa decidir que estagiários podem acessar o Kanban, basta editar o perfil uma única vez.\n\n#### Como acessar a página\n\nCaminho clicando no Menu Administração, aba Usuários e no botão superior direito Gerenciar Perfis.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Botão + Novo Perfil: Abre o formulário para criação de um novo template de acesso.\n Nome do Perfil: Identificação do template (ex: Atendente Noturno).\n Contador de Usuários: Exibe quantos colaboradores estão vinculados àquele perfil no momento.\n Ícone Editar (Lápis): Permite alterar as permissões e o nome do perfil.\n Ícone Excluir (Lixeira): Remove o perfil do sistema\n\n**\n\n#### Passo a passo de uso\n\n1. Criar um Perfil com IA (Copiloto)\n\n1. Clique em + Novo Perfil.\n2. No campo Sugerir com IA, descreva o que o usuário fará. Exemplo: "Atendente que responde tickets e vê contatos, mas não pode deletar nada nem exportar".\n3. Clique em Sugerir. O Copiloto marcará automaticamente os campos correspondentes.\n4. Revise as marcações manuais antes de salvar.\n\n\n\n2. Configuração Manual\n\n1. Insira o Nome do perfil e uma Descrição opcional.\n2. Navegue pelas seções de Módulos Visíveis para definir o que aparecerá no menu lateral do usuário.\n3. Navegue pela seção Permissões para definir as ações permitidas (ex: resolver ticket, deletar mensagem).\n4. Clique em Salvar.\n\n3. Atribuir o Perfil ao Usuário\n\n1. Volte para a página de Usuários.\n2. Edite o usuário desejado, mude o campo Perfil para Personalizado.\n3. No novo campo que surgirá (Perfil de acesso), selecione o template criado.\n\n*\n\n#### Detalhamento das Permissões\n\nAbaixo estão os agrupamentos de permissões disponíveis para configuração:\n\nMódulos Visíveis (Sidebar)\n\n* Principal: Ter acesso aos menus atendimento, chat-privado, contatos, mensagens-rápidas, painel-atendimento, tarefas e wavoip.\n* Organização: Ter acesso aos menus agenda, campanhas, funil, galeria, grupo e kanban.\n* Configuração: Ter acesso aos menus agendamentos, aniversários, auto-resposta, avaliações, chat-flow, etiquetas, fechamento, filas, horário-Atendimento, notas e protocolos.\n* Relatórios: Ter acesso aos menus audit-log, dashboard, log- ligação e relatórios.\n* Integrações e Canais: Ter acesso aos menus api-service, sessões e woocommerce-produtos.\n* Redes Sociais: Ter acesso aos menus de gestão de comentários do facebook, instagram, tiktok e youtube, além de menções no instagram.\n* Administração: Ter acesso aos menus de equipes e usuários.\n\n\n\n\n\nPermissões de Ação\n\n* Atendimentos: Permissões para atribuir tickets (assign), usar o copiloto de IA (copilot), criar (create), deletar (delete), reabrir (reopen), resolver (resolve), visualizar todos (view\_all) e visualizar via chatbot (view\_chatbot).\n* Contatos: Permissões para criar (create), deletar (delete), editar (edit), exportar base (export) e visualizar todos os detalhes (view\_full).\n* Mensagens: Permissões para deletar mensagens enviadas (delete), encaminhar mensagens (forward) e gerenciar respostas rápidas públicas (quickreplies\_manage\_public).\n* Tarefas: Permissões para criar (create), deletar (delete), editar (edit) e visualizar todas (view\_all).\n* Kanban e Funil: Permissões para visualizar o painel de atendimentos geral (attendance\_panel\_view\_all), gerenciar o funil (funnel\_manage) e gerenciar o kanban (kanban\_manage).\n* Relatórios: Permissões para exportar dados (export) e visualizar relatórios (view).\n* Configurações: Permissão para acessar as configurações gerais do sistema (settings\_general).\n* Módulos Diversos: Permissões para gerenciar horários (business\_hours), campanhas (campaigns), chatflow (chat\_flow), motivos de fechamento (closure\_reasons), galeria (gallery), grupos (groups), envios em massa (mass\_send), notas (notes), notificações (notifications), acesso ao chat privado (private\_chat), protocolos (protocols), filas (queues), avaliações (ratings), mensagens agendadas (scheduled\_messages) e etiquetas (tags).\n* Administração Avançada: Permissões para gerenciar serviços de API (api\_service\_access), visualizar logs de auditoria (audit\_log\_view), gerenciar sessões/canais (sessions\_manage) e gerenciar ou visualizar usuários (users\_manage / users\_view).\n* VoIP: Permissões para uso do serviço WaVoIP (voip\_wavoip) e acesso ao webphone (voip\_webphone).\n\n\n\n\n\n*\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nRegra de Exclusão: Um perfil que esteja sendo utilizado por pelo menos um usuário ativo não poderá ser excluído. Para deletá-lo, você deve primeiro reatribuir esses usuários a outro perfil.\n{% endhint %}\n\n{% hint style="danger" %}\nSegurança: Ao usar a sugestão por IA, sempre revise manualmente se as permissões críticas (como tickets_delete ou audit_log_view) foram marcadas corretamente para evitar exposição de dados sensíveis.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Automação\n\n- Agendamentos: Visualização de Agendamentos\n- Aniversários: Visualização de Aniversários\n- Chat Flow\n- Gerenciando os fluxos: Robô de Atendimento\n- Etapas para criação do fluxo: Criando os Fluxos\n- Possíveis erros: Chatbbot nativo\n- Distribuição sequencial Chatbot\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Agendamentos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Agendamentos é uma ferramenta de automação que permite programar o envio de mensagens para datas e horários futuros. Com ela, o gestor ou atendente pode garantir que comunicações importantes, cobranças ou lembretes sejam entregues ao destinatário no momento oportuno, sem a necessidade de intervenção manual no horário do disparo.\n\n#### Principais funções\n\n Programação de Mensagens: Definição exata de dia e hora para o envio.\n Gestão de Recorrência: Configuração de disparos repetitivos em intervalos pré-definidos.\n Monitoramento de Status: Acompanhamento em tempo real se a mensagem foi enviada ou se houve falha.\n\n#### Caso de uso\n\nUm escritório de contabilidade precisa enviar um lembrete de vencimento de impostos para um cliente todo dia 10 de cada mês. O administrador utiliza a página de Agendamentos, seleciona o Contato, define a Recorrência para mensal e escreve a mensagem. O sistema cuidará do disparo automático, garantindo a pontualidade da entrega.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Automação e selecione a aba Agendamentos.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nColunas da Tabela:\n\n # (ID): Código identificador único do agendamento (UUID).\n Contato: Nome do cliente ou número que receberá a mensagem.\n Mensagem: Prévia do texto que será enviado.\n Agendado para: Data e hora programada para o disparo.\n Criado em: Registro de quando o agendamento foi configurado.\n Status: Indica a situação da mensagem (Pendente, Enviado, Falhou ou Cancelado).\n Ações: Ícones para editar agendamentos pendentes ou excluir registros.\n\n*\n\n#### Passo a passo de uso\n\nCriar um novo agendamento\n\n1. Clique no botão + Novo Agendamento.\n2. Conexão: Selecione por qual Canal a mensagem deve sair.\n3. Contato: Pesquise pelo nome ou número do contato na sua base de dados.\n4. Quando: Escolha um período pré-definido ou selecione Personalizado para habilitar os campos de Data e Hora.\n5. Recorrência: Defina se a mensagem deve ser enviada apenas uma vez (Sem repetição) ou se deve se repetir em intervalos específicos (ex: a cada 5, 10 ou 15 dias).\n6. Mensagem: Digite o texto desejado. Você pode utilizar emojis e habilitar a Assinatura do atendente se desejar.\n7. Clique em Agendar.\n\n\n\n*\n\n#### Detalhamento\n\n Status de Falha: Se um agendamento aparecer com o status "Falhou", verifique se o Canal selecionado estava conectado no momento do disparo ou se o número do contato é válido.\n Mensagens Recorrentes: Uma mensagem configurada com recorrência gerará um novo registro na lista automaticamente após o envio do ciclo atual, respeitando o intervalo definido.\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nAtenção: Para interromper uma sequência de mensagens recorrentes, você deve localizar o agendamento na lista e realizar a exclusão manual.\n{% endhint %}\n\n{% hint style="info" %}\nCertifique-se de que a Conexão escolhida esteja ativa e com bateria/internet estável no celular (em casos de APIs não oficiais) para garantir a entrega.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/agendamentos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Aniversários\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\n## Aniversários\n\n{% hint style="info" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Aniversários é uma ferramenta de relacionamento voltada para a fidelização de clientes. Nela, o sistema centraliza todos os contatos que possuem data de nascimento cadastrada, permitindo o acompanhamento cronológico dos aniversariantes e o envio de mensagens comemorativas manuais ou automatizadas.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Automação e selecione a aba Aniversários.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Barra de Busca: Localiza um contato específico pelo nome ou parte dele.\n Contador de Contatos: Exibe o total de pessoas na base que possuem data de nascimento preenchida.\n Colunas da Tabela:\n Nome: Identificação do contato.\n Número: Telefone vinculado ao cadastro.\n Data de Nascimento: Dia, mês e ano registrados no Contato.\n Idade: Cálculo automático da idade atual.\n Dias Restantes: Cronômetro regressivo para a próxima celebração.\n Ações (Ícone de Balão): Abre o modal para envio de uma mensagem rápida de felicitação.\n\n**\n\nEnviar Mensagem Manual\n\n1. Identifique o aniversariante na lista e clique no ícone de Balão (Responder) na coluna Ações.\n2. No modal que será aberto, selecione a Conexão (canal de saída) desejada.\n3. Certifique-se de que a mensagem padrão (ou a que você digitar) está correta.\n4. Clique em Enviar.\n\n\n\n*\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nCadastro de Dados:** A página de Aniversários só exibirá contatos que tenham o campo "Data de Nascimento" preenchido corretamente no módulo de Contatos.\n{% endhint %}\n\n{% hint style="info" %}\nO envio de mensagens através desta tela segue as mesmas regras de segurança das Campanhas, dependendo da estabilidade da conexão selecionada.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/aniversarios.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Chat Flow\n\nO Construtor de Fluxo é a ferramenta nativa do Z-PRO para a criação de chatbots e automações de conversa. Ele permite desenhar jornadas interativas de forma visual, qualificando atendimentos, capturando dados e direcionando clientes sem a necessidade de ferramentas externas.\n\n#### Conceitos Fundamentais\n\nO construtor opera com base em quatro elementos principais:\n\n1. Fluxo: O conjunto completo de todas as etapas e regras da sua automação.\n2. Etapa (ou Nó): Cada "caixa" dentro do seu fluxo, representando um momento específico da conversa.\n3. Interações (Ações): As ações que o chatbot executa dentro de uma etapa (ex: enviar uma mensagem, adicionar uma tag).\n4. Condições (Regras): As regras que determinam para qual etapa o fluxo deve seguir, com base na resposta do cliente.\n\n*\n\n#### Interações (Ações Disponíveis)\n\nDentro de cada etapa do fluxo, você pode adicionar uma ou mais das seguintes interações:\n\nComunicação com o Cliente\n\n* Enviar Mensagem de Texto: Envia uma ou mais mensagens de texto sequenciais.\n* Enviar Mídia: Envia um documento, imagem ou outro arquivo.\n* Agendar Mensagem: Agenda o envio de uma mensagem para uma data e hora futura (ex: 30 minutos, próximo dia, data personalizada).\n* Enviar SMS: Dispara um SMS para o contato, utilizando uma das integrações de SMS configuradas (Comtele, Connecta, etc.).\n* Chamar VAPI: Inicia uma chamada de voz automatizada com IA, utilizando a integração com a VAPI.\n\nControle do Fluxo e Atendimento\n\n* Delay: Adiciona um atraso em segundos entre o envio de uma mensagem e outra.\n* Adicionar Novo Fluxo: Transfere o cliente de um fluxo para outro.\n* Bloquear Chatbot: Impede que o chatbot seja acionado novamente para aquele contato específico em futuras interações. É ideal para ser usado ao final de um fluxo de qualificação.\n\nGestão de Dados e Contatos\n\n* Adicionar Tag: Aplica uma etiqueta (tag) ao contato (ex: "lead\_qualificado").\n* Adicionar Kanban: Move ou cria um card para o contato no Funil de Oportunidades.\n* Adicionar Oportunidade: Cria uma nova oportunidade no funil, definindo etapa, valor e responsável.\n* Adicionar Nota: Anexa uma nota interna ao atendimento, visível para os operadores.\n* Adicionar Demanda/Razão: Associa um motivo específico ao contato.\n\nIntegrações Externas\n\n* Adicionar Webhook: Envia dados para uma URL externa via métodos GET, POST, PUT ou DELETE, com opções para configurar headers, body e retentativas.\n* Chamar Typebot: Transfere o controle da conversa para um fluxo do Typebot.\n* Chamar ChatGPT (ou outra IA): Aciona um modelo de IA integrado para interagir com o cliente.\n* Criar Evento no Google Agenda: Adiciona um evento na agenda integrada, definindo título, participantes e data.\n\n{% hint style="info" %}\nIntegrações Externas:\\nInterações que transferem o controle da conversa para um sistema externo (como Typebot, ChatGPT e Bloquear Chatbot) devem ser sempre a última interação de uma etapa.\n{% endhint %}\n\n*\n\n#### Condições (Regras de Roteamento)\n\nAs condições definem como o fluxo reage à resposta do cliente.\n\n Qualquer Resposta: O fluxo avança para a próxima etapa assim que o cliente envia qualquer mensagem.\n Resposta Única: O fluxo avança apenas se a resposta do cliente atender a critérios específicos. Os tipos de comparação são:\n Igual a: A resposta deve ser idêntica a uma das palavras-chave definidas (separadas por vírgula para "OU").\n Contém: A resposta deve conter uma das palavras-chave.\n Começa com / Termina com: A resposta deve começar ou terminar com o texto definido.\n Regex: Valida a resposta com base em uma expressão regular (ex: para validar formato de e-mail, CPF, etc.). O Regex sempre tem prioridade sobre as outras condições.\n\n*\n\n#### Captura e Uso de Variáveis\n\nO construtor de fluxo permite capturar a resposta de um cliente e reutilizá-la em mensagens futuras, personalizando a conversa.\n\n* Como Capturar: Em cada etapa, você pode habilitar a opção "Capturar Variável", dando um nome a ela (ex: nome\_cliente). A resposta do cliente naquela etapa será armazenada nessa variável.\n* Como Usar: Em qualquer mensagem de texto em etapas posteriores, você pode chamar o valor armazenado usando chaves duplas. Ex: Olá, {{nome\_cliente}}! Como posso ajudar?\n\nAlém das variáveis que você cria, é possível usar variáveis de sistema, como:\n\n {{contact.name}}: Primeiro nome do contato (se salvo).\n {{agent.name}}: Nome do atendente que assumiu a conversa.\n* {{ticket.protocol}}: Número do protocolo de atendimento.\n\n{% hint style="info" %}\nComportamento Importante das Variáveis: A Regra da Etapa Anterior\n\nO sistema de variáveis do Construtor de Fluxo foi projetado para operar de forma sequencial.\n\nIsso significa que você só pode utilizar o valor de uma variável que foi capturada na etapa imediatamente anterior do fluxo. Não é possível armazenar os valores de múltiplas variáveis ao longo de várias etapas para criar um resumo final.\n\nExemplo prático:\n\n1. Você cria uma Etapa 1 para capturar o nome do cliente {nome}.\n2. Na Etapa 2, você só conseguirá acessar a variável {nome}, pois ela foi capturada na etapa anterior. Não será possível, acessar outra variável capturada duas etapas antes.\n\nO uso ideal da funcionalidade é para a personalização imediata da conversa, utilizando a informação coletada logo na etapa seguinte.\n{% endhint %}\n\n\n\n\n\n*\n\n#### Configurações Gerais do Fluxo\n\nNo painel de configurações de cada fluxo, você pode ajustar comportamentos globais:\n\n Mensagem de Transferência: Mensagem padrão enviada quando o bot transfere o atendimento.\n Mensagem de Fallback: Resposta enviada quando a resposta do cliente não corresponde a nenhuma condição.\n Palavra-Gatilho: Uma palavra que, se enviada a qualquer momento, reinicia este fluxo.\n Timeout (Sem Resposta): Ação a ser executada se o cliente não responder dentro de um tempo determinado.\n Horário de Atendimento: Permite definir um comportamento específico para o fluxo se o contato ocorrer fora do horário comercial configurado no sistema.\n\n**\n\n#### Ativando o Fluxo em um Canal\n\nUm fluxo criado não faz nada até ser conectado a um canal de comunicação.\n\n1. Acesse o menu "Canais".\n2. Localize o canal desejado (ex: o número de WhatsApp).\n3. Clique no ícone de "Chatbot".\n4. Selecione o fluxo que você criou na lista suspensa.\n\nA partir desse momento, toda nova conversa iniciada naquele canal será automaticamente gerenciada pelo fluxo selecionado.\n\n*\n\n#### Tutoriais em Vídeo\n\nPara uma demonstração prática da construção e aplicação dos fluxos, assista aos vídeos abaixo.\n\n* Construindo um Fluxo de Boas-Vindas e Coleta de Dados\n\n{% embed url="https://www.youtube.com/watch?v=S2T4MU8lBPo" %}\n\n* Novas Funcionalidades do Chatbot (Atualização Agosto/25)\n\n{% embed url="https://www.youtube.com/watch?v=nMAmSPKYx-o" %}\n\n* Live Completa: Criando Chatbots Simples, Inteligentes e Híbridos**\n\n{% embed url="https://youtu.be/T4nIUEZToag?t=1287" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/chat-flow.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Distribuição sequencial Chatbot\n\nA Distribuição Sequencial (identificada como Método "S") é um sistema que distribui tickets em uma fila rotativa entre os usuários que estão online.\n\nO objetivo é garantir que cada usuário receba tickets de forma sequencial e equilibrada, evitando a concentração de atendimentos em um único atendente.\n\n\n\n### Como Funciona a Lógica\n\nO sistema segue um fluxo de 5 etapas para determinar quem receberá o próximo ticket:\n\n#### 1. Busca de Usuários Online\n\nO sistema identifica quem está disponível para receber o ticket:\n\n Se queueId for fornecido: Busca usuários online associados àquela fila específica.\n* Se não encontrar (ou não houver fila): Busca todos os usuários online do tenant.\n* Exclusão: Em ambos os casos, usuários com perfil de Admins ou Superadmins são excluídos da distribuição.\n* Ordenação: A lista final é ordenada por ID (ASC) para manter uma ordem consistente.\n\n#### 2. Validação\n\nO sistema verifica a lista gerada no passo anterior.\n\n* Se não houver usuários online, o processo é encerrado sem atribuir o ticket.\n\n#### 3. Busca do ChatFlow\n\nO sistema localiza as configurações do fluxo de conversa (ChatFlow) associado ao ticket:\n\n1. Tenta identificar primeiro pelo ticket.chatFlowId.\n2. Se não houver, tenta identificar pelo whatsapp.chatFlowId da conexão do WhatsApp associada.\n\n#### 4. Seleção Rotativa\n\nAqui ocorre a distribuição propriamente dita. O sistema obtém o lastUserId (o último usuário que recebeu atendimento) gravado no ChatFlow e encontra o próximo na lista:\n\n* Se houver lastUserId: O sistema avança para o próximo usuário da lista.\n* Rotação Circular: Se o lastUserId for o último da lista, o sistema volta ao primeiro usuário.\n* Se não houver lastUserId: O sistema começa distribuindo pelo primeiro usuário da lista (índice 0).\n\n#### 5. Atribuição do Ticket\n\nUma vez definido o usuário, o sistema finaliza o processo:\n\n1. Atualiza o campo lastUserId no ChatFlow com o ID do usuário selecionado (para que a rotação continue correta no próximo ticket).\n2. Cria um log da atribuição via CreateLogTicketService.\n3. Atribui efetivamente o ticket ao usuário selecionado.\n\n*\n\n#### Resumo\n\nEsta funcionalidade distribui tickets em ordem rotativa, garantindo que a carga de trabalho seja dividida sequencialmente entre os atendentes disponíveis, respeitando a fila e o status online.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/chat-flow/distribuicao-sequencial-chatbot.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Etapas para criação do fluxo\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\n### Exemplo de fluxo\n\n{% embed url="https://youtu.be/S2T4MU8lBPo" %}\n\nLink da Live sobre criação de fluxo: https://youtu.be/T4nIUEZToag?t=1286 \n\n### Passo a passo \n\nAo clicar no botão:\n\n\n\nVocê verá a seguinte tela:\n\n\n\nNo canto superior direito você verá as seguintes opções:\n\n| Descrição | Aparência |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |\n| Excluir - Essa opção estará desabilitada para o bloco Início. Recomendamos que não exclua as configurações para que o Bot de Atendimento funcione normalmente. Para excluir outros blocos basta clicar no desejado e em seguida no símbolo de excluir. | |\n| Expandir - Essa opção serve para ganhar mais área útil, facilitando a configuração do seu fluxo de atendimento. | |\n\n## Início\n\n\n\nEssa etapa representa o contato inicial do atendimento.\n\n Caso seja o primeiro contato do cliente, o sistema salvará automaticamente na agenda as informações do cliente;\n O Bot irá interagir nos atendimentos iniciados pelos clientes;\n O Bot irá parar de interagir caso o atendimento seja assumido por um usuário.\n\n## Configurações\n\nO primeiro passo então será definir as **Configurações desse fluxo. Para isso clique no bloco correspondente.\n\n\n\nAo clicar, a lateral do seu painel de edição do fluxo ficará assim:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Mensagem de saudação (Fila/Usuário) | Quando o bot direcionar o atendimento para uma fila ou usuário, essa mensagem será enviada. Nesse caso você pode incluir emoji na mensagem. |\n| Se nenhuma resposta esperada for enviada | Essa exceção será aplicada caso a resposta enviada pelo cliente não corresponda aos valores esperados conforme condições da etapa. Nesse caso você pode incluir emoji na mensagem. |\n| Palavra chave para iniciar o fluxo | Essa interação será acionada quando o cliente enviar a palavra chave definida, e o cliente será encaminhado para a Fila/Usuário configurados. Ou seja, ao receber essa mensagem, o bot ativa novamente |\n| Ausência de resposta | Após o tempo determinado (minutos), se o cliente não responder, o bot realizará o encaminhamento para uma Fila, Usuário ou encerrará o atendimento. |\n| Mensagem de Ausência | Após o tempo determinado, se o cliente não responder, o bot enviará essa mensagem. |\n| Máximo de Tentativas do Bot | Uma vez excedido o número máximo de retentativas de pergunta/resposta, caso o cliente não envie uma respota válida, o bot irá realizar o encaminhamento para uma Fila, Usuário ou encerrará o atendimento. |\n| Direcionamento na primeira interação | Essa interação será acionada na primeira interação com o cliente, e o cliente será encaminhado para a Fila/Usuário configurados. |\n| Se estiver fora do horário de atendimento | Essa interação será acionada caso o cliente envie uma mensagem fora do horário de atendimento, e o cliente será encaminhado para a Fila/Usuário configurados. |\n| Auto Distribuir Atendimento | Nessa opção você tem duas alternativas: Não, permanecendo desativada a opção; ou Aleatória, onde definirá um Usuário de forma aleatória para os usuários da fila. |\n| Encerrar Atendimento | Caso o cliente digite algumas das informações esperadas, o atendimento será encerrado. Para cadastrar a palavra que será o gatilho para encerrar o atendimento, basta digitá-la e apertar Enter. |\n| Mensagem de Encerramento (Fila/Usuário) | Quando o bot terminar o atendimento, seja para uma Fila ou um Usuário, essa mensagem será enviada. Nesse caso você pode incluir emoji na mensagem. |\n\nAo concluir o preenchimento, clique em Salvar.\n\n\n\n## Boas Vindas \n\nPara editar a mensagem de inicial do bot de atendimento, clique no bloco Boas Vindas.\n\n\n\nAo clicar, a lateral do seu painel de edição do fluxo ficará assim:\n\nNa etapa de Interações você pode adicionar mensagens de texto, algum arquivo, adicionar um delay, adicionar uma etiqueta ao contato, chamar um webhook get ou iniciar um novo fluxo.\n\n\n\nAo clicar na etapa de Condições, será preciso selecionar o botão de Nova Condição sempre que quiser uma variável. Assim que selecionar, parecerá um campo para inserir a variável desejada.\n\n\n\nNo campo Se, selecione uma entre as opções:\n\n Qualquer Resposta - Independentemente do que o cliente responder, ele será direcionado para uma outra Etapa do fluxo, Fila de atendimento ou Usuário selecionado.\n Respostas - Digite o valor necessário para realizar o mesmo direcionamento e aperte Enter. Esse caso é mais eficaz quando se é apresentado um menu de atendimento ou uma tabela de serviços/produtos.\n\nAssim como em Interações, você pode incluir mais de uma condição, movendo a ordem ou excluindo-as. Ao concluir o preenchimento, clique em Salvar.\n\n\n\n## Nova Etapa\n\nA qualquer momento você pode clicar no botão + Nova Etapa. Isso permite que uma nova etapa seja criada a cada clique dado, surgindo assim um novo bloco no seu painel de edição do fluxo:\n\n\n\nClique no bloco para abrir o painel de edição na lateral da sua tela. Assim como no bloco de Boas Vindas, você pode inserir quantas Interações e Condições desejar.\n\nO mais importante aqui é renomear a nova etapa para facilitar o processo de construção do seu fluxo. Assim você saberá quais fases do atendimento já foram criadas.\n\nLembre-se que para que uma Nova Etapa seja apresentada ao cliente no atendimento, ela deve estar vinculada as Condições da etapa anterior.\n\nPara gravar as alterações, clique no botão Salvar.*\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/chat-flow/etapas-para-criacao-do-fluxo.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gerenciando os fluxos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nO fluxo é uma forma simplificada e intuitiva de contrução o seu Bot de Atendimento. Nessa seção é possível criar quantos fluxos forem necessários para um melhor funcionamento do seu atendimento.\n\nPara acessar basta clicar no ícone de ChatBot no menu lateral do seu painel.\n\n\n\nVocê verá a seguinte tela:\n\n\n\n## Novo ChatBot\n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ----------------- | ------------------------------------------------------------------------------------------------------------------ |\n| Nome | Insira um nome para identificar esse fluxo de atendimento. |\n| Número para Teste | Deixe limpo para que a Auto Resposta funcione. Caso contrário, irá funcionar somente para o número informado aqui. |\n\nAlém disso, é importante marcar a caixinha de Ativo. Para finalizar, clique em Salvar e pronto!\n\n## Gerenciar ChatBots \n\nNa parte inferior do painel de ChatBot, você poderá visualizar informações como: Nome, Status e Celular Teste.\n\n\n\nLogo ao lado você verá os seguintes botões:\n\n| Descrição | Aparência |\n| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Aqui você pode editar as mesmas informações do pop up de cadastro. | |\n| A função de duplicar o fluxo pode auxiliar no desenvolvimento de um bot similar. | |\n| Aqui é onde você irá desenvolver o fluxo do atendimento. Veja o tutorial no próximo tópico. | |\n| Exclua o fluxo de atendimento. | |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/chat-flow/gerenciando-os-fluxos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Possíveis erros: Chatbbot nativo\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao/chat-flow/possiveis-erros-chatbbot-nativo.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configuração\n\n- API\n- Configurações Gerais Admin: Configurações\n- Configurações Gerais: Configs Gerais\n- Gerais: Config Gerais\n- Visibilidade de Tickets para usuários (atendentes)\n- Transbordo de mensagem (processo de seleção)\n- SMTP: Config SMTP\n- Bots e IA: Integrações externas\n- Copiloto de IA\n- Integrações: Integrações Externas\n- Habilitar Webhooks: Config Webhooks\n- Habilitar Meta: Config. Meta\n- Habilitar Evolution: Config Evolution\n- Habilitar Wuzapi: Config Wuzapi\n- Habilitar Hub NotificaMe: Config Hub Notificame\n- Habilitar SMS: Config SMS\n- Habilitar GroqCloud: Config GroqCloud\n- CRM: Configs. CRM\n- Gerenciar Kanban: Como configurar e gerenciar o Kanban (Clássico)\n- Demanda: Config Demanda\n- Variáveis: Config. Variáveis\n- Sessões: Listar Sessões\n- Listar Sessões: Config Listar Sessões\n- Log auditoria (admin)\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
API\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nA página de API do sistema Z-PRO é o ambiente destinado à integração técnica entre a plataforma e sistemas externos (como CRMs, sites, ERPs ou automações de marketing). Através desta tela, o administrador gera chaves de acesso, consulta a documentação técnica e testa as rotas de comunicação em tempo real.\n\n#### Principais funções\n\n Gestão de Tokens: Criação e revogação de chaves de autenticação.\n Documentação Interativa: Acesso direto à lista de endpoints e parâmetros.\n Sandbox: Ambiente de teste para validar requisições sem sair do painel.\n Webhooks: Configuração de disparos automáticos de eventos do sistema para URLs externas.\n\n#### Caso de uso\n\nUma empresa utiliza um CRM externo para gerenciar suas vendas. Através da API, o desenvolvedor integra os sistemas para que, toda vez que um negócio for movido para "Fechado" no CRM, o Z-PRO envie automaticamente uma mensagem de boas-vindas ao Contato utilizando uma Sessão WhatsApp específica.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Configuração e na aba API.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Botão Postman: Atalho para baixar a coleção de requisições pré-configuradas para uso no software Postman.\n https://www.postman.com/comunidade-zdg/z-pro/collection/s16subg/postman-v3-x-x-x?action=share&creator=25151510&sideView=agentMode\n Botão + Nova API: Abre o formulário para gerar uma nova integração vinculada a um canal.\n URL de Integração: O endereço base que deve ser utilizado nas chamadas externas.\n Bearer Token: A chave secreta de autenticação.\n Ícones de Ação:\n Atualizar (Seta circular): Gera um novo token para a API selecionada (o anterior é invalidado imediatamente).\n Editar (Lápis): Permite alterar o nome da integração.\n Excluir (Lixeira): Remove a integração e invalida o acesso externo permanentemente.\n Olho / Copiar: Permite visualizar o token oculto e copiá-lo para a área de transferência.\n\n*\n\n#### Criando uma API\n\n1. Clique no botão + Nova API no canto superior direito.\n2. No modal que aparecerá, dê um Nome identificador para a integração (ex: CRM Vendas).\n3. Selecione a Sessão (canal de WhatsApp) que será utilizada para os disparos desta API.\n4. Clique em Salvar.\n5. Importante: Copie o token gerado imediatamente. Por questões de segurança, recomenda-se o armazenamento em local seguro, pois ele é a chave de acesso ao seu sistema.\n\n\n\n#### Usando a API e Documentação\n\nPara facilitar o desenvolvimento, o Z-PRO disponibiliza uma documentação completa e testável dentro da própria interface:\n\n1. Consulte a seção Documentação de rotas para visualizar todos os Endpoints disponíveis.\n2. Utilize o Sandbox selecionando uma API ativa no menu suspenso. Isso permite que você preencha os parâmetros e teste a requisição diretamente na página para ver a resposta do servidor.\n3. A autenticação de todas as chamadas deve ser feita via Header: Authorization: Bearer {seu_token}.\n\n\n\n#### Webhooks e Eventos\n\nOs Webhooks permitem que o Z-PRO "fale" com o seu sistema externo em tempo real quando algo acontece:\n\n* Configuração: Informe a URL de callback no campo de destino.\n* Eventos Disponíveis: O sistema pode notificar sobre novas mensagens recebidas, tickets abertos, alterações de status e confirmações de entrega.\n* Otimização:** Filtre apenas os eventos que são estritamente necessários para sua integração, reduzindo o tráfego de dados desnecessário.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/api.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configurações Gerais Admin\n\nAssim que realizar o primeiro login na plataforma, acesse o menu lateral do seu painel e clique no ícone de Configurações.\n\n\n\nVocê verá as seguintes opções na tela:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Bots e IA\n\nNo painel de Configurações Gerais > Bots e IA, você pode centralizar e gerenciar todas as ferramentas de automação e modelos de linguagem que irão operar no seu sistema.\n\nA plataforma possui integração nativa com os seguintes serviços:\n\n Construtores de Fluxo e Automação: Typebot, N8N, Dify e DialogFlow.\n Modelos de Inteligência Artificial (LLMs): ChatGPT, Grok, Gemini, Qwen, Claude, Deepseek, Ollama e LM Studio.\n\n\n\n#### Regras de Configuração\n\nPara cada uma das ferramentas listadas acima, o painel oferece duas chaves principais de controle de comportamento:\n\n1. Ativar integração com \[Nome da Integração]\n\n O que faz: Habilita a comunicação entre o sistema e a ferramenta externa.\n Como funciona: Quando ativa, o sistema está pronto para consumir o fluxo de mensagens ou as informações processadas pela respectiva integração (ex: as respostas geradas pelo ChatGPT ou as automações do N8N).\n\n2. Ativar integração com \[Nome da Integração] para todos os atendimentos por Padrão\n\n O que faz: Aplica a inteligência artificial ou o fluxo de automação de forma global.\n Como funciona: Quando ativa, o sistema consumirá o fluxo ou as informações dessa integração de forma automática em todos os novos atendimentos que chegarem à plataforma, independentemente do canal. Se estiver inativa, a integração só funcionará nos locais onde for vinculada manualmente.\n\n> 💡 Nota Importante: Ativar a integração nesta tela é o primeiro passo. Para que as ferramentas de IA funcionem corretamente, lembre-se de que é necessário acessar o menu Canais e inserir as respectivas credenciais (como API Keys e Tokens) dentro das configurações de cada número ou conexão que utilizará a inteligência.\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Copiloto de IA\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nO Copiloto de IA é um assistente inteligente integrado à tela de atendimento do Z-PRO. Ele utiliza modelos de linguagem avançados (como ChatGPT, Gemini ou Claude) para auxiliar o atendente em tempo real, analisando o sentimento das conversas, sugerindo respostas contextuais, reescrevendo textos e resumindo históricos longos.\n\n#### Principais funções\n\n Sugestão de Resposta: Gera sugestões baseadas no contexto da conversa atual.\n Análise de Sentimento: Identifica o tom do cliente (neutro, engajado, impaciente).\n Reescrita de Mensagem: Ajusta o tom da resposta (ex: tornar mais simpático ou formal).\n Resumo de Conversa: Cria uma síntese de diálogos extensos para facilitar a leitura rápida.\n\n#### Caso de Uso\n\nUm atendente recebe um ticket com um histórico de 50 mensagens. Para não perder tempo lendo tudo, ele utiliza a função Resumir. Após entender o problema, ele pede uma Sugestão de Resposta ao Copiloto e usa a Reescrita para deixar a mensagem com um tom mais acolhedor antes de enviar ao cliente.\n\n{% embed url="https://www.loom.com/share/318e4ee827e240019874f51942fbe618" %}\n\n\n\n#### Como acessar a página\n\n1. No menu lateral, clique em Configurações;\n\n\n\n2. Selecione a aba Bots IA;\n3. Clique na sub-aba Copiloto de IA.\n\n#### Você verá a seguinte tela:\n\n\n\n\n\n#### Explicação dos campos e ícones\n\n Habilitar Copiloto: Chave para ativar ou desativar a função na tela de atendimento.\n Provedor: Seleção da plataforma de IA (OpenAI, Anthropic, Google Gemini, Groq).\n API Key: Campo para colar a chave secreta gerada no provedor escolhido.\n Modelo: Identificação técnica da versão da IA (ex: gpt-4o, gemini-1.5-pro).\n Prompt de Contexto: Espaço para descrever como a IA deve se comportar e quais informações sobre a empresa ela deve conhecer.\n\n**\n\n#### Passo a passo de uso\n\nPasso 1: Obter a API Key\n\nAntes de configurar no Z-PRO, você deve gerar uma chave no site do provedor:\n\n OpenAI (ChatGPT): Acesse platform.openai.com, vá em API Keys e crie uma nova.\n Google (Gemini): Acesse o Google AI Studio, clique em Get API Key.\n Outros: Acesse os portais de desenvolvedor da Anthropic ou Groq.\n\nPasso 2: Configurar o Provedor no Z-PRO\n\n1. Cole a API Key no campo correspondente.\n2. Insira o Modelo exato conforme as diretrizes do provedor.\n\n{% hint style="info" %}\nModelos Recomendados: Para OpenAI use gpt-4o ou gpt-3.5-turbo. Para Gemini, use gemini-1.5-flash ou similar conforme a documentação oficial do provedor.\n{% endhint %}\n\nPasso 3: Contextualizar o Copiloto\n\nNo campo Prompt, defina o papel da IA.\n\n Exemplo: "Você é um assistente de suporte da empresa X. Seja direto, educado e use informações do nosso catálogo de produtos para sugerir respostas."\n\nPasso 4: Utilizar no Atendimento\n\nCom tudo salvo, vá até a tela de atendimento:\n\n1. Abra um chat e clique no ícone de três pontinhos (Mais Opções).\n2. Selecione Copiloto.\n\n\n\n3. Use os botões Analisar Sentimento ou Sugerir Resposta.\n\n\n\n#### Detalhamento das Funções Adicionais\n\n Reescrita com IA: Abaixo do campo de digitação, ao clicar no ícone de IA, você pode pedir para "Tornar mais simpático", "Mais formal" ou "Corrigir gramática".\n Resumo de Diálogo: Localizado no menu de opções do chat, permite escolher entre resumir as mensagens do cliente, do atendente ou de ambos.\n\n\n\n\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nConsumo de Créditos: O uso da API gera custos diretamente no provedor escolhido (OpenAI, Google, etc.). Monitore seu consumo nas plataformas originais.\n\nPrivacidade: Evite enviar dados sensíveis de clientes para a IA se a política de privacidade da sua empresa não permitir o processamento de dados em nuvens de terceiros.\n\nRevisão Humana: O Copiloto sugere respostas, mas o atendente deve sempre revisar o texto antes de enviar para garantir a precisão das informações\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia/copiloto-de-ia.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configurações Gerais\n\nConfira a seguir cada seção presente nesse painel:\n\n Config. Gerais\n SMTP\n* Pagamentos (Se assas ativo)\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gerais\n\nConfira a seguir cada seção presente nesse painel e suas respectivas descrições:\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| Não visualizar Tickets já atribuidos à outros usuários | Se ativo, somente o usuário responsável pelo ticket e/ou os administradores visualizarão a atendimento. |\n| Não visualizar Tickets no ChatBot | Habilitando esta opção somente administradores poderão visualizar tickets que estivem interagindo com o ChatBot. |\n| Forçar atendimento via Carteira | Caso essa opção esteja ativa, todo contato que estiver vinculado a uma carteira será direcionado ao usuário correspondente. Assim, somente os donos da carteira irão atender os clientes que já são recorrentes à eles. |\n| Visualizar Tickets sem Usuário ou Fila Atribuído (essa opção invalida os demais filtros e condições) | Habilitando esta opção todos os usuários visualizaram os atendimentos que entrarem na plataforma. |\n| Remover privilégios de visualização do supervisor | Habilitando esta opção, a listagem de tickets do supervisor seguirá a lógica do usuário comum e não mais do administrador. |\n| Usar Envio Rápido de Mensagens | Habilitando esta opção, as mensagens serão enviadas de forma imediata, sem passar pelo sistema de envio cadenciado. |\n| Fluxo ativo para o Bot de Atendimento | Aqui é onde você escolhe o fluxo que será utilizado pelo Bot para os novos atendimentos. Ou seja, o fluxo que estiver selecionado nesse campo irá realizar os novos atendimento. |\n| Ignorar Mensagens de Grupo | Habilitando esta opção o sistema não abrira ticket para grupos. |\n| Ignorar Stories do Instagram | Ao habilitar essa opção, serão ignorados os Stories do Instagram |\n| Mostrar Grupos para todos os usuários | Ao habilitar essa opção, os Grupos serão visíveis para todos os usuários |\n| Mostrar Fechados para todos os usuários | Ao habilitar essa opção, os Fechados serão visíveis para todos os usuários |\n| Recusar chamadas no WhatsApp | Quando ativo, as ligações de aúdio e video serão recusadas, automaticamente. Nesse caso você pode atribuir uma mensagem que será enviada assim que a ligação for rejeitada. |\n| Habilitar guia de atendimento de Chatbots | Habilitando esta opção será adicionada uma guia de atendimento exclusiva para os chatbots. |\n| Fixar conexões no topo do atendimento | Habilitando esta opção as conexões deixaram de flutuar no roda-pé e serão fixadas no topo da lista de atendimentos. |\n| Forçar usuário atual ao mudar status do atendimento pendente | Habilitando esta opção, o ticket manterá o usuário associado ao atendimento quando mudar o status de aberto para pendente. |\n| Mostrar histórico de mensagens | Habilitando esta opção, o sistema irá mostrar todas as mensagens associadas ao canal e contato, em todos os tickets. |\n| Listar atendimentos pela última mensagem | Ao ativar essa opção, o sistema irá listar os atendimentos pela última mensagem recebida. |\n| Validar Contato | Verifica automaticamente junto à API do WhatsApp se o número informado possui uma conta ativa antes de iniciar uma conversa. Isso previne erros de envio e mantém sua base de dados limpa, evitando o cadastro de números inválidos ou fixos |\n| Ativar escuta da API do Hub Notificame | Habilita o recebimento de eventos externos vindos do Hub. Garante que mensagens disparadas por outras ferramentas integradas ao Hub apareçam corretamente no histórico de conversa dentro do painel do Z-PRO. |\n| Ativar Filtro de tickets no socket (recomendável em alto volume) | Recurso de performance que filtra as atualizações em tempo real, enviando ao navegador do atendente apenas os dados da sua própria carteira ou fila. Altamente recomendado para operações com alto volume (acima de 1.000 atendimentos diários). |\n| Desativar integrações externas quando carteirização estiver ativa | Ao ativar essa opção, as integrações externas como ChatGPT, Typebot e outras serão desativadas quando a carteirização estiver ativa e um novo ticket for recebido. |\n| Habilitar espera no processamento de mensagens com integrações externas (Typebot, ChatGPT...) | Ao receber mais de uma mensagem no atendimento, o sistema somente irá processar novas mensagens após a primeira mensagem ter sido respondida. Mensagens recebidas nesse meio tempo não irão interagir com a integração externa. |\n| Transbordo de Mensagens | Habilitando esta opção, o sistema irá fazer o transbordo do atendimento carteirizado, caso o usuário encontre-se com status offline. |\n| Habilitar envio de mensagem Waba fora da janela (não garante a entrega) | Tenta forçar o envio de mensagens de texto livre pela API Oficial (WABA) mesmo após o fechamento da janela de 24 horas. Atenção: O funcionamento não é garantido, pois depende das regras de bloqueio da Meta. |\n| Não atualizar nome ao receber mensagens | Habilitando esta opção, o sistema não irá atualizar o nome do contato em mensagem recebida |\n| Forçar admin no atendimento | Habilitando esta opção os ticket pendentes serão atribuídos ao admin. |\n| Usar Plugin de Áudio (Beta) | Ao habilitar essa opção, será utilizado um novo plugin de áudio beta. |\n| Usar Módulo de Áudio com Ondas (Beta) | Ao habilitar essa opção, será utilizado um novo módulo de áudio com ondas sonoras. |\n| Desabilitar controle de assinatura | Habilitando esta opção, os usuários não poderão desabilitar a assinatura no atendimento. Ou seja, todos os atendimentos realizados por eles serão identificados. |\n| Controle de Features | Ao ativar essa opção, o sistema irá controlar as funcionalidades de espiar e fechamento forçado para usuários. |\n| Forçar definição de demanda no fechamento de atendimento | Ao ativar essa opção, o sistema irá exigir a definição de demanda no fechamento de atendimento |\n| Permitir pausar atendimento | Ao ativar essa opção, o sistema irá permitir que o atendimento seja pausado temporariamente. |\n| Contador nas tabs superiores (Privados/Grupos) | Caso essa opção esteja ativa, os usuários irão visualizar os tickets com mensagens abertas nas tabs superiores de conversas privadas e grupos. |\n| Resolver atendimento sem interação automaticamente | Habilitando esta opção atendimentos ociosos serão resolvidos automaticamente. Nesse caso você pode escolher a quantidade de tempo em minutos e a mensagem que será enviada para o encerramento. |\n| Filtrar atendimentos antigos | Habilitando esta opção você irá filtrar atendimentos antigos. |\n| Notificações sonoras | Receber notificações de áudio. |\n| Persistir Download de Mídias (Baileys) | Ao habilitar essa opção, serão realizadas tentativas sequenciais para download das mídias recebidas pela API Não Oficial Baileys |\n| Máximo de vezes que a mensagem de horário de atendimento deve ser enviada para o cliente. | Insira aqui a quantidade de vezes que a mensagem de ausência pode ser enviada para cada atendimento. |\n| Quantidade de ticket que devem ser consultados em atendimentos. | Insira aqui a quantidade de tickets que devem ser buscado na tela de atendimento. |\n| Quantidade de mensagens que devem ser carregadas no chat interno por atendimento. | Insira aqui a quantidade de mensagens que devem ser buscadas no chat interno. |\n| Números bloqueados na plataforma | Insira aqui a lista dos números (separados por vírgula) que não devem ser atendidos dentro da plataforma. |\n| Enviar mensagens paradas | Esse comando irá enviar mensagens paradas no sistema. |\n| Resolver Mensagens | Esse comando irá remover mensagens com erro do sistema. |\n| Validar Todos os Contatos | Esse comando irá validar o número de todos os contatos do sistema. |\n| Atualizar Data das Mensagens Importadas | Ao ativar essa opção, o sistema irá atualizar a data das mensagens importadas para o horário original. |\n| Atualizar Data dos Tickets | Ao ativar essa opção, o sistema irá atualizar a data dos tickets para o horário da mensagem mais recente. |\n| Scan de Contatos sem Lid | Executa uma rotina de manutenção no banco de dados para identificar e corrigir contatos que não possuem o identificador de conexão (LID). Útil para resolver falhas de visualização em contatos importados ou não sincronizados. |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Transbordo de mensagem (processo de seleção)\n\n### O que é o Transbordo Automático?\n\nO "Transbordo de Mensagens" é uma funcionalidade criada para garantir que um cliente não fique sem resposta caso o atendente responsável pelo seu ticket (atendimento carteirizado) esteja offline.\n\nAo habilitar esta opção, o sistema monitora o status do usuário e, se ele não estiver online quando o cliente enviar uma nova mensagem, o Z-PRO redistribui automaticamente o ticket para outro membro da equipe que esteja online, seguindo uma lógica de distribuição balanceada.\n\n\n\n### Como Habilitar\n\nPara ativar, acesse o painel Admin > Configurações > Gerais.\n\nNa aba "Gerais", habilite a opção "Transbordo de Mensagens".\n\n{% hint style="info" %}\nPara mais detalhes sobre as outras opções nesta tela, consulte nosso guia: Configurações Gerais (Admin).\n{% endhint %}\n\n### A Lógica de Redistribuição (Passo a Passo)\n\nQuando um ticket carteirizado recebe uma nova mensagem, o sistema segue 4 passos para decidir se deve ou não realizar o transbordo:\n\n#### 1. Verificação do Atendente Atual\n\nO sistema primeiro confere o status do usuário que é o "dono" atual do ticket. Se este usuário estiver com o status online, o transbordo não acontece e o ticket permanece com ele.\n\n#### 2. Busca por Atendentes Elegíveis\n\nSe o dono do ticket estiver offline, o sistema procura por um substituto. Os critérios para um atendente ser considerado "elegível" são:\n\n Estar com status online.\n Pertencer ao mesmo time (tenant).\n Ter permissão de acesso à fila (WhatsApp) do ticket em questão.\n\n#### 3. Algoritmo de Balanceamento de Carga\n\nCom a lista de atendentes elegíveis, o sistema aplica um filtro para distribuição justa:\n\n Usuários com perfil Superadmin são excluídos da seleção (para não sobrecarregar gestores).\n O sistema conta quantos tickets individuais (que não são de grupo) cada atendente elegível recebeu no dia.\n O ticket é então atribuído ao atendente que tiver o menor número de tickets recebidos no dia.\n\n#### 4. Execução da Transferência\n\nPor fim, o ticket é oficialmente transferido para o novo atendente selecionado. O sistema atualiza a tela de atendimentos de todos em tempo real (via socket) e registra a ação no log para fins de auditoria.\n\n\n\n#### Pontos-Chave do Transbordo\n\n{% hint style="success" %}\n\n O transbordo SÓ acontece se o dono do ticket estiver offline.\n* A distribuição é balanceada, priorizando o atendente online que menos recebeu tickets no dia.\n* Atendentes com perfil Superadmin NUNCA recebem tickets por transbordo.\n* A contagem de balanceamento considera apenas tickets individuais**, não conversas em grupo.\n {% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/transbordo-de-mensagem-processo-de-selecao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Visibilidade de Tickets para usuários (atendentes)\n\nEsta documentação detalha as configurações que permitem ao administrador controlar quais tickets os atendentes (usuários) podem visualizar no painel de atendimento. A gestão correta destas permissões é essencial para estruturar a operação e garantir a privacidade das informações.\n\nExistem duas funcionalidades principais que definem o nível de acesso dos atendentes.\n\n#### Dentro do painel de admin na aba "Configurações Gerais" você encontra dois ícones:\n\n Não visualizar Tickets já atribuídos à outros usuários\n Visualizar Tickets sem Usuário ou Fila Atribuído\n\n\n\nEssas duas configurações podem ser complementares e/ou excludentes, por isso, criamos essa documentação para explicar como utilizá-las.\n\n## Possíveis formas de configurar\n\n#### 1. Para o usuário ver todos os tickets abertos e pendentes das filas associadas à ele\n\n Não visualizar Tickets já atribuídos à outros usuários: INATIVO\n Visualizar Tickets sem Usuário ou Fila Atribuído: INATIVO\n\n#### 2. Para o usuário ver apenas os tickets abertos dele e todos os pendentes da fila que está associado\n\n Não visualizar Tickets já atribuídos à outros usuários: ATIVO\n Visualizar Tickets sem Usuário ou Fila Atribuído: INATIVO\n\nNesse caso os usuários não vão ver tickets que não possuem fila definidos.\n\nSerá necessário adicionar uma fila padrão para o canal e, assim, quando o atendimento iniciar com a filam o usuário visualizará todos os atendimentos em pendente \n\n#### 3. Para o usuário ver todos os tickets dele e que não possuam fila ou usuários definidos\n\n Não visualizar Tickets já atribuídos à outros usuários: INATIVO\n Visualizar Tickets sem Usuário ou Fila Atribuído: ATIVO\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/visibilidade-de-tickets-para-usuarios-atendentes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
SMTP\n\nConfiguração do SMTP no painel superadmin: E-Mail (SMTP)\n\nComo recuperar senha\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Ativar SMTP | Quando ativo o sistema enviará informaçãos para o e-mail do usuário. Nesse caso, é necessário informar o servidor do e-mail, porta SMTP, usuário do e-mail e senha do e-mail. |\n| Servidor | Servidor de email do seu host |\n| Porta SMTP | Porta de acesso ao servidor SMTP |\n| Usuário | Conta de e-mail |\n| Senha | Senha do e-mail |\n| Protocolo de Segurança | Ativar protocolo seguro. |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/smtp.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
CRM\n\nConfira a seguir cada seção presente nesse painel:\n\n Kanbans e Lanes\n Demandas\n* Variáveis\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Demanda\n\nEssa seção é extremamente intuitiva. Aqui é onde você cria, edita e exclui as Demandas para a organização dos seus atendimentos.\n\n\n\nClique em adicionar para criar novas demandas:\n\n\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/demanda.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gerenciar Kanban\n\nNo ZPRO, o Kanban Clássico permite que você mova tickets entre diferentes colunas (lanes) para controlar o fluxo de trabalho da sua equipe.\n\n### Etapa 1: Criando as Colunas (Lanes)\n\n\\nAntes de começar a utilizar o quadro Kanban, é obrigatório definir quais serão as etapas do seu processo. Sem criar as colunas (também chamadas de Lanes), o quadro não funcionará.\n\n\n\n1. No menu lateral, acesse Configurações.\n2. Navegue até a seção CRM.\n3. Clique em Kanban e Lanes.\n\nNesta tela, você poderá criar, editar e excluir as colunas que aparecerão no seu quadro.\n\n\n\n#### Adicionando uma nova Lane:\n\n Clique no botão Adicionar (geralmente localizado no topo ou canto da tela).\n Defina um nome para a coluna (Ex: "Aguardando", "Em Atendimento", "Finalizado").\n Defina uma cor para facilitar a visualização.\n Clique em Salvar.\n\n\n\n\n\n### Etapa 2: Visualizando o Quadro Kanban\n\nApós criar as colunas na etapa anterior, elas ficarão automaticamente disponíveis no seu Quadro Kanban Clássico.\n\n1. No menu principal do Z-PRO, clique em Kanban.\n2. Você verá as colunas que acabou de criar.\n3. Agora você pode arrastar e soltar os cards de atendimento entre as colunas para organizar o fluxo de trabalho.\n\n\n\n\ DIFERENÇA IMPORTANTE: KANBAN CLÁSSICO vs. CRM (FUNIL)\n\nÉ importante não confundir as funcionalidades:\n\n **Kanban Clássico (Configurado aqui): Utilizado para gestão geral de TICKETS e status de atendimentos rápidos. As colunas são configuradas em Configurações > CRM > Kanban e Lanes.\n *Kanban do Funil de Vendas:** Utilizado para gestão de OPORTUNIDADES, com recursos mais avançados de gerenciamento comercial e de vendas, dentro do módulo Funil.\\n [https://ajuda.zdg.com.br/funil-de-oportunidades*](/funil-de-oportunidades.md)\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/gerenciar-kanban.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Variáveis\n\nNessa seção você tem a listagem das variáveis disponíveis no sistema:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | --------------------- |\n| name | nome |\n| greeting | saudação |\n| protocol | protocolo de abertura |\n| email | e-mail (se existir) |\n| phoneNumber | telefone |\n| kanban | kanban (se existir) |\n| user | atendente |\n| userEmail | e-mail do atendente |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/variaveis.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Integrações\n\nConfira a seguir cada seção presente nesse painel:\n\n Webhooks\n Meta\n Evolution API\n Wuzapi\n Hub Notificame\n SMS\n* GroqCloud\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar Evolution\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | ----------------------------------------- |\n| URL da API | Informar a url de instalação da Evolution |\n| Global Key | Informar a Global Key da Evolution |\n\nPasso a passo para usar a Evolution API:\n\n{% embed url="https://www.youtube.com/watch?v=ibXm0HHbhhs" %}\n\nO endereço url para baixar: https://github.com/EvolutionAPI/evolution-api \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-evolution.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar GroqCloud\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | ------------------------------------ |\n| Chave da API | Informar a chave de API da GroqCloud |\n| Idioma | Idioma padrão para transcrição |\n| Modelo | Modelo da IA |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-groqcloud.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar Hub NotificaMe\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| -------------------- | --------------------------------------------------------------------------------------------------------------- |\n| Seu token notificame | Informar o token contratado na notificame |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-hub-notificame.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar Meta\n\n{% embed url="https://www.youtube.com/watch?t=31s&v=FEJdb5V9ZM8" %}\n\n\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | ---------------------------------------------- |\n| Token Webhook | Token para validação do Webhook na BM da Meta. |\n| Webhook Meta | URL que deverá ser informada na BM da Meta. |\n\nVocê também poderá testar números associados a sua BM informando os dados abaixo:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | ---------------------------- |\n| WABA ID | Identificação da conta WABA |\n| WABA API Version | Versão da API Waba |\n| WABA Token | Token de acesso a conta WABA |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-meta.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar SMS\n\nNessa seção você tem a opção das permissões:\n\nCrie uma conta em comtele.com.br e gera uma chave de API\n\nhttps://sms.comtele.com.br/account/apiconfig/1\n\nCrie uma conta em Conecta e gera uma chave de API\n\nhttps://dashboard.conectastartup.com.br/application/login\n\n| Tipo de Permissão | Descrição |\n| -------------------- | --------------------------------------- |\n| Chave de API Comtele | Token de autenticação para envio de SMS |\n| Chave de API Conecta | Token de autenticação para envio de SMS |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-sms.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar Webhooks\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| Ativar Webhook | Quando ativo, o sistema enviara informaçoes para o webhook detinido. Nesse caso é necessário informar a URL do Webhook |\n| Receber mensagens e atendimentos | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Criar canal/conexão | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Atualizar canal/conexão | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Criar usuário | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Atualizar usuário | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Criar API | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Atualizar API | Quando ativo, o sistema enviará informações para o webhook definido. |\n| Renovar token da API | Quando ativo, o sistema enviará informações para o webhook definido. |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-webhooks.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Habilitar Wuzapi\n\nNessa seção você tem a opção das permissões:\n\n| Tipo de Permissão | Descrição |\n| ----------------- | -------------------------------------- |\n| URL da API | Informar a url de instalação da WUZAPI |\n\nPasso a passo de como usar a Wuzapi:\n\n{% embed url="https://comunidadezdg.com.br/wuzapi-zpro/" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-wuzapi.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Sessões\n\nConfira a seguir cada seção presente nesse painel:\n\n* Listar sessões\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/sessoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Log auditoria (admin)\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nA página de Log de Auditoria é a central de transparência e segurança do sistema Z-PRO. Nela, o administrador pode rastrear detalhadamente cada interação realizada na plataforma, identificando quem executou cada ação, em qual momento, de qual local e qual recurso foi afetado.\n\n#### Principais funções\n\n Rastreabilidade Total: Monitoramento de criações, edições e exclusões de dados.\n Segurança e Conformidade: Registro de endereços IP e histórico de acessos dos usuários.\n Filtragem Avançada: Localização de eventos específicos por usuário, período ou tipo de entidade.\n Inspeção Técnica: Visualização do corpo técnico das requisições realizadas ao sistema.\n Exportação de Dados: Geração de arquivos para auditorias externas.\n\n#### Caso de uso\n\nSe um Ticket importante for encerrado indevidamente, o administrador pode acessar o Log de Auditoria, filtrar pela entidade "tickets" e pelo método "PUT" (atualização). O log revelará exatamente qual Usuário realizou a alteração, o horário exato e o endereço IP utilizado, permitindo a correção do processo interno.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Configuração e selecione a aba Log de Auditoria.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Filtros Superiores:\n Ação: Filtra pelo tipo de operação (ex: Todas as ações, Criar, Atualizar, Deletar).\n Entidade: Permite buscar por um recurso específico (ex: tickets, users, Canais).\n Usuário: Filtra as ações realizadas por um colaborador específico.\n Data Inicial/Final: Define o intervalo de tempo da consulta.\n Botão Filtrar: Aplica os filtros selecionados à lista.\n Ícone de Download: Exporta os logs filtrados para um arquivo CSV.\n Colunas da Tabela:\n Ação (Badge): Descrição amigável da operação (ex: Atualizar, Criar).\n Método: Indica o método técnico HTTP (ex: POST para criar, PUT para atualizar, DELETE para excluir).\n Caminho: Exibe a rota do sistema onde a ação ocorreu.\n Status: Código de resposta do sistema (ex: 200 indica sucesso).\n IP: Endereço de rede do dispositivo que realizou a ação.\n Ícone Ver Detalhes (Olho): Abre um modal com os dados técnicos completos (Payload) da requisição.\n\n**\n\n#### Consultando e Interpretando os Logs\n\nComo realizar uma consulta\n\nPara buscar um evento, utilize os filtros de Usuário ou Entidade. Caso esteja procurando por uma alteração em um contato específico, digite o nome do recurso no campo Entidade e defina o Período desejado. Clique em Filtrar para atualizar a listagem.\n\nComo interpretar os registros\n\n Ações CREATE (POST): Indicam que novos dados foram inseridos no sistema.\n Ações UPDATE (PUT): Indicam modificações em cadastros ou configurações existentes.\n Ações DELETE (DELETE): Indicam que uma informação foi removida permanentemente.\n Identificação de Suspeitas: Verifique regularmente se o IP registrado condiz com a localização habitual do colaborador e se o Status apresenta muitos erros (códigos diferentes de 200).\n\nComo exportar logs para arquivamento\n\nPara manter a conformidade e possuir cópias de segurança fora do sistema:\n\n1. Aplique os filtros necessários para o período desejado (ex: último mês).\n2. Clique no ícone de Download (Exportar CSV) ao lado do botão de filtro.\n3. O arquivo será gerado com todo o histórico filtrado para análise em planilhas externas.\n\n*\n\n#### Detalhamento: Visualização de Dados (Ícone do Olho)\n\nAo clicar no ícone de visualização, o administrador tem acesso ao "corpo" da ação. Isso é útil para verificar exatamente qual informação foi alterada (por exemplo, qual era o valor antigo e qual passou a ser o novo valor de um campo).\n\n\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nUso Administrativo:** Esta página contém informações sensíveis de navegação e operação. O acesso deve ser restrito apenas a perfis de alta confiança na organização.\n{% endhint %}\n\n{% hint style="info" %}\nOs logs de auditoria são gerados automaticamente e não podem ser editados ou excluídos, garantindo a integridade da informação para fins de fiscalização.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/log-auditoria-admin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gestão Comercial\n\n- Operação (Gestão comercial)\n- Etiquetas: Cadastro de Etiquetas\n- Fechamentos: Mensagens de Fechamento Personalizadas\n- Filas: Cadastro de Filas\n- Horários de Atendimento\n- Notas: Notas do Atendimento\n- Produtos WooCommerce\n- Análises e Registros\n- Avaliações: Avaliações de Atendimento\n- Log Ligações\n- Painel de Atendimentos: Visão Geral dos Atendimento\n- Protocolos: Protocolos de Atendimento\n- Relatórios: Relatórios Gerais\n- WaVoIP: Gerenciamento de chamadas WaVoIP\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Análises e Registros\n\n- Avaliações: Avaliações de Atendimento\n- Log Ligações\n- Painel de Atendimentos: Visão Geral dos Atendimento\n- Protocolos: Protocolos de Atendimento\n- Relatórios: Relatórios Gerais\n- WaVoIP: Gerenciamento de chamadas WaVoIP\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Avaliações\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Avaliações é a ferramenta de controle de qualidade e satisfação do cliente (CSAT) do sistema Z-PRO. Através dela, o gestor pode monitorar o desempenho da equipe, analisar o feedback dos usuários e configurar as réguas automáticas de pesquisa que são disparadas ao final de cada atendimento.\n\n#### Principais funções\n\n Monitoramento de Satisfação: Visualização das notas atribuídas pelos clientes aos atendimentos.\n Configuração de Pesquisa: Personalização total das mensagens de avaliação para cada nível de nota.\n Auditoria de Feedback: Acesso direto ao ticket que gerou a avaliação para análise de contexto.\n\n#### Caso de uso\n\nUm gerente de suporte deseja identificar por que o índice de satisfação caiu na última semana. Ele acessa a aba Avaliações, filtra pelas notas "1" e "2", e utiliza o ícone de Espiar para ler as conversas. Ao identificar um padrão de demora, ele ajusta o treinamento da equipe e altera a Mensagem de Agradecimento na aba de configurações para incluir um cupom de desconto em casos de avaliações positivas.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Gestão Comercial e selecione a aba Avaliações.\n\n\n\n#### Você verá a seguinte tela:\n\nA página é dividida entre a listagem de resultados (Avaliações) e a área de parametrização (Configurações).\n\n\n\nExplicação dos campos e ícones (Aba Avaliações)\n\n Filtros Superiores: Permitem buscar avaliações por texto, intervalo de datas e nota específica (estrelas).\n Ticket: Número identificador do atendimento.\n Agente: Nome do atendente que realizou o serviço avaliado.\n Nota: Representação visual (estrelas) da satisfação do cliente.\n Ações:\n Olho (Espiar): Abre a conversa de forma resumida para consulta.\n Quadrado com Seta (Ir para atendimento): Direciona para o chat completo na Central de Atendimentos.\n Lixeira (Excluir): Remove o registro da avaliação.\n\n**\n\n#### Configuração da Pesquisa de Satisfação\n\nNa aba Configurações, o administrador define como o robô deve se comportar ao solicitar o feedback.\n\n\n\n1. Distribuição de Notas (0 a 5)\n\nPara cada nível de nota, você pode definir:\n\n Campo de Etiqueta: O nome interno da nota (ex: 0 = Péssimo, 5 = Incrível).\n Mensagem de Resposta: Texto que o sistema enviará ao cliente imediatamente após ele digitar o número correspondente àquela nota.\n\n2. Configurações Gerais\n\n\n\n Mensagem de agradecimento: Enviada após a conclusão bem-sucedida da avaliação.\n Mensagem de erro: Enviada caso o cliente digite uma opção inválida.\n Mensagem de reenvio: Texto de reforço caso o cliente não responda à primeira solicitação.\n Tempo para armazenar: Define por quanto tempo o sistema aguardará a resposta do cliente antes de ignorar a avaliação (ex: 12 horas).\n Habilitar avaliações (Toggle): Ativa ou desativa o envio automático em todos os fechamentos de ticket do sistema.\n Privacidade das avaliações: Se ativo, restringe a visualização dos logs apenas para Administradores e Supervisores.\n Pontuação máxima: Define a escala da pesquisa (ex: 0 a 3, 0 a 5, 0 a 10).\n\n**\n\n#### Passo a passo para enviar uma avaliação manual\n\nAlém do envio automático ao encerrar um ticket, você pode solicitar o feedback do cliente manualmente durante a conversa seguindo os passos abaixo:\n\n1. Acesse os Detalhes: Dentro do chat de Atendimento, clique no ícone "i" (Informações) no canto superior direito para abrir a barra lateral.\n2. Selecione a aba Atendimento: No painel lateral "Detalhes do contato", clique na aba Atend. (segunda aba).\n3. Dispare a Pesquisa: Localize o bloco Avaliação e clique no botão roxo Enviar.\n4. Interação do Cliente: O sistema enviará instantaneamente o menu de notas no chat (ex: 0 a 5). O cliente deve responder apenas com o número correspondente à nota desejada.\n5. Confirmação: Assim que o cliente responder, o sistema enviará a "Mensagem de agradecimento" configurada e armazenará a nota automaticamente no banco de dados.\n\n\n\n*\n\n#### Como consultar o histórico de avaliações do contato\n\nCaso precise verificar notas dadas anteriormente por esse mesmo cliente:\n\n1. Na mesma aba Atend. do painel lateral, clique no botão Log** ao lado do botão de enviar avaliação.\n2. O sistema exibirá uma lista com as datas e as notas atribuídas em atendimentos passados.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/avaliacoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Log Ligações\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Log de Ligações é o registro histórico de toda a atividade de voz realizada através das integrações de telefonia do sistema Z-PRO (como o WaVoIP). Nela, o gestor pode auditar chamadas recebidas e efetuadas, monitorar a duração dos contatos e avaliar a produtividade da equipe de atendimento por voz.\n\n#### Principais funções\n\n Auditoria de Chamadas: Registro detalhado de números de origem e destino.\n Controle de Produtividade: Visualização do tempo de duração de cada ligação.\n Rastreabilidade por Agente: Identificação de qual Usuário realizou ou atendeu a chamada.\n Exportação Gerencial: Geração de relatórios em formato CSV para análises externas.\n\n#### Caso de uso\n\nUm supervisor de atendimento precisa verificar o volume de chamadas não atendidas no dia anterior. Ele acessa a página de Log de Ligações, filtra o status por "Falhou" ou "Perdida" e identifica quais números de clientes não foram contatados. Com essas informações, ele delega à equipe uma lista de retorno prioritária, garantindo que nenhum lead ou cliente fique sem retorno.\n\n#### Como acessar a página\n\nNo menu lateral esquerdo, clique no Menu Gestão Comercial e selecione a aba Log Ligações.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Painel de Filtros:\n Data Início / Data Fim: Delimita o período do histórico.\n Status: Filtra chamadas por estado (ex: Encerrada, Chamando, Falhou).\n Agente: Filtra as ligações vinculadas a um Usuário específico.\n Número Origem / Destino: Localiza chamadas envolvendo um telefone específico.\n Colunas da Tabela:\n ID: Identificador numérico da ligação no sistema.\n Usuário: Nome do atendente responsável.\n Origem: Número que iniciou a chamada.\n Destino: Número que recebeu a chamada.\n Status (Badge): Situação final da ligação (ex: Encerrada, em laranja para Chamando).\n Duração: Tempo total de conversação.\n Data: Dia e horário exato do registro.\n Botão Exportar CSV: Baixa a lista filtrada para uma planilha Excel.\n Ícone Lixeira (Ações): Permite excluir um registro individual de log.\n\n**\n\n#### Passo a passo de uso\n\nConsultar o Histórico\n\n1. Defina o intervalo de datas nos campos Data Início e Data Fim.\n2. Se desejar analisar um colaborador específico, selecione o nome dele no campo Agente.\n3. Clique no botão Buscar. A tabela será atualizada com os registros correspondentes.\n\nExportar Dados para Relatórios\n\n1. Aplique os filtros desejados para segmentar os dados que você precisa.\n2. Clique no botão Exportar CSV localizado no canto superior direito.\n3. O arquivo será gerado automaticamente com todas as colunas da tabela para análise externa.\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/log-ligacoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Painel de Atendimentos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nO Painel de Atendimentos é o centro de comando para supervisores e administradores do Z-PRO. Diferente da tela operacional de chat, este painel oferece uma visão macro e em tempo real de todos os tickets da empresa, permitindo realizar intervenções rápidas e ações em lote para manter a fluidez da operação.\n\n#### Principais funções\n\n Monitoramento Global: Visualização de todos os tickets abertos e pendentes divididos por colunas.\n Ações em Massa: Resolução ou transferência de múltiplos atendimentos simultaneamente.\n Gestão de Contingência: Reatribuição rápida de tickets entre usuários e filas.\n Auditoria Visual: Acesso rápido ao conteúdo das conversas sem necessidade de assumir o ticket.\n\n#### Caso de uso\n\nUm supervisor percebe que um atendente precisou se ausentar inesperadamente, deixando 15 tickets em aberto. Para não interromper o fluxo, o supervisor acessa o Painel de Atendimentos, utiliza a ferramenta de Transferir entre Usuários e move todos os atendimentos daquele colaborador para um colega disponível, garantindo que nenhum cliente fique sem resposta.\n\n#### Como acessar a página\n\nClique no Menu Gestão Comercial e selecione a aba Painel Atendimentos.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\n*\n\n#### Explicação dos Campos e Ícones\n\nBarra de Ferramentas Superior\n\n\n\nOs ícones localizados no canto superior direito permitem executar ações que afetam toda a visualização ou grupos de tickets:\n\n1. Ícone Check (Abertos): Resolve (encerra) todos os tickets com status "Aberto" de uma só vez. \\n \n2. Ícone Check (Pendentes): Resolve (encerra) todos os tickets com status "Pendente" de uma só vez.\\n \n3. Ícone Troca entre Usuários: Abre o modal para transferir tickets de um atendente origem para um atendente destino.\n\n\n\n4. Ícone Troca entre Filas: Abre o modal para mover tickets de uma fila específica para outra.\n\n\n\n5. Ícone Troca entre Canais: Permite migrar atendimentos de uma conexão para outra (ex: mudar do WhatsApp A para o WhatsApp B).\n\n\n\n6. Ícone Envelope: Marca todos os tickets visualizados como lidos.\n7. Botão Filtros: Permite alternar o Tipo de Visualização entre Por Usuário (focado em quem atende) ou Por Fila (focado nos departamentos).\n\n\n\nÍcones dentro do Card de Chat\n\n\n\nCada ticket individual no painel possui dois controles rápidos:\n\n* Ícone de Seta (Atender): Assume o ticket para você, movendo-o para sua central de atendimentos.\n* Ícone de Olho (Espiar): Abre o histórico da conversa em modo de leitura para supervisão, sem que o cliente saiba e sem assumir a responsabilidade pelo ticket.\n\n*\n\n#### Passo a passo de uso (Ações em Lote)\n\n1. Transferir entre Usuários\n\n1. Clique no ícone de transferência entre usuários na barra superior.\n2. No modal, selecione o Usuário origem (quem está com os tickets agora).\n3. Selecione o Usuário destino (quem passará a ser o responsável).\n4. Confirme em Transferir.\n\n2. Transferir entre Filas e Lógica de Conflitos\n\n1. Clique no ícone de transferência entre filas.\n2. Selecione a Fila origem e a Fila destino.\n3. Usuário destino (Opcional): Se você informar um usuário específico aqui, todos os tickets serão atribuídos a ele.\n4. Tratamento de Conflitos: Se você não informar um usuário destino, o sistema detectará automaticamente se os atendentes atuais possuem acesso à nova fila.\n\n*\n\n#### Avisos e precauções\n\n{% hint style="danger" %}\nCuidado com as Ações Globais:** As funções de "Resolver tickets abertos/pendentes" são irreversíveis e encerram centenas de conversas simultaneamente. Certifique-se de aplicar os filtros de data corretamente antes de executar.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/painel-de-atendimentos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Protocolos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Protocolos centraliza todos os números identificadores únicos gerados para os atendimentos no sistema Z-PRO. O protocolo é a garantia de rastreabilidade para o cliente e para a empresa, permitindo localizar rapidamente o histórico de uma interação específica em auditorias ou consultas futuras.\n\n#### Caso de uso\n\nUm cliente entra em contato informando que possui um protocolo de um atendimento realizado no mês anterior para contestar uma informação. O supervisor acessa a página de Protocolos, insere o número fornecido no campo de busca e, ao localizar o registro, utiliza o ícone de Espiar conversa para validar o que foi tratado, sem precisar abrir um novo ticket para isso.\n\n#### Como acessar a página\n\nNo menu lateral esquerdo, clique no Menu Gestão Comercial e selecione a aba Protocolos.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Barra de Busca: Localiza protocolos digitando o número gerado ou o ID do ticket.\n Filtros de Data (Início/Fim): Delimita a busca por um intervalo de tempo específico.\n Colunas da Tabela:\n Protocolo: O código identificador gerado pelo sistema.\n Ticket ID: O número do Atendimento ao qual o protocolo pertence.\n Data: Registro do dia e hora da criação do protocolo.\n Ações (Ícones):\n Olho (Espiar conversa): Abre a visualização da conversa vinculada sem sair da tela.\n Quadrado com Seta (Ir para atendimento): Direciona o usuário para o chat ativo ou histórico na central de atendimentos.\n Lápis (Editar): Permite alterar o número do protocolo ou o Ticket ID vinculado.\n Lixeira (Excluir): Remove o registro de protocolo do sistema.\n\n**\n\n#### Como gerenciar e enviar protocolos\n\nO sistema Z-PRO permite que o protocolo seja gerenciado tanto na tela administrativa quanto diretamente na operação de chat.\n\nConsultar e Editar\n\n1. Utilize os filtros de data e busca para localizar o registro.\n2. Para correções, clique no Lápis (Editar), altere os dados no modal e clique em Salvar.\n\n\n\nEnviar o Protocolo para o cliente durante o chat\n\nPara informar o número do protocolo ao cliente em tempo real:\n\n1. Na Central de Atendimentos, abra o ticket do cliente.\n2. Clique no ícone "i" (Informações) no canto superior direito.\n3. No painel lateral, selecione a aba Atend..\n4. Localize a seção Protocolo e clique no botão Enviar.\n5. Confirme no modal clicando em Sim, enviar. O número será disparado automaticamente na conversa do cliente.\n\n\n\n\n\n*\n\n#### Detalhamento\n\nOs protocolos são gerados automaticamente pelo sistema seguindo uma lógica cronológica e sequencial. Eles servem como uma camada de organização extra ao Ticket ID, sendo este último uma identificação interna de banco de dados, enquanto o Protocolo é a identificação voltada ao cliente final.\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nAtenção:** A exclusão de um protocolo nesta página remove apenas o registro do índice de busca de protocolos. A conversa original (Ticket) permanece salva no banco de dados do sistema.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/protocolos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Relatórios\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Relatórios é a central de inteligência de dados do sistema Z-PRO. Ela permite a extração de informações detalhadas sobre a base de clientes e a performance operacional da equipe. Através de filtros avançados, o gestor pode gerar visões específicas e exportar os dados para planilhas (Excel/CSV), facilitando a tomada de decisão estratégica e a execução de campanhas de marketing direcionadas.\n\n#### Principais funções\n\n Extração de Base: Download de listas de contatos com dados cadastrais completos.\n Segmentação Geográfica e Comportamental: Relatórios baseados em DDD (Estados) e Etiquetas.\n Acompanhamento de Funil: Análise de contatos distribuídos por colunas de Kanban.\n Auditoria de Performance: Métricas de produtividade individual por atendente.\n\n#### Caso de uso\n\nO gestor de uma empresa deseja realizar um pós-venda apenas com clientes do estado de São Paulo que foram atendidos pelo setor de "Suporte" e marcados com a etiqueta "Upgrade". Ele utiliza o relatório de Contatos por Estado para filtrar o DDD 11, cruza com o relatório de Contatos por Etiqueta e exporta a lista para o Excel para realizar um Envio em Massa.\n\n#### Como acessar a página\n\nClique no Menu Gestão Comercial e selecione a aba Relatórios.\n\n\n\n*\n\n#### Visão Geral dos Relatórios\n\nAo acessar a página, você verá cards que direcionam para cada modalidade de análise:\n\n\n\nAbaixo, detalhamos cada tipo de relatório disponível e como utilizá-los:\n\n1. Relatório de Contatos\n\nGera a lista completa de Contatos criados no sistema dentro de um intervalo de tempo.\n\n* Como usar: Defina a Data Início e Data Fim do período de criação e clique em Gerar Relatório.\n* Dados exibidos: Nome, WhatsApp, e-mail e informações cadastradas nos campos extras.\n* Finalidade: Auditoria de crescimento da base e backup de cadastros.\n*\n\n\n \n\n\n2. Contatos por Etiqueta\n\nSegmenta a base de clientes conforme as marcações atribuídas.\n\n* Como usar: Selecione uma ou mais Etiquetas no filtro suspenso e gere o relatório.\n* Dados exibidos: Nome, WhatsApp e a lista de etiquetas vinculadas ao contato.\n* Finalidade: Ideal para segmentação de campanhas de marketing e identificação de perfis de consumo.\n\n\n\n3. Contatos por Estado (UF)\n\nIdentifica a localização geográfica dos contatos baseando-se no código de área (DDD) do WhatsApp.\n\n* Como usar: Selecione o estado (UF) desejado no filtro.\n* Dados exibidos: Listagem de contatos pertencentes à região filtrada.\n* Finalidade: Análise de alcance regional e campanhas sazonais por estado.\n\n\n\n4. Contatos por Kanban\n\nRelatório focado na progressão dos leads ou processos dentro do fluxo comercial.\n\n* Como usar: Selecione o quadro Kanban específico para analisar a distribuição dos cards.\n* Dados exibidos: Nome do contato e em qual etapa (lane) do funil ele se encontra.\n* Finalidade: Identificar gargalos no processo de vendas e volume de oportunidades em cada estágio.\n\n\n\n5. Contatos por Carteira\n\nFiltra os clientes com base no Usuário responsável pelo relacionamento (atendimento fixo).\n\n* Como usar: Selecione uma ou mais Carteiras (atendentes).\n* Dados exibidos: Lista de contatos vinculados aos usuários selecionados.\n* Finalidade: Avaliação de distribuição de carga de trabalho e gestão de carteira de clientes por vendedor.\n\n\n\n6. Atendimentos por Parâmetros\n\nO relatório mais granular do sistema, permitindo filtrar Tickets por diversas variáveis técnicas.\n\n* Filtros disponíveis: Status (Aberto, Fechado, Pendente, Agendado), Conexões, Filas, Usuário, Canal e tipo de Demanda (Ativa/Receptiva). Também permite filtrar por valor mínimo/máximo, caso utilize campos financeiros.\n* Finalidade: Auditoria técnica detalhada e extração de histórico de conversas para conformidade.\n\n\n\n7. Resumo de Atendimentos por Usuário\n\nRelatório focado em produtividade e indicadores de desempenho (KPIs) da equipe.\n\n* Como usar: Defina o período desejado e gere o relatório.\n* Dados exibidos: Total de atendimentos por agente, divididos entre pendentes, em atendimento e resolvidos.\n* Finalidade: Comparar a performance entre membros da Equipe e identificar a eficiência na resolução de demandas.\n\n\n\n*\n\n#### Ações Disponíveis\n\nEm cada modalidade de relatório, o sistema disponibiliza botões específicos para o processamento e extração dos dados:\n\n Gerar Relatório: Botão utilizado para processar os filtros selecionados (como intervalo de datas ou etiquetas) e carregar a lista de resultados na tabela de visualização. É necessário clicar neste botão sempre que os filtros forem alterados.\n Exportar Excel: Realiza o download imediato dos dados exibidos na tabela para um arquivo no formato .xlsx. Este formato é recomendado para análises que exijam fórmulas e formatação avançada em planilhas.\n Exportar CSV: Gera um arquivo de texto com os dados brutos separados por vírgulas. Este formato é ideal para importação manual em outros sistemas, CRMs ou ferramentas de tratamento de dados que não suportam arquivos Excel nativos.\n\n\n\n**\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nVolume de Dados: Ao gerar relatórios de períodos muito longos (ex: superior a 1 ano) com muitos filtros, o processamento pode levar alguns segundos. Aguarde a mensagem de conclusão antes de tentar exportar.\n{% endhint %}\n\n{% hint style="info" %}\nExportação: Todos os relatórios possuem o botão Exportar Excel. Recomenda-se aplicar os filtros antes de exportar para garantir que o arquivo contenha apenas os dados relevantes.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WaVoIP\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página WaVoIP é o módulo dedicado à gestão e auditoria de chamadas telefônicas realizadas através da integração de voz sobre IP do sistema Z-PRO. Esta interface permite autenticar a conta de telefonia, sincronizar o histórico de comunicações e acessar gravações para monitoria de qualidade.\n\n#### Como acessar a página\n\nClique no Menu Gestão Comercial e selecione a aba WaVoIP.\n\n\n\n#### Você verá a seguinte tela:\n\nA página oferece dois métodos de acesso aos dados, divididos em abas superiores:\n\nExplicação dos campos e ícones\n\n Aba Login e Chamadas: Utilizada para autenticação padrão via conta de usuário.\n E-mail: Endereço de e-mail cadastrado no serviço WaVoIP.\n Senha: Senha de acesso vinculada à conta.\n Botão Autorizar e Carregar Chamadas: Valida as credenciais e puxa a lista de chamadas recentes para a tela.\n\n\n\n Aba Por Token: Utilizada para consultas rápidas através de chaves de integração.\n Token WaVoIP: Campo para seleção ou inserção do token de autenticação técnica.\n Botão Buscar Chamadas: Filtra o histórico com base no token informado.\n\n\n\n**\n\n#### Passo a passo de uso\n\nAutenticação e Consulta via Login\n\n1. Acesse a aba Login e Chamadas.\n2. Insira seu E-mail e Senha do serviço de telefonia.\n3. Clique em Autorizar e Carregar Chamadas.\n4. O sistema exibirá a tabela com o histórico completo abaixo dos campos de login.\n\nConsulta via Token\n\n1. Acesse a aba Por Token.\n2. Selecione o Token WaVoIP desejado no menu suspenso ou insira a chave manual se solicitado.\n3. Clique em Buscar Chamadas para atualizar a listagem.\n\nOuvir Gravações\n\n1. Na lista de chamadas gerada, identifique o contato desejado.\n2. Localize a coluna Gravação.\n3. Clique no link ou ícone de Ver/Ouvir para abrir o reprodutor de áudio da chamada selecionada.\n\n#### Detalhamento\n\nA integração WaVoIP permite que os dados de voz sejam vinculados aos Contatos do Z-PRO, facilitando a identificação do cliente na lista de chamadas. Caso uma chamada seja identificada, o nome do contato aparecerá ao lado do número de telefone.\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nCredenciais: Certifique-se de que os dados de login informados são os mesmos utilizados no painel administrativo do seu provedor WaVoIP.\n{% endhint %}\n\n{% hint style="info" %}\nA disponibilidade das gravações depende da retenção de dados configurada em seu plano de telefonia WaVoIP. Caso o áudio não carregue, verifique se a chamada ainda está dentro do prazo de armazenamento do provedor.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/wavoip.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Operação (Gestão comercial)\n\n- Etiquetas: Cadastro de Etiquetas\n- Fechamentos: Mensagens de Fechamento Personalizadas\n- Filas: Cadastro de Filas\n- Horários de Atendimento\n- Notas: Notas do Atendimento\n- Produtos WooCommerce\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Etiquetas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Etiquetas (também conhecidas como tags) é uma ferramenta essencial para a organização e segmentação visual dos atendimentos no Z-PRO. Através dela, o administrador cria identificadores coloridos que permitem categorizar contatos e tickets, facilitando a triagem manual e a automação de processos.\n\n#### Caso de uso\n\nUma imobiliária utiliza as etiquetas para separar os contatos entre "Interesse em Aluguel" (cor azul) e "Interesse em Venda" (cor verde). Ao configurar a palavra-chave gatilho "alugar", o sistema aplica automaticamente a etiqueta azul assim que o cliente envia essa mensagem. Posteriormente, o gestor utiliza o filtro de etiquetas na Central de Atendimentos para visualizar apenas os interessados em locação.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Gestão Comercial e selecione a aba Etiquetas.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Campo de Busca: Permite localizar uma etiqueta específica pelo nome.\n Botão + Nova Etiqueta: Abre o formulário para criação de um novo identificador.\n ID: Número de identificação único da etiqueta no banco de dados.\n Nome: Título da etiqueta (ex: Urgente, VIP, Lead).\n Cor: Representação visual da etiqueta. O texto interno assume a cor escolhida para facilitar a leitura.\n Ações (Ícones):\n Lápis (Editar): Permite alterar o nome, a cor ou a palavra-chave de automação.\n Lixeira (Excluir): Remove a etiqueta do sistema.\n\n*\n\n#### Passo a passo de uso\n\nCriar uma nova etiqueta\n\n1. Clique no botão + Nova Etiqueta.\n2. Nome: Insira um nome curto e objetivo.\n3. Cor: Clique no seletor de cores ou insira o código hexadecimal (ex: #3B82F6) para definir a identidade visual.\n4. Palavra-chave gatilho (Opcional): Insira termos que, se recebidos em uma mensagem do cliente, farão com que o sistema aplique esta etiqueta automaticamente.\n5. Clique em Salvar.\n\n\n\nAplicar etiquetas em atendimentos\n\n1. Acesse a Central de Atendimentos.\n2. Abra um ticket e, no painel de Detalhes do Contato (ícone "i"), localize o campo Etiquetas**.\n3. Selecione uma ou mais etiquetas para o contato. Elas aparecerão imediatamente no card do chat na lista lateral.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/etiquetas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Fechamentos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Motivos de Fechamento permite a padronização e categorização do encerramento de tickets no sistema Z-PRO. Através desta funcionalidade, o administrador define opções pré-configuradas que os atendentes devem selecionar ao finalizar um atendimento, garantindo uma base de dados qualificada para auditorias e Relatórios.\n\n#### Principais funções\n\n Padronização de Encerramento: Criação de categorias específicas para o fim do atendimento (ex: Venda Concluída, Dúvida Sanada, Desistência).\n Mensagens Automáticas: Configuração de textos que podem ser enviados automaticamente ao cliente no momento em que o ticket é resolvido.\n\n#### Caso de uso\n\nUma empresa de e-commerce utiliza a página para criar o motivo "Pedido Entregue". Ao configurar este motivo, o administrador insere a mensagem: "Olá! Seu pedido foi entregue com sucesso. Caso precise de algo mais, estamos à disposição!". Quando o atendente utiliza esse motivo na Central de Atendimentos, o sistema encerra o ticket e envia a saudação final de forma automática, otimizando o fluxo de trabalho.\n\n#### Como acessar a página\n\nCaminho clicando no Menu Gestão Comercial e na aba Operação - Fechamento.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Nome: Título descritivo do motivo de encerramento. É o texto que aparecerá para o atendente escolher.\n Mensagem: O conteúdo textual que será disparado para o cliente caso este motivo seja selecionado no fechamento.\n Ações (Ícones):\n Lápis (Editar): Abre o modal para alteração do nome ou da mensagem de fechamento vinculada.\n Lixeira (Excluir): Remove permanentemente o motivo da lista de opções do sistema.\n Botão + Novo Motivo: Abre o formulário para criação de uma nova categoria de fechamento.\n Botão Atualizar: Recarrega a lista para exibir as alterações mais recentes.\n\n**\n\n#### Passo a passo de uso\n\nCriar um novo motivo de fechamento\n\n1. Clique no botão + Novo Motivo no canto superior direito.\n2. No campo Nome, insira a categoria (ex: Suporte Finalizado).\n3. No campo Mensagem de fechamento, digite o texto de despedida que o cliente receberá.\n4. Clique em Criar.\n\n\n\nUtilizar o motivo no atendimento\n\n1. Na Central de Atendimentos, ao clicar no ícone de Resolver Atendimento (check verde), o sistema solicitará que você selecione um dos motivos criados.\n\n\n\n2. Ao selecionar o motivo e confirmar, o ticket será movido para a aba Fechados e a mensagem configurada será enviada ao contato.\n\n\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/fechamentos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Filas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e supervisor\n{% endhint %}\n\nA página de Filas é utilizada para organizar os atendimentos em diferentes departamentos ou categorias (ex: Suporte, Vendas, Financeiro). Elas são fundamentais para o direcionamento correto dos Tickets, permitindo que cada setor tenha suas próprias regras de disponibilidade, cores de identificação e mensagens automáticas.\n\n#### Principais funções\n\n Segmentação de Setores: Criação de departamentos para organizar o fluxo de entrada.\n Gestão de Disponibilidade: Configuração de horários de funcionamento específicos por fila.\n Mensagens Personalizadas: Definição de respostas automáticas para períodos em que a fila estiver fechada.\n Identificação Visual: Atribuição de cores para facilitar a triagem na Central de Atendimentos.\n\n#### Caso de uso\n\nUma empresa possui uma equipe de Vendas que trabalha aos sábados e uma equipe Financeira que opera apenas de segunda a sexta. Ao criar duas filas distintas, o administrador configura horários diferentes para cada uma. Se um cliente tentar contato com o Financeiro no sábado, ele receberá automaticamente a "Mensagem fora do horário" específica daquele setor, enquanto o setor de Vendas continuará recebendo tickets normalmente.\n\n#### Como acessar a página\n\nCaminho clicando no Menu Gestão Comercial e na aba Filas.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n ID: Identificador único da fila no sistema.\n Nome: Nome do departamento ou setor.\n Cor: Código hexadecimal e amostra visual da cor atribuída à fila.\n Status: Indica se a fila está Ativa (recebendo atendimentos) ou Inativa.\n Ações (Ícones):\n Lápis (Editar): Abre o modal de configurações da fila.\n Lixeira (Excluir): Remove a fila permanentemente.\n\n**\n\n#### Passo a passo de uso\n\n1. Criar uma nova fila\n\n1. Clique no botão + Nova Fila no canto superior direito.\n2. No modal que abrirá, certifique-se de que a chave Ativa está ligada.\n3. Insira o Nome da fila e escolha uma Cor para identificação visual.\n\n2. Configurar Horário de Atendimento\n\nPara cada dia da semana, selecione uma das opções de status:\n\n Aberto: A fila aceita atendimentos durante todo o dia (ou segue a regra global).\n Bloqueado: A fila não recebe atendimentos neste dia.\n Agendado: Permite configurar janelas específicas de horário (turnos) para o funcionamento da fila.\n\n3. Definir Mensagem de Ausência\n\nNo campo Fora do horário, digite a mensagem que o cliente receberá caso entre em contato enquanto a fila estiver com o status "Bloqueado" ou fora do intervalo "Agendado".\n\n4. Clique em Salvar.\n\n\n\n**\n\n#### Atribuir usuários em filas\n\nAs filas criadas nesta página devem ser vinculadas aos Usuários para que eles possam visualizar as mensagens destinadas a cada setor. Além disso, as filas são utilizadas como destinos dentro do ChatFlow para automatizar o transbordo do robô para o atendente humano.\n\nUtilizar "Ações" para configurar quais filas o usuário está:\n\n\n\n*\n\n#### Casos de Uso Práticos das Filas\n\nAs filas não apenas organizam a visualização, mas controlam a inteligência de distribuição de dados no sistema. Abaixo, detalhamos como utilizá-las estrategicamente:\n\n1. Organização e Filtro no Atendimento\n\nNa operação diária, as filas permitem que cada atendente foque exclusivamente em sua área de especialidade, evitando a poluição visual com tickets irrelevantes para sua função.\n\n* Aplicação: Na Central de Atendimentos, o agente utiliza o painel de Filtros para selecionar apenas a fila "Comercial".\n* Benefício: O sistema oculta instantaneamente todos os tickets de "Suporte" ou "Financeiro", permitindo que o colaborador visualize apenas as demandas de vendas pendentes ou abertas sob sua responsabilidade.\n\n\n\n2. Roteamento Inteligente no ChatFlow\n\nDentro do construtor de automação, as filas são utilizadas como o "destino final" da triagem inicial feita pelo bot.\n\n* Encaminhamento por Escolha: No fluxo de boas-vindas, o bot apresenta um menu (Ex: "Digite 1 para Vendas ou 2 para Suporte").\n * Condição Igual a 1: O sistema é configurado para Encaminhar para Fila > "Vendas".\n * Condição Igual a 2: O sistema é configurado para Encaminhar para Fila > "Suporte".\n\n\n\n* Tratamento de Exceções (Timeout e Erros): Caso o cliente pare de responder ou erre a opção repetidamente, as filas servem como plano de contingência.\n * Sem resposta (timeout): Se o cliente não responder em 10 minutos, o fluxo pode encaminhá-lo automaticamente para uma fila de "Retenção" ou encerrar o ticket.\n * Máximo de tentativas: Após 3 erros de digitação do cliente, o sistema pode ignorar a automação e encaminhá-lo diretamente para a fila de "Atendimento Humano".\n\n\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/filas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Horários de Atendimento\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nA página de Horário de Atendimento permite estabelecer o período operacional global da organização no sistema Z-PRO. Através desta configuração, o administrador define quando a plataforma deve processar atendimentos normalmente e quando deve disparar mensagens de ausência, além de gerenciar datas específicas de recesso por meio do cadastro de feriados.\n\n#### Caso de uso\n\nUma empresa que opera comercialmente de segunda a sexta, das 08:00 às 18:00, com intervalo entre 12:00 e 13:30, utiliza esta página para configurar esses turnos. Ao chegar às 18:01, o sistema ativa automaticamente a Mensagem Fora do Horário, informando ao cliente que o atendimento retornará no próximo dia útil, evitando que o contato fique sem resposta.\n\n#### Como acessar a página\n\nNo menu lateral, clique em Gestão Comercial e selecione a aba Horário de Atendimento.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Opções por Dia:\n 24 horas: O sistema permanece aberto e receptivo durante todo o dia selecionado.\n Agendado: Habilita campos para inserção de horários de início e fim. Permite a configuração de até dois períodos (turnos) por dia.\n Fechado: O sistema considera a organização inativa durante todo o dia selecionado.\n Mensagem Fora do Horário: Campo de texto para redigir a resposta automática enviada aos clientes que contatarem o Canal fora do expediente.\n Feriados: Seção para listagem de datas específicas onde o atendimento será bloqueado, independentemente do dia da semana.\n Botão Adicionar Feriado: Abre o modal para cadastro de nova data.\n Botão Salvar: Aplica todas as alterações realizadas na página.\n\n*\n\n#### Passo a passo de uso: Horário do Tenant\n\n1. Configurar o Horário Semanal\n\n1. Para cada dia da semana, selecione o regime de atendimento (24 horas, Agendado ou Fechado).\n2. No regime Agendado, insira a hora de início e término do primeiro turno. Se houver intervalo, insira o horário de retorno e encerramento no segundo período.\n3. Repita o processo para os demais dias.\n\n2. Definir a Resposta de Ausência\n\n1. No campo Mensagem Fora do Horário, escreva o texto que o cliente deve receber.\n2. Deixe o campo em branco caso prefira que nenhuma mensagem automática seja enviada.\n\n\n\n3. Cadastrar Feriados\n\n1. Role a página até a seção Feriados e clique em Adicionar Feriado.\n2. No modal, selecione a Data no calendário e insira uma Descrição (ex: Natal).\n3. Clique em Adicionar.\n4. Lembre-se de clicar no botão Salvar no topo da página principal após configurar os feriados.\n\n\n\n*\n\n#### A Lógica de Hierarquia\n\nO sistema Z-PRO utiliza uma lógica de precedência para verificar os horários de atendimento. Entender esta hierarquia é fundamental para evitar conflitos entre as mensagens do Chatbot e as respostas de ausência.\n\nA ordem de verificação é: Fila > Usuário > Tenant (Global).\n\n1. Nível 1: Horário por Fila O sistema primeiro verifica se a Fila para onde o ticket está (ou será) direcionado possui um horário de atendimento próprio e ativo. Se sim, o Z-PRO usará este horário e a mensagem de ausência desta fila, ignorando os níveis abaixo.\n2. Nível 2: Horário por Usuário Se a Fila não tiver horário configurado (ou se o ticket estiver carteirizado), o sistema verifica se o Usuário (atendente) possui um horário de atendimento ativo em seu perfil. Se sim, esta regra prevalece sobre o Global.\n3. Nível 3: Horário por Tenant Se nem a Fila nem o Usuário possuírem horários específicos, o sistema utilizará as regras configuradas nesta página (Global/Tenant) como padrão final.\n\n*\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nImportante: Sempre clique no botão Salvar após qualquer alteração nos horários ou feriados. As modificações não são aplicadas automaticamente ao preencher os campos.\n{% endhint %}\n\n{% hint style="info" %}\nOs feriados marcados como ativos bloqueiam o atendimento durante as 24 horas da data selecionada, sobrepondo-se ao horário agendado para aquele dia da semana.\n{% endhint %}\n\n*\n\n### Como Configurar os outros Horários de atendimento\n\n#### Horário por Fila\n\nIdeal para empresas onde diferentes setores (ex: Vendas, Suporte, Financeiro) têm horários de funcionamento distintos.\n\n Onde configurar: Admin > Filas > (Editar uma Fila) > Aba "Horário de Atendimento"\n Como funciona: Ative os dias da semana desejados, defina os horários de início e fim, e escreva a "Mensagem de Ausência" específica para esta fila.\n\n\n\n#### Horário por Usuário\n\nIdeal para atendentes com jornadas de trabalho específicas (ex: meio período, turnos diferentes, folgas alternadas).\n\n Onde configurar: Admin > Usuários > (Editar um Usuário) > Aba "Horário de Atendimento"\n Como funciona: Similar à Fila, ative os dias e horários em que este usuário específico está disponível. Se um ticket for direcionado a ele fora deste horário, o sistema o tratará como ausente.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/horarios-de-atendimento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Notas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nA página de Notas centraliza todas as anotações internas realizadas pelos atendentes durante os atendimentos. Essa ferramenta é essencial para a supervisão e o acompanhamento de informações estratégicas que não são visíveis para o cliente, mas que auxiliam na continuidade e na qualidade do suporte ou da negociação comercial.\n\n#### Principais funções\n\n Gestão Centralizada: Visualização de todas as notas criadas em diferentes tickets em uma única tela.\n Filtro Cronológico: Busca de anotações por intervalos específicos de datas.\n Auditoria de Conteúdo: Capacidade de editar ou excluir observações para manter o histórico preciso.\n Rastreabilidade: Identificação imediata de qual usuário criou a nota e a qual ticket ela pertence.\n\n#### Caso de uso\n\nUm supervisor de vendas precisa auditar as observações feitas pela equipe sobre clientes que solicitaram orçamentos personalizados. Ele acessa a página de Notas, filtra pelo período da última semana e utiliza o recurso de Espiar atendimento para entender o contexto da anotação sem precisar sair da lista gerencial, agilizando o processo de monitoria.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Gestão Comercial e selecione a aba Notas.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Buscar notas...: Campo de busca textual para encontrar termos específicos dentro do conteúdo das anotações.\n Data início / Data fim: Filtros de calendário para delimitar o período de exibição dos registros.\n Ticket ID: Identificador único do Atendimento onde a nota foi gerada.\n Conteúdo: O texto da anotação realizada pelo atendente.\n Usuário: Nome do colaborador que redigiu a nota.\n Data: Registro do dia e horário exato da criação.\n Ações (Ícones):\n Olho (Espiar atendimento): Abre uma visualização rápida da conversa sem sair da página de Notas.\n\n\n\n Quadrado com Seta (Ir para atendimento): Direciona o navegador para a Central de Atendimentos carregando o ticket correspondente.\n Lápis (Editar): Permite alterar o texto da nota existente.\n Lixeira (Excluir): Remove a nota permanentemente do histórico do sistema.\n\n**\n\n#### Detalhamento\n\nAs notas são criadas exclusivamente dentro da Central de Atendimentos, no painel de detalhes do contato (ícone "i")\n\n\n\nAssim que adicionar uma nota ao usuário, o chat mostra qual a nota foi criada:\n\n\n\nA página de Notas funciona como um indexador dessas informações para fins de gestão, não sendo possível criar uma "nota avulsa" nesta tela sem vinculação a um ticket existente.\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nAtenção: As notas são estritamente internas. Elas servem para a comunicação entre membros da equipe e supervisão, nunca sendo enviadas ou visualizadas pelo contato externo (cliente).\n{% endhint %}\n\n{% hint style="danger" %}\nExclusão: Ao excluir uma nota nesta página, ela também será removida da aba de detalhes do contato dentro do atendimento. Essa ação é irreversível.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/notas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Produtos WooCommerce\n\nEm construção\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/produtos-woocommerce.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Visão geral Admin\n\nO Painel Admin é a interface utilizada pelos gestores e colaboradores de uma empresa que utiliza o Z-PRO. Ele é segmentado para permitir tanto a operação diária quanto a configuração estratégica do negócio.\n\n\n\n### Entendendo os Níveis de Acesso\n\nPara garantir a segurança dos dados e a organização da equipe, o painel do Tenant é dividido em três níveis hierárquicos de permissão:\n\n#### 1. Administrador (Gestor)\n\n Função: Responsável pela configuração estratégica da conta.\n* Permissões: Tem acesso total e irrestrito a todos os menus e configurações. É o único que pode conectar canais (WhatsApp), gerenciar assinaturas e alterar configurações de API e Webhooks.\n\n#### 2. Supervisor\n\n* Função: Perfil intermediário focado na gestão de pessoas e análise de métricas, sem poder alterar configurações estruturais críticas (como desconectar canais ou apagar a conta).\n* Regra de Visualização de Tickets:\n * Padrão: O Supervisor visualiza todos os tickets e atendimentos (semelhante ao Admin).\n * Restrito: Existe uma configuração específica em Configurações > Geral chamada "Remover privilégios de visualização do supervisor". Se ativada, o supervisor passa a ver apenas os tickets vinculados a ele ou à sua fila, comportando-se como um usuário comum neste aspecto.\n\n#### 3. Usuário (Atendente)\n\n* Função: Focado exclusivamente na operação de atendimento.\n* Permissões: Acesso restrito aos menus operacionais. Não visualiza relatórios gerenciais, configurações de sistema ou gestão de outros usuários.\n\n*\n\n### Estrutura de Menus\n\nO sistema Z-PRO organiza as funcionalidades em oito menus principais. A visibilidade destes menus varia de acordo com o nível de acesso.\n\n\n\n#### 1. Menus Operacionais (Visíveis para Todos)\n\nEstes menus são voltados para a execução do dia a dia.\n\n1. Principal\n Home: Tela inicial de boas-vindas.\n Dashboard: Indicadores e métricas em tempo real.\n2. Atendimento\n Atendimentos: Central de chat e gestão de tickets.\n Chat Privado: Comunicação interna entre membros da equipe.\n Contatos: Lista e gestão de clientes.\n3. Comunicação e Marketing\n Campanhas: Criação de ações de marketing.\n Envio em Massa: Disparos de mensagens para listas.\n Galeria: Armazenamento de arquivos de mídia.\n Grupos: Gestão de grupos de chat.\n Instagram / TikTok / YouTube: Integrações com redes sociais.\n Mensagens Rápidas: Atalhos para respostas padronizadas.\n4. Gestão\n Agenda: Compromissos e lembretes.\n Funil / Kanban: Visualização do processo de vendas ou processos internos.\n Tarefas: Gestão de atividades pendentes.\n5. Conta\n Informações do plano e perfil logado.\n\n#### 2. Menus Administrativos (Restritos)\n\nEstes menus contêm configurações que alteram o comportamento do sistema. Por padrão, são visíveis apenas para Admin (e parcialmente para Supervisor, dependendo das permissões concedidas).\n\n1. Administração\n Canais: Configuração de conexões (WhatsApp, etc).\n Equipes: Organização de departamentos.\n Usuários: Cadastro e permissões de colaboradores.\n2. Automação\n Agendamentos: Mensagens programadas para envio futuro.\n Aniversários: Automação de mensagens para datas comemorativas.\n Chat Flow: Construtor de fluxos inteligentes de atendimento.\n3. Gestão Comercial\n Avaliações: Feedback dos atendimentos realizados.\n Etiquetas: Tags para organização de conversas.\n Fechamento: Registro de conclusão de tickets.\n Filas / Horário de Atendimento: Regras de distribuição e disponibilidade.\n Log de Ligações / Notas / Protocolos: Registros históricos e auditoria.\n Relatórios: Extração de dados gerenciais.\n WaVoIP: Recursos de telefonia integrada.\n4. Configuração\n API: Chaves de integração para sistemas externos.\n Configurações: Ajustes globais do sistema.\n Log de Auditoria: Histórico de ações realizadas no painel.\n\n**\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/visao-geral-admin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configuracao Superadmin
Canais e Integrações (superadmin)\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Facebook Login incorporado (waba/insta/messenger)\n\n## Login do Facebook Incorporado (WABA)\n\nA funcionalidade de Login do Facebook permite que seus clientes conectem contas de WhatsApp Business API (WABA) ao Z-PRO de forma simplificada.\n\nAo configurar seu aplicativo da Meta no Superadmin, o cliente final não precisará gerar tokens manuais. Ele apenas clicará em um botão "Logar com Facebook", aceitará as permissões e selecionará os números disponíveis para criar o canal.\n\nVídeo Tutorial:\n\n{% embed url="https://www.youtube.com/watch?v=0Whyjg5VHec" %}\n\n*\n\n### Parte 1: Configuração na Meta (Facebook Developers)\n\nPara que o login funcione, você precisa configurar um aplicativo no painel de desenvolvedores do Facebook.\n\n#### 1. Criar e Configurar o App\n\n1. Acesse developers.facebook.com e crie um aplicativo do tipo Empresa (Business).\n2. No painel do app, vá em Configurações Básicas e copie o ID do Aplicativo e a Chave Secreta (App Secret). Você precisará deles depois.\n3. Adicione o domínio do seu Z-PRO (onde o front-end roda) no campo Domínios do Aplicativo.\n\n#### 2. Adicionar o Produto "Login do Facebook"\n\n1. No menu lateral ou em "Adicionar Produto", selecione Login do Facebook.\n2. Vá em Configurações (dentro de Login do Facebook).\n3. Ative a opção Login com o SDK do JavaScript.\n4. Em Domínios permitidos para o SDK do JavaScript, insira o domínio do seu painel (ex: https://app.seusistema.com.br).\n5. IMPORTANTE: No campo URIs de redirecionamento do OAuth, adicione o caminho do arquivo de embed: https://app.seusistema.com.br/facebook_embed_signup.html (Substitua app.seusistema.com.br pelo seu domínio real).\n\n#### 3. Configurar Permissões e Casos de Uso\n\nDependendo da versão do painel da Meta, vá em Revisão do App > Permissões e Recursos ou Casos de Uso. Certifique-se de adicionar e conceder acesso avançado (ou standard para testes) às seguintes permissões:\n\n email\n public_profile\n whatsapp_business_management\n business_management\n\n#### 4. Configuração do Cadastro Incorporado (Embedded Signup)\n\n1. Adicione o produto WhatsApp ao seu app.\n2. Vá em Configuração > Cadastro Incorporado.\n3. Crie uma nova configuração (Config ID).\n4. Selecione as permissões citadas acima e marque a opção "Token nunca expira".\n5. Ao salvar, ele gerará um código de Config ID. Copie este número.\n\n#### 5. Gerar Token do Sistema (Business Manager)\n\n1. Acesse o Gerenciador de Negócios (Business Manager) vinculado ao app.\n2. Vá em Usuários > Usuários do Sistema.\n3. Adicione um usuário (se não houver) e clique em Gerar Novo Token.\n4. Selecione o Aplicativo que você criou.\n5. Marque as permissões (whatsapp_business_management, business_management) e gere o token.\n6. Copie este token (ele é o Token Permanente do Sistema).\n\n*\n\n### Parte 2: Configuração no Z-PRO (Superadmin)\n\nAgora que você tem os dados da Meta, vamos configurar no seu sistema.\n\n1. Acesse o painel Superadmin do Z-PRO.\n2. No menu lateral, localize a opção Apps WABA (ou Configurações do Facebook).\n3. Clique em Adicionar e preencha os campos com os dados obtidos na Parte 1:\n App ID: (Copiado da Configuração Básica).\n App Secret: (Copiado da Configuração Básica).\n Token: (Gerado no Business Manager - Usuário do Sistema).\n Config ID: (Gerado no Cadastro Incorporado do WhatsApp).\n Versão da API: Utilize a versão atual (ex: v21.0 ou a mais recente disponível no seu app Meta).\n4. Salve a configuração.\n\n**\n\n### Parte 3: Como o Cliente Utiliza (Tenant)\n\nCom tudo configurado, o processo para o seu cliente é extremamente simples:\n\n1. O cliente acessa o painel da empresa dele (Admin).\n2. Vai em Configurações > Integrações.\n3. Na sessão do Facebook/Meta, ele verá o botão "Login com Facebook" (ou "Continuar com Facebook").\n4. Ao clicar, abrirá um popup da Meta pedindo autorização.\n5. Após autorizar, o sistema listará as contas de WhatsApp Business vinculadas ao usuário.\n6. O cliente seleciona a conta e o número desejado.\n7. O sistema cria o canal WABA automaticamente, pronto para uso.\n\n{% hint style="warning" %}\nNota sobre Permissões: Se o cliente encontrar erros ao logar, verifique se o seu Aplicativo na Meta está no modo "Ao Vivo" (Live) e se o "Acesso à Empresa" foi concluído. Apps em modo de "Desenvolvimento" só funcionam para administradores do próprio app.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/facebook-login-incorporado-waba-insta-messenger.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Provedores de IA (Globais)\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nO módulo de Provedores de IA permite que o Superadministrador centralize e gerencie as integrações com serviços de Inteligência Artificial que serão utilizados em toda a plataforma. Essas configurações são essenciais para habilitar recursos avançados como a transcrição de áudio em tempo real e o processamento de linguagem para chatbots.\n\nO principal objetivo desta funcionalidade é garantir a segurança e a praticidade: ela evita que você exponha dados sensíveis (como URLs de Host e Tokens) no painel de cada cliente. Você configura a integração uma única vez no Superadmin e apenas libera o uso para as empresas (Tenants).\n\nAs principais funções dos provedores de IA são:\n\n Transcrição de Áudio: Conversão automática de mensagens de voz em texto;\n Chatbots Inteligentes: Integração com modelos de linguagem (LLMs) para respostas automatizadas;\n Automações: Processamento de comandos e dados via IA nos fluxos de atendimento;\n Distribuição Flexível: Possibilidade de oferecer o recurso de forma global ou apenas para clientes específicos.\n\nCaso de Uso: Um administrador pode configurar uma chave da GroqCloud como "Global". Com isso, todos os tenants (clientes) do sistema ganham automaticamente o recurso de transcrição de áudio, melhorando a produtividade dos atendentes que não precisam ouvir áudios longos.\n\n*\n\n#### 1. Acessando a Página de Provedores\n\nNo menu lateral do painel Superadmin, localize a sessão de integrações e selecione a aba "Provedores de IA". A tela exibe a listagem de todos os serviços configurados, indicando o status de atividade e a abrangência (Global ou por Tenant).\n\n\n\n#### Formas de Conexão\n\nO sistema permite que a conexão de canais (como Uazapi, Z-API ou Evolution) seja feita de duas formas distintas:\n\n1. Com Provedor Global: Você (Superadmin) cadastra o Host e o Token único do serviço de API uma única vez nesta tela. Quando o cliente (Tenant) for adicionar um número no painel dele, ele apenas selecionará o provedor configurado, dará um nome ao canal e lerá o QR Code. O cliente não precisa preencher configurações avançadas nem tem acesso ao seu Token.\n2. Sem Provedor Global (Configuração Individual): Caso não utilize um provedor global, o Administrador de cada empresa (Tenant) precisará inserir manualmente a URL do Host e o Token correspondente na tela de criação de canais, para só então realizar a leitura do QR Code.\n\n\n\n*\n\n#### 2. Cadastrando um Novo Provedor\n\n\n\nPara adicionar uma nova integração de IA:\n\n1. Clique no botão "+ Novo Provedor" no canto superior direito.\n2. Preencha os campos obrigatórios:\n\n Nome: Identificação interna do provedor (ex: "Servidor Uazapi Principal").\n Tipo de Provider: Selecione o canal ou serviço correspondente (ex: Z-API, Uazapi, WABA, GroqCloud, etc.).\n\n\n\n Host: A URL base ou endereço do servidor da API externa.\n Token: A chave de segurança fornecida pelo serviço externo.\n Ativo: Define se o provedor está ligado ou desligado.\n Disponível para todos os tenants: \n\n Ativado: Todos os clientes cadastrados na sua plataforma poderão utilizar esta conexão.\n Desativado: A configuração será restrita e você precisará definir manualmente quais tenants terão acesso (veja a seção de Gerenciamento abaixo).\n\n 3 Clique em "Salvar".\n\n*\n\n#### 3. Configuração Específica: GroqCloud (Transcrição)\n\nO GroqCloud possui um formulário específico para lidar com modelos de linguagem e transcrição de áudios (ex: Whisper). Ao selecionar "GroqCloud" no campo Tipo de Provider, a tela exibirá os seguintes campos:\n\n* GroqCloud Habilitado: Chave principal para ligar ou desligar a integração.\n* API Key do GroqCloud: Insira a chave gerada no painel de desenvolvedor da Groq.\n* Idioma do GroqCloud: Defina o idioma padrão para as transcrições (ex: pt, en, es).\n* Modelo do GroqCloud: Especifique o modelo que realizará o processamento (ex: whisper-large-v3, whisper-large-v2).\n\nAs opções de "Ativo" e "Disponível para todos os tenants" seguem o mesmo comportamento dos provedores de comunicação.\n\n\n\n*\n\n#### 4. Gestão e Ações (Menu ⋮)\n\nAo final de cada linha na listagem de provedores, o menu de três pontos (⋮) oferece as seguintes opções de gerenciamento:\n\n Editar: Permite alterar o nome, a URL do host ou atualizar o Token/API Key do provedor;\n Gerenciar Tenants: Esta opção fica disponível quando o provedor não é global. Ela permite que o administrador selecione manualmente quais tenants específicos terão permissão para utilizar aquele provedor de IA;\n Excluir: Remove permanentemente o provedor do sistema. Atenção: Caso o provedor esteja em uso em chatbots ou automações, essas funções deixarão de operar imediatamente após a exclusão.\n\n**\n\n#### Importante: Múltiplos Provedores\n\nO sistema permite cadastrar múltiplos provedores do mesmo tipo. Isso possibilita, por exemplo, ter uma chave da GroqCloud para uso global e outras chaves específicas para tenants que possuem alto volume de tráfego e desejam arcar com seus próprios custos de API.\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/provedores-de-ia-globais.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Sessões dos Tenants (Canais superadmin)\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA página de Sessões dos Tenants é o centro de monitoramento técnico do Superadministrador. Ela oferece uma visão macro e em tempo real de todas as conexões (instâncias) ativas na plataforma, independentemente do tenant ao qual pertencem. Através desta tela, é possível auditar a saúde das conexões de WhatsApp, Telegram, Webchat e outros canais.\n\n\n\nAs principais funções da supervisão de canais são:\n\n Monitoramento de Uptime: Identificação imediata de quantas sessões estão online ou offline em toda a infraestrutura;\n Diagnóstico de Falhas: Verificação de erros de conexão (ex: QR Code pendente ou desconexão) sem precisar acessar o painel individual do cliente;\n Gestão de Recursos: Exclusão de sessões inativas ou desnecessárias para otimização do servidor;\n Organização por Provedor: Agrupamento de sessões por tecnologia (Baileys, WABA, Evolution, etc.) para análise de estabilidade por tipo de canal.\n\nCaso de Uso: Se um Superadministrador percebe uma instabilidade em uma tecnologia específica (ex: Evolution), ele pode utilizar o agrupamento por provedor nesta página para verificar se todas as sessões daquele tipo caíram simultaneamente, facilitando a identificação de problemas globais de API ou servidor.\n\n\n\n#### 1. Indicadores de Status (Dashboard)\n\n\n\nNo topo da página, quatro cards fornecem um resumo quantitativo da operação:\n\n Total de Sessões: Soma de todas as conexões criadas no sistema;\n* Conectadas: Sessões que estão online e operacionais (Status: CONNECTED);\n* Desconectadas: Sessões que perderam o vínculo ou foram desconectadas manualmente (Status: DISCONNECTED);\n* Outros Status: Sessões em estados intermediários, como aguardando leitura de QR Code ou em processo de inicialização.\n\n*\n\n#### 2. Visualização e Agrupamento\n\nDada a grande volumetria de dados, o sistema oferece três modos de exibição através do botão de Agrupamento:\n\n1. Sem Agrupamento: Exibe uma lista linear de todas as sessões por ordem de criação;\n2. Por Tenant: Agrupa as conexões dentro de blocos correspondentes a cada empresa cliente. Ideal para verificar a saúde de um cliente específico;\n3. Por Provedor: Organiza as sessões pelo tipo de tecnologia (ex: Baileys, Meow, Telegram, Webchat). Útil para auditorias técnicas de infraestrutura.\n4.\n\n\n \n\n\n\n\n#### 3. Entendendo a Tabela de Sessões\n\nA listagem detalha as seguintes informações técnicas:\n\n ID: Identificador numérico da sessão;\n* Nome: Nome atribuído à conexão pelo usuário;\n* Tipo: A tecnologia/provedor utilizada (Waba, Baileys, Zapi, Telegram, etc.);\n* Número: O identificador do canal (número de telefone ou ID da conta);\n* Tenant: O ID da empresa proprietária daquela sessão (ex: Tenant 1 é a conta mestre);\n* Status: Estado atual da conexão (ex: CONNECTED, DISCONNECTED, qrcode);\n* Padrão: Indica se aquela é a conexão principal definida para o tenant;\n* Proxy: Exibe se a sessão está utilizando um túnel de IP específico para a conexão.\n\n*\n\n#### 4. Ações Administrativas\n\n Atualizar: O botão "Atualizar" no canto superior direito recarrega o status de todas as sessões, garantindo que o administrador veja a situação exata do momento.\n Excluir Sessão: Ao clicar no menu de três pontos (⋮) ao final de cada linha, o administrador pode excluir a sessão permanentemente.\n Importante: Esta ação é definitiva e removerá a instância do banco de dados, sendo necessário que o tenant configure o canal novamente caso deseje restabelecê-lo.\n\n**\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/sessoes-dos-tenants-canais-superadmin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tenant API (superadmin)\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA Tenant API é uma interface que permite ao Superadministrador gerenciar a criação e a manutenção de instâncias (tenants) de forma programática, sem a necessidade de intervenção manual no painel. Através desta API, sistemas externos podem se comunicar com o Z-PRO para automatizar o ciclo de vida dos clientes.\n\n\n\nAs principais funções da Tenant API são:\n\n Provisionamento Automático: Criação de novos tenants e usuários administradores;\n Gestão de Sessões: Geração de chaves de acesso para instâncias específicas;\n Sincronização de Dados: Atualização e listagem de tenants para auditoria externa;\n Integração com Billing: Ativação ou suspensão de clientes via sistemas de cobrança terceiros.\n\nCaso de Uso: Uma empresa que utiliza um CRM ou uma plataforma de vendas (como Hotmart, Kiwify ou site próprio) pode configurar um Webhook para que, assim que um novo pagamento for aprovado, o sistema chame a Tenant API do Z-PRO. Isso garante que o cliente receba seus dados de acesso instantaneamente, sem que o Superadministrador precise criar a conta manualmente.\n\n*\n\n#### 1. Gerenciando Tokens de API\n\nPara utilizar os endpoints, é necessário gerar um token de autenticação seguro.\n\n1. No menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e acesse a aba "Tenant API".\n\n\n\n1. Clique no botão "+ Nova API" no canto superior direito.\n2. Na janela pop-up, clique no ícone de "Sincronizar/Gerar" (setas circulares) para que o sistema crie um token aleatório e seguro.\n\n\n\n3. Clique em "Salvar".\n\nAviso de Segurança: O token gerado é a chave de acesso à infraestrutura do seu sistema. Copie e armazene-o em um local seguro. Ele será exibido de forma ofuscada na listagem por motivos de segurança.\n\n*\n\n#### 2. Sandbox e Testes de Endpoints\n\nO sistema oferece um ambiente de Sandbox integrado para que o administrador realize testes de requisição diretamente na interface antes de implementar o código em produção.\n\n Seleção de Token: No campo "Sandbox", selecione o token que você acabou de criar.\n Base URL: O sistema exibirá a URL base da sua instalação para as chamadas de API (ex: https://api.seusistema.com.br).\n Autenticação: Todas as chamadas devem conter o header Authorization: Bearer {apiToken}.\n\n\n\n**\n\n#### 3. Rotas Disponíveis (Endpoints)\n\nA API disponibiliza 5 endpoints principais para a gestão de tenants:\n\n\[POST] /tenantApiStoreTenant\n\nUtilizado para criar um novo tenant e, simultaneamente, o seu usuário administrador inicial.\n\n Campos obrigatórios no Body (JSON): Nome da empresa, e-mail do admin, senha, CPF/CNPJ (identity) e perfil.\n Configurações de limites: Permite definir via API o maxUsers (limite de usuários) e maxConnections (limite de conexões de WhatsApp) que o cliente terá.\n\n\[POST] /tenantApiUpdateTenant\n\nPermite atualizar os dados de um tenant existente, como alterar o status para inactive em caso de inadimplência ou aumentar seus limites de uso.\n\n\[POST] /tenantApiShowTenant\n\nRetorna os detalhes técnicos de um tenant específico através de sua identificação.\n\n\[POST] /tenantApiCreateSession\n\nGera uma sessão de acesso para o tenant, permitindo integrações de login único ou comandos diretos na instância.\n\n\[GET] /tenantApiListTenants\n\nLista todos os tenants cadastrados no sistema, facilitando a conferência de dados e status de toda a base.\n\n\n\n*\n\n#### 4. Implementação Técnica\n\nAo expandir qualquer uma das rotas na interface, o Z-PRO exibe o exemplo exato do Body (JSON)* necessário para a requisição. Certifique-se de que o sistema externo envie os dados exatamente conforme o modelo proposto para evitar erros de validação.\n\n#### Tópicos Relacionados\n\n Gerenciamento de Tenants\n* Configuração de Planos e Trial\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/tenant-api-superadmin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Configurações\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Customizar (White Label)\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nO módulo de customização permite que o Superadministrador aplique a identidade visual de sua própria marca em toda a interface do sistema Z-PRO. Através do modelo White Label, é possível transformar a plataforma em um produto proprietário, garantindo que os tenants (clientes) visualizem apenas os logotipos, cores e nomes definidos pelo administrador.\n\nAs principais funções da customização são:\n\n Identidade Visual: Padronização de cores e logos em todos os níveis de acesso;\n Branding Móvel: Configuração de ícones para instalação via PWA (Progressive Web App);\n Experiência de Usuário: Definição de estilos de tela de login e alertas sonoros personalizados;\n Gestão Educacional: Inclusão de tutoriais em vídeo para autoatendimento dos clientes;\n Administração Avançada: Ferramentas de acesso emergencial (Masterkey) e encerramento de sessões (Force Logout).\n\n{% hint style="info" %}\nImportante: As configurações realizadas neste módulo possuem caráter global. Isso significa que todas as alterações de cores, branding, estilos de login e tutoriais serão aplicadas automaticamente a todos os tenants (clientes) cadastrados na plataforma, garantindo a padronização da sua marca em toda a infraestrutura do sistema.\n{% endhint %}\n\n**\n\n#### 1. Acessando o Painel de Customização\n\nPara iniciar as alterações, acesse o menu lateral do painel Superadmin e selecione a opção "Customizar". O painel é dividido em abas que organizam cada aspecto da personalização.\n\n\n\n\n\n#### 2. Aba Cores\n\nNesta aba, define-se a paleta cromática que será aplicada em botões, menus e fundos do sistema.\n\n Paletas Pré-definidas: Opções de combinações de cores testadas (ex: Azul Padrão, Oceano, Floresta) para aplicação rápida.\n* Cores do Sistema (Manual): Permite inserir códigos hexadecimais para cores específicas:\n * Primária: Cor principal de botões e links;\n * Secundária: Cor de menus e elementos de apoio;\n * Destaque: Cor para notificações e itens ativos;\n * Status (Aviso, Positiva, Negativa): Cores para alertas, sucessos e erros;\n * Neutra e Clara: Cores de fundos e textos.\n* Ação: Clique em "Salvar" para aplicar ou "Resetar" para voltar ao padrão original.\n\n\n\n*\n\n#### 3. Aba Sons\n\nConfiguração dos alertas sonoros emitidos pelo sistema para diferentes tipos de interações.\n\n Chat / Atendimento: Som ao receber novos tickets ou mensagens de clientes;\n Chat Interno: Som para mensagens entre colaboradores da empresa;\n Chat Suporte: Som para mensagens diretas no canal de suporte.\n Formatos aceitos: MP3, OGG e WAV.\n Importante: Utilize arquivos leves (recomendado até 500 KB) para não impactar o carregamento das páginas.\n\n\n\n**\n\n#### 4. Aba Branding\n\nDefine a identidade da marca e a presença do aplicativo em navegadores e dispositivos móveis.\n\n Nome do Aplicativo: Nome exibido na aba do navegador e em notificações de sistema;\n Logotipo (Claro/Escuro): Versões da marca para exibição nos respectivos temas visuais do sistema;\n Favicon: Pequeno ícone exibido ao lado do título na aba do navegador;\n Ícone PWA: Imagem quadrada (mínimo 512x512 px) usada ao instalar o app no celular ou desktop. O sistema gera automaticamente os tamanhos necessários para Android e iOS.\n\n\n\n\n\n#### 5. Aba Login\n\nPersonalização visual da porta de entrada do sistema para todos os usuários.\n\n Estilo de Tela: Seleção entre 8 variantes visuais (ex: Minimalista, Corporativo, Bold Hero, Glassmorphism).\n* Mídia Lateral: Possibilidade de inserir uma imagem ou vídeo (JPG, PNG, MP4) que ocupará a lateral da tela de login nos estilos Split Screen ou Bold Hero.\n* Texto sobre a mídia: Chave para habilitar a exibição do logotipo e descrição sobre o vídeo ou imagem lateral.\n\n\n\n*\n\n#### 6. Abas de Ferramentas Administrativas\n\nConfigurações técnicas e de segurança para o Superadministrador.\n\n Force Logout: Permite selecionar um tenant específico e desconectar obrigatoriamente todos os seus usuários ativos. Útil após atualizações ou mudanças de política.\n\n\n\n Masterkey: Ferramenta de acesso administrativo. Ao habilitar e gerar uma chave, o administrador pode acessar o painel de qualquer usuário utilizando o e-mail do usuário e a Masterkey no campo de senha.\n\n\n\n Criptografia: Geração da chave mestra para proteção de dados sensíveis no banco de dados.\n\n\n\n Socket (Otimização): O Modo Otimizado deve ser ativado em instalações com alta carga (mais de 25 usuários simultâneos). Ele reduz a carga de consultas ao servidor através de técnicas de cache e debounce.\n\n\n\n\n\n#### 7. Aba Tutoriais\n\nPermite ao administrador criar uma biblioteca de vídeos para instruir os tenants sobre o uso da plataforma.\n\n Cadastrando um Tutorial: Clique em "Novo Tutorial", insira um título, descrição e o link do vídeo (YouTube/Vimeo).\n* Thumbnail: Selecione uma imagem de capa para o vídeo.\n* Hierarquia: Defina a ordem numérica em que os vídeos aparecerão para o cliente.\n* Visualização: Uma vez ativos, os vídeos aparecem na aba "Tutoriais" do painel do usuário final, servindo como uma base de conhecimento White Label.\n\n\n\n\n\n*\n\n#### Importante: Cache de Arquivos\n\nArquivos de branding e sons são servidos diretamente do servidor sem cache. Isso garante que as alterações entrem em vigor imediatamente após o salvamento, sem a necessidade de o usuário limpar o navegador.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/customizar-white-label.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
E-mail - SMTP do Tenant\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\n### Introdução\n\nA configuração do SMTP é um passo técnico essencial para permitir que sua plataforma Z-PRO envie e-mails transacionais automaticamente em seu nome.\n\nO principal uso desta funcionalidade é para o envio de e-mails de redefinição de senha para todos os usuários do sistema (sejam eles Admins ou Atendentes). Sem esta configuração, a recuperação de senhas não funcionará.\n\n### Como acessar \n\nPara acessá-lo, clique no ícone de Configurações - Email no menu lateral do seu painel.\n\n\n\nNessa seção você tem a opção das permissões para ativar a recuperação de senhas na tela de login:\n\n\n\nTipo de PermissãoDescriçãoHabilitar SMTPQuando ativo o sistema enviará informaçãos para o e-mail do usuário. Nesse caso, é necessário informar o servidor do e-mail, porta SMTP, usuário do e-mail e senha do e-mail.Host SMTPServidor de email do seu hostPorta SMTPPorta de acesso ao servidor SMTPUsuárioConta de e-mailSenhaSenha do e-mailProtocolo de Segurança (TLS/SSL)Ativar protocolo seguro.\n\n### Artigo: Como recuperar a senha SMTP\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/e-mail-smtp-do-tenant.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como recuperar a senha SMTP\n\n#### 🔐 Para Contas Google (Gmail, Google Workspace) \n\n1. Acesse sua Conta Google: Vá para myaccount.google.com\n2. Vá para Segurança: No menu à esquerda, clique em Segurança.\n3. Verifique a 2FA: Confirme se a "Verificação em duas etapas" está Ativada. Se não estiver, ative-a primeiro.\n4. Encontre Senhas de App: Na seção "Como fazer login no Google", clique em Senhas de app. (Você talvez precise fazer login novamente).\n5. Selecione o App e o Dispositivo:\n No menu suspenso "Selecionar app", escolha o tipo de aplicativo (ex: "E-mail", "Contatos" ou "Outro (Nome personalizado)").\n Em "Selecionar dispositivo", escolha o dispositivo (ex: "Computador Windows", "iPhone", etc.).\n6. Gerar: Clique em Gerar.\n7. Use a Senha: O Google mostrará a senha de 16 dígitos em uma caixa amarela.\n\n> Como usar: Copie essa senha (sem os espaços) e cole-a no campo de senha do aplicativo que você está tentando configurar (ex: no Outlook, quando ele pede a senha do seu Gmail).\n\n#### 🔐 Para Contas Microsoft (Hotmail, Outlook.com, Live)\n\n1. Acesse sua Conta Microsoft: Vá para account.microsoft.com\n2. Vá para Segurança: No menu superior, clique em Segurança e depois em Opções de segurança avançadas.\n3. Verifique a 2FA: Confirme se a "Verificação em duas etapas" está ativada.\n4. Encontre Senhas de Aplicativo: Role a página para baixo até a seção Senhas de aplicativo.\n5. Gerar: Clique em Criar uma nova senha de aplicativo.\n6. Use a Senha: A Microsoft exibirá a senha de 16 dígitos.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/e-mail-smtp-do-tenant/como-recuperar-a-senha-smtp.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Notificações internas\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nO módulo de Notificações Internas funciona como uma central de comunicados e alertas emitida pelo Superadministrador para os usuários da plataforma. Ele permite não apenas o envio de avisos, mas também o monitoramento em tempo real de quem recebeu e se a mensagem já foi visualizada.\n\n*\n\n#### 1. Acessando a Página de Notificações\n\nNo menu lateral do painel Superadmin, localize a sessão de configurações e selecione a aba "Notificação".\n\n\n\n*\n\n#### 2. Entendendo a Listagem de Notificações\n\nA tela principal exibe o histórico detalhado de todas as notificações disparadas. Cada linha representa o recebimento da mensagem por um usuário específico:\n\n ID: Identificador único da notificação no banco de dados;\n Mensagem: O conteúdo do texto enviado;\n Usuário: O nome do colaborador ou administrador que recebeu o aviso;\n Lida: Status de visualização. Exibe "Não" (em laranja) se o usuário ainda não abriu a notificação, e "Sim" após a leitura;\n Data: Carimbo de data e hora exata em que a notificação foi gerada.\n\n\n\n**\n\n#### 3. Criando uma Nova Notificação\n\nPara emitir um novo comunicado:\n\n1. Clique no botão "+ Adicionar" no canto superior direito.\n2. Na janela pop-up, preencha o campo "Mensagem" com o conteúdo desejado.\n3. Clique em "Salvar".\n\nComportamento: O sistema processará o envio e a mensagem aparecerá instantaneamente (ou no próximo login) para os usuários. Na listagem do Superadmin, novas entradas serão criadas para cada usuário destinatário com o status "Lida: Não".\n\n\n\n\n\n#### 4. Ações e Gestão de Histórico\n\nO administrador possui controle total sobre as mensagens enviadas através dos seguintes comandos:\n\n Editar (Ícone Lápis): Permite corrigir o texto de uma notificação já enviada;\n* Excluir (Ícone Lixeira): Remove o registro de notificação de um usuário específico;\n* Atualizar: Recarrega a tabela para verificar mudanças no status de leitura ("Lida");\n* Excluir Todas:** Botão vermelho que limpa todo o histórico de notificações do sistema para todos os usuários.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/configuracoes/notificacoes-internas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Sistema\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Backup\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA página de Backup no painel SuperAdmin do Z-PRO é a ferramenta central para a gestão de segurança de dados. Ela permite que o administrador realize cópias de segurança manuais, configure rotinas automáticas e gerencie o armazenamento para garantir a integridade das informações de todos os tenants (empresas).\n\n\n\n### 1. Visão Geral do Armazenamento\n\nNo topo da página, o sistema apresenta indicadores em tempo real sobre o estado geral dos backups:\n\n Total de backups: Quantidade total de arquivos de segurança armazenados;\n Tamanho total: Espaço em disco ocupado por todos os backups no servidor;\n Último backup: Data e hora da última rotina de segurança executada com sucesso.\n\n**\n\n### 2. Criando Backups\n\nO sistema permite a geração de cópias de segurança de duas formas:\n\n#### Backup Geral\n\nAo clicar no botão "Backup Geral" (localizado no canto superior direito), o sistema iniciará um processo de cópia de toda a estrutura do banco de dados e arquivos globais.\n\n#### Backup por Empresa\n\nPara realizar a cópia de segurança de um cliente específico:\n\n1. No campo "Backup por Empresa", selecione o tenant desejado na lista suspensa;\n2. Clique no botão "Fazer backup".\n\n> O backup inclui integralmente o banco de dados e os arquivos (anexos e mídias) pertencentes ao tenant selecionado.\n\n\n\n### 3. Configuração de Backup por Empresa\n\nEsta seção é utilizada para definir parâmetros específicos de automação:\n\n Selecionar Empresa: Escolha o tenant para aplicar ou editar uma regra;\n Nova configuração: Define a frequência da rotina automática (diária, semanal, etc);\n Recriar padrão: Restaura as configurações de backup para os parâmetros originais do sistema.\n\n*\n\n### 4. Gerenciando Backups Existentes\n\nNa listagem de Configuração de todas as empresas, o administrador pode monitorar o status de cada tenant.\n\n Detalhes: Clique para visualizar informações completas de um arquivo específico;\n Restauração: Ao clicar em "Restaurar", o sistema aplicará o arquivo de backup ao tenant correspondente.\n Atenção: A restauração sobrescreve os dados atuais. Recomenda-se realizar um backup manual antes de iniciar qualquer processo de restauração.\n\n**\n\n### 5. Manutenção e Limpeza\n\nPara garantir a performance do servidor e evitar o preenchimento total do disco, utilize a seção Limpar backups antigos:\n\n Por Empresa: Selecione um tenant e clique em "Limpar backups desta empresa" para remover arquivos históricos específicos;\n Global: O botão "Limpar backups de todas as empresas" remove todos os arquivos de segurança armazenados no servidor.\n\n> Importante: A limpeza de backups é uma ação irreversível. Certifique-se de que não há necessidade de restaurar dados antigos antes de prosseguir com a exclusão.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/backup.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Dados Internos\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA seção de Informações do Sistema permite ao SuperAdmin visualizar dados técnicos estruturais e variáveis de ambiente que compõem a instância atual do Z-PRO. Esta página é fundamental para diagnósticos técnicos, verificação de versões e suporte especializado.\n\nAs informações são extraídas diretamente dos arquivos de configuração do servidor e do arquivo package.json da aplicação.\n\n\n\n### 1. Visualizando Dados Técnicos\n\nPara acessar estas informações, navegue até o menu de administração e selecione a opção SISTEMA - Dados Internos.\n\n\n\nAs principais funcionalidades desta tela são:\n\n Cópia Rápida: Ao lado de cada valor, existe um ícone de cópia para facilitar o envio de informações ao suporte técnico;\n Atualização: O botão "Atualizar" no canto superior direito permite recarregar as variáveis sem a necessidade de atualizar a página inteira do navegador.\n\n### 2. Variáveis de Ambiente\n\nNeste bloco, são listadas as variáveis globais que definem o comportamento do ecossistema Z-PRO:\n\n FRONTEND\_URL: Indica o endereço de URL da interface do usuário;\n NODE\_ENV: Define o ambiente de execução do sistema (ex: production, development);\n BACKEND\_URL: Indica o endereço de URL da API e processamento de dados.\n\n### 3. Dados do Package.json\n\nEste bloco detalha informações específicas do código-fonte e metadados da aplicação:\n\n name: Nome técnico do pacote da aplicação (ex: zprobackend);\n version: Versão atual do sistema instalada. É essencial verificar este campo para garantir que o sistema esteja atualizado;\n description: Descrição breve da finalidade do módulo consultado.\n\n{% hint style="info" %}\nDiagnóstico: Utilize os dados desta página sempre que precisar relatar uma instabilidade ou comportamento inesperado ao suporte técnico\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/dados-internos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Log de Auditoria\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA página de Log de Auditoria é a ferramenta de rastreabilidade do Z-PRO, projetada para monitorar todas as ações realizadas no sistema. Ela permite que o SuperAdmin identifique quem realizou uma alteração, em qual momento, a partir de qual endereço IP e qual dado específico foi modificado.\n\n\n\n\n\n### 1. Filtrando Registros\n\nPara localizar eventos específicos em meio ao histórico do sistema, utilize os filtros superiores:\n\n Tenant: Filtre as ações por uma empresa específica ou visualize "Todos os tenants";\n Ação: Selecione o tipo de operação realizada no sistema. As opções disponíveis no menu suspenso incluem:\n Criar: Registros de novas inserções de dados;\n Atualizar: Modificações em dados já existentes;\n Deletar: Remoção de registros do sistema;\n Login / Logout: Monitoramento de acessos e saídas de usuários;\n Testar: Ações de teste de conexões ou recursos;\n Migrar: Registros de migrações de dados ou versões;\n Reparar: Ações de correção ou manutenção de recursos.\n Entidade: Busque por um recurso específico do sistema, como tickets, users ou messages;\n Usuário: Filtre as ações executadas por um colaborador ou administrador específico;\n Data Inicial e Data Final: Defina um intervalo de tempo para restringir a busca.\n\nApós configurar os campos desejados, clique no botão "Filtrar" para atualizar a listagem.\n\n\n\n### 2. Interpretando a Listagem de Logs\n\nA tabela de resultados apresenta as seguintes colunas para análise rápida:\n\n Data/Hora: O momento exato da execução da tarefa;\n Usuário: Nome e e-mail de quem realizou a ação;\n Ação e Entidade: O tipo de modificação e o ID do recurso afetado (ex: tickets #5934);\n Método e Caminho: Informações técnicas da API (POST, PUT, DELETE) e a rota acessada;\n Status: Código de resposta do servidor (ex: 200 ou 201 para sucesso);\n IP: O endereço de rede de onde partiu a requisição, útil para identificar acessos suspeitos.\n\n\n\n### 3. Detalhes do Log\n\nAo clicar no ícone de olho (visualizar) na última coluna de um registro, uma janela modal será aberta com os Detalhes do Log.\n\n\n\nEsta visão contém:\n\n User-Agent: Identificação do navegador e sistema operacional utilizado pelo usuário;\n Corpo da Requisição: Exibe o arquivo JSON com os dados exatos que foram enviados ao servidor para realizar aquela ação específica.\n\n**\n\n### 4. Exportação e Boas Práticas\n\nPara manter a conformidade e segurança do ambiente, recomenda-se:\n\n Arquivamento Externo: Utilize o botão "Exportar CSV" (conforme disponível na interface) para baixar o histórico filtrado e armazená-lo em local seguro;\n\n\n\n Auditoria Regular: Verifique periodicamente os logs de entidades sensíveis e ações de exclusão (DELETE);\n Investigação: Em caso de erros reportados por usuários, utilize o campo "Entidade" para rastrear as últimas modificações naquele recurso específico.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/log-de-auditoria.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Migração de Tenants\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA página de Migração de Dados permite a transferência de informações de uma instância externa (remota) para o servidor atual. O processo é registrado em tempo real, permitindo o acompanhamento do progresso e de eventuais interrupções.\n\n> Aviso: A migração importa dados do sistema de origem. Verifique se as configurações estão corretas antes de iniciar o procedimento.\n\n\n\n\n\n### 1. Acessando a Página de Migração\n\nPara acessar as configurações de migração, utilize o menu lateral do painel SuperAdmin:\n\n1. Clique no menu Sistema;\n2. Selecione a aba Migração de Dados.\n\n\n\n\n\n### 2. Monitoramento de Status\n\nO topo da página apresenta três indicadores sobre o estado das operações:\n\n Concluídas: Quantidade de migrações finalizadas com sucesso;\n* Em Andamento: Migrações que estão sendo processadas no momento;\n* Falhou: Registro de migrações que apresentaram erro crítico.\n\nResumo quantitativo das migrações realizadas.\n\n*\n\n### 3. Configuração da Conexão Remota\n\nPara que o sistema acesse os dados de origem, é necessário configurar o caminho de comunicação:\n\n#### Configuração SSH\n\nCaso o banco de dados remoto esteja em um servidor diferente, preencha os campos da seção Configuração SSH:\n\n Host SSH: Endereço IP do servidor de origem;\n Porta SSH: Porta de conexão (padrão 22);\n Usuário SSH e Senha SSH: Credenciais de acesso ao servidor;\n Caminho da chave SSH: Localização dos arquivos de chave privada para autenticação.\n\n#### Banco de Dados Remoto\n\nInforme os dados da instância de origem dos dados:\n\n Host e Porta: Endereço do banco e porta (ex: 5432 para Postgres);\n Nome do banco e Usuário: Identificação da base de dados e usuário com permissão de leitura;\n Senha: Senha de acesso ao banco de dados remoto;\n Dialeto: Tipo de banco de dados utilizado (ex: postgres);\n ID do tenant na instância remota: Identificador numérico do cliente a ser migrado.\n\n**\n\n### 4. Execução da Migração\n\n1. Após preencher os campos, clique em "Salvar Config" para registrar os parâmetros localmente;\n2. Clique no botão "Iniciar Migração" no canto superior direito;\n3. Acompanhe a evolução na tabela Migrações.\n\n#### Comandos da Listagem:\n\n Progresso: Barra indicando a porcentagem de conclusão e a etapa atual (ex: TenantApi);\n Logs Disponíveis: Contador de registros processados (ex: 10409 / 10412);\n Ações: \ Clique no ícone de Play (Retomar) caso uma migração apresente o status "Pausada";\n Clique no ícone de olho para abrir os Detalhes da Migração.\n\n**\n\n### 5. Detalhes da Migração\n\nAo abrir os detalhes de uma migração, o sistema exibe o status específico de cada módulo migrado e os logs técnicos da operação.\n\n\n\n#### Módulos Migrados (Seção Concluída)\n\nNesta área, o sistema lista todas as entidades que foram processadas, incluindo:\n\n Configurações e Usuários: Setting, User, Login;\n Comunicação: WhatsApp, Message, ChatFlow, AutoReply;\n Organização: Kanban, Pipeline, Tag, Ticket, Contact;\n Financeiro e Licença: Plans, License, LicenseActivationLog.\n\n#### Logs de Erro\n\nCaso ocorram inconsistências, utilize os botões para download de logs específicos:\n\n fk\_violations: Violações de chaves estrangeiras;\n import\_errors: Erros na inserção dos dados na nova instância;\n download\_errors: Falhas no download de mídias da instância remota.\n\n**\n\n### 6. Verificação de Problemas\n\nCaso a migração não seja concluída, verifique os seguintes itens:\n\n Conexão com Banco: Valide se o host, porta e credenciais de usuário/senha estão corretos;\n Configuração de SSH: Em caso de erro de SSH, confirme o host e a chave privada do servidor;\n Status Pausado: Em caso de oscilação na rede, utilize o botão "Retomar" após a estabilização do ambiente.\n\n**\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/migracao-de-tenants.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Monitor\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA tela de Monitoramento é um painel de diagnóstico que exibe informações em tempo real sobre o consumo de recursos do seu servidor, como o uso de CPU e memória.\n\nUtilize esta ferramenta para verificar a "saúde" da sua instalação, identificar possíveis gargalos de performance ou para auxiliar no diagnóstico de problemas de lentidão.\n\n### Como visualizar\n\nNo Menu SISTEMA você poderá acessar o terminal da sua VPS clicando em Monitor:\n\n\n\nVocê verá a seguinte tela:\n\n\n\n### Consultando métricas\n\n As métricas são atualizadas automaticamente a cada 15 segundos\n Clique em Atualizar para forçar a recarga imediata dos dados\n Verifique CPU e memória quando perceber lentidão no sistema\n\n### Interpretando os dados\n\n PU acima de 80% por longos períodos indica necessidade de otimização\n* Memória próxima do limite pode causar instabilidade — considere ampliar o plano\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/monitor.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tenants
Terminal\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nNessa seção você poderá acessar o terminal de comandos do backend. Execute comandos diretamente no servidor com extremo cuidado - ações são irreversíveis.\n\nEntre no Menu SISTEMA aba Terminal:\n\n\n\nVocê verá a seguinte tela:\n\n\n\n{% hint style="danger" %}\nCUIDADO: Comandos executados aqui afetam diretamente o servidor.\n{% endhint %}\n\n### Executando comandos\n\n Digite o comando no terminal e pressione Enter para executar\n Use comandos de leitura (ls, cat, ps) antes de executar operacoes destrutivas\n O terminal tem acesso root - qualquer comando pode afetar o servidor inteiro\n\n### Precauções importantes\n\n Nunca execute rm -rf ou comandos que possam apagar dados criticos\n* Faca um backup antes de qualquer operacao de manutencao critica\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/terminal.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tenants e Licença\n\nO módulo "Tenants e licença" no painel superadmin é o motor da sua revenda SaaS, focado na gestão da plataforma como um negócio ao centralizar a administração de assinaturas, controle de pagamentos, criação de planos de serviço, canais de suporte e o gerenciamento completo das contas isoladas de clientes (tenants) e seus respectivos usuários\n\nA primeira aba do painel superadmin é dividido nos seguintes blocos:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Artigo: Usando o White-Label para Vários Clientes\n\nEsta página é um guia completo para entender como o modelo White-Label do Z-PRO funciona em cenários com múltiplos clientes. O objetivo é esclarecer a relação entre sua licença, as instalações, a personalização de marca e as regras de uso da plataforma.\n\nA Dúvida Mais Comum: "Posso configurar uma marca, logo e cores diferentes para cada um dos meus clientes?"\n\nA resposta curta é: uma instalação = uma marca. Para ter marcas diferentes para clientes diferentes, você precisará de instalações separadas. Abaixo, detalhamos os dois modelos de operação possíveis.\n\n*\n\n### Entendendo os Conceitos-Chave da Sua Licença\n\nSua licença Z-PRO está atrelada a alguns conceitos fundamentais que definem como você pode estruturar seu negócio:\n\n* Uma Licença Anual: Governa o seu direito de uso do software Z-PRO.\n* Um Domínio Principal: Sua licença está associada a um domínio principal (ex: suaagencia.com). Todas as suas instalações devem operar em subdomínios deste domínio principal.\n* Múltiplas Instalações (VPS): Sua única licença permite que você instale o Z-PRO em múltiplos servidores (VPS), desde que as regras de propriedade da infraestrutura sejam seguidas.\n* Múltiplos Clientes (Tenants): O Z-PRO foi projetado para o modelo SaaS, permitindo que você crie contas de clientes (tenants) isoladas.\n* Uma Marca (White-Label) por Instalação: A personalização de marca (logo, cores, nome) é definida no nível do Super Admin e se aplica a toda aquela instalação e a todos os tenants dentro dela.\n\n*\n\n#### Cenário 1: O Modelo Centralizado (Uma Instalação, Vários Clientes, Uma Marca)\n\nEste é o modelo de operação mais comum e direto.\n\n Como Funciona: Você tem uma única instalação do Z-PRO em um único servidor (VPS). Dentro desta instalação, você cria múltiplos tenants, um para cada cliente seu.\n Personalização: Você configura o White-Label com a sua própria marca no painel Super Admin. Todos os seus clientes acessarão a plataforma através de um subdomínio seu (ex: app.suaagencia.com) e verão a sua marca. \n\nVantagens:\n\n Gestão Simplificada: Você gerencia, atualiza e mantém um único servidor.\n Custo de Infraestrutura Menor: O custo se limita a um único VPS (que pode precisar de upgrade conforme o número de clientes cresce).\n\nLimitação:\n\n Você não pode personalizar a marca para cada cliente individualmente. Todos verão a mesma marca (a sua).\n\n**\n\n#### Cenário 2: O Modelo Distribuído (Várias Instalações, Vários Clientes, Várias Marcas)\n\nEste modelo oferece a máxima flexibilidade de personalização e é a solução para quem precisa oferecer a plataforma com a marca de cada cliente.\n\n Como Funciona: Você realiza múltiplas instalações do Z-PRO, cada uma em um servidor (VPS) separado. Cada instalação será dedicada a um único cliente final.\n\n{% hint style="warning" %}\nVocê (o assinante) deve ser o proprietário ou o responsável direto pela infraestrutura (VPS) onde cada instalação está rodando\n{% endhint %}\n\n Personalização: Como cada instalação tem seu próprio painel Super Admin, você pode configurar o White-Label de cada instalação com a marca específica daquele cliente.\n\nExemplo:\n\n Instalação 1 (VPS 1): Para o Cliente A. Acessível em clientea.suaagencia.com. Marca, logo e cores do Cliente A.\n Instalação 2 (VPS 2): Para o Cliente B. Acessível em clienteb.suaagencia.com. Marca, logo e cores do Cliente B.\n\nVantagens:\n\n Personalização Total: Cada cliente tem uma experiência 100% White-Label com sua própria marca.\n Isolamento de Infraestrutura: Cada cliente opera em um ambiente completamente isolado, o que pode ser um requisito de segurança para alguns.\n\nPontos a Considerar:\n\n Custo de Infraestrutura Maior: Cada instalação requer seu próprio VPS, multiplicando os custos.\n Gestão Mais Complexa: Você será responsável por manter e atualizar múltiplas instalações.\n\n*\n\n#### A Regra de Ouro: Licenciamento e Propriedade da Infraestrutura\n\nA flexibilidade de múltiplas instalações está diretamente ligada aos nossos Termos de Uso, especificamente à cláusula de sublicenciamento.\n\n{% hint style="danger" %}\nAviso sobre Sublicenciamento e Propriedade\n\nSua licença Z-PRO pode ser usada em múltiplas instalações sem custo adicional, contanto que duas condições sejam atendidas:\n\n1. Todas as instalações operem sob subdomínios do mesmo domínio principal associado à sua licença.\n2. Você (o assinante) deve ser o proprietário ou o responsável direto pela infraestrutura (VPS) onde cada instalação está rodando.\n\nNão é permitido "revender" ou "transferir" a licença do software de forma avulsa. O que você vende é o acesso a um serviço que roda em uma infraestrutura gerenciada por você.\n{% endhint %}\n\nPara detalhes completos, consulte a seção 9 dos nossos Termos de Uso.\\n[→ Ler os Termos e Condições de Uso](/diretrizes-e-politicas/termos-e-condicoes-gerais-de-uso-e-licenciamento.md)\n\n*\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/artigo-usando-o-white-label-para-varios-clientes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Chat Suporte\n\nO chat de suporte é o canal destinado ao gerenciamento do atendimento dos usuários dos tenants, possibilitando o envio de respostas e o auxílio direto na plataforma.\n\nA definição do chat de suporte é usada para representar o local onde se pode interagir e auxiliar os usuários das empresas de forma centralizada.\n\n{% hint style="info" %}\nPara o cliente abrir o chat com o suporte é preciso habilitar essa função no cadastro/edição do Tenant\n{% endhint %}\n\nAs principais funções do chat de suporte são:\n\n Visualizar e responder mensagens de usuários;\n Filtrar contatos por empresa ou nome;\n Anexar arquivos e enviar áudios.\n\n\n\n### 1. Atendendo um Usuário\n\nPara atender um usuário é necessário acessar o painel e ir na aba Chat de Suporte.\n\nAo acessar a listagem lateral, clique em um usuário para visualizar o histórico e responder às mensagens.\n\n\n\n### 2. Recursos da Lista de Usuários\n\nAbaixo estão listados os itens presentes na lista de usuários e suas funcionalidades:\n\n Selecionar um usuário: Clique em um usuário na lista lateral para visualizar o histórico e responder às mensagens;\n Filtrar usuários: Utilize o campo de busca para filtrar os usuários por empresa ou por nome;\n Identificar chats ativos: Os usuários com chat ativo aparecem destacados na lista lateral.\n\n### 3. Enviando Mensagens\n\nNessa área é possível enviar os textos e mídias para interagir com o usuário selecionado.\n\nAbaixo estão listados os recursos presentes no envio de mensagens e suas funcionalidades:\n\n Envio de texto: Digite a mensagem no campo inferior da tela e pressione a tecla Enter para enviar;\n Envio de mídias: Utilize os botões auxiliares na tela para anexar arquivos ou enviar áudios gravados diretamente no chat.\n *Envio de link de reunião: Ao clicar no ícone, será enviado uma mensagem automática com um link para realizar uma reunião online com o contato.\n\n### Visão do chat para o Tenant\n\nO administrador do Tenant conseguirá acessar o chat com o superadmin clicando no ícone no canto superior direito\n\n\n\nAbrirá uma guia no seguinte modelo:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/chat-suporte.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gerenciar Licença Z-PRO\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\n### Link para aula completa - portal do assinante\n\nEsta documentação detalha como gerenciar a assinatura da sua licença anual da plataforma Z-PRO. Manter a licença ativa e válida é fundamental para o funcionamento contínuo do sistema e para o acesso às atualizações.\n\n### Acessando a Página de Assinatura\n\n1. No menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e entre na aba "Assinatura"\n\n\n\nA página exibirá os detalhes da sua licença atual.\n\n### Entendendo as Informações da Tela\n\nNesta tela, você encontrará os seguintes dados:\n\n#### Licença\n\n Status da Licença: O estado atual da sua licença (Ativo, Inativo, Em Validação).\n Código da Licença: A sua chave de licença atual, parcialmente ofuscada por segurança.\n Validade da Licença: A data de vencimento da sua assinatura anual.\n Domínio: Domínio utilizado na instalação (não precisa adicionar os subdomínios)\n\n#### Versão do Sistema\n\n Versão do Backend / Frontend: As versões atuais da sua instalação Z-PRO.\n Expira em: A data limite que a versão que está usando irá vencer.\n Dias restantes: Contagem regressiva de dias para a atualização de versão obrigatória.\n\n\n\n## Como Validar sua Licença\n\n### Passo 1: Adicionar seu código de licença\n\nEste procedimento é necessário logo após a primeira instalação do Z-PRO.\n\n1. Na página de Assinatura, clique no botão "Alterar licença".\n\n\n\n2. Uma nova janela será aberta. No campo "Atualizar licença", cole a chave de licença que você recebeu por e-mail assim que finalizou a compra.\n\n\n\n3. Clique em "Salvar".\n\nAviso: Após salvar, o status da licença pode levar alguns minutos para ser atualizado. Aguarde um tempo até que o sistema processe a validação e o status mude para "Ativo".\n\n\n\n{% hint style="info" %}\nSe não recebeu sua licença por e-mail, abra um chamado de Suporte administrativo em https://suporte.zdg.com.br/\n{% endhint %}\n\n### Passo 2: Adicionar domínio\n\nEste procedimento é necessário logo após a primeira instalação do Z-PRO.\n\n1. Clique para Editar domínio\n\n\n\n{% hint style="danger" %}\nRetire o domínio "whatsapp.com" e adicione o seu domínio da instalação.\n\nNão é necessário adicionar os subdomínios, apenas o domínio. \n{% endhint %}\n\n2. Adicione o(s) domínios que utiliza na instalação deparado por vírgula\n\n\n\n{% hint style="info" %}\nEsteja atento ao seu plano: \n\n One Domain: adicionar apenas um domínio\n Unlimited: adicionar todos os domínios utilizados na chave de licença\n {% endhint %}\n\n### Renovação da Licença Anual\n\nQuando você renova sua assinatura por mais um ano, o procedimento para atualizar a data de expiração no sistema é simples.\n\n1. A sua chave de licença não muda. Você continuará usando o mesmo código.\n2. Após a confirmação do pagamento da renovação, acesse a página "Assinatura".\n3. Clique em "Atualizar dados".\n\n\n\n4. Aguarde alguns minutos. O sistema irá identificar a renovação em nosso servidor e atualizará a "Expiração da Licença" no seu painel.\n\nImportante: A nova data de validade será de mais 12 meses somados à sua data de vencimento *atual, e não à data em que você realizou o pagamento da renovação.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/gerenciar-licenca-z-pro.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gestão de Tenants (clientes)\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nEsta documentação detalha como criar, configurar e gerenciar os recursos de cada tenant cadastrado no sistema.\n\n*\n\n#### Acessando a Página de Tenants\n\nNo menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e selecione a aba "Tenants".\n\n\n\n#### Visão Geral da Listagem\n\nA tela principal exibe todos os tenants cadastrados com as seguintes informações:\n\n* Nome: Identificação da empresa.\n* Status: Indica se a conta está Ativa (Verde) ou Inativa (Vermelho).\n* Plano: Nome do plano assinado (caso configurado).\n* Usuários / Conexões: Exibição do consumo atual versus o limite permitido.\n* Criado em: Data e hora de abertura da conta.\n* Ações: Atalhos para edição rápida ou ferramentas administrativas avançadas.\n\n\n\n*\n\n#### Criando ou Editando um Tenant\n\nAo clicar em "+ Novo Tenant" ou no ícone de edição (lápis), uma janela de configuração completa será aberta.\n\n1. Dados Básicos e Limites\n\n Status: Chave para ativar ou suspender o acesso do tenant. \n Nota: O Tenant ID 1 (instalação mestre) não pode ser desativado.\n Nome: Nome oficial da empresa.\n Máx. Usuários / Máx. Conexões: Define o teto de atendentes e canais que o cliente pode cadastrar.\n Identidade: Campo para o identificador único do tenant no banco de dados.\n\n\n\n2. Financeiro e Suporte\n\n Período de Trial: Chave para habilitar ou desabilitar o período de teste gratuito.\n Gateway de Pagamento: Seleção do gateway (ex: Asaas) e inserção do Token de API e Customer ID específico para este cliente.\n Chat de Suporte: Habilita ou desabilita o acesso do tenant ao chat de suporte direto.\n\n\n\n3. Menus Visíveis e Canais Permitidos\n\nNesta seção, o Superadmin define exatamente quais funcionalidades o tenant poderá visualizar em seu painel lateral:\n\n Recursos: Grupos, Kanban, API, Relatórios, Chat Privado, Disparo em Massa, Tarefas, Chatbot, Campanhas e Equipes.\n Canais: Checklist para permitir quais tipos de conexão o cliente pode usar (WhatsApp Oficial WABA, Baileys, WebJs, Meow, Evolution, Telegram, WebChat, Instagram/Facebook OAuth, etc).\n\n\n\n4. Limites por Tipo de Canal\n\nPermite um controle granular sobre a quantidade de conexões para cada tecnologia específica.\n\n\n\nVer documentação OAuth\n\n\n\n#### Ações e Ferramentas Administrativas\n\nNo menu de três pontos ao lado de cada tenant, estão disponíveis ferramentas de manutenção:\n\n\n\n Apagar empresa: Remove permanentemente o tenant e todos os seus dados.\n* Calcular tamanho dos dados: Verifica o espaço em disco ocupado pelo banco de dados do tenant.\n\n\n\n* Métricas: Exibe dados de performance e uso da instância.\n\n\n\n* Limpeza por filtro: Permite a remoção em massa de mensagens ou logs antigos para otimização do banco.\n* Apagar arquivos da empresa:** Remove mídias (imagens, áudios, documentos) armazenadas nos buckets ou pastas locais do tenant.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/gestao-de-tenants-clientes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Pagamentos dos Tenants\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nEsta página é uma central de visualização e gestão financeira dos seus clientes (tenants). Ela permite identificar rapidamente inadimplências e acessar links diretos para as faturas geradas pelos gateways de pagamento.\n\n{% hint style="info" %}\nObservação importante: Esta tela destina-se apenas à visualização e gestão dos pagamentos individuais. Para configurar os gateways de pagamento (Asaas, Stripe, etc.) ou definir os valores e períodos de teste, acesse a documentação de Planos.\n{% endhint %}\n\n#### Acessando a Página de Pagamentos\n\nNo menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e selecione a aba "Pagamentos".\n\n\n\n*\n\n#### Entendendo as Informações da Tela\n\nA interface exibe os tenants em blocos expansíveis. Ao clicar no nome de um tenant, o sistema detalha o histórico de cobranças associado a ele.\n\n\n\nCabeçalho do Tenant\n\n* Nome do Tenant: Nome do cliente/empresa.\n* Gateway: Identifica por qual integrador a cobrança é processada (ex: Asaas).\n* Contador de Pagamentos: Quantidade total de faturas registradas para aquele tenant.\n\nTabela de Cobranças\n\nDentro de cada tenant, você encontrará as seguintes colunas:\n\n* ID: Código de identificação único da transação no gateway de pagamento.\n* Status: Indica a situação atual da fatura:\n PENDING (Laranja): Aguardando pagamento.\n OVERDUE (Vermelho): Pagamento vencido e não identificado.\n RECEIVED/CONFIRMED: Pagamento realizado com sucesso.\n Vencimento: A data limite para o pagamento da fatura.\n* Valor: O valor bruto cobrado do tenant (Ex: R$ 10,00).\n* Link: Atalho externo que redireciona para a página oficial da fatura no gateway, permitindo a visualização de boleto, linha digitável ou QR Code do Pix.\n\n*\n\n#### Gestão de Cobranças e Ações\n\nA página de pagamentos deve ser utilizada para a rotina de monitoramento financeiro da sua operação:\n\n1. Identificação de Inadimplência: As faturas com o status OVERDUE ficam destacadas em vermelho para facilitar a identificação imediata de tenants com pagamentos em atraso.\n2. Ações de Cobrança: Utilize o campo Link para copiar o endereço da fatura e enviar diretamente ao cliente via WhatsApp ou E-mail, agilizando o processo de recebimento.\n3. Auditoria de Valores: Verifique se o valor cobrado está em conformidade com o plano assinado pelo tenant.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/pagamentos-dos-tenants.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Planos\n\n{% hint style="warning" %}\nDisponível para o perfil: Superadministrador\n{% endhint %}\n\nA página de Planos é fundamental para a monetização da plataforma, permitindo que o administrador estabeleça diferentes níveis de serviço e automatize a cobrança por meio de integradores financeiros.\n\n#### Acessando a Página de Planos\n\nNo menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e entre na aba "Planos".\n\n\n\nVisão geral da página:\n\n\n\n*\n\n#### 1. Criando um Novo Plano\n\nPara disponibilizar uma nova opção de assinatura para seus clientes:\n\n1. Clique no botão "+ Novo Plano" localizado no canto superior direito.\n2. Na janela pop-up, preencha os seguintes campos:\n * Nome: Identificação do plano (ex: Plano Start, Plano Pro).\n * Valor (R$): Preço que será cobrado do tenant.\n * Conexões: Limite máximo de instâncias/canais de WhatsApp que o tenant pode conectar.\n * Usuários: Limite máximo de atendentes que podem ser cadastrados no tenant.\n * Período Trial: Acione a chave (switch) caso deseje oferecer um tempo de uso gratuito.\n * Dias de Trial: Defina a quantidade de dias para o teste gratuito antes da primeira cobrança.\n3. Clique em "Salvar". O novo plano ficará imediatamente disponível para ser atribuído a novos tenants.\n\n\n\n*\n\n#### 2. Gerenciando Planos Existentes\n\nNa listagem principal, você visualiza o resumo de todos os planos criados, incluindo ID, limites e status do trial. Cline no ícone de 3 pontos para:\n\n Editar Plano: Ao ajustar preços ou limites de um plano existente, as alterações serão aplicadas para novas contratações.\n Excluir Plano: Planos excluídos deixam de estar disponíveis para novos tenants, mas os usuários já vinculados a eles permanecem ativos até uma alteração manual.\n\n*\n\n#### 3. Configuração Global de Gateway\n\nEsta seção define o gateway de pagamento padrão utilizado no momento do cadastro (signup) de novos tenants, eliminando a necessidade de configurar individualmente cada cliente, a menos que haja uma exceção.\n\nGateways suportados:\n\n Asaas\n Stripe\n Pagarme\n Mercado Pago\n\nComo configurar:\n\n1. No bloco "Configuração Global de Gateway", selecione o Gateway Ativo desejado.\n2. Insira o Token/API Key fornecido pela sua conta no gateway escolhido.\n3. Clique em "Salvar Configuração Global".\n\n*\n\n#### 4. Gateway de Pagamento por Tenant\n\nCaso precise definir uma conta de recebimento específica para um cliente determinado (diferente da configuração global):\n\n1. Vá até o bloco "Gateway de Pagamento".\n2. No campo Tenant, selecione o cliente desejado na lista.\n3. Escolha o Gateway Ativo para este cliente específico.\n4. Insira o Token correspondente à conta que deve receber os pagamentos deste tenant.\n5. Clique em "Salvar Configuração".\n\n\n\n### Utilizando a Página de Signup\n\nApós criar os planos, você terá uma página pública para que seus clientes possam se cadastrar sozinhos.\n\n URL da Página: O endereço é o seu domínio de frontend, seguido por /signup.\n Exemplo: app.suaempresa.com.br/signup\n Como Funciona o Fluxo do Cliente:\n 1. O cliente acessa a sua página de signup.\n 2. Ele preenche os dados cadastrais (nome, e-mail, telefone, senha).\n 3. Ele seleciona um dos planos que você criou.\n 4. Ao finalizar, o sistema realiza as seguintes ações automaticamente:\n * Cria um novo Tenant (cliente) no seu Z-PRO.\n * Cria um novo Usuário Admin para este tenant.\n * Cria um novo Cliente na sua conta do Gateway global.\n * Gera a primeira cobrança de assinatura** para este cliente no Gateway global.\n\nPágina de signup:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/planos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como gerar a Chave API no Asaas\n\nPara que a loja online passe a se comunicar com a sua conta Asaas, é necessário gerar a Chave API no Asaas para fazer a configuração.\n\nVeja abaixo como fazer:\n\n1. No painel do Asaas, no canto superior direito, clique sobre o ícone de perfil\n\n2. Em seguida, clique em Integrações \n\n3. Em “Chaves de API”, clique em Gerar chave de API ou Gerar nova chave de API (caso já tenha gerado antes)\n\n4. Na mensagem que aparecer na tela, leia com atenção as informações e clique em Avançar\n\n\n\n5. Será necessário autorizar via SMS, clique em Enviar código e informe o número encaminhado ao celular\n\n\n\n6. Em seguida, clique em Gerar chave de API ou Gerar chave nova de API\n\n7. Em “Chaves da API”, clique em Copiar - E salve a chave gerada, ela deverá ser adicionada no painel superadmin, em planos > token asaas\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/planos/como-gerar-a-chave-api-no-asaas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Usuários por Tenant\n\nNesta página, o Superadministrador realiza a gestão centralizada de todos os usuários cadastrados na plataforma, independentemente do tenant ao qual pertencem. É possível definir perfis de acesso, permissões específicas de menu e horários de atendimento individuais.\n\n{% hint style="warning" %}\nDisponível para os perfis: Superadministrador\n{% endhint %}\n\nEsta documentação detalha os procedimentos para criação, edição e controle de permissões de usuários.\n\n*\n\n#### Acessando a Página de Usuários\n\nNo menu lateral do painel Superadmin, localize a sessão "TENANTS E LICENCIAMENTO" e entre na aba "Usuários Tenants".\n\n\n\n#### Visão Geral da Listagem\n\nA tela exibe uma tabela com todos os usuários do sistema:\n\n* Nome e Email: Identificação básica do usuário.\n* Tenant: Indica a qual empresa (instância) o usuário está vinculado.\n* Perfil: Exibe o nível de acesso (ex: Administrador, Super Admin, Supervisor, Usuário).\n* Ações: Ícones para editar dados ou excluir o registro.\n\n\n\n*\n\n#### Entendendo os Perfis de Usuário\n\nA plataforma Z-PRO utiliza uma hierarquia de perfis para garantir a segurança dos dados e a organização das funções operacionais. Cada perfil possui níveis de permissão distintos:\n\n Super Admin: Este é o nível mais alto de acesso. Possui permissão global para gerenciar a infraestrutura do sistema, incluindo a criação de tenants, gestão de licenças, configuração de planos e gateways de pagamento globais.\n\n\n\n Administrador: Possui controle total dentro de um tenant específico. Pode criar e editar usuários da sua empresa, configurar conexões (instâncias de WhatsApp), ajustar fluxos de chatbot e acessar todas as configurações e relatórios do painel do cliente.\n\n\n\n Supervisor: Perfil com foco gerencial sobre a operação de atendimento. O Supervisor pode visualizar os chats de outros atendentes, acompanhar relatórios de desempenho e monitorar o Kanban, mas possui restrições de acesso a configurações estruturais do sistema e faturamento.\n\n\n\n Usuário (Atendente): Nível estritamente operacional. O acesso é limitado às ferramentas de comunicação direta, como o Chat, Kanban e Tarefas. Geralmente, este perfil visualiza apenas os atendimentos vinculados a ele ou aos seus departamentos, sem permissão para alterar configurações do tenant.\n\n\n\n*\n\n#### Criando um Novo Usuário\n\nPara adicionar um colaborador a um tenant específico:\n\n1. Clique no botão "+ Novo Usuário".\n2. Preencha os Dados Básicos:\n * Nome e Email: Dados de identificação e login.\n * Senha: Código de acesso (mínimo de 7 caracteres).\n * Telefone: Número de contato do usuário.\n3. Defina o Perfil: Selecione entre as opções de hierarquia mencionadas acima.\n4. Selecione o Tenant: Escolha a qual empresa este usuário pertence.\n5. Configurações Adicionais: Use a chave "Usuário restrito" para limitar funcionalidades específicas, caso necessário.\n\n\n\n*\n\n#### Configurações de Permissões e Horários\n\nDentro da tela de criação ou edição, o sistema permite um ajuste fino das capacidades do usuário:\n\n1. Permissões de Menu\n\nSelecione quais módulos o usuário terá permissão para visualizar e operar dentro do sistema:\n\n Disparos em massa.\n Gestão de Grupos.\n Chat Privado.\n Kanban e Funil.\n Relatórios e Campanhas.\n Agendamentos e Configurações.\n\n2. Horário de Atendimento\n\nDefine em quais períodos o usuário poderá realizar atendimentos no sistema:\n\n Status: Define se o usuário está "Aberto" ou "Fechado" para atendimento em cada dia da semana.\n Períodos: Permite configurar até dois turnos de trabalho por dia (ex: 08:00–12:00 e 14:00–18:00).\n\n\n\n\n\n#### Gestão e Manutenção\n\n Edição: Permite ajustar permissões de menu, alterar a senha ou trocar o perfil de acesso a qualquer momento.\n* Desativação: Para impedir o acesso de um usuário sem excluí-lo definitivamente, o administrador pode alterar o status ou remover as permissões de menu.\n* Busca: Utilize o campo de pesquisa no topo da página para localizar rapidamente usuários por nome ou e-mail.\n\nApós preencher todas as informações e ajustar as permissões desejadas, clique no botão SALVAR** no canto inferior direito para finalizar o cadastro. O usuário já poderá acessar a plataforma!\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/tenants-e-licenca/usuarios-por-tenant.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Visão geral Super Admin\n\nO Painel Superadmin é a área administrativa global do Z-PRO. É através dele que você gerencia a infraestrutura do sistema, as licenças, a personalização (White-label) e a criação das empresas (Tenants) que utilizarão a plataforma.\n\nEste painel é exclusivo para o dono da instalação (dono da VPS/SaaS) e não deve ser confundido com o painel de atendimento.\n\n\n\n### Estrutura do Painel Superadmin\n\nO gerenciamento da sua assinatura e dos seus clientes é feito através de quatro menus principais. Abaixo, detalhamos o que cada seção controla:\n\n\n\n#### 1. Tenants e Licença\n\nEste é o coração do seu SaaS. Aqui você gerencia as empresas cadastradas e a validação da sua licença Z-PRO.\n\n Principais funções: Criar novo Tenant (empresa), definir limites de usuários/conexões, alterar data de vencimento e visualizar o status da licença oficial.\n\n#### 2. Configurações\n\nÁrea responsável pela identidade visual e configurações globais do servidor.\n\n* Principais funções: Configuração de White-label (Nome, Cor, Logo), Termos de Uso, e configurações de SMTP para envio de e-mails do sistema.\n\n#### 3. Canais e Integrações\n\nGerenciamento das conexões externas que alimentam o sistema.\n\n* Principais funções: Configuração da API Oficial do WhatsApp (WABA), Integração com Typebot (fluxos de conversa) e Gerenciamento de Proxies.\n\n#### 4. Sistema\n\nMonitoramento da saúde técnica da plataforma.\n\n* Principais funções:** Gerenciamento do banco de dados Redis, limpeza de cache e visualização de logs do sistema. Essencial para manutenção preventiva.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-superadmin/visao-geral-super-admin.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Conheca O Z Pro
Conheça o Z-PRO\n\nO Z-PRO é um sistema de atendimento e automação projetado para centralizar múltiplos canais de comunicação, permitindo que você gerencie toda a sua operação em um único lugar ou crie o seu próprio negócio de software (SaaS). Abaixo, apresentamos um resumo de como a nossa solução funciona.\n\n#### O que está incluso na assinatura\n\nO Z-PRO é comercializado através de uma licença de uso anual com preço fixo, sem cobrança de mensalidades ou taxas por volume da nossa parte. A sua assinatura inclui:\n\n Licença de uso sem limites: Usuários (atendentes), conexões, canais e disparos de mensagens ilimitados (limitados apenas pela capacidade do seu servidor).\n Setup de Instalação Inicial: Nossa equipe técnica realiza a primeira instalação da plataforma no seu servidor (VPS).\n Suporte Técnico: Acesso ao nosso sistema de tickets (de segunda a sexta-feira) para resolução de dúvidas e correções de bugs da plataforma.\n Atualizações Contínuas: Acesso constante a novas funcionalidades, melhorias e correções de segurança desenvolvidas pela nossa equipe. \n\nLer Termos e condições de uso e licenciamento\n\nLer política de suporte\n\n#### Como funciona o modelo Whitelabel, SaaS e Revenda\n\nO Z-PRO é uma solução auto-hospedada (self-hosted) e White-Label. Isso significa que o sistema rodará no seu próprio servidor, e você terá controle total sobre ele.\n\n White-Label: Você pode customizar a plataforma com a sua logomarca, suas cores e usar o seu próprio domínio web. Para o seu cliente final, a marca Z-PRO não aparece.\n SaaS (Software as a Service): Através do painel Superadmin, você pode criar contas isoladas (tenants) para revender o sistema a outras empresas, definir limites de conexões/usuários, montar os seus próprios planos de assinatura e integrar com o gateway de pagamento ASAAS para realizar a cobrança automática dos seus clientes. A estratégia de preços e o lucro são 100% seus. \n\nLer detalhamento\n\n#### Requisitos e responsabilidades\n\nPor ser um sistema auto-hospedado, as responsabilidades são divididas:\n\n Requisitos: Você precisará contratar um servidor VPS em nuvem com no mínimo 16GB de RAM, 4 vCPUs e sistema operacional Ubuntu 20.04 ou 22.04 LTS, além de um domínio web próprio.\n Responsabilidade do Cliente: Como a infraestrutura é sua, você é o responsável pelos custos e pela manutenção do servidor (VPS), incluindo atualizações, gerenciamento de firewall, proteção de dados e rotinas de backup.\n Responsabilidade do Z-PRO: Nós fornecemos o software funcional, enviamos as atualizações periódicas e prestamos o suporte técnico focado exclusivamente no funcionamento e em bugs nativos da plataforma Z-PRO. \n\n[Ler pré requisitos de instalação e utilização](/diretrizes-e-politicas/pre-requisitos-de-instalacao-e-utilizacao.md)\n\n#### Custos adicionais\n\nAlém do valor da licença anual do Z-PRO, a sua operação terá os seguintes custos:\n\n Obrigatórios: Custos com a contratação da hospedagem/servidor (VPS) e o registro do seu domínio web.\n Variáveis/Opcionais: Custos diretos com as integrações que você escolher usar, como: consumo da API Oficial do WhatsApp cobrado pela Meta, tokens de Inteligência Artificial (OpenAI, Gemini), assinaturas de serviços terceiros (como o Hub NotificaMe) ou plataformas de automação (N8N, Typebot). \[Link detalhado aqui]\n\n#### Canais de comunicação integrados\n\nO Z-PRO centraliza as mensagens de diferentes plataformas em uma única caixa de entrada para a sua equipe. As conexões suportadas são:\n\n WhatsApp: Integração com a API Oficial da Meta (WABA) e diversas opções de APIs não oficiais (como Baileys, Evolution, Wuzapi, Z-API, Uazapi, WebJs).\n Redes Sociais: Instagram Direct e Facebook Messenger (via integração nativa ou Hub Notificame).\n Webchat: Janela de chat para o seu site (nativo ou via Hub Notificame).\n E-mail (Webmail): Integração para recebimento e resposta de e-mails, com integração nativa ao Gmail.\n Telegram: Conexão nativa e direta através de bots.\n Telefonia/Voz: O sistema também atua como softphone, permitindo chamadas via WhatsApp (com a parceira Wavoip) ou integração com PABX convencional via protocolo SIP. \[Link detalhado aqui]\n\n#### Quais integrações com IA\n\nNossa plataforma permite plugar os modelos de linguagem (LLMs) mais avançados do mercado para criar agentes de atendimento inteligentes, exigindo apenas que você insira as suas chaves de API. \n\n ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google), Grok (xAI), Deepseek e Qwen (Alibaba).\n Modelos Auto-Hospedados como Ollama e LM Studio.\n\n#### Quais ferramentas de automação e APIs\n\nO Z-PRO fornece ferramentas robustas para construção de fluxos e atua como um hub central, conversando com ferramentas externas poderosas:\n\n Chatbot Nativo: Um construtor visual de fluxos (Flowbuilder) interno para criar as jornadas de atendimento, direcionar conversas e automatizar processos sem ferramentas adicionais.\n Integrações Externas de Automação: Suporte direto ao N8N (para fluxos de trabalho avançados), Typebot e Dialogflow (para construção de fluxos complexos fora do Z-PRO) e Dify (para desenvolvimento avançado de apps de IA).\n APIs Z-PRO e Webhooks: A plataforma oferece Webhooks e rotas de API próprias e documentadas via Postman, que permitem integrações personalizadas com CRMs e ERPs ou a criação automática de contas (Tenants) no modelo SaaS. \[Link detalhado aqui]\n\n#### Dando o próximo passo\n\nGostou das possibilidades que o Z-PRO oferece para escalar o seu atendimento ou criar o seu próprio negócio de tecnologia? Você pode iniciar adquirindo a licença e agendando a instalação conosco, para que a nossa equipe deixe a aplicação pronta no seu servidor. Caso prefira conhecer o sistema na prática antes de decidir, disponibilizamos demonstrações completas.\n\nhttps://zpro.zdg.com.br/\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Canais de Comunicação Integrados\n\nO Z-PRO é uma plataforma omnichannel projetada para centralizar múltiplos canais de comunicação em uma única caixa de entrada, permitindo que sua equipe gerencie todos os atendimentos de forma unificada, organizada e eficiente.\n\nAbaixo, detalhamos todos os canais suportados pela plataforma e as formas de integração disponíveis para o seu negócio:\n\n### WhatsApp\n\nO WhatsApp é o canal central do Z-PRO, oferecendo flexibilidade para diferentes perfis e tamanhos de operação. Você pode optar por duas abordagens:\n\n API Oficial (WABA - WhatsApp Business Platform): É a conexão oficial, homologada e mais estável, cobrada diretamente pela Meta. É a opção recomendada para operações profissionais que demandam alta confiabilidade e escalabilidade.\n APIs Não Oficiais (via QR Code): Permitem usar o WhatsApp de forma similar ao WhatsApp Web, automatizando uma sessão do aparelho. O Z-PRO suporta diversas bibliotecas e APIs para isso, incluindo Baileys, WebJs, Evolution API, Meow API (Wuzapi), Uazapi e Z-API. Apesar do menor custo inicial, estão sujeitas a instabilidades e bloqueios por não serem oficiais.\n\nVeja o detalhamento das APIs Aqui\n\n### Redes Sociais: Instagram e Facebook Messenger\n\nPara integrar o ecossistema da Meta, o Z-PRO disponibiliza duas vias de conexão:\n\n Integração Nativa: É possível conectar o Instagram Direct e o Facebook Messenger de forma nativa e direta via Login Incorporado. Para isso, é necessário ter um aplicativo configurado no painel do Facebook Developers com as devidas permissões.\n Via Hub NotificaMe: Alternativa facilitada através de um serviço parceiro externo. Exige a contratação de um plano à parte com a plataforma Hub NotificaMe para intermediar a conexão dessas redes sociais.\n\n### Webchat\n\nAdicione uma janela de chat personalizada diretamente no site da sua empresa para atender os visitantes em tempo real:\n\n Webchat Nativo: O Z-PRO permite criar o seu próprio webchat nativo. É necessário configurar um subdomínio e rodar o autoinstalador no servidor para instalar o serviço de socket, gerando um widget (código JavaScript) que será embutido no seu site.\n\n### E-mail (Webmail)\n\nReceba e responda e-mails de clientes diretamente na mesma tela de chat onde atende o WhatsApp:\n\n Webmail Nativo (Gmail): Integração direta com contas do Gmail (via servidor SMTP e autenticação OAuth2 do Google Cloud Console). Requer a criação de um aplicativo e tela de consentimento no painel do Google para autorizar o recebimento dos e-mails.\n\n### Telegram\n\nA integração com o Telegram é feita de forma nativa e direta. Basta criar o seu bot através do BotFather no aplicativo do Telegram e inserir o token com as credenciais no painel do Z-PRO para começar a operar.\n\n### Telefonia e Voz\n\nO Z-PRO também centraliza canais de voz, permitindo realizar e receber chamadas pela interface do sistema:\n\n Wavoip (Ligações via WhatsApp): Habilita o recebimento e a realização de chamadas de voz diretamente pelo WhatsApp.\n SIP (VoIP): Integração com sistemas de telefonia convencionais (como Asterisk, 3CX, FreeSwitch ou Issabel) usando o protocolo SIP e WebRTC para transformar o Z-PRO num softphone (Webphone) e realizar ligações telefônicas tradicionais.\n\n*\n\n#### ⚙️ Como conectar seu primeiro canal no Z-PRO\n\nIndependentemente do canal escolhido, o fluxo básico para adicionar uma nova conexão no sistema é o seguinte:\n\n1. No menu lateral do seu painel Admin, clique no ícone Canais.\n2. Clique no botão Adicionar Canal no canto superior direito.\n3. No pop-up que se abrirá, selecione o Tipo de canal (WhatsApp Oficial, Baileys, Webchat, Telegram, Hub Notificame, etc.).\n4. Preencha os dados solicitados\n5. Clique em Salvar. O canal aparecerá na lista e você poderá realizar a autenticação específica (como ler o QR Code, conectar no Facebook, inserir o Token ou as chaves OAuth) para ativá-lo.\n\n*\n\nInformações Importantes\n\n Limite de Conexões: O Z-PRO não impõe um limite no número de canais ou conexões que você pode adicionar. A capacidade de atendimento dependerá da performance do seu servidor (VPS).\n Caixa de Entrada Unificada: Independentemente do canal de origem, todas as conversas chegam de forma padronizada para os operadores na interface de atendimento do Z-PRO.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/canais-de-comunicacao-integrados.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Como Funciona o Modelo de Negócio Z-PRO\n\n{% hint style="success" %}\nEsta página centraliza todas as informações comerciais sobre a aquisição e o uso do Z-PRO. Nosso objetivo é oferecer total clareza sobre o investimento, o que ele inclui e quais são as responsabilidades de cada parte.\n{% endhint %}\n\n## Qual é o valor da assinatura e o que está incluso?\n\nO modelo de licenciamento do ZPRO foi pensado para ser simples e permitir a máxima utilização, sem taxas ocultas ou mensalidades.\n\n{% hint style="info" %}\nO Z-PRO é comercializado através de uma licença de uso anual, estruturada em dois planos distintos conforme o objetivo da sua operação:\n\n1. Plano para Uso Próprio Desenvolvido para empresas que desejam centralizar e gerenciar o próprio atendimento.\n\n Licença restrita a 1 conta (Tenant) de uso próprio.\n Usuários (atendentes) e canais (números/conexões) ilimitados.\n Acesso completo ao construtor de chatbots e integrações com IA.\n\n2. Plano para Revenda (SaaS / White-Label) Desenvolvido para operações que desejam comercializar o sistema como serviço para terceiros.\n\n Inclui todos os recursos operacionais do plano de Uso Próprio.\n Acesso ao Módulo Superadmin (Multi-Tenant) para criação de contas ilimitadas para clientes.\n Integração com gateways de pagamento (Asaas)\n Permite múltiplas instalações em diferentes servidores utilizando a mesma chave de licença (desde que em subdomínios vinculados ao mesmo domínio principal).\n\nOs valores atualizados de cada plano podem ser consultados diretamente em nossa página oficial: https://zpro.zdg.com.br/#oferta\n{% endhint %}\n\nAo comprar o sistema, você receberá os seguintes entregáveis:\n\n Licença de Uso Anual (Sem Limites) - Acesso completo ao motor do ZPRO para você gerenciar sua operação ou revender como SaaS. Escale à vontade: não cobramos taxas extras por novos usuários, conexões, canais ou chatbots.\n Setup Inicial Feito Por Nós (Ou Autonomia Total) - Nossa equipe técnica acessa o seu servidor (VPS) e realiza a primeira instalação para deixar tudo pronto para uso. Prefere fazer sozinho ou instalar em novos clientes? Disponibilizamos o auto-instalador e o passo a passo completo.\n Portal de Treinamento Exclusivo - Acesso a uma área de membros com vídeo-aulas detalhadas ensinando a configurar, operar e escalar o sistema. (Módulos: Introdução, Instalação, Atualização, Configurações Técnicas, Modo de Usar, Conexões/Integrações e Dúvidas Frequentes).\n Suporte Técnico Especializado - Acesso direto à nossa equipe de suporte (via sistema de tickets, de segunda a sexta-feira) para te auxiliar com dúvidas operacionais e garantir o perfeito funcionamento da plataforma.\n Atualizações Contínuas de Software - Tecnologia que não envelhece. Com a licença ativa, você recebe acesso a todas as correções, melhorias e novas funcionalidades (como novas integrações de IA e Canais) desenvolvidas mensalmente pela nossa engenharia.\n\n{% hint style="warning" %}\nSobre a Renovação da Licença\\nPara continuar utilizando o sistema, recebendo atualizações e tendo acesso ao suporte técnico após o primeiro ano, a licença precisa ser renovada anualmente. Uma licença inativa impede o funcionamento da plataforma.\n{% endhint %}\n\n\n\n## Requisitos e responsabilidades\n\n\n\n## Como funciona o modelo White-Label e SAAS?\n\n> Requisito de Plano: A operação no formato White-Label e a gestão de múltiplos clientes (Multi-Tenant) detalhadas abaixo são recursos exclusivos do Plano para Revenda.\n\nO modelo White-Label é o que permite que você utilize a tecnologia do Z-PRO para criar seu próprio serviço de atendimento, com sua própria marca e identidade visual.\n\nAtravés do Painel Super Admin, você tem controle total para:\n\n Customizar a Plataforma: Adicionar seu próprio logotipo e definir as cores da interface para que correspondam à sua identidade visual.\n Utilizar seu Próprio Domínio: Acessar e fornecer a plataforma a partir do seu próprio endereço web (ex: app.suaempresa.com).\n Gerenciar seus Clientes (Tenants): Criar e administrar contas individuais e isoladas para cada um dos seus clientes dentro da sua plataforma.\n Definir as Funcionalidades por Cliente: Escolher quais recursos e módulos do Z-PRO estarão visíveis e disponíveis para cada conta de cliente.\n\n{% hint style="info" %}\nEm resumo, o modelo White-Label fornece a tecnologia para que você crie e gerencie seu próprio negócio de SaaS de atendimento, com total autonomia sobre a marca e a oferta comercial. Para o seu cliente final, a marca Z-PRO não aparece.\n{% endhint %}\n\nPara um guia técnico detalhado sobre como aplicar sua marca, configurar domínios e gerenciar clientes, acesse nossa documentação de configuração.\\n→ Ver Detalhes da Configuração White-Label\n\n{% hint style="danger" %}\nImportante: Z-PRO é uma Solução Auto-hospedada (Self-Hosted)\\nÉ fundamental entender que, embora você possa vender o Z-PRO no modelo SaaS para seus clientes, a sua licença conosco é de um software auto-hospedado. Isso significa que você é o responsável por toda a infraestrutura (servidor/VPS) onde a plataforma opera. O Z-PRO não é um serviço na nuvem (Cloud) que nós gerenciamos para você.\n{% endhint %}\n\n*\n\n### Existem outros custos além da assinatura do Z-PRO?\n\nSim. Por ser uma solução auto-hospedada (self-hosted), você tem controle total sobre a infraestrutura, o que implica na gestão de alguns custos operacionais.\n\n#### Custos Obrigatórios\n\nEstes são os custos de infraestrutura essenciais para que o Z-PRO funcione.\n\n1. Servidor (VPS - Servidor Virtual Privado)\n * É o ambiente onde o Z-PRO será instalado. O custo varia de acordo com o provedor e a capacidade do servidor escolhido.[ Ver requisitos da VPS para instalar o Z-PRO.](/diretrizes-e-politicas/pre-requisitos-de-instalacao-e-utilizacao.md)\n2. Domínio e Subdomínios\n Você precisará de um domínio e, no mínimo, dois subdomínios (um para o frontend e outro para o backend da aplicação) para que o sistema seja acessível pela internet.\n\n#### Custos Opcionais (Variáveis)\n\nEstes custos dependem das integrações e ferramentas que você decidir usar para potencializar sua operação.\n\n APIs de Inteligência Artificial: O uso de serviços como ChatGPT (OpenAI) ou Gemini (Google) geralmente envolve custos baseados no consumo de tokens.\n* API Oficial do WhatsApp (WABA): A Meta cobra por "janelas de conversa" de 24 horas, após uma cota mensal gratuita. [Ver custos da meta aqui.](https://developers.facebook.com/docs/whatsapp/pricing?locale=pt_BR)\n* Outras Ferramentas de Automação: Serviços como N8N, Typebot ou gateways de SMS (Comtele) podem ter seus próprios planos de assinatura.\n\n{% hint style="warning" %}\nDivisão de Responsabilidades\\nO valor pago ao Z-PRO refere-se exclusivamente à licença de uso do software e ao setup inicial. Todos os custos com infraestrutura e serviços de terceiros são de responsabilidade do assinante e pagos diretamente aos respectivos provedores.\n{% endhint %}\n\n*\n\n### Por quanto posso revender o Z-PRO para meus clientes?\n\nComo o Z-PRO é uma plataforma White-Label, a estratégia de precificação é 100% sua. Você define os planos, os limites (se houver) e os valores que irá cobrar dos seus clientes finais.\n\n> Como referência de mercado, é comum encontrar planos a partir de R$ 500 / mês para um serviço básico de gestão de conversas. Este valor pode aumentar consideravelmente dependendo dos serviços agregados.\n\nLimites de Uso\n\nA licença do Z-PRO não impõe limites de software para o número de usuários (atendentes) ou para a quantidade de conexões (números de WhatsApp, etc.) que você pode configurar. A capacidade real de sua operação será determinada pela performance e pelos recursos do seu servidor (VPS).\n\nLicenciamento em Múltiplos Servidores\n\nA licença anual do Z-PRO permite a instalação da plataforma em múltiplos servidores, caso sua estratégia de negócio exija a segregação de clientes em diferentes infraestruturas. É importante destacar dois pontos:\n\n1. Instalação Inclusa: O serviço de setup de instalação, incluído no valor da licença, é válido apenas para o primeiro servidor. Instalações adicionais em outros servidores são de responsabilidade do cliente, que pode utilizar o auto-instalador.\n2. Propriedade da Infraestrutura: Conforme os Termos de Uso, a licença destina-se ao uso em infraestrutura própria ou gerenciada pelo licenciado. Não é permitido o sublicenciamento ou a revenda da licença de forma desvinculada de um serviço prestado em sua própria infraestrutura.\n\n{% hint style="info" %}\nO modelo White-Label foi projetado para oferecer altas margens de lucro, permitindo que você construa um negócio escalável sobre a nossa tecnologia, com total autonomia para definir e adaptar sua oferta ao mercado.\n{% endhint %}\n\n\n\n### Quais são as regras de uso e políticas do Z-PRO?\n\nPara garantir uma parceria transparente e profissional, é fundamental que você conheça os documentos que regem o uso da plataforma e o escopo dos nossos serviços.\n\n Termos de Uso\n Descreve o que você pode e não pode fazer com a plataforma, as regras do White Label, direitos de propriedade intelectual e as responsabilidades de ambas as partes.\n [→ Acessar os Termos de Uso completos](/diretrizes-e-politicas/termos-e-condicoes-gerais-de-uso-e-licenciamento.md)\n* Política de Privacidade\n Detalha nosso compromisso com a segurança dos seus dados e explica como as informações são coletadas, usadas e protegidas dentro da plataforma.\n [→ Ler a Política de Privacidade completa](/diretrizes-e-politicas/aviso-de-privacidade.md)\n* Política de Suporte (SLA)\n Define com clareza o que nosso suporte técnico cobre, os canais oficiais de atendimento, os horários e os prazos de resposta. A leitura deste documento é essencial para alinhar as expectativas sobre o serviço de suporte.\n [→ Ver a Política de Suporte completa**](/diretrizes-e-politicas/politica-de-suporte-tecnico.md)\n\n{% hint style="info" %}\nO Z-PRO oferece acesso ao código-fonte do front-end, permitindo customizações no design e na interface do usuário. Contudo, o código-fonte do back-end (a lógica do servidor) é fechado e não é comercializado. Este modelo garante a integridade, segurança e a capacidade de evolução contínua da plataforma central.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/como-funciona-o-modelo-de-negocio-z-pro.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Dando o Próximo Passo\n\n{% hint style="info" %}\nEsta página contém as informações para você testar a plataforma ou, caso já tenha se decidido, iniciar o processo de onboarding após a compra.\n{% endhint %}\n\n### Posso testar o Z-PRO antes de comprar?\n\nSim. Oferecemos um ambiente de demonstração para que você possa avaliar as funcionalidades da plataforma antes de realizar a compra.\n\nA demonstração foi criada para permitir uma avaliação técnica e funcional do sistema.\n\nO que o acesso de demonstração inclui:\n\n Acesso de 7 dias a um ambiente compartilhado da plataforma.\n Painel Admin liberado, permitindo que você explore todas as funcionalidades disponíveis.\n Possibilidade de conectar um número de WhatsApp para realizar testes práticos de envio e recebimento de mensagens.\n\n{% hint style="success" %}\nPara solicitar seu acesso ao ambiente de demonstração, mande mensagem para nosso canal de atendimento: https://wa.me/553531420951\n{% endhint %}\n\n**\n\n### Comprei o Z-PRO. E agora?\n\nBem-vindo ao Z-PRO. O processo para iniciar o uso da plataforma é estruturado para ser claro e eficiente.\n\nPreparamos um guia completo de Onboarding que centraliza todas as informações e os primeiros passos que você precisa seguir. Este guia irá orientá-lo desde o recebimento das suas credenciais até a solicitação de instalação da plataforma em seu servidor.\n\n#### Prazo de Instalação\n\nA instalação assistida, realizada por nossa equipe, é concluída em um prazo médio de 2 a 5 dias úteis. Este prazo começa a contar a partir do momento em que o cliente envia todas as informações de acesso necessárias (credenciais da VPS e do domínio) através do ticket de agendamento.\n\nPara os usuários que optarem pelo auto-instalador, o acesso e a possibilidade de instalação são imediatos após a confirmação do pagamento.\n\n{% hint style="success" %}\nSeu próximo passo é acessar a nossa página de Onboarding:\\n→ Acessar a Página de Onboarding para Novos Assinantes\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/dando-o-proximo-passo.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Ferramentas de automação e APIs\n\n{% hint style="success" %}\nO Z-PRO permite a conexão direta com uma variedade de Modelos de Linguagem (LLMs) de ponta. Essa abordagem oferece a flexibilidade de escolher O Z-PRO funciona como um hub de comunicação que se integra a uma vasta gama de ferramentas externas. Você pode conectar construtores de chatbot como Typebot e Dialogflow, plataformas de automação como N8N, e praticamente qualquer outro sistema através de Webhooks. Isso permite a criação de fluxos de trabalho complexos e personalizados, onde o Z-PRO gerencia a conversa e as ferramentas externas executam a lógica.\n{% endhint %}\n\n### O Papel do Z-PRO: O Hub Centralizador\n\nO Z-PRO gerencia a conexão com os canais de atendimento (WhatsApp, Instagram, etc.). As ferramentas abaixo são conectadas ao Z-PRO para adicionar camadas de lógica, inteligência e automação, permitindo que você crie experiências muito além de um simples chatbot.\n\n*\n\n## 1. Ferramentas de Automação e Construção de Chatbots\n\nEstas são as principais ferramentas para desenhar fluxos de conversa e automatizar processos.\n\n* Typebot\n * O que é: Uma plataforma de código aberto para a construção de chatbots de forma visual. Com uma interface de "arrastar e soltar", permite criar fluxos de conversa interativos, coletar dados de usuários, criar formulários e direcionar o atendimento.\n * Ideal para: Criar a jornada conversacional do cliente de forma intuitiva, sem a necessidade de programação.\n* N8N\n * O que é: Uma poderosa ferramenta de automação de fluxos de trabalho. O N8N vai além de um chatbot, permitindo conectar centenas de aplicações diferentes.\n * Exemplo de uso: Quando um cliente finaliza um atendimento no Z-PRO, o N8N pode automaticamente criar uma tarefa no Trello, adicionar o contato a uma planilha do Google Sheets e enviar um resumo por e-mail para a equipe de vendas.\n * Ideal para: Orquestrar processos complexos que envolvem múltiplos sistemas, não apenas a conversa em si.\n* Dialogflow (do Google)\n * O que é: Uma plataforma avançada para a criação de agentes conversacionais, com um dos mais sofisticados sistemas de compreensão de linguagem natural (NLU) do mercado.\n * Diferencial: Sua força está em interpretar a intenção do usuário, mesmo que ele não use as palavras-chave exatas, permitindo diálogos mais fluidos e precisos.\n * Ideal para: Aplicações que exigem uma compreensão profunda e contextual da fala do usuário, comum em grandes operações de suporte.\n* Dify\n * O que é: Uma plataforma de desenvolvimento de aplicações de IA (LLM-Ops). Ela permite orquestrar prompts, agentes de IA e bases de conhecimento para construir assistentes virtuais mais complexos e inteligentes.\n * Ideal para: Desenvolver soluções de IA mais robustas que um chatbot tradicional, combinando fluxos de trabalho com o poder dos modelos de linguagem.\n\n*\n\n## 2. Integrações Essenciais e APIs\n\nEstes são os blocos de construção que permitem a comunicação entre o Z-PRO e outras ferramentas.\n\n Webhooks\n O que é: O método universal para que diferentes sistemas se comuniquem em tempo real. Um webhook é um "sinalizador" que o Z-PRO envia para uma URL externa (como um fluxo no N8N) sempre que um evento acontece (ex: uma nova mensagem chega).\n Importância: É a tecnologia que serve de base para a maioria das integrações, oferecendo flexibilidade para conectar o Z-PRO a praticamente qualquer sistema que possua uma API.\n Webchat\n O que é: O Z-PRO permite a integração de um canal de Webchat, geralmente através de um parceiro como o Hub Notificame. Isso permite que você adicione uma janela de chat em seu site ou sistema, e todas as conversas são direcionadas para a mesma caixa de entrada unificada do Z-PRO.\n Google Calendar\n O que é: Um exemplo prático de automação. Usando uma ferramenta como o N8N, você pode criar um fluxo onde seu chatbot agenda um horário com um cliente e o evento é automaticamente criado na agenda do Google Calendar da sua equipe.\n\n**\n\n## 3. Conectores de Canais e APIs Externas\n\nPara garantir a conexão com canais externos, o Z-PRO utiliza APIs consolidadas no mercado.\n\n Meta (API Oficial): Para a conexão oficial e estável com WhatsApp e Instagram.\n Evolution API / Wuzapi (Meow): Exemplos de APIs utilizadas para as conexões não oficiais do WhatsApp.\n SMS (via Comtele): Permite a integração para o envio e recebimento de mensagens SMS.\n\n**\n\n## 4. Integrações Complementares e Avançadas\n\nPara casos de uso mais específicos, o Z-PRO pode ser conectado a serviços especializados.\n\n Vapi AI\n O que é: Um serviço para a criação de assistentes de voz com recurso a inteligência artificial. Permite que você crie automações que podem interagir com clientes por telefone, usando uma voz natural.\n GroqCloud\n O que é: Uma plataforma de nuvem que oferece acesso a "LPUs" (Language Processing Units), permitindo a execução de modelos de linguagem com uma velocidade de resposta (inferência) extremamente alta.\n Ideal para: Aplicações de IA em tempo real que exigem respostas quase instantâneas.\n SMS (via Comtele)\n O que é: Permite a integração com o serviço da Comtele para o envio e recebimento de mensagens SMS, um canal eficaz para notificações, alertas de segurança e marketing direto.\n\n**\n\n### Requisitos e Escopo do Suporte para Ferramentas de Terceiros\n\nAo integrar o Z-PRO com as ferramentas e APIs mencionadas, é crucial entender a divisão de responsabilidades.\n\n Necessidade de Contas Ativas: Para utilizar qualquer serviço externo (como Typebot, N8N, Evolution API, Comtele, etc.), você precisa ter uma conta ativa e, em muitos casos, uma assinatura paga diretamente com o provedor da ferramenta.\n Custos de Ferramentas Externas: Todos os custos relacionados ao uso, assinaturas ou consumo de recursos dessas plataformas são de sua responsabilidade e faturados diretamente pelos respectivos fornecedores.\n O Papel do Suporte Z-PRO: Nossa equipe de suporte garante que a capacidade de integração do Z-PRO – como o envio correto de webhooks e a conexão com as APIs de canais – esteja funcionando conforme o esperado. O escopo do nosso suporte não inclui:\n A criação, depuração ou otimização de fluxos no N8N ou Typebot.\n A configuração de contas em plataformas de terceiros.\n A escrita de código ou a configuração de sistemas para receber webhooks.\n * O diagnóstico de problemas de instabilidade em APIs externas (como as de canais não oficiais).\n\nO Z-PRO fornece os "pontos de conexão"; a construção e a manutenção da lógica dentro das ferramentas externas são de responsabilidade do administrador da plataforma.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/ferramentas-de-automacao-e-apis.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Integração com IA (inteligência artificial)\n\n{% hint style="success" %}\nO Z-PRO permite a conexão direta com uma variedade de Modelos de Linguagem (LLMs) de ponta. Essa abordagem oferece a flexibilidade de escolher a "inteligência" que melhor se alinha às suas necessidades de negócio, enquanto o Z-PRO cuida da conexão dessa IA com seus clientes.\n\nA integração é feita via API, o que requer que você possua as credenciais de acesso do modelo de IA que deseja utilizar. Abaixo, detalhamos os principais modelos suportados e suas características.\n{% endhint %}\n\n## Modelos de IA Suportados e Suas Diferenças\n\nCada modelo possui uma especialidade e um "perfil" de resposta. A escolha dependerá do tipo de interação que você deseja automatizar.\n\n### 1. ChatGPT (da OpenAI)\n\n O que é: É o modelo de linguagem mais conhecido e amplamente utilizado, reconhecido por sua versatilidade e fluidez conversacional.\n Diferencial: Excelente na compreensão de instruções complexas e na geração de texto criativo e natural. É um ótimo ponto de partida para a maioria das aplicações de chatbot.\n Ideal para: Atendimento ao cliente geral, automação de FAQs, geração de rascunhos de e-mail e tarefas que exigem um diálogo mais humano.\n\n### 2. Gemini (do Google)\n\n O que é: É o modelo de IA do Google, projetado com forte capacidade de raciocínio e acesso ao vasto conhecimento do Google.\n Diferencial: Frequentemente se destaca em tarefas que exigem precisão, lógica e informações factuais. É construído para ser multimodal, compreendendo nativamente informações de texto, imagens e outros formatos.\n Ideal para: Chatbots que precisam fornecer dados precisos, assistentes que realizam tarefas baseadas em raciocínio lógico e automações que precisam de informações atualizadas.\n\n### 3. Claude (da Anthropic)\n\n O que é: Um modelo focado em segurança, interpretação de texto e diálogo ético.\n Diferencial: Sua principal característica é a "janela de contexto" extremamente grande, permitindo processar e analisar documentos ou históricos de conversas muito longos de uma só vez, com alta capacidade de resumo e interpretação.\n Ideal para: Análise de grandes volumes de texto (como contratos ou tickets de suporte extensos), atendimento ao cliente que exige um tom mais cauteloso e profissional, e resumo de interações complexas.\n\n### 4. Grok (da xAI)\n\n O que é: O modelo de IA desenvolvido pela xAI, com a particularidade de ter acesso em tempo real a informações da plataforma X (antigo Twitter).\n Diferencial: Possui um tom mais direto, com senso de humor e a capacidade de responder perguntas com base em dados e tendências sociais muito recentes.\n Ideal para: Casos de uso que se beneficiam de informações em tempo real, como monitoramento de marca, e para criar chatbots com uma personalidade mais ousada e engajadora.\n\n### 5. Deepseek\n\n O que é: Um modelo de IA altamente especializado em tarefas relacionadas a código e programação.\n Diferencial: Seu desempenho na geração, tradução e explicação de código é seu ponto mais forte, superando muitos modelos generalistas nessa área específica.\n Ideal para: Empresas de tecnologia que precisam automatizar o suporte técnico de primeiro nível, criar documentação de código ou desenvolver ferramentas internas para suas equipes de engenharia.\n\n### 6. Qwen (da Alibaba Cloud)\n\n O que é: Uma família de modelos de código aberto desenvolvida pela Alibaba, com forte desempenho em múltiplos idiomas.\n Diferencial: É uma alternativa de código aberto robusta aos modelos proprietários, com excelente performance especialmente em inglês e mandarim.\n Ideal para: Aplicações que exigem suporte multilíngue e para empresas que buscam uma solução de IA de alto desempenho sem depender de um único fornecedor de API.\n\n### 7. Ollama (Framework para Modelos Self-Hosted)\n\n O que é: Ollama não é um modelo de IA, mas sim uma ferramenta que simplifica a execução de diversos modelos de código aberto (como Llama, Mistral, e o próprio Qwen) em seu próprio servidor.\n Diferencial: Oferece controle total sobre a IA e os dados, garantindo máxima privacidade, pois nenhuma informação sai da sua infraestrutura. Permite rodar modelos offline.\n Ideal para: Empresas com políticas rígidas de privacidade de dados, aplicações que precisam funcionar sem conexão com a internet e para quem deseja experimentar diferentes modelos open source com menor custo.\n\n### 8. LM Studio (Interface para Modelos Self-Hosted)\n\n O que é: Assim como o Ollama, o LM Studio é uma aplicação que permite descobrir, baixar e executar modelos de linguagem (LLMs) localmente em seu próprio computador ou servidor.\n Diferencial: Sua principal vantagem é a interface gráfica amigável, que facilita o gerenciamento de diferentes modelos de código aberto sem a necessidade de comandos complexos no terminal. Ele cria um servidor local compatível com a API da OpenAI, o que torna a integração com o Z-PRO extremamente simples.\n Ideal para: Desenvolvedores e entusiastas que desejam testar e comparar facilmente vários modelos open source, e para criar um ambiente de desenvolvimento local antes de implantar uma solução de IA em um servidor de produção.\n\n*\n\n## Requisitos de Integração\n\n* Chaves de API e Contas Ativas: Para utilizar qualquer um desses modelos, você deve primeiro ter uma conta no respectivo provedor (OpenAI, Google, etc.) e gerar uma chave de API para inserir no painel do Z-PRO.\n* Custos de Uso: O consumo de tokens e outros custos associados ao uso desses modelos são de sua responsabilidade e faturados diretamente pelo provedor da IA.\n* Infraestrutura para Self-Hosted: Para soluções como o Ollama, é necessário um servidor com a capacidade de hardware adequada para executar o modelo de IA escolhido.\n\nPróximo Passo:**\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/integracao-com-ia-inteligencia-artificial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Requisitos e Responsabilidades\n\n{% hint style="success" %}\nO Z-PRO é uma solução auto-hospedada (self-hosted). Este modelo concede controle total sobre a plataforma e os dados. Esta página detalha a infraestrutura necessária e a divisão de responsabilidades entre o cliente e o Z-PRO.\n{% endhint %}\n\n### Quais são os requisitos de servidor (VPS)?\n\nO Z-PRO é instalado em um ambiente de servidor controlado pelo cliente. Para que a plataforma opere com a performance e estabilidade esperadas, o servidor (VPS) precisa atender a especificações mínimas.\n\nRequisitos Mínimos Recomendados:\n\n Memória RAM: 16 GB ou mais\n Processador (vCPU): 4 núcleos ou mais\n Armazenamento: 200 GB SSD ou NVMe\n Sistema Operacional: Ubuntu 20.04 ou 22.04 LTS (sem painel de gestão como cPanel)\n Arquitetura: AMD\n\nEstes são os requisitos para um início de operação. À medida que o número de usuários, conexões e o volume de mensagens aumentam, pode ser necessário ampliar os recursos do servidor para manter a performance.\n\n{% hint style="info" %}\nPara detalhes técnicos completos:\\n→ Ver Requisitos de Uso Detalhados\n{% endhint %}\n\n**\n\n### Quem é responsável pela manutenção e segurança?\n\nNo modelo auto-hospedado, a responsabilidade pela gestão do ambiente operacional é do cliente. A seguir, são detalhadas as responsabilidades de cada parte.\n\n#### Responsabilidades do Cliente (Administrador da Plataforma)\n\n Manutenção do Servidor (VPS): Garantir que o servidor esteja online, funcional e com os recursos adequados para a demanda da operação.\n Aplicação de Atualizações: O Z-PRO disponibiliza as atualizações do software, mas a execução e a aplicação dessas atualizações no ambiente do cliente são de responsabilidade do mesmo.\n Segurança da Infraestrutura: Implementar e gerenciar boas práticas de segurança, como a configuração de firewalls, controle de portas de acesso (SSH, etc.) e proteção contra acessos não autorizados.\n Backups: A criação e a gestão de rotinas de backup dos dados da aplicação são de inteira responsabilidade do cliente.\n\n#### Responsabilidades do Z-PRO (Fornecedor do Software)\n\n Fornecer um Software Funcional: Entregar uma plataforma estável e testada.\n Disponibilizar Atualizações: Lançar periodicamente atualizações com melhorias, novas funcionalidades e correções de segurança.\n Garantir a Segurança do Código: Assegurar que o código-fonte do Z-PRO não possua vulnerabilidades conhecidas.\n\n{% hint style="warning" %}\nInformação Importante: O Z-PRO não possui acesso ao servidor do cliente após a instalação inicial. Toda a gestão, manutenção e segurança contínuas do ambiente de hospedagem são responsabilidades do cliente.\\n→ Ler a Política de Manutenção e Segurança\n{% endhint %}\n\n**\n\n### Qual é o escopo do Suporte Técnico?\n\nO escopo do suporte técnico do Z-PRO é definido para garantir clareza no atendimento. A seguir, estão os detalhes sobre os canais, horários e as responsabilidades cobertas.\n\n{% hint style="success" %}\nCanal Oficial e Horários\\nO suporte técnico opera exclusivamente através do nosso sistema de tickets (Tomticket), de segunda a sexta-feira, das 8h às 18h, com um tempo para a primeira resposta de até 24 hours úteis. Não há atendimento de suporte técnico via WhatsApp.\n{% endhint %}\n\n#### O que o suporte COBRE:\n\n Bugs e Falhas no Software Z-PRO: Diagnosticar e corrigir problemas que são comprovadamente falhas no código da plataforma.\n Dúvidas sobre Funcionalidades Nativas: Orientar sobre como utilizar os recursos existentes no Z-PRO (ex: criação de usuários, funcionamento do painel Super Admin, etc.).\n Auxílio na Instalação Inicial: Conforme incluído na licença anual.\n\n#### O que o suporte NÃO COBRE:\n\n Problemas de Infraestrutura: Lentidão no servidor, falhas de conexão, configurações de firewall, falta de recursos (RAM, CPU, etc.).\n Configuração de Ferramentas de Terceiros: Criação de fluxos no N8N, Typebot, configuração de contas na OpenAI, Google, etc.\n Desenvolvimento Personalizado: Criação de novas funcionalidades sob demanda ou customização do código da aplicação.\n Gestão e Manutenção do Servidor: Execução de atualizações, backups ou configurações de segurança no VPS do cliente.\n Consultoria de Negócios: Orientação sobre como criar fluxos de chatbot, estratégias de vendas ou modelos de negócio.\n\n{% hint style="warning" %}\nPara os detalhes do nosso compromisso de serviço:\\nA política completa, com prazos, canais e o escopo detalhado do atendimento, pode ser consultada no link abaixo.\\n→ Ler a Política de Suporte Técnico (SLA) Completa\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/conheca-o-z-pro/requisitos-e-responsabilidades.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Diretrizes E Politicas
Diretrizes e Políticas\n\nA seção "Diretrizes da Plataforma" reúne os documentos fundamentais que definem a relação técnica, operacional e legal para o uso do software Z-PRO.\n\nA leitura destes artigos é recomendada para todos, pois eles estabelecem as bases de responsabilidades, requisitos e políticas que garantem o bom funcionamento e a segurança da sua instalação.\n\nNesta seção você encontrará os seguintes artigos:\n\n Termos e Condições de Uso\n Requisitos de Uso\n Política de Suporte Técnico\n Manutenção e Segurança\n API Oficial e Não Oficial (WhatsApp)\n Aviso de Privacidade\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
API Oficial vs API Não Oficial\n\n{% hint style="success" %}\nA API Oficial (WABA) é a conexão direta e garantida pela Meta (dona do WhatsApp), oferecendo máxima estabilidade e segurança, mas com custos por conversa. As APIs Não Oficiais são conexões alternativas, sem custo inicial de mensagem, mas sem garantia de estabilidade. O Z-PRO suporta ambas as opções, dando a você liberdade para escolher a que melhor se adapta ao seu modelo de negócio.\n{% endhint %}\n\nO Z-PRO suporta quatro categorias de conexão com o WhatsApp, cada uma com diferentes níveis de estabilidade, custo e responsabilidade:\n\n1. API Oficial (WABA): A conexão direta e garantida pela Meta, com máxima estabilidade e custos por conversa.\n2. APIs Não Oficiais Nativas (via QR Code): Conexões incluídas no Z-PRO (Baileys e WWebJS), sem custo adicional, mas com responsabilidade de estabilidade do usuário.\n3. APIs Não Oficiais Gerenciadas (Pagas): Serviços de terceiros (Z-API, Uazapi) que oferecem a conexão como um serviço pago, com suporte e estabilidade gerenciados por eles.\n4. APIs Não Oficiais Auto-hospedadas (Self-Hosted): Aplicações externas (Evolution API) que o usuário instala e gerencia em seu próprio servidor.\n\nA escolha da API de conexão do WhatsApp é uma das decisões técnicas e de negócio mais importantes para a sua operação. Ela define o equilíbrio entre custo, controle e confiabilidade do seu serviço.\n\n## 1. API Oficial (WABA - WhatsApp Business API)\n\nA API Oficial é o caminho legítimo, construído e mantido pela própria Meta para que empresas se comuniquem em escala.\n\n✅ Principais Vantagens:\n\n Estabilidade Garantida: Por ser a solução oficial, ela é extremamente confiável, com garantia de funcionamento de 100% da parte da Meta e do Z-PRO.\n Máxima Segurança: A comunicação é criptografada e segue todas as políticas de segurança da Meta.\n Credibilidade e Acesso a Recursos: Usar a API Oficial transmite profissionalismo e segurança. Além disso, garante acesso antecipado a novas funcionalidades que a Meta lança para o ambiente de negócios, como novos tipos de botões e formatos de mensagem.\n\n⚠️ Pontos a Considerar:\n\n Custo por Conversa: A Meta cobra por "janelas de conversa" de 24 horas. As primeiras 1.000 conversas iniciadas pelo cliente por mês são gratuitas, mas as demais são pagas. Clique aqui se quer entender sobre os custos: https://business.whatsapp.com/products/platform-pricing\n Processo de Aprovação: Requer a criação de uma conta no Gerenciador de Negócios da Meta e a verificação da empresa. Explicamos nesse vídeo: https://www.youtube.com/watch?v=sLp5P9Qb50w\n\n**\n\n## 2. APIs Não Oficiais Nativas (Conexão via QR Code)\n\nEstas são as opções de conexão não oficial incluídas por padrão no Z-PRO, ativadas através da leitura de um QR Code.\n\n✅ Vantagens:\n\n Sem Custo Adicional: O uso destas APIs está incluso no valor da licença do Z-PRO.\n Simplicidade de Conexão: A ativação é rápida e direta pelo painel administrativo.\n\n⚠️ Pontos a Considerar:\n\n Instabilidade: Por não serem oficiais, estão sujeitas a desconexões quando o WhatsApp atualiza sua plataforma.\n Risco de Bloqueio: A utilização de qualquer sistema não oficial infringe os Termos de Serviço do WhatsApp, o que representa um risco contínuo de o número ser banido.\n Responsabilidade do Usuário: A estabilidade da conexão é de responsabilidade do administrador da plataforma.\n\nAs duas tecnologias nativas disponíveis são:\n\n Baileys: Interage diretamente com o protocolo WebSocket (WAM) do WhatsApp. É uma abordagem mais leve e com melhor performance, mas historicamente apresenta menor compatibilidade com o gerenciamento de conversas em grupos.\n WWebJS: Simula a interface do WhatsApp Web em um navegador no servidor. É uma tecnologia mais pesada e mais lenta para carregar, mas tende a ter maior compatibilidade com todas as funcionalidades, incluindo grupos.\n\nO Z-PRO oferece ambas as opções para que o administrador escolha a tecnologia mais adequada à sua necessidade.\n\n**\n\n## 3. APIs Não Oficiais Auto-hospedadas (Self-Hosted)\n\nEstas são aplicações de código aberto que você mesmo instala e gerencia em seu próprio servidor, de forma separada do Z-PRO.\n\n Exemplos: Evolution API, Wuzapi (Meow)\n\n✅ Vantagens:\n\n Custo Reduzido: Não há mensalidades para o uso da API em si, apenas os custos de manter seu servidor.\n Controle Total: O administrador tem total governança sobre a instalação e os dados da API externa.\n\n⚠️ Pontos a Considerar:\n\n Responsabilidade Total: O usuário é o único responsável por instalar, manter, atualizar e garantir a estabilidade da API externa.\n Complexidade Técnica: Exige um maior conhecimento técnico para a instalação e manutenção.\n\n**\n\n## 4. APIs Não Oficiais Gerenciadas (Pagas)\n\nEstas são soluções oferecidas como um serviço (SaaS) por empresas externas especializadas. Elas criam e mantêm a conexão não oficial, cobrando uma mensalidade pelo serviço.\n\n Exemplos: Z-API, Uazapi \n\n✅ Vantagens:\n\n Estabilidade Gerenciada: A empresa provedora da API é responsável por manter a conexão funcionando, reduzindo a carga de manutenção do administrador do Z-PRO.\n Suporte Externo: O usuário conta com o suporte técnico da empresa que fornece a API para resolver problemas de conexão.\n\n⚠️ Pontos a Considerar:\n\n Custo Mensal: Há uma taxa de assinatura recorrente paga diretamente ao provedor da API.\n Risco de Bloqueio: Embora gerenciadas, ainda operam sob os mesmos riscos de qualquer API não homologada pela Meta.\n\n{% hint style="warning" %}\nStatus Atual no Z-PRO:\\nAs integrações com as APIs Z-API e Uazapi estão atualmente em fase de desenvolvimento e testes em nossa plataforma.\n{% endhint %}\n\n### Riscos\n\nPor questões de flexibilidade, habilitamos o suporte para APIs não oficiais no sistema. No entanto, é importante destacar que o uso de APIs não oficiais pode apresentar riscos como:\n\n Desconexões frequentes\n Perda de mensagens enviadas ou recebidas\n Instabilidade no funcionamento\n\n{% hint style="danger" %}\nReforçamos que não garantimos a estabilidade ou o suporte pleno para conexões realizadas por APIs não oficiais. Recomendamos fortemente o uso da API Oficial do WhatsApp para garantir a melhor experiência e evitar problemas operacionais.\n{% endhint %}\n\n### Informações e Recomendações\n\n Antes de conectar seu WhatsApp no sistema, remova a conexão com o WhatsApp Web.\n Depende do smartphone.\n Necessita de reconexão periódica.\n Para o perfeito funcionamento, mantenha o telefone sincronizado sempre ligado e conectado a internet, desative o descanso de tela e mantenha o app do WhatsApp aberto\n Arquive pelo celular conversas dispensáveis ou mais antigas\n Recomendamos o uso do navegador Chrome e do sistema operacional Windows\n Não abrir o WhatsApp Web com o número sincronizado na plataforma em outro navegador. Caso isso aconteça, o funcionamento poderá ser impactado\n\n### Conexão de Múltiplos Números na API Não Oficial e Riscos Associados\n\nAo conectar múltiplos números de WhatsApp na mesma aplicação e compartilhar o mesmo endereço de IP e infraestrutura física (como uma VPS), há um risco significativo de que o WhatsApp identifique essa prática como um comportamento irregular. Isso pode resultar em:\n\n Marcações do IP ou da infraestrutura pela Meta\n Desconexões frequentes e redução da estabilidade\n Risco de banimento permanente de números conectados\n Bloqueios em cascata, afetando todos os clientes na mesma plataforma\n\nAlém disso, o uso de campanhas de disparo em massa intensifica esses problemas, já que tais atividades são frequentemente detectadas como abuso, aumentando as chances de marcação da infraestrutura e dos números envolvidos.\n\n{% hint style="warning" %}\nImportante: Uma vez que a infraestrutura seja marcada pelo WhatsApp, todos os números conectados à plataforma podem sofrer consequências em cascata. Recomendamos seguir as melhores práticas e, sempre que possível, priorizar o uso da API Oficial do WhatsApp para garantir maior estabilidade e segurança para sua operação.\n{% endhint %}\n\n#### Recomendações:\n\n1. Escala Horizontal: Avalie separar números em diferentes aplicações ou servidores para distribuir a carga e reduzir o compartilhamento do IP.\n2. Uso de Proxies: Configure proxies dedicados para isolar as conexões e minimizar os riscos de detecção e marcação de infraestruturas compartilhadas.\n3. Evite Disparos em Massa: Sempre utilize práticas éticas e que respeitem os termos de uso do WhatsApp.\n\n{% hint style="info" %}\nSe tiver dúvidas ou precisar de suporte para configurar a API Oficial, nossa equipe está à disposição para ajudar!\n{% endhint %}\n\n## Bloqueios e Banimentos\n\n{% hint style="danger" %}\nExiste alguma possibilidade do WhatsApp bloquear meu número?\n\nSIM, A POSSIBILIDADE EXISTE!\n{% endhint %}\n\n### O WHATSAPP NÃO TOLERA SPAM!\n\nO WhatsApp leva o combate ao spam muito a sério, o que faz com que a plataforma seja mais valorizada do que o SMS. Já percebeu como ignoramos mensagens acumuladas no SMS, mas paramos tudo para ver um WhatsApp? Isso acontece porque as mensagens geralmente vêm de contatos conhecidos, e promoções são bem menos frequentes por lá.\n\n## Por que recebi o aviso "Aguardando mensagem. Essa ação pode levar alguns instantes."?\n\n{% embed url="https://faq.whatsapp.com/3398056720476987/?locale=pt_BR" %}\n\nÀs vezes, o aviso acima poderá ser exibido no lugar de uma mensagem. No WhatsApp, suas mensagens pessoais são protegidas com a criptografia de ponta a ponta. Dessa forma, elas ficam somente entre você e a pessoa com quem você está conversando. Ninguém mais pode ler nem ouvir o conteúdo dessas conversas, nem mesmo o WhatsApp. Existem alguns motivos para que uma mensagem seja substituída pelo aviso "Aguardando mensagem. Essa ação pode levar alguns instantes.":\n\n Não foi possível entregar a mensagem.\n Você ou a outra pessoa reinstalou o WhatsApp recentemente.\n Você ou a outra pessoa não está usando a versão mais recente do WhatsApp.\n Você trocou de celular e instalou o WhatsApp em um dispositivo novo usando o mesmo número de telefone.\n\nÉ possível seguir algumas etapas para tentar solucionar o problema.\n\n### Acesse o WhatsApp\n\nAbra o app e peça para que a outra pessoa acesse o WhatsApp ao mesmo tempo que você.\n\n### Verifique sua conexão à internet\n\nConfira se sua conexão à internet é estável. Experimente alternar sua conexão entre rede Wi-Fi e dados móveis. Se não houver uma rede Wi-Fi disponível ou se a rede de dados móveis estiver instável, procure um local onde sua conexão funcione melhor.Saiba como resolver problemas de conexão no WhatsApp neste artigo.\n\n### Atualize o WhatsApp\n\nConfira se você e a pessoa com quem você está conversando têm a versão mais recente do WhatsApp instalada no dispositivo. Saiba como atualizar o WhatsApp neste artigo.\n\n### Peça para que a pessoa envie a mensagem novamente\n\nCaso a mensagem não tenha sido entregue, peça para que a outra pessoa envie a mensagem novamente.\n\n### Use seu dispositivo principal\n\nAcesse o WhatsApp no seu dispositivo Android ou iOS principal. O dispositivo principal é o celular usado para registrar sua conta do WhatsApp.Observação: para que os demais dispositivos permaneçam conectados à sua conta, é necessário acessar o WhatsApp no seu celular principal a cada 14 dias.\n\n### Desconecte o dispositivo e conecte-o novamente\n\nSiga as etapas apresentadas neste artigo para desconectar seu dispositivo conectado e conectá-lo novamente.\n\n### Respondendo às Suas Principais Dúvidas\n\n1. O que exatamente o Z-PRO garante?\\nNós oferecemos 100% de garantia de funcionalidade e estabilidade para a API Oficial. Para as APIs não oficiais, nós garantimos que nossa plataforma está pronta para se conectar, mas o funcionamento e a estabilidade da conexão em si dependem de fatores externos que estão fora do nosso controle.\n\n2. Se a API Oficial é melhor, por que alguém usaria a Não Oficial?\\nPrincipalmente por dois motivos: custo e simplicidade inicial. Para quem está começando, testando uma ideia ou tem um volume muito baixo de mensagens, a API não oficial permite iniciar uma operação sem o custo por conversa e com menos burocracia.\n\n3. Qual é o custo real da API Oficial?\\nA cobrança é feita pela Meta e varia por país. Ela se baseia em "conversas" de 24 horas. Por exemplo, no Brasil, uma conversa iniciada pela empresa custa alguns centavos de dólar. Para ver a tabela de preços oficial e atualizada, você pode consultar diretamente a página da Meta: Página de Preços da API do WhatsApp\n\n*4. Usar a API Não Oficial pode bloquear meu número?\\nSim, o uso de qualquer sistema não oficial vai contra os termos de serviço do WhatsApp. O risco de bloqueio sempre existirá. Por isso, para operações críticas e de longo prazo, a recomendação é sempre a API Oficial.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Aviso de Privacidade\n\n## Módulo Z-PRO\n\nData de disponibilização: 22/05/2024\n\n\n\nOi, Titular!\n\nA Comunidade ZDG tem um compromisso sério com a privacidade e a proteção dos dados pessoais das pessoas impactadas pelas suas atividades. Por isso, criamos este Aviso de Privacidade (o “Aviso”), para informar você como coletamos, utilizamos, processamos e compartilhamos, quando estritamente necessário, dados pessoais quando você executa e utiliza o Z-PRO.\n\nO Z-PRO é um Software as a Service que permite aos seus Usuários a otimização da comunicação com leads e clientes, através de uma plataforma de multiatendimento de gestão de atividades e mensagens via Plataforma WhatsApp, durante o uso da licença pelo período contratado no Plano de Assinatura adquirido, de acordo com os Termos e Condições de Uso do Z-PRO\[1] .\n\nPara que nossa relação seja transparente e adequada à Lei Geral de Proteção de Dados Pessoais (a “LGPD”), criamos este AVISO DE PRIVACIDADE (o “Aviso”), através do qual informaremos a você como coletamos, utilizamos, processamos e divulgamos suas informações e dados pessoais, quando do seu acesso e uso do Z-PRO Software as a Service, nosso Site e nossas landing pages.\n\nComo você vai perceber, nós coletamos o mínimo possível de Dados Pessoais na prestação dos nossos serviços e optamos por não ter acesso a nenhum Dado Pessoal a que não precisamos ter, efetivamente, acesso, para cumprimento de nossas atividades.\n\nLeia atentamente este documento e, na hipótese de ter algum questionamento, querer manifestar alguma inconformidade sobre o tratamento de dados pessoais que realizamos ou desejar exercer seus direitos de titular, não utilize nosso Software as a Service, nosso Site e nossas landing pages e falem imediatamente conosco no nosso Canal de Atendimento | https://comunidadezdg.com.br/fale-com-a-zdg ou [email protected] .\n\nEste Aviso de Privacidade integra de forma indissociável os Termos e Condições de Uso, que definem as condições da utilização do Site, então não deixe de ler esse documento também.\n\n\n\n## QUAIS AS INFORMAÇÕES QUE VOCÊ ENCONTRARÁ NESTE AVISO\n\n1\. CONCEITOS IMPORTANTES PARA ESTE AVISO\n\n2\. A QUEM SE APLICA ESTE AVISO?\n\n3\. PAPÉIS E RESPONSABILIDADES NO TRATAMENTO DE DADOS PESSOAIS\n\n3.1. COMO SÃO TRATADOS OS DADOS PESSOAIS DE QUEM UTILIZA O MÓDULO Z-PRO E O NOSSO SITE\n\n3.1.3. Dados coletados quando você interage com as nossas redes sociais\n\n4\. COMPARTILHAMENTO DE DADOS PESSOAIS\n\n5\. LINK PARA SITES/PLATAFORMAS DE TERCEIROS\n\n6\. COMO PROTEGEMOS SEUS DADOS\n\n7\. SAIBA OS SEUS DIREITOS E COMO EXERCÊ-LOS\n\n8\. POR QUANTO TEMPO ARMAZENAMOS SEUS DADOS?\n\n9\. DISPOSIÇÕES GERAIS\n\n10\. CANAL DE COMUNICAÇÃO\n\n\n\n## CONCEITOS IMPORTANTES PARA ESTE AVISO\n\nAlguns conceitos para auxiliar na compreensão deste Aviso\n\nAnonimização. Processo pelo qual os dados pessoais coletados se tornam arquivos armazenados pelo Controlador tornando impossível a identificação da pessoa a quem tais dados se referem.\n\nANPD. Autoridade Nacional de Proteção de Dados, órgão da administração pública responsável por zelar, implementar e fiscalizar o cumprimento da LGPD em todo o território nacional.\n\nCliente. Pessoa que efetua o pagamento da licença de uso do Z-PRO e determina quem são os Usuários cadastrados no seu dashboard.\n\nControlador. O responsável pelas decisões referentes ao tratamento de dados dos titulares afetados por uma atividade.\n\nDados Pessoais. Informações que identificam uma pessoa natural, como por exemplo: e-mail, CPF, telefone e endereço.\n\nDados Pessoais Sensíveis. Dado pessoal sobre origem racial ou étnica, convicção religiosa, opinião, filiação a sindicato ou a organização de caráter religioso, filosófico ou político, dado referente à saúde ou à vida sexual, dado genético ou biométrico.\n\nIP. O endereço IP é o código atribuído a um terminal de uma rede para permitir sua identificação, definido segundo parâmetros internacionais.\n\nLGPD. Lei Geral de Proteção de Dados Pessoais, Lei n° 13.709/2018, que dispõe sobre o tratamento e proteção de dados.\n\nOperador. Quem realiza o tratamento de dados segundo as orientações do Controlador.\n\nPassaporte ZDG. Plataforma que oferece soluções de autoatendimento 24h através de chatbots, gerenciamento de atendimentos e envio de mensagens via Plataforma WhatsApp e Plataforma Telegram para o seu público-alvo.\n\nPlano de Assinatura. Plano de contratação aderido por clique pelo Cliente, diretamente nas Plataformas de Compras parceiras, de acordo com os seus termos de uso, avisos de privacidade e condições de compra.\n\nPlataforma WhatsApp. Plataforma de propriedade da WhatsApp LLC, sobre a qual poderá ser executado o Software as a Service Z-PRO, de acordo com o Plano de Assinatura contratado e os termos de uso da plataforma, no link https://www.whatsapp.com/legal/.\n\nPlataforma Telegram. Plataforma de propriedade da Telegram Messenger Inc., sobre a qual poderá ser executado o Software as a Service Z-PRO, de acordo com o Plano de Assinatura contratado e os termos de uso da plataforma, no link https://telegram.org/tos/br.\n\nSite. O site do Z-PRO, disponível no link “https://comunidadezdg.com.br/passaporte”.\n\nTratamento de Dados. Toda operação realizada com dados pessoais, como as que se referem à coleta, produção, recepção, classificação, utilização, acesso, reprodução, transmissão, distribuição, processamento, arquivamento, armazenamento, eliminação, avaliação ou controle da informação, modificação, comunicação, transferência, difusão ou extração.\n\nTitulares. Pessoa física a quem se referem os dados pessoais objeto de Tratamento por Controladores e Operadores.\n\nUsuário. Pessoa indicada pelo Cliente para utilização de licença do Z-PRO, podendo ser:\n\n● Usuário Administrador (o “Admin”). Pessoa com visibilidade sobre as funcionalidades de gestão da equipe.\n\n● Usuário Interno. Pessoa física cadastrada pelo Admin para acesso e utilização do Z-PRO.\n\n● Usuário do Site. Pessoa física que utiliza o Site do Z-PRO, mas não interage com a plataforma.\n\nZ-PRO. Módulo do Passaporte ZDG que disponibiliza um Software as a Service (SaaS), acessível no ambiente web, que proporciona a otimização de atendimento de leads e clientes do Cliente e dos Usuários na Plataforma WhatsApp e na Plataforma Telegram, através de suas diversas funcionalidades.\n\n\n\n## A QUEM SE APLICA ESTE AVISO?\n\nEste Aviso de Privacidade (Aviso) se aplica aos Usuários do Z-PRO e do Site.\n\n\n\n## PAPÉIS E RESPONSABILIDADES NO TRATAMENTO DE DADOS PESSOAIS\n\nPessoas responsáveis pelo tratamento de dados pessoais de Titulares\n\nA Bianca Sant Ana Pereira 10398514607 ME, pessoa jurídica de direito privado, inscrita no CNPJ sob o nº 35.617.749/0001-67, com endereço na Rua Alaor Ferreira da Fonseca, n. 295, bairro Jardim América, em Alfenas/MG, CEP: 37.136-132, é a responsável pelo tratamento dos dados pessoais dos Usuários do Z-PRO e do Site, agindo como Controladora desses dados.\n\nTodavia, quando um Cliente do Z-PRO usa a sua licença, ele também age como Controlador Conjunto sobre esses dados, sendo indispensável que mantenha suas próprias políticas e medidas técnicas e administrativas de controle e proteção de dados pessoais. É fundamental que o Cliente e seus Usuários, por exemplo, assumam integralmente a obrigação de inclusão das operações realizadas pelo Z-PRO nos avisos de privacidade necessários, bem como que obtenha todos os\n\nconsentimentos aplicáveis, sendo responsabilidade do Cliente e de seus Usuários a manutenção do Tratamento de Dados de acordo com a legislação.\n\nPara fazer a contratação de Plano de Assinatura, o cliente deverá realizar a compra da licença de uso por tempo determinado na Plataforma de Pagamento Parceira. Essa Plataforma de Pagamento também é Controladora dos dados, na medida em que processa os dados pessoais de titulares para sua devidas finalidades.\n\nA Bianca Sant Ana Pereira 10398514607 ME não é e nem será responsável pelo Tratamento de Dados realizado por terceiros, dentro ou fora do seu Software as a Service.\n\n### COMO SÃO TRATADOS OS DADOS PESSOAIS DE QUEM UTILIZA O MÓDULO Z-PRO E O NOSSO SITE\n\n#### Dados coletados para acesso ao Z-PRO\n\nPara cadastro e criação de Usuário, são coletados os seguintes dados:\n\n● Nome\n\n● Telefone\n\n● E-mail\n\n● IP\n\n● Senha\n\n● Aceite de Termos e Condições de Uso\n\n#### Dados coletados para comunicação com Usuários\n\nPara comunicação com o Titular, são coletados os seguintes dados:\n\n● Nome\n\n● Telefone\n\n● E-mail\n\n#### Dados coletados quando você interage com as nossas redes sociais\n\nColetamos os dados necessários para entrar em contato com você, como nome, e-mail e telefone.\n\nOs dados pessoais que podem ser acessados são:\n\n● Nome\n\n● Telefone\n\n● Foto de WhatsApp\n\n#### Dados coletados indiretamente e cookies\n\nA nossa empresa pode coletar indiretamente durante a utilização do Z-PRO pelo Usuário, como endereço IP, sessão, registros de data e horário de ações, aceite de Termos e Condições de Uso, atividades no nosso Software as a Service etc, por meio de webhooks e cookies, que serão tratados em um item específico.\n\n#### Logs de aplicação\n\nSão coletados os registros de acesso, conjunto de informações referentes à data e hora de uso de uma determinada aplicação de internet a partir de um determinado endereço IP, nos termos da Lei nº 12.965/2014 (Marco Civil da Internet).\n\nEsse registro somente pode ser acessado através de mandado judicial.\n\n#### Cookies\n\nNo nosso Site, temos um banner de cookies\[1] que pode ser acessado sempre que você quiser acessar e setar as configurações de privacidade nas nossas atividades e mudar as configurações relacionadas ao seu consentimento sobre o que puder ser alterado.\n\nEsse banner é dividido em duas telas, na primeira tela, você pode decidir se quer:\n\n● Aceitar todos os nossos cookies\n\n● Rejeitar os cookies não necessários\n\n● Configurar o seu aceite, de acordo com as suas preferências.\n\nSe você optar por configurar o seu aceite, você consegue ver que nosso Site utiliza diversos tipos de cookies para aprimorar a sua experiência e customizar a sua navegação, que podem estar divididos em 5 grandes “famílias”, são elas:\n\n● Cookies necessários\n\nOs cookies necessários são essenciais para o funcionamento do site, sem eles o site não funcionaria corretamente (por exemplo, acesso a áreas seguras do site, segurança, legislação).\n\n● Cookies de performance\n\nOs cookies de desempenho permitem que o site se comporte de acordo com o visitante, ajustando-se à sua localização, idioma preferido, etc.\n\n● Cookies funcionais\n\nOs cookies funcionais ajustam o site a serviços de terceiros, como links para seu perfil em redes sociais, comentários, chatbots, etc.\n\n● Cookies de marketing\n\nOs cookies de marketing ou publicidade rastreiam a navegação dos visitantes e coletam dados para que a empresa possa fornecer anúncios mais relevantes de acordo com tal comportamento.\n\n● Cookies de estatísticas\n\nOs cookies de estatísticas, ou análises, traduzem as interações dos visitantes em relatórios detalhados de comportamento, de maneira anônima.\n\nVocê pode conferir como cada cookie se comporta diretamente no nosso banner.\n\nDiferentes funcionalidades de cookies trazem diferentes bases legais de tratamento de dados, motivo pelo qual o Titular pode modular a sua aceitação na tela de configurações, optando ativamente por aqueles dados que consente em coletar. Eles vêm desativados por padrão, então se você não aceitou ou rejeitou todos no botão rápido da primeira tela, poderá selecionar os que consente em aceitar nessa segunda tela.\n\n### Da negativa de tratamento de dados de clientes\n\nO Z-PRO não tem acesso aos dados que os Usuários operam no Z-PRO.\n\nO Z-PRO não tem acesso aos dados dos contatos telefônicos dos Usuários do Z-PRO.\n\nO Z-PRO não tem acesso às conversas dos Usuários do Z-PRO.\n\n### Finalidades e bases legais do tratamento de dados pessoais\n\nOs dados pessoais tratados para acesso e utilização do Z-PRO serão utilizados apenas para atender as seguintes finalidades:\n\n| Dados Coletados | Finalidade | Base legal |\n| ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Informações de Cadastro de Cliente | Para formação do contrato e identificação do Usuário que adquire o direito de usar a Licença do Z-PRO e suas funcionalidades. | ● Execução de Contrato e procedimentos preliminares (art. 7º, V, LGPD) |\n| Informações de Cadastro de Usuário | Para identificação do Usuário que adquire o direito de usar a Licença do Z-PRO e suas funcionalidades. | ● Execução de Contrato e procedimentos preliminares (art. 7º, V, LGPD) |\n| Interações de Usuários com o Z-PRO em canais de comunicação e/ou atendimento. | Tornar o atendimento do Z-PRO mais eficiente e melhorar a experiência do Usuário. | ● Legítimo interesse (art. 7º, IX, LGPD) |\n| Endereço IP, sessão do Usuário, registros de data e horário de ações, dispositivo/navegador, as atividades do Usuário no site. | Coletar informações para identificar e proteger os Usuários, bem como cumprir com as obrigações legais. | ● Obrigação legal ou regulatória do Controlador (art. 7º, II, LGPD) - Atender ao Marco Civil da Internet (art. 15) ● Legítimo interesse do Controlador (art. 7º, IX, LGPD) |\n| Cookies necessários | Para registrar a ação de aceitação, modulação ou rejeição de cookies pelo Titular durante a navegação no Site. | ● Legítimo interesse do Controlador (art. 10, LGPD) |\n| Cookies funcionais, estatísticos, de performance e de marketing | Para personalização da experiência do Usuário, aprimorar as nossas funcionalidades e direcionar a publicidade para Usuários de acordo com o interesse dele na SAFIE. | ● Consentimento (art. 7º, I, LGPD) |\n\n### Veracidade dos dados\n\nO Usuário é responsável pela veracidade dos seus dados pessoais. A licença de uso do Z-PRO não contempla a responsabilidade pela conferência da autenticidade de dados do Cliente/Usuário e/ou outras ações de confirmação ou validação dos dados durante a utilização do Z-PRO.\n\nA licença de uso do Z-PRO não inclui a obrigatoriedade de processamento ou Tratamento de Dados fornecidos pelo Cliente ou pelo Usuário se pender suspeita motivada para crer que a realização da atividade possa causar infração de qualquer lei aplicável, bem como sobre a utilização indevida do Z-PRO pelo Cliente/Usuário, como para fins ilegais, ilícitos ou contrários a este Aviso ou aos Termos e Condições de Uso.\n\n\n\n## COMPARTILHAMENTO DE DADOS PESSOAIS\n\nO Z-PRO pode compartilhar os dados necessários para que seja possível a manutenção das suas operações de forma eficiente. Ou seja, dados poderão ser compartilhados com empresas contratadas para que as funcionalidades do Z-PRO estejam disponíveis e/ou para que forneçam uma melhor experiência para o Cliente e os Usuários.\n\nTerão acesso aos dados pessoais coletados para operação do Z-PRO, como Operadores de dados, os agentes terceirizados especializados para prestação de serviços pontuais e específicos para o nosso Software as a Service, tais como:\n\n● Plataforma Cloud Hetzner - servidores em nuvem - https://www.hetzner.com/legal/privacy-policy/\n\n● Plataforma WhatsApp - serviços de mensagens instantâneas - https://www.whatsapp.com/legal/\n\n● Plataforma Telegram - serviços de mensagens instantâneas - https://telegram.org/tos/br\n\nNo entanto, poderão ser que, para utilização do Z-PRO, o Cliente tenha que compartilhar dados pessoais com outros Controladores de dados, como as nossas parceiras:\n\n● Plataforma de Pagamento Hotmart - https://hotmart.com/pt-br/legal/privacidade-de-dados\n\n● Plataforma de Pagamento Greenn - https://greenn.com.br/politica-de-privacidade-greenn/\n\nNesse caso, você precisa entender que essas plataformas poderão solicitar dados pessoais que não são armazenados no Z-PRO para cumprir suas próprias obrigações relacionadas ao Tratamento de Dados. Antes de aceitar qualquer tipo de termo ou política de privacidade, informe-se bem.\n\nTodas as nossas contratações prezam pelo tratamento seguro das informações do Cliente/Usuário.\n\nA partir do momento que esses terceiros tiverem acesso aos dados compartilhados, serão responsáveis pelo seu tratamento em segurança, estando limitados às finalidades relacionadas ao serviço contratado e devendo respeitar a Lei aplicável.\n\n### Transferência Internacional de Dados\n\nAté o limite permitido pela LGPD, poderá haver o compartilhamento de dados fora do Brasil.\n\nEssa transferência internacional ocorre quando utilizamos serviços em nuvem para processamento ou armazenamento de dados, para que seja possível executar os nossos serviços da melhor forma, em um ambiente seguro.\n\nPara isso, utiliza-se os servidores cloud da Hetzner, que implica em uma transferência internacional dos dados pessoais para o país sede deste servidor, nos Estados Unidos da América. Outros servidores da Z-PRO ficam em São Paulo/SP, no Brasil.\n\nAo fazer isso, tomamos todas as medidas cabíveis para assegurar que os seus dados sejam tratados e compartilhados de forma segura e em conformidade com a legislação vigente e este Aviso de Privacidade.\n\n\n\n## LINK PARA SITES/PLATAFORMAS DE TERCEIROS\n\nNosso Site pode conter links para sites/plataformas de terceiros, como parceiros, anunciantes e redes sociais. Ao seguir um link, é importante observar que esses sites/plataformas têm seus próprios avisos e políticas de privacidade e que a nossa empresa não é responsável \u200b\u200bpor esses avisos e nem pela coleta de dados realizada. Recomendamos a verificação desses avisos e políticas antes de enviar quaisquer dados pessoais a esses terceiros.\n\n\n\n## COMO PROTEGEMOS SEUS DADOS\n\nO Z-PRO se compromete com a segurança de todos seus Usuários e, por isso, adota procedimentos físicos, eletrônicos e administrativos que garantem a privacidade e segurança dos seus dados, com medidas técnicas compatíveis com os padrões esperados e boas práticas de segurança da informação.\n\nSempre que possível, não coletamos dados sobre a sua utilização do Z-PRO.\n\nEm hipótese alguma, teremos acesso às suas conversas.\n\nTodas as tecnologias utilizadas e empregadas no Z-PRO respeitarão sempre a legislação vigente e os termos deste Aviso de Privacidade.\n\n\n\n## SAIBA OS SEUS DIREITOS E COMO EXERCÊ-LOS\n\nAcesso e confirmação de tratamento. Você pode solicitar o acesso à relação completa de dados coletados e tratados, bem como a confirmação do tratamento de seus dados pessoais.\n\nRetirada de consentimento. Você poderá retirar a sua anuência com o Tratamento de Dados Pessoais a qualquer momento, quando esta for a base legal adequada para realização do tratamento dos seus dados pessoais.\n\nCorreção de dados pessoais. Você pode solicitar a correção de dados que estão incompletos, inexatos ou desatualizados. \n\nAnonimização, bloqueio ou eliminação. Todos os dados coletados e tratados por nós têm como finalidade a prestação de serviços e o bom desempenho do Software as a Service.\n\nCaso você acredite que algum dado seu está sendo tratado de forma desnecessária, em excesso ou o tratamento não esteja em conformidade com a LGPD, você poderá solicitar a anonimização, bloqueio ou eliminação, caso prove que houve excesso, desnecessidade ou desconformidade com a LGPD.\n\nInformação acerca do compartilhamento. Você pode solicitar informações sobre nossos parceiros e fornecedores com os quais compartilhamos os dados.\n\nTodos os nossos parceiros também estão preocupados com segurança dos Usuários e garantem a adoção de medidas adequadas para a proteção de seus dados.\n\nDecisões automatizadas. Você pode solicitar a revisão de decisões tomadas unicamente com base no tratamento automatizado de dados e os critérios utilizados nessas decisões, observados sempre os segredos comerciais e industriais da nossa empresa.\n\nPortabilidade de dados. Você poderá solicitar a portabilidade dos seus dados pessoais a outro fornecedor de serviços, em atendimento ao disposto na LGPD.\n\nOposição ou objeção a Tratamento de Dados Pessoais. Se você quiser, pode objetar o tratamento de alguns Dados Pessoais que realizamos ou apresentar oposição ao tratamento por completo. Nesse caso, poderemos parar o tratamento ou explicar que temos uma base legal adequada para realizar os tratamentos questionados.\n\nRegistro de reclamação. Você poderá procurar a ANPD a qualquer momento, caso sinta que seus direitos foram violados.\n\nPara exercer qualquer um dos seus direitos como Titular, entre em contato através do Canal de Atendimento | https://comunidadezdg.com.br/fale-com-a-zdg ou [email protected] .\n\n\n\n## POR QUANTO TEMPO ARMAZENAMOS SEUS DADOS?\n\nOs dados fornecidos pelo Cliente/Usuário serão armazenados e processados enquanto seu cadastro estiver ativo.\n\nCaso o Usuário desejar, pode solicitar a exclusão da sua conta e dos seus dados pessoais, através do Canal de Atendimento | https://comunidadezdg.com.br/fale-com-a-zdg ou [email protected] \n\nDiante da solicitação de exclusão ou término da finalidade de tratamento, o Usuário terá todos os seus dados deletados permanentemente, exceto os dados cuja manutenção seja obrigatória por lei ou regulamentação ou em relação aos dados necessários para o exercício regular de direitos em processo judicial, administrativo ou arbitral.\n\n\n\n## DISPOSIÇÕES GERAIS\n\nA qualquer momento, unilateralmente, poderemos modificar/atualizar este Aviso. Caso isso aconteça, o Titular será notificado e a versão atualizada valerá a partir de sua publicação.\n\nA continuidade de acesso ou utilização do Cliente/Usuário após divulgação da atualização confirmará a ciência e vigência do novo Aviso.\n\nAlém deste Aviso de Privacidade, nós dispomos de Termos e Condições de Uso, os quais definem as condições de uso que irão disciplinar a utilização do Z-PRO. Os Termos abrangem inseparavelmente as disposições deste Aviso de Privacidade.\n\n\n\n## CANAL DE COMUNICAÇÃO\n\nNós disponibilizamos um canal de comunicação para oferecer suporte ao titular de dados pessoais e quaisquer questões relacionadas a esse Aviso, no Canal de Atendimento | https://comunidadezdg.com.br/fale-com-a-zdg ou [email protected] \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/aviso-de-privacidade.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
LID do WhatsApp\n\n### Introdução\n\nRecentemente, o WhatsApp implementou uma mudança de privacidade na forma como os números de telefone são exibidos em novas conversas, introduzindo um identificador chamado LID. Isso pode, em alguns casos, gerar dúvidas e a criação de contatos duplicados na plataforma.\n\nEsta documentação explica o que é o LID, por que isso acontece e como você deve proceder para gerenciar e unificar seus contatos.\n\n\n\n#### 1. O que é o "LID"? Por que estou vendo um número estranho em vez do telefone do cliente?\n\nO LID é um identificador temporário que o WhatsApp agora usa para novas conversas, a fim de proteger a privacidade do usuário.\n\n Por que acontece: Quando um cliente que não está na sua lista de contatos (ou que tem configurações de privacidade restritas) inicia uma conversa, o WhatsApp pode enviar primeiro este LID em vez do número de telefone real.\n* Comportamento do Z-PRO: Nosso sistema exibe o LID que recebe. Assim que o cliente interage e o WhatsApp libera o número real, o Z-PRO automaticamente cria (ou atualiza) o contato com o número correto.\n* Importante: Enquanto o sistema só tiver o LID, não é possível responder à conversa, pois a plataforma ainda não tem o número de telefone para o qual enviar a mensagem.\n\n#### 2. Por que isso cria contatos duplicados?\n\nO problema de duplicação ocorre porque o sistema, por um tempo, pode ter dois registros para a mesma pessoa:\n\n1. Um registro antigo com o número de telefone.\n2. Um novo registro temporário com o LID.\n\nAté que o WhatsApp libere o número e o sistema consiga vincular os dois, eles podem aparecer como contatos separados, o que pode dividir o histórico de conversas.\n\n#### 3. Como eu resolvo o problema de contatos duplicados?\n\nExistem duas formas de unificar os contatos:\n\nMétodo 1: Agrupamento na Tela de Atendimento (Recomendado)\n\nEsta é a forma mais rápida de resolver uma duplicação que você acabou de identificar.\n\n* Ação: Dentro da tela de atendimento do contato que está com o LID, localize a opção "@lid Agrupar Contato".\n* O que faz: Ao clicar, o sistema irá procurar por um contato que tenha aquele LID no campo de número e fará a fusão de todas as conversas e dados no contato correto.\n\nMétodo 2: Agrupamento na Página de Contatos\n\nEsta ferramenta é útil para fazer uma "limpeza" geral na sua base de contatos.\n\n* Ação: Acesse a página "Contatos", selecione o contato que deseja corrigir e procure pela opção de agrupar/atualizar LID.\n* O que faz: Executa uma lógica similar à do método 1, consolidando as informações.\n\n#### 4. O botão "Agrupar Contatos" não funcionou. Por quê?\n\nPara que o agrupamento funcione corretamente, a lógica do sistema precisa que certas condições sejam atendidas. A fusão só é possível se o sistema conseguir identificar claramente quem é o contato "original" e quem é o "duplicado".\n\nA lógica funciona assim:\n\n1. O sistema identifica um Contato Original (aquele que tem o número de telefone correto no campo number).\n2. Ele procura por Contatos Duplicados (aqueles cujo campo lid é igual ao number do Contato Original).\n3. Se encontrar essa correspondência, ele migra todas as informações (tickets, mensagens, oportunidades) do contato duplicado para o original.\n4. Após a migração, o contato duplicado é removido.\n\nSe a função não funcionou, provavelmente é porque o sistema não encontrou essa correspondência clara (ex: o LID no contato duplicado está diferente do número no contato original).\n\n{% hint style="warning" %}\n\n#### API Oficial (WABA) e o LID\n\nA instabilidade de LID, que pode causar duplicação de contatos e tickets, ocorre apenas em APIs não oficiais (Baileys, Webjs, Uazapi, Wuzapi, Evolution, Z-Api).\n\nNa API Oficial do WhatsApp (WABA), esse problema não existe. Como Meta Business Partner, já adaptamos nossa integração para o BSUID (Business-Scoped User ID), o novo identificador da Cloud API, garantindo a resolução consistente dos contatos.\n{% endhint %}\n\n#### 5. Perguntas Frequentes Adicionais\n\n* Preciso ter o número do cliente salvo no meu celular para evitar o LID? Ajuda, mas não é uma garantia. A exibição do LID é uma regra de privacidade do WhatsApp e pode ocorrer mesmo com números salvos, dependendo das configurações do cliente.\n* Um contato antigo de repente apareceu com um LID. O que aconteceu? Isso pode acontecer se o cliente iniciou uma nova conversa e o WhatsApp, por algum motivo, enviou o LID primeiro. Isso cria uma conversa temporária que depois precisa ser agrupada com o contato original.\n* Estou usando uma API Não Oficial (Baileys). Isso influencia? Sim. As APIs não oficiais podem ter mais dificuldade em lidar com as novas regras do WhatsApp, o que pode aumentar a frequência de problemas com o LID. \n\n#### Detalhamento técnico das Condições para Agrupamento de Dados\n\n\n\nComo Funciona o Agrupamento de Contatos (Detalhe técnico)\n\n### Lógica e Condições de Agrupamento\n\nO processo de agrupamento busca por um Contato Original e um ou mais Contatos Duplicados para realizar a fusão. Para que isso aconteça, as seguintes condições devem ser atendidas:\n\n* Condição Principal: Deve existir um Contato Original que tenha o número de telefone correto no campo number e um Contato Duplicado cujo campo lid seja exatamente igual ao number do Contato Original.\n* Validação: O sistema verifica se o number do contato a ser corrigido não está vazio e se o lid está nulo ou vazio antes de procurar por correspondências.\n\n### Ordem de Migração de Dados\n\nQuando uma correspondência válida é encontrada, os seguintes dados são migrados do Contato Duplicado para o Contato Original:\n\n1. Oportunidades: Todas as oportunidades são transferidas.\n2. Tickets: Todos os tickets de atendimento são movidos.\n3. Mensagens: Todas as mensagens dos tickets movidos são transferidas para o ticket mais recente do Contato Original.\n4. Foto de Perfil: A foto do Contato Duplicado só é transferida se o Contato Original não possuir uma foto de perfil válida.\n\n### Processo de Remoção\n\nApós a migração bem-sucedida de todos os dados, o Contato Duplicado é removido do sistema para evitar futuras inconsistências.\n\n### Diferença entre os Botões de Agrupamento\n\n* Agrupar na Tela de Atendimento: Esta ação processa apenas o contato específico que está aberto na tela.\n* Agrupar na Página de Contatos:** Esta ação realiza uma varredura mais ampla, processando todos os contatos do seu ambiente (tenant) para identificar e corrigir todas as duplicidades de uma só vez.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/lid-do-whatsapp.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Manutenção e Segurança\n\n### Atualizações da Plataforma\n\nO Z-PRO está em desenvolvimento contínuo, com novas atualizações sendo liberadas frequentemente. Manter o sistema atualizado é uma responsabilidade do cliente e é fundamental para garantir a segurança e o acesso a novos recursos.\n\n Processo de Atualização: A atualização pode ser executada de forma automática. Um tutorial em vídeo detalhando este processo está disponível na área de membros. Alternativamente, a atualização manual (via terminal do servidor) também é detalhada na área de membros.\n Histórico de Versões (Changelog): Todas as mudanças, correções e novas funcionalidades de cada versão podem ser consultadas publicamente em nosso roadmap: https://roadmap.zdg.dev.br/changelog\n\n### Responsabilidades do Cliente\n\nA segurança da sua instalação depende de ações diretas realizadas pelo assinante do sistema. As seguintes práticas são mandatórias:\n\n#### 1. Acesso e Credenciais\n\nImediatamente após a instalação, é obrigatório alterar as seguintes informações para proteger sua instância:\n\n Chaves de Autenticação: Alterar os valores para JWT_SECRET e JWT_REFRESH_SECRET no arquivo de ambiente do backend.\n Senhas de Banco de Dados: Modificar as senhas de acesso aos bancos de dados.\n Senha de Usuário: Alterar a senha do usuário padrão de deploy (deployzdg).\n\n#### 2. Segurança do Servidor\n\n Firewall: Manter um firewall ativo no servidor. As portas que devem permanecer abertas para o funcionamento do Z-PRO são as portas 22 (para acesso SSH), 80 (HTTP) e 443 (HTTPS). Todas as outras portas devem ser bloqueadas.\n Manutenção do Servidor: Executar demais rotinas pertinentes à manutenção e segurança do servidor, como atualizações do sistema operacional e outras configurações de proteção.\n\n#### 3. Rotinas de Backup\n\n Responsabilidade: A criação e gestão de rotinas de backup de dados da aplicação e do banco de dados são de inteira responsabilidade do cliente.\n *Recomendação: É altamente recomendado configurar uma rotina de backups automáticos e periódicos no servidor para prevenir a perda de dados em caso de falhas de hardware ou outros incidentes.\n\n> Lembre-se:\\n> O Z-PRO é um software entregue e instalado no servidor do cliente. Assim como um veículo, ele requer um ambiente operacional adequado (seu servidor) e manutenções periódicas (atualizações, backups e segurança). A ZDG é responsável por fornecer o software funcional e suas atualizações; a gestão e a manutenção contínua do ambiente do servidor são de responsabilidade do cliente.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/manutencao-e-seguranca.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Política de Suporte Técnico\n\n### Canais de Atendimento\n\nO único canal oficial para solicitação de suporte técnico é o nosso portal de tickets: https://suporte.zdg.com.br\n\n### Horário de Atendimento\n\nA equipe de suporte opera de Segunda a Sexta-feira, das 8h às 18h (Horário de Brasília), exceto em feriados.\n\n### Prazo de Resposta (SLA)\n\nNosso prazo máximo para resposta a um novo chamado é de até 03 dias úteis, contados a partir da data de abertura do ticket.\n\n### Escopo do Suporte (O que está incluso)\n\nNossa equipe de suporte está preparada para auxiliar com:\n\n Dúvidas sobre o funcionamento e os recursos do sistema Z-PRO.\n Investigação e correção de bugs ou falhas na plataforma.\n Auxílio via helpdesk em configurações relacionadas às funcionalidades nativas do Z-PRO.\n\n### Fora do Escopo do Suporte (O que não está incluso)\n\nPara garantir o foco e a qualidade do nosso atendimento, os seguintes itens não são cobertos pelo suporte técnico:\n\n Configuração, gestão, manutenção ou segurança do servidor (VPS) do cliente.\n Suporte para ferramentas de terceiros (Typebot, N8N, SIP, entre outros)\n Criação de fluxos de chatbot específicos para o negócio do cliente.\n Consultoria de negócios, marketing ou estratégias de atendimento.\n Acesso remoto à máquina do cliente.\n Customizações de frontend\n\n### Procedimento e Regras de Atendimento\n\n1. Acesso ao Portal: Para abrir um chamado, acesse o portal Tomticket. Utilize o seu e-mail de compra da licença para acessar a plataforma.\n2. Identificação do Cliente: É mandatório que o e-mail utilizado no portal de suporte seja o mesmo da compra. Não altere este e-mail na plataforma, pois ele é o seu identificador como cliente ativo.\n3. Envio de Anexos: Ao descrever sua dúvida, seja claro e forneça o máximo de detalhes. Anexos no formato de vídeo são aceitos, com duração máxima de 30 segundos por vídeo e limite de 1 vídeo por interação no ticket.\n4. *Encerramento por Inatividade: Chamados que permanecerem sem resposta por parte do cliente por mais de 72 horas serão encerrados automaticamente pelo sistema.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/politica-de-suporte-tecnico.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Pré-requisitos de instalação e utilização\n\n## Requisitos de Servidor (VPS)\n\nA VPS onde o sistema será instalado deverá satisfazer, os seguintes requisitos mínimos:\n\n Memória (RAM) de 16GB ou mais\n 4vcpus ou mais\n SSD ou NVME à partir de 200gb\n Latência de 50ms ou menos\n Linux Ubuntu 22.04 ou superior, sem Painel\n Arquitetura AMD ou Intel (x86-64)\n\n⚠️ O pleno funcionamento do sistema está condicionado ao atendimento integral dessas especificações técnicas.\n\n{% hint style="warning" %}\nRecomendamos o uso de datacenter brasileiro para garantir que trocas de telas e cliques sejam rápidos e consiga oferecer a melhor experiência para o usuário.\n{% endhint %}\n\nOutras opções sugeridas (avaliar latência antes da contratação):\n\n https://www.hostinger.com/zdg\n https://www.hetzner.com/\n https://www.digitalocean.com/\u200b\n https://aws.amazon.com/\n https://www.ovhcloud.com/pt/\u200b\n\n### Manutenção e Segurança do servidor são de responsabilidade do cliente\n\nVer documentação completa aqui: Manutenção e Segurança\n\n**\n\n### Escalabilidade e Projeção de Consumo de Recursos\n\nUma dúvida comum é sobre a capacidade que os requisitos mínimos de servidor suportam em termos de clientes, canais e atendentes.\n\nÉ importante entender que o software Z-PRO não possui limitações em sua licença quanto ao número de canais ou usuários. A capacidade da sua operação de escalar depende diretamente dos recursos do seu servidor (VPS). À medida que seu uso cresce, a infraestrutura precisará ser aumentada.\n\n#### Projeção Média de Consumo (Memória RAM)\n\nPara ajudar no seu planejamento, abaixo estão as métricas médias de consumo de memória RAM observadas. Estes valores são uma projeção e podem variar dependendo da intensidade de uso.\n\n Por Canal (Conexão):\n Canais WABA / Hub: até 100 MB de RAM por canal.\n Canais Baileys / Evolution / Meow: até 250 MB de RAM por canal.\n Canais wwebjs: até 1 GB de RAM por canal.\n Por Usuário (Atendente):\n Cada usuário logado: em média de 100 a 150 MB de RAM.\n\n{% hint style="info" %}\n\n#### Recomendação \n\nAconselhamos que você comece com os requisitos recomendados e monitore o consumo de recursos do seu servidor à medida que sua operação cresce. Se notar lentidão ou alto consumo de RAM/CPU, é um indicativo de que é hora de realizar um upgrade no seu plano de VPS para uma configuração com mais recursos.\n{% endhint %}\n\n\n\n## Requisitos Sistema operacional e navegador\n\n São requisitos obrigatórios* para a utilização do Z-PRO que o Usuário, cumulativamente:Utilize a Plataforma WhatsApp e a Plataforma Telegram, de acordo com os Termos e Condições de Uso próprios dessas plataformas;\n Tenha idade igual ou superior a 13 (treze) anos.\n\nRecomendamos que o sistema operacional e o navegador do Usuário estejam atualizados para aproveitar as otimizações de desempenho e segurança do Z-PRO, bem como que satisfaçam, pelo menos, os seguintes requisitos:\n\n Memória (RAM) de 8GB ou superior\n Processador i5 ou superior\n Conexão de internet rápida e estável\n\nAlém disso, é crucial manter o sistema operacional e o navegador atualizados para evitar riscos de segurança da informação e privacidade, bem como para garantir uma melhor eficácia e funcionamento do Z-PRO.\n\nAs versões suportadas da Plataforma WhatsApp são as seguintes:\n\n API WhatsApp Business Account v19.0 ou superior\n* Até a versão Whatsapp Web v2.24xx.x\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/pre-requisitos-de-instalacao-e-utilizacao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Termos e Condições Gerais de Uso e Licenciamento\n\nData de disponibilização: 22/05/2024\n\nÚltima atualização: 27/03/2026\n\n*\n\nEstes Termos e Condições de Uso (“Termos”) regulam a relação comercial e o licenciamento de\ruso entre a empresa BIANCA SANT ANA PEREIRA & CIA LTDA, pessoa jurídica de direito\rprivado, inscrita no CNPJ sob o nº 35.617.749/0001-67, doravante denominada “ZPRO” ou \r“LICENCIANTE”, e a pessoa física ou jurídica que adquire a licença, doravante denominada\r “CLIENTE” ou “LICENCIADO”.\n\nO objeto deste instrumento é o regramento da utilização do software de gestão e automação de\ratendimentos denominado “SISTEMA ZPRO”, fornecido na modalidade auto-hospedada (selfhosted).\n\nAO CONTRATAR E UTILIZAR O SISTEMA ZPRO, O CLIENTE DECLARA TER LIDO, COMPREENDIDO E ACEITO INTEGRALMENTE ESTES TERMOS.\n\n*\n\n### QUAIS AS INFORMAÇÕES QUE VOCÊ ENCONTRARÁ NESTES TERMOS\n\n1. CONCEITOS IMPORTANTES NESTES TERMOS\n2. NATUREZA E EFICÁCIA DOS TERMOS\n3. REQUISITOS TÉCNICOS E CONDIÇÕES DE OPERAÇÃO\n4. DELIMITAÇÃO DE RESPONSABILIDADES E RELAÇÃO COM TERCEIROS\n5. OBJETO E LICENÇA DE USO\n6. PLANOS, PAGAMENTO, RENOVAÇÃO E CANCELAMENTO\n7. POLÍTICA DE SUPORTE TÉCNICO E SLA\n8. OBRIGAÇÕES, RESPONSABILIDADES E LIMITAÇÕES\n9. PROPRIEDADE INTELECTUAL\n10. PRIVACIDADE E PROTEÇÃO DE DADOS (LGPD)\n11. DISPOSIÇÕES GERAIS\n12. FORO E LEGISLAÇÃO APLICÁVEL\n\n\n\n## 1. CONCEITOS IMPORTANTES NESTES TERMOS\n\nPara facilitar a leitura e interpretação deste documento, adotamos as seguintes definições:\n\n Cliente (ou Licenciado): Pessoa física ou jurídica que adquire a Licença de Uso do Software ZPRO, responsável pelo pagamento, pela contratação da infraestrutura (VPS) e pela gestão dos Usuários e Clientes Finais (Tenants).\n* Sistema ZPRO: Software desenvolvido e de propriedade exclusiva da ZPRO, fornecido sob regime de licenciamento self-hosted. Trata-se de uma solução tecnológica para centralização e gestão de multicanais de atendimento e automação.\n* Licença de Uso Anual: Modalidade de contratação que concede ao Cliente o direito de uso do Sistema ZPRO pelo período de 12 (doze) meses, instalada na infraestrutura providenciada pelo Cliente.\n* Modelo White-Label: Característica do Sistema ZPRO que permite ao Cliente personalizar a identidade visual e revender o acesso ao software para terceiros sob sua própria marca.\n* Infraestrutura (VPS): Servidor Virtual Privado (Virtual Private Server) contratado e custeado diretamente pelo Cliente junto a terceiros, onde o Sistema ZPRO será instalado.\n* Usuário: Pessoa autorizada pelo Cliente a acessar o painel do sistema (Super Admin, Admin, supervisores ou atendentes).\n* Tenant (Cliente Final): Conta ou instância criada pelo Cliente dentro do Sistema ZPRO para revender serviços a terceiros.\n\n*\n\n## 2. NATUREZA E EFICÁCIA DOS TERMOS\n\n2.1. Ao adquirir a Licença de Uso, o Cliente concorda integralmente com estes Termos. A aceitação destas regras é condição indispensável para a liberação do acesso, instalação e utilização do Sistema ZPRO.\n\n\\n2.2. A realização do pagamento ou o simples início da utilização do Sistema ZPRO implica, para todos os fins de direito, na aceitação plena, inequívoca e irrevogável de todas as condições estabelecidas nestes Termos e suas futuras atualizações.\n\n\\n2.3. O Cliente reconhece que estes Termos possuem força de contrato vinculante, substituindo quaisquer acordos verbais ou trocas de mensagens anteriores.\n\n\\n2.4. Pela teoria da aparência, a ZPRO considerará válida a contratação realizada mediante o fornecimento de dados cadastrais e pagamento, declarando o Cliente que a pessoa responsável pela compra possui plenos poderes para representá-lo.\n\n\\n2.5. A ZPRO poderá alterar estes Termos a qualquer momento. O uso continuado do sistema após a publicação das alterações confirma a aceitação dos novos Termos.\n\n## 3. REQUISITOS TÉCNICOS E CONDIÇÕES DE OPERAÇÃO\n\nPara garantir a performance, segurança e estabilidade do Sistema ZPRO, o Cliente deve observar rigorosamente os seguintes requisitos técnicos.\n\n3.1. Requisitos da Estação de Trabalho (Usuário):\\nRecomendamos que o sistema operacional e o navegador do Usuário estejam atualizados. As máquinas utilizadas para acessar o painel devem satisfazer, no mínimo:\n\n Memória (RAM): 8GB ou mais.\n Processador: Intel i5 ou superior (ou equivalente).\n Conexão: Internet rápida e estável.\n\n3.2. Requisitos do Servidor (Infraestrutura VPS):\\nA VPS onde o sistema será instalado deverá satisfazer os seguintes requisitos mínimos obrigatórios:\n\n Memória (RAM): 16GB ou mais.\n Processamento: 4 vCPUs ou mais.\n Latência: 50ms ou menos (recomendado servidor no Brasil ou próximo).\n Sistema Operacional: Ubuntu 20.04 ou 22.04 LTS (limpo, sem painel).\n Armazenamento: SSD ou NVMe a partir de 200GB.\n\n3.3. Documentação Técnica:\\nOs requisitos detalhados e atualizados constam no link oficial: https://zpro.passaportezdg.com.br/requisitos-de-uso.\n\n3.4. Versões Suportadas:\\nÉ crucial manter o sistema operacional e navegadores atualizados. As versões suportadas para conexão com a Plataforma WhatsApp são:\n\n API WhatsApp Business Account v19.0 (ou superior).\n WhatsApp Web v2.24xx.x (ou superior).\n\n3.5. Veracidade das Informações:\\nO Usuário deve fornecer informações verdadeiras, exatas e atuais. A ZPRO reserva o direito de recusar o cadastro ou cancelar contas cujos Usuários adotem condutas contrárias a estes Termos ou aos valores da empresa, sem necessidade de notificação prévia ou indenização.\n\n3.6. Protocolos de Conexão (API Oficial vs. Não Oficial):\n\n 3.6.1. Padrão Recomendado: A ZPRO foi desenvolvida para utilizar a API Oficial do WhatsApp (WABA) como padrão. A API Oficial garante maior estabilidade, segurança e suporte direto da Meta, sendo a única opção para a qual oferecemos garantia plena de funcionalidade.\n 3.6.2. APIs Não Oficiais (Riscos): Para maior flexibilidade, o sistema permite integração com APIs Não Oficiais (WWebJS, Baileys, Meow, Evolution, Uazapi, Z-API, etc). O uso dessas APIs é de total responsabilidade do Cliente, que deve estar ciente dos riscos, incluindo:\n Desconexões frequentes;\n Perda de mensagens enviadas ou recebidas;\n Instabilidade no funcionamento após atualizações do app WhatsApp;\n Possíveis bloqueios ou banimentos de contas pela Meta.\n 3.6.3. Isenção de Garantia: A ZPRO não garante a estabilidade, o desempenho ou o suporte técnico para problemas decorrentes exclusivamente do uso de APIs Não Oficiais. Ao habilitar essa conexão, o Cliente assume integralmente os riscos e isenta a ZPRO de responsabilidade por perdas ou danos.\n\n## 4. DELIMITAÇÃO DE RESPONSABILIDADES E RELAÇÃO COM TERCEIROS\n\n4.1. Estes Termos disciplinam exclusivamente a relação comercial entre a ZPRO e o Cliente (Licenciado).\n\n\\n4.2. Responsabilidade sobre Equipe: O Cliente é o único responsável pela seleção, contratação, remuneração e gestão de seus funcionários (Usuários/Atendentes) que utilizam a plataforma, isentando a ZPRO de qualquer vínculo trabalhista ou solidariedade.\n\n\\n4.3. Responsabilidade sobre o Modelo White-Label (Tenants):\\nConsiderando que o Cliente pode revender o uso do sistema (SaaS) sob marca própria:\n\n 4.3.1. A ZPRO atua como fornecedora de tecnologia e não possui relação com os clientes finais (Tenants) do Cliente.\n\n4.3.2. O Cliente é o único responsável pelo suporte, cobrança e cumprimento legal perante seus próprios clientes. Qualquer disputa judicial iniciada por um Tenant deverá ser assumida integralmente pelo Cliente.\n\n## 5. OBJETO E LICENÇA DE USO\n\n5.1. Objeto: O contrato concede ao Cliente uma Licença de Uso de Software (Direito de Uso), não exclusiva, intransferível e temporária, do Sistema ZPRO, para instalação em servidor (VPS) do Cliente.\n\n\\n5.2. Escopo: A licença permite instalar o software, configurar o White-Label, criar usuários ilimitados (conforme capacidade do servidor) e receber atualizações durante a vigência contratual.\n\n\\n5.3. Restrições:\\nSob pena de cancelamento imediato e medidas judiciais, é vedado:\n\n a) Copiar, vender ou distribuir o código-fonte ou o instalador do sistema.\n b) Realizar engenharia reversa ou descompilação do código fonte.\n c) Sublicenciamento e Distribuição: Vender, alugar, doar ou transferir os arquivos de instalação, o código-fonte ou a chave de licença para que terceiros realizem a instalação em infraestrutura própria (pirataria).\n Única Modalidade Permitida (SaaS): A comercialização autorizada restringe-se exclusivamente à venda do acesso ao sistema (login/senha), com o software rodando obrigatoriamente em infraestrutura gerida pelo Cliente Licenciado.\n\n5.4. Natureza Self-Hosted: O Cliente declara-se ciente de que a ZPRO fornece o software, não a infraestrutura. A gestão do servidor (VPS) é de responsabilidade do Cliente.\n\n\\n5.5. Serviço de Setup de Instalação:\\nAlém de disponibilizar o instalador automatizado e tutoriais na área de membros, caso o Cliente opte pela instalação agendada, a ZPRO realizará, uma única vez, a instalação técnica remota do software no servidor indicado pelo Cliente. A execução deste serviço está condicionada, obrigatoriamente, à entrega do ambiente nas seguintes condições:\n\n 5.5.1. Estado do Servidor: A VPS deve ser entregue formatada (instalação limpa), contendo apenas o Sistema Operacional instalado, sem painéis de gestão (como cPanel, Plesk, CyberPanel) e sem outros serviços rodando (Apache, Nginx ou bancos de dados pré-instalados), para evitar conflitos de porta.\n 5.5.2. Especificações Obrigatórias:\n Sistema Operacional: Ubuntu Server nas versões 20.04, 22.04 ou 24.04 LTS.\n Hardware: Mínimo de 16GB de memória RAM.\n 5.5.3. Dados para Execução: O Cliente deverá fornecer previamente à equipe técnica:\n I. IP da VPS e senha de acesso SSH (usuário ROOT).\n II. Definição dos 02 (dois) subdomínios para a aplicação (Ex: app.dominio.com para frontend e api.dominio.com para backend), já com os apontamentos DNS (Tipo A) direcionados para o IP da VPS.\n III. E-mail de cadastro na ZPRO e número de WhatsApp para validação.\n 5.5.4. Método de Acesso: A instalação é realizada exclusivamente via protocolos de terminal (SSH). Não realizamos instalações via acesso remoto visual ou compartilhamento de tela (ex: AnyDesk, TeamViewer, Zoom), nem instalações em computadores locais (PC/Notebook).\n 5.5.5. Serviços Extra-Contratuais: Reinstalações, execução remota de atualizações, formatações, alterações de servidor ou migração de bancos de dados não estão cobertas pela licença. A ZPRO não se obriga a realizar estes procedimentos, sendo a sua eventual execução mera liberalidade, sujeita à disponibilidade de agenda técnica e aprovação de orçamento extra.\n 5.5.6. Prazo de Execução: O prazo para realização da instalação pela equipe técnica é de até 03 (três) dias úteis. A contagem deste prazo inicia-se exclusivamente após o envio completo e a validação bem-sucedida de todas as credenciais e requisitos técnicos necessários. Caso os dados fornecidos estejam incorretos ou o servidor apresente falhas de conexão, a solicitação entrará em pendência e o prazo será reiniciado a partir da regularização pelo Cliente.\n\n## 6. PLANOS, PAGAMENTO, RENOVAÇÃO E CANCELAMENTO\n\n1. Natureza da Contratação e Licença Anual:\\nA aquisição do Sistema ZPRO é realizada através da compra de uma Licença de Uso Anual, disponibilizada em diferentes categorias de Planos, conforme a finalidade de uso do Cliente.\n\n 6.1.1. O valor da licença corresponde a um pagamento único referente ao ciclo de 12 (doze) meses.\n 6.1.2. Parcelamento ≠ Mensalidade: Caso o Cliente opte pelo pagamento parcelado via cartão de crédito (ex: em 12 vezes), ele declara estar ciente de que não se trata de uma assinatura mensal cancelável, mas sim de uma única compra parcelada, assumindo o compromisso de quitar a integralidade das parcelas perante a operadora do cartão, independentemente da utilização efetiva do sistema durante todo o período.\n\n6.2. Escopo de Uso, Planos e Auditoria:\\nO limite de instâncias e os direitos comerciais de uso são estritamente determinados pela categoria do Plano adquirido pelo Cliente:\n\n 6.2.1. Modalidades de Licenciamento:\n I. Plano "Uso Próprio" (Single-Tenant): Concede o direito de ativação de apenas 01 (uma) instância (Tenant) vinculada à chave de licença. Este plano é destinado exclusivamente à centralização e gestão do próprio negócio do Cliente, não havendo limites para a criação de usuários (atendentes) ou conexão de números telefônicos nesta mesma instância. É expressamente vedada a revenda, sublocação ou criação de contas para terceiros nesta modalidade.\n II. Plano "Para Revenda" (Multi-Tenant): Concede o direito de criação e gestão de múltiplas instâncias (Tenants) de forma ilimitada. Este plano autoriza o Cliente a operar no modelo White-Label e revender acessos (SaaS) para múltiplos clientes finais. Todas as instâncias criadas devem estar vinculadas a subdomínios de um mesmo domínio raiz de titularidade do Cliente (ex: app1.cliente.com, app2.cliente.com), validado pela chave de licença no momento da ativação.\n 6.2.2. Intransferibilidade da Licença Matriz: A licença (chave de ativação) é pessoal, intransferível e vinculada ao CPF/CNPJ do Cliente adquirente. Mesmo no Plano "Para Revenda", o Cliente comercializa apenas o acesso (login) aos seus Tenants, sendo expressamente vedado o compartilhamento ou repasse da chave de licença para ativação em servidores ou domínios raízes de terceiros.\n 6.2.3. Auditoria e Penalidades: A ZPRO reserva-se o direito de verificar o cumprimento destas cláusulas a qualquer momento (via telemetria ou auditoria de banco de dados). A constatação de uso indevido — a exemplo de um Cliente do "Plano Uso Próprio" comercializando acessos a terceiros, ou ativações em domínios não autorizados — poderá acarretar a suspensão imediata da licença e a cobrança proporcional à diferença de plano ou licenças extras utilizadas irregularmente.\n\n6.2.4. Condições Especiais (Multi-domínio): A critério exclusivo da ZPRO, poderão ser comercializadas licenças especiais ou oferecidos bônus promocionais que permitam a ativação em múltiplos domínios raízes dentro de uma mesma chave. Tais condições serão válidas apenas se expressamente descritas na oferta ou fatura correspondente.\n\n6.3. Renovação da Licença:\\nA licença possui validade de 1 ano a contar da data da compra. Para garantir a continuidade do uso, o Cliente deverá renovar a licença ao final do ciclo.\n\n 6.3.1. Renovação Automática (Assinatura): O Cliente poderá optar, no momento da compra ou através do painel de controle, pela ativação da Renovação Automática. Neste modelo, a cobrança da nova anuidade será realizada automaticamente no método de pagamento cadastrado, garantindo a continuidade do serviço sem interrupções.\n I. O Cliente pode desativar a renovação automática a qualquer momento antes da data de cobrança, sem penalidades, retornando ao modelo de renovação manual.\n 6.3.2. Antecipação de Renovação: O Cliente poderá, a seu critério, antecipar a renovação da licença antes do vencimento. Neste caso, o novo período de 12 meses será acrescido à data final da licença vigente (somando-se ao prazo restante), limitado a um acúmulo máximo de 24 (vinte e quatro) meses de validade total da chave de licença.\n 6.3.3. Bloqueio por Falta de Renovação: Caso não ocorra a renovação (manual ou automática) até a data de vencimento, a licença será desativada automaticamente no final do ciclo anual. O bloqueio da licença impede o acesso ao painel administrativo e interrompe imediatamente o funcionamento de todas as conexões, automações e APIs, até que a regularização financeira seja efetuada.\n\n6.4. Política de Cancelamento e Reembolso (Venda Anual):\n\n 6.4.1. Prazo de Arrependimento (7 Dias): Em conformidade com o Art. 49 do Código de Defesa do Consumidor, o Cliente poderá solicitar o cancelamento e o reembolso integral do valor pago em até 07 (sete) dias corridos após a data da compra inicial.\n 6.4.2. Irrevogabilidade após 7 Dias: Decorrido o prazo de 7 dias, a licença é considerada plenamente entregue e consumada. Não haverá reembolso, estorno ou cancelamento de parcelas vincendas (pro rata) caso o Cliente decida deixar de usar o sistema antes do fim do período de 12 meses.\n 6.4.3. O pedido de cancelamento efetuado após o prazo legal de arrependimento terá efeito apenas de não renovação para o próximo ciclo, permanecendo o sistema disponível para uso até o término da vigência já contratada e paga.\n\n6.5. Reajuste de Preços e Proteção de Valor:\\nA ZPRO reserva-se o direito de reajustar o valor da licença para novos licenciamentos ou renovações, visando preservar o equilíbrio econômico do serviço frente a variações de mercado, inflação ou custos operacionais.\n\n 6.5.1. Aviso Prévio: Para Clientes com licença ativa, eventuais reajustes serão aplicados somente na data da próxima renovação. A ZPRO compromete-se a comunicar qualquer alteração de preço com antecedência mínima via e-mail ou painel administrativo.\n 6.5.2. Travamento de Preço (Price Lock): O Cliente tem a opção de garantir o valor da tabela atual e proteger-se de futuros reajustes. Para isso, basta realizar a antecipação da renovação (conforme regras do item 6.3.2), o que permite "travar" o preço vigente pelo período contratado, até o limite máximo de 24 (vinte e quatro) meses acumulados.\n\n6.6. Custos Variáveis de Terceiros:\\nOs valores cobrados pela ZPRO referem-se exclusivamente à licença de software. Custos variáveis decorrentes de serviços de terceiros integrados à plataforma são de responsabilidade exclusiva do Cliente e podem sofrer alterações alheias à vontade da ZPRO, tais como:\n\n I. Tarifas da Meta/WhatsApp (janelas de conversação, WABA);\n II. Consumo de APIs de Inteligência Artificial (OpenAI, Anthropic, Google, Grok, etc);\n III. Serviços de SMS, Gateways de Pagamento e Provedores de VPS.\n IV. Consumo de APIs externas gerenciadas por terceiros (Hub Notificame, Uazapi, Z-API, etc);\n\n6.7. Inadimplência e Suspensão:\\nNa hipótese de falha no processamento de pagamentos parcelados ou estornos indevidos (Chargeback):\n\n I. A ZPRO suspenderá imediatamente o acesso à licença e ao suporte técnico.\n II. A ZPRO reserva-se o direito de recusar novas vendas a Clientes com histórico de inadimplência ou que tenham violado as regras de conduta e respeito com a equipe de suporte.\n\n## 7. POLÍTICA DE SUPORTE TÉCNICO E SLA\n\nEste capítulo define o escopo, canais, horários e procedimentos para o acionamento do suporte técnico.\n\n7.1. Canais e Horários:\\nO único canal oficial para solicitação de suporte técnico é através do nosso portal de tickets.\n\n Horário de Atendimento: De Segunda a Sexta-feira, das 08h às 18h (Horário de Brasília), exceto feriados nacionais.\n\n7.2. Tempo de Resposta (SLA):\\nNosso prazo máximo para resposta a um novo chamado é de até 03 (três) dias úteis, contados a partir da abertura do ticket.\n\n7.3. Escopo do Suporte (O que está incluso):\\nNossa equipe está preparada e restrita para auxiliar com:\n\n I. Esclarecimento de dúvidas sobre o funcionamento e os recursos nativos do sistema ZPRO.\n II. Investigação e correção de bugs ou falhas no código do sistema.\n III. Auxílio em configurações relacionadas exclusivamente ao software ZPRO.\n\n7.4. Limitações (O que NÃO está incluso):\\nPara garantir a qualidade do atendimento, os seguintes itens estão fora do escopo do nosso suporte técnico padrão, sendo de responsabilidade do Cliente:\n\n I. Configuração, gestão, manutenção ou segurança do servidor (VPS) do cliente.\n II. Suporte para ferramentas de terceiros (Typebot, N8N, SIP, Webhooks externos, etc.).\n III. Criação de fluxos de chatbot, lógicas de atendimento, implementação de automações ou consultoria de negócios/marketing.\n IV. Acesso remoto à máquina do cliente (por questões de privacidade e segurança).\n V. Customizações de frontend, alterações de código ou design (CSS/HTML) de forma personalizada para o cliente.\n VI. Resolução de instabilidades ou falhas em APIs Não Oficiais. O funcionamento destas conexões depende de bibliotecas de terceiros e rotas não homologadas (simulação do WhatsApp Web), estando sujeitas a bloqueios e interrupções por parte da Meta que fogem ao controle técnico da ZPRO.\n VII. Suporte a ambientes locais e redes restritivas: Diagnóstico de problemas de conexão decorrentes de instalações em infraestrutura local (Localhost, servidores físicos on-premise, máquinas virtuais em PCs pessoais), bem como dificuldades relacionadas a redes sem IP público dedicado (CGNAT), túneis de conexão (Ngrok, Cloudflare Tunnel), proxies reversos customizados ou firewalls de borda corporativos que divirjam do ambiente padrão homologado (VPS Cloud com IP Público).\n\n## 8. OBRIGAÇÕES, RESPONSABILIDADES E LIMITAÇÕES\n\n8.1. Obrigações da ZPRO: Fornecer os arquivos de instalação, realizar o setup inicial, liberar atualizações (updates) de correção/segurança e prestar suporte técnico limitado ao funcionamento do software (bugs e dúvidas operacionais).\n\n\\n8.2. Obrigações do Cliente: Contratar e manter a VPS, realizar backups periódicos (a ZPRO não tem acesso aos dados), gerenciar as integrações de terceiros e administrar os usuários.\n\n\\n8.3. Limitações sobre Integrações de Terceiros:\\nConforme detalhado na Cláusula 3.6, a ZPRO não possui controle sobre serviços externos (Meta/WhatsApp, OpenAI, Gateways).\n\n 8.3.1. A ZPRO não será responsabilizada por indisponibilidade, mudanças de política, bloqueios ou banimentos de números aplicados por terceiros.\n 8.3.2. A indisponibilidade de serviços de terceiros não isenta o Cliente do pagamento da licença, nem gera direito a reembolso.\n 8.3.3. O Cliente declara ciência dos termos de uso do WhatsApp: https://www.whatsapp.com/legal/business-terms/\n\n8.4. Riscos Inerentes e Dependência Tecnológica:\n\n 8.4.1. O Cliente reconhece que o sistema está sujeito a interferências, mau funcionamento ou atrasos inerentes ao uso da internet e infraestrutura de servidores.\n\n8.4.2. O Cliente declara ter conhecimento desses riscos e concorda que falhas decorrentes de fatores externos não constituem defeito do software. Nestas hipóteses, não será devida pela ZPRO qualquer indenização por prejuízos, incluindo, mas não se limitando a: danos materiais, lucros cessantes, perda de uma chance ou danos morais.\n\n## 9. PROPRIEDADE INTELECTUAL\n\n9.1. Titularidade da ZPRO:\\nO Sistema ZPRO, seu código-fonte, arquitetura de banco de dados, logotipos (da marca ZPRO), documentações, manuais e APIs são de propriedade intelectual exclusiva da ZPRO (Licenciante).\n\n 9.1.1. A contratação da licença não transfere, em hipótese alguma, a titularidade ou os direitos autorais do software para o Cliente. O Cliente recebe apenas uma autorização de uso (Licença), limitada, revogável e não exclusiva.\n 9.1.2. É vedado ao Cliente remover, ocultar ou alterar os avisos de copyright ou mecanismos de validação de licença embutidos no código-fonte, exceto nas áreas explicitamente designadas para personalização visual (White-Label).\n\n9.2. Titularidade do Cliente (White-Label e Dados):\\nPertencem exclusivamente ao Cliente:\n\n I. A marca, logotipo e identidade visual aplicados sobre a plataforma no modelo White-Label.\n II. A base de dados de contatos, históricos de conversas e informações de seus clientes finais (Tenants).\n III. A estratégia de precificação e os contratos firmados com seus próprios clientes.\n\n9.3. Auditoria:\\nA ZPRO reserva-se o direito de monitorar remotamente, via telemetria do sistema, a validade da chave de licença, os subdomínios registrados e as estatísticas de logins realizados no sistema, respeitando a privacidade dos dados Cliente.\n\n## 10. PRIVACIDADE E PROTEÇÃO DE DADOS (LGPD)\n\n10.1. Papéis das Partes (Definição de Controlador e Operador):\\nPara fins da Lei Geral de Proteção de Dados (Lei nº 13.709/2018):\n\n 10.1.1. ZPRO como Controladora: A ZPRO atua como Controladora apenas dos dados cadastrais do Cliente Direto (nome, e-mail, CPF/CNPJ, telefone, domínio), utilizados para faturamento, validação da licença e suporte.\n 10.1.2. Cliente como Controlador: O Cliente é o único e exclusivo Controlador dos dados pessoais de terceiros (seus clientes finais/tenants, leads e contatos) que trafegam pelo Sistema ZPRO instalado em seu servidor.\n\n10.2. Ausência de Acesso aos Dados (Modelo Self-Hosted):\\nO Cliente reconhece que, devido à natureza auto-hospedada (self-hosted) do software:\n\n 10.2.1. O banco de dados fica hospedado na infraestrutura (VPS) contratada pelo Cliente, sob sua guarda e responsabilidade.\n 10.2.2. A ZPRO não possui acesso ao conteúdo das mensagens, lista de contatos ou dados sensíveis processados pelo Cliente, exceto quando o Cliente fornece voluntariamente credenciais de acesso temporário para fins de suporte técnico.\n\n10.3. Responsabilidade por Vazamentos:\\nCompete exclusivamente ao Cliente garantir a segurança de seu servidor (VPS), aplicando firewalls, atualizações de sistema operacional e boas práticas de segurança. A ZPRO não se responsabiliza por vazamentos de dados decorrentes de invasões, falhas de segurança na VPS ou engenharia social sofrida pelo Cliente ou sua equipe.\n\n## 11. DISPOSIÇÕES GERAIS\n\nA ZPRO informa que poderá, a qualquer momento, unilateralmente, modificar/atualizar estes Termos e Condições de Uso. Caso isso aconteça, o Usuário com Plano de Assinatura vigente será notificado e a versão atualizada valerá a partir de sua publicação. A continuidade de acesso ou utilização do Z-PRO pelos Usuários, depois da divulgação, confirmará a aceitação e vigência dos novos Termos e Condições de Uso.\n\n11.1. Comunicações:\\nTodas as comunicações, notificações e avisos serão considerados válidos quando enviados para os endereços de e-mail cadastrados pelo Cliente no momento da compra ou através de avisos no painel administrativo do sistema.\n\n\\n11.2. Tolerância:\\nA eventual tolerância da ZPRO em exigir o cumprimento de qualquer cláusula deste contrato não configurará novação, renúncia ou perdão de direitos, podendo a cláusula ser exigida a qualquer tempo (não aplicação do supressio).\n\n\\n11.3. Conduta e Respeito:\\nA ZPRO preza pelo respeito mútuo. Reserva-se o direito de suspender o suporte técnico ou, em casos extremos, rescindir a licença, caso o Cliente ou seus representantes tratem a equipe de atendimento com agressividade, ofensas, racismo, assédio ou qualquer comportamento inadequado.\n\n\\n11.4. Cessão:\\nO Cliente não poderá ceder ou transferir este contrato a terceiros sem a prévia autorização por escrito da ZPRO. A ZPRO poderá ceder este contrato em caso de fusão, aquisição ou venda de ativos da empresa.\n\n\\n*11.5. Independência das Cláusulas:\\nSe qualquer disposição deste contrato for considerada inválida ou inexequível por um tribunal, as demais disposições permanecerão em pleno vigor e efeito.\n\n## 12. FORO E LEGISLAÇÃO APLICÁVEL\n\n12.1. Este contrato é regido pelas leis da República Federativa do Brasil, em especial pelo Código Civil e pelas Leis de Propriedade Intelectual e Software.\n\n\\n12.2. Fica eleito o foro da Comarca de Alfenas - MG como o único competente para dirimir quaisquer dúvidas ou litígios oriundos deste contrato, com renúncia expressa a qualquer outro, por mais privilegiado que seja ou venha a ser.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/diretrizes-e-politicas/termos-e-condicoes-gerais-de-uso-e-licenciamento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Duvidas Frequentes
Facebook E Instagram Nativo
Facebook e Instagram nativo\n\n- Canal Instagram Nativo (BETA): A partir da v3.1.4.7\n- Canal Facebook Messenger Nativo (BETA): A partir da v3.1.4.8\n- BM do Facebook: Como criar um aplicativo na BM do Facebook para usar a API do WhatsApp\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/facebook-e-instagram-nativo.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
BM do Facebook\n\n### Passo 1: Criação de Conta e Configuração Inicial\n\n#### Criação de Conta na Business Manager (BM)\n\n1\. Acesse o Facebook Business Manager.\n\n2\. Faça login com sua conta do Facebook.\n\n3\. Clique em "Criar Conta" e siga as instruções para configurar sua conta Business Manager.\n\n### Passo 2: Criando um Aplicativo no Facebook Developers\n\n1\. Acesse o Facebook Developers.\n\n2\. Faça login com sua conta do Facebook.\n\n3\. Clique em "Meus Aplicativos" no canto superior direito e depois em "Criar Aplicativo".\n\n4\. Escolha a categoria "Gerenciar integrações empresariais" e clique em "Avançar".\n\n5\. Preencha o nome do aplicativo, seu e-mail de contato e selecione sua conta Business Manager. Clique em "Criar ID do aplicativo".\n\n### Passo 3: Configurando o Aplicativo para Usar o WhatsApp\n\n1\. No painel do seu novo aplicativo, vá para "Configurações" > "Básico".\n\n2\. Anote o "App ID" e o "App Secret", pois você precisará deles mais tarde.\n\n3\. No menu lateral, clique em "Adicionar Produto" e selecione "WhatsApp".\n\n4\. Clique em "Configurar" no WhatsApp.\n\n### Passo 4: Ativando a API do WhatsApp\n\n1\. Siga as instruções para configurar uma conta do WhatsApp Business. Você precisará fornecer um número de telefone válido e outras informações comerciais.\n\n2\. No painel do WhatsApp, você verá uma seção para "Access Tokens". Clique em "Generate Token" para gerar um token temporário.\n\n3\. Anote esse token temporário para testes iniciais.\n\n### Passo 5: Definindo um Token Permanente no Gerenciador de Negócios\n\n1\. No Facebook Business Manager, vá para "Configurações do Negócio".\n\n2\. No menu lateral, vá para "Sistema de Segurança" > "Tokens de Acesso".\n\n3\. Clique em "Gerar Token" e siga as instruções para gerar um token permanente.\n\n4\. No campo de permissões, selecione as permissões necessárias para a API do WhatsApp, como whatsapp\_business\_messaging, whatsapp\_business\_management, etc.\n\n5\. Anote o token gerado.\n\n### Passo 6: Habilitando o Webhook de Escuta\n\n1\. No painel do seu aplicativo no Facebook Developers, vá para "Configurações" "Básico" e adicione a URL do webhook.\n\n2\. No menu lateral, vá para "Produtos" > "Webhooks".\n\n3\. Clique em "Configurar Webhooks" e depois em "Assinar um Webhook".\n\n4\. Selecione "WhatsApp Business Account" e adicione a URL do seu endpoint de webhook e o token de verificação.\n\n5\. Defina os campos de assinatura para escutar os eventos desejados, como messages, messages\_status, etc.\n\n6\. Clique em "Verificar e Salvar" para ativar o webhook.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/facebook-e-instagram-nativo/bm-do-facebook.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Canal Facebook Messenger Nativo (BETA)\n\nA integração de login incorporado para Facebook permite conectar o Messenger diretamente ao Z-PRO, trazendo as mensagens nativamente.\n\n{% hint style="warning" %}\nFuncionalidade em BETA Este recurso está em fase de testes. Siga os passos abaixo atentamente para configurar as permissões no seu aplicativo do Facebook.\n{% endhint %}\n\n{% embed url="https://www.loom.com/share/97907581b630417991275dde71dd1ce4" %}\n\n*\n\n### Parte 1: Obter URL de Callback (Superadmin)\n\nAntes de configurar o Facebook, precisamos capturar a URL de redirecionamento correta dentro do seu sistema.\n\n1. Acesse o painel Superadmin do Z-PRO.\n2. No menu esquerdo, vá até o App Waba.\n3. Localize e copie a URL Redirect URI Facebook\n\n*\n\n### Parte 2: Configuração no Facebook Developers\n\nPara ativar o Messenger, você deve editar o mesmo Aplicativo (App) que utiliza para na integração de instagram/waba com o ZPRO.\n\n1. Acesse developers.facebook.com e selecione o seu App.\n2. No menu lateral, vá em Casos de Uso (ou Use Cases).\n3. Clique em Adicionar e procure pela opção "Interagir com os clientes no Messenger".\n4. Adicione este caso de uso ao seu aplicativo.\n5. Clique em Personalizar configurações (as permissões necessárias serão carregadas automaticamente).\n\nConfiguração de Login:\n\n1. Ainda no painel do Developers, no menu esquerdo, vá até Login do Facebook > Configurações.\n2. No campo URIs de redirecionamento do OAuth válidos, cole a URL que você copiou na Parte 1.\n3. Salve as alterações.\n\n*\n\n### Parte 3: Conectando no Painel (Admin)\n\nApós as configurações técnicas, você pode realizar a conexão da conta.\n\n1. Acesse o painel de Configurações > Integrações Meta.\n2. Localize a opção Facebook Login.\n3. Selecione o seu aplicativo na lista.\n4. Clique no botão Adicionar Facebook.\n5. Uma janela da Meta (popup) se abrirá. Faça o login e conceda as permissões solicitadas para as Páginas (perfis) que deseja conectar.\n6. Após autorizar, clique em Create Channel (Criar Canal).\n7. O sistema configurará o Webhook automaticamente e o canal estará pronto para uso via Messenger.\n\n*\n\n{% hint style="info" %}\nPré-requisito da Conta: Para que funcione, a conta do Instagram do cliente deve ser uma Conta Comercial (Business) e estar obrigatoriamente vinculada a uma Página do Facebook.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/facebook-e-instagram-nativo/canal-facebook-messenger-nativo-beta.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Canal Instagram Nativo (BETA)\n\nA integração nativa do Instagram permite conectar o Instagram Direct diretamente ao Z-PRO através da API Oficial da Meta.\n\nDiferente de emuladores ou automações de tela, esta conexão é oficial, oferecendo maior estabilidade e segurança contra bloqueios.\n\n{% hint style="warning" %}\nFuncionalidade em BETA Este recurso está em fase de testes. Siga os passos abaixo atentamente para configurar as permissões no seu aplicativo do Facebook.\n{% endhint %}\n\n{% embed url="https://www.loom.com/share/6ece54ce3410460c81a16fa89f33f40d" %}\n\n{% embed url="https://www.loom.com/share/837bdedc497243cf9ea890cc39159aab" %}\n\n*\n\n### Parte 1: Configuração no Facebook Developers\n\nPara utilizar o Instagram Nativo, você deve editar o mesmo Aplicativo (App) que você já utiliza para o WhatsApp (WABA) ou criar um novo.\n\n1. Acesse developers.facebook.com e selecione o seu App.\n2. No menu lateral, vá em Casos de Uso (ou Use Cases).\n3. Clique em Adicionar (ou Edit) e procure pela opção relacionada a Gerenciar mensagens de conteúdo no Instagram (Instagram Message Management).\n4. Adicione este caso de uso ao seu aplicativo.\n5. Configurações de Login:\n * Verifique a seção "Configurações de Login da Empresa".\n Certifique-se de que a URL de callback (a mesma usada para o WABA) esteja salva corretamente.\n\n#### Permissões Necessárias\n\nAo adicionar o caso de uso, o sistema solicitará permissões. Certifique-se de adicionar:\n\n instagram_basic\n instagram_manage_messages\n pages_manage_metadata\n pages_show_list (geralmente necessárias para listar as páginas vinculadas ao Instagram).\n\n\n\n### Parte 2: Atualizar o Token (Gerenciador de Negócios)\n\nComo adicionamos novas permissões (Instagram) a um aplicativo que antes só tinha WhatsApp, o Token antigo não funcionará. É obrigatório gerar um novo.\n\n1. Acesse o Gerenciador de Negócios (Business Manager).\n2. Vá em Usuários do Sistema.\n3. Clique em Gerar Novo Token.\n4. Selecione o Aplicativo que você configurou na Parte 1.\n5. Importante: Na lista de permissões, agora aparecerão as novas opções do Instagram que você ativou. Marque todas as permissões de Instagram disponíveis, além das permissões de WhatsApp e Business Management que já usava.\n6. Gere o Token e copie-o.\n\n*\n\n### Parte 3: Configuração no Z-PRO (Superadmin)\n\n1. Acesse o painel Superadmin do Z-PRO.\n2. Vá até as configurações do App WABA (onde você configurou o login do Facebook).\n3. Você notará que agora existe uma seção específica para Configuração do Instagram.\n4. Preencha os campos:\n * App ID: O ID do aplicativo (o mesmo do WABA).\n * App Secret: O segredo do aplicativo (se houver campo específico ou usar o geral).\n * Token: Cole aqui o NOVO Token que você gerou na Parte 2 (que contém as permissões de Instagram).\n5. Salve as alterações.\n\n*\n\n### Parte 4: Conectando no Painel do Cliente\n\nApós o Superadmin realizar a configuração técnica, o cliente final pode conectar a conta facilmente.\n\n1. Acesse o painel da empresa (Tenant).\n2. Vá em Conexões (ou Canais).\n3. Clique em Adicionar e escolha a opção Instagram.\n4. Você verá um botão para Login com Instagram (ou Facebook).\n5. Ao clicar, uma janela da Meta se abrirá solicitando permissão para acessar a conta do Instagram Business vinculada à Página do Facebook.\n6. Após autorizar, selecione a conta desejada e o canal será criado no Z-PRO.\n\n{% hint style="info" %}\nPré-requisito da Conta: Para que funcione, a conta do Instagram do cliente deve ser uma Conta Comercial (Business) e estar obrigatoriamente vinculada a uma Página do Facebook.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/facebook-e-instagram-nativo/canal-instagram-nativo-beta.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Ferramentas Adicionais E Integracoes
Ligações no Z-PRO (Telefonia e Voz)\n\n### Introdução\n\nA plataforma Z-PRO permite integrar canais de voz para que sua equipe possa realizar e receber chamadas diretamente pela interface. É importante entender que o Z-PRO funciona como um centralizador destas operações, mas não é o provedor do serviço de telefonia.\n\nAtualmente, existem duas possibilidades para integrar chamadas de voz:\n\n1. Ligações via WhatsApp (Wavoip): Para realizar e receber chamadas de voz que ocorrem dentro do ecossistema do WhatsApp.\n2. Ligações Convencionais (Telefonia SIP): Para integrar um sistema de telefonia VoIP (ramais, PABX virtual) e realizar chamadas telefônicas tradicionais.\n\nEsta documentação detalha cada uma das opções.\n\n\n\n### 1. Ligações via WhatsApp (Wavoip)\n\nEsta integração permite que seus atendentes realizem e recebam chamadas de voz do WhatsApp diretamente pela interface do Z-PRO.\n\n Como Funciona: A funcionalidade é viabilizada através de uma integração com o serviço Wavoip. Você precisa ter uma conta ativa com eles para que o Z-PRO possa se conectar.\n* Configuração: As credenciais da sua conta Wavoip devem ser inseridas nas configurações do seu canal Baileys dentro do Z-PRO.\n* Vídeo Tutorial: Assista ao passo a passo completo de como realizar a integração: https://www.youtube.com/watch?v=1CIn7qWB3rY\n\n{% hint style="warning" %}\nAVISO SOBRE O SUPORTE\n\nO Wavoip é um serviço de terceiros. A Z-PRO oferece suporte apenas para a integração (conectar as credenciais). Problemas relacionados ao funcionamento, qualidade da chamada ou qualquer outra questão da plataforma Wavoip devem ser direcionados ao suporte do próprio Wavoip.\n{% endhint %}\n\nPara acessar as ligações, basta clicar no ícone *Wavoip* no menu lateral do painel.\n\n\n\nVocê verá a seguinte tela:\n\n\n\n## Login\n\nInforme seu login e senha da Wavoip para ter acesso as ligações e dispositivos\n\n\n\nPara trocar a conta, clique no ícone abaixo e resete o seu login:\n\n\n\n### 2. Ligações Convencionais (Telefonia SIP)\n\nEsta integração permite conectar o Z-PRO ao seu sistema de telefonia VoIP (PABX, ramais) que utiliza o protocolo SIP. Com isso, seus atendentes podem usar um Webphone dentro do Z-PRO para fazer e receber chamadas telefônicas tradicionais.\n\n#### Pré-requisitos Obrigatórios\n\nA configuração do ambiente SIP é externa ao Z-PRO e de responsabilidade do cliente. Para que a integração funcione, seu servidor de telefonia (ex: Asterisk, Issabel) deve ter suporte a:\n\n* ✅ WebRTC\n* ✅ WSS (Web Socket Secure), geralmente operando na porta 8089.\n\n#### Como Configurar\n\nA configuração é feita individualmente para cada atendente.\n\n1. Acesse o Painel Admin e vá para "Usuários".\n2. Edite o usuário para o qual deseja habilitar a telefonia SIP.\n3. Habilite a opção "SIP" e preencha as credenciais do ramal daquele usuário:\n Usuário SIP\n Senha SIP\n Servidor SIP\n Porta WSS (ex: 8089)\n4. Após salvar, a opção do Webphone será habilitada na interface daquele atendente.\n\n\n\nAula sobre a integração SIP : https://portal.zdg.com.br/270021-sistema-zpro/5179490-telefonia-sip\n\n{% hint style="danger" %}\nAVISO SOBRE O SUPORTE TÉCNICO\n\nA configuração do servidor SIP/PJSIP, incluindo a habilitação de WebRTC e WSS, não faz parte do escopo de suporte do Z-PRO.\n\nA responsabilidade pela configuração, compatibilidade e estabilidade da conexão de telefonia é do seu provedor ou do profissional de TI responsável. Caso precise de ajuda especializada, podemos indicar parceiros homologados. Para isso, abra um chamado no departamento "Preciso de indicação de profissional"**.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-adicionais-e-integracoes/ligacoes-no-z-pro-telefonia-e-voz.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Notificações Aplicativo (web push)\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador\n{% endhint %}\n\nEsta documentação explica como ativar as notificações de novas mensagens no seu celular através da tecnologia Web Push.\n\nO Z-PRO não é um aplicativo nativo que você baixa em uma loja (App Store ou Play Store). Ele funciona como um PWA (Progressive Web App).\n\nIsso significa que você pode "instalar" um atalho do site diretamente na tela inicial do seu celular, e ele se comportará de forma muito similar a um aplicativo nativo, ocupando a tela inteira e permitindo o recebimento de notificações.\n\nComo Funcionam as Notificações Web Push\n\nAs notificações são enviadas através da tecnologia Web Push, que permite que o navegador (ou o PWA) receba alertas do Z-PRO mesmo quando você não está com a tela do aplicativo aberta. Para que funcione, é preciso uma configuração em três etapas.\n\n### 2. Passo a Passo para Ativar as Notificações\n\n#### Etapa 1: Ative as Notificações no Aplicativo PWA\n\nPrimeiro, você precisa habilitar a recepção de notificações dentro do próprio PWA.\n\n Localize e acione o botão de notificação (geralmente um ícone de sino).\n Importante: Este botão só é visível quando o Z-PRO é executado a partir do atalho na tela inicial (PWA).\n\n\n\n#### Etapa 2: Habilite o Web Push no Canal Desejado\n\nEm seguida, você precisa dizer ao Z-PRO para qual canal você quer receber os alertas.\n\n No painel do Z-PRO, acesse Canais.\n Edite o canal para o qual deseja receber notificações.\n Marque a opção "Habilitar WebPush" e salve as alterações.\n\n\n\n#### Etapa 3: Permita as Notificações no seu Celular\n\nO passo final é garantir que o seu sistema operacional (Android ou iOS) tenha permissão para exibir as notificações do Z-PRO.\n\nPara Android:\n\n\n\nPara iOS:\n\n\n\n3\. Solução de Problemas\n\n Não estou recebendo as notificações. O que verificar?\n 1. Confirme se as permissões de notificação estão concedidas para o Z-PRO (ou para o navegador) nas configurações do seu celular (Etapa 3).\n 2. Verifique se a opção "Habilitar WebPush" está marcada no canal desejado dentro das configurações do Z-PRO (Etapa 2).\n 3. Certifique-se de que o modo "Não Perturbe" ou "Foco" do seu celular não está ativo.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-adicionais-e-integracoes/notificacoes-aplicativo-web-push.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Visão geral - Ferramentas Adicionais e Integrações\n\nEsta seção agrupa um conjunto de ferramentas e funcionalidades que expandem as capacidades do Z-PRO para além do atendimento convencional por texto.\n\nAqui você encontrará canais de comunicação alternativos como a telefonia (Wavoip) e recursos para desenvolvedores, como a API, que permite conectar o Z-PRO a outros sistemas\n\n*\n\n[Telefonia (Wavoip)](broken://pages/k2INkChuq3WIMbiGntCb)\n\nEsta documentação explica como integrar uma conta Wavoip à plataforma para visualizar o histórico de todas as chamadas de voz feitas ou recebidas através do seu número.\n\n[Notificações do Aplicativo (Web Push)](/ferramentas-adicionais-e-integracoes/notificacoes-aplicativo-web-push.md)\n\nAprenda a ativar e gerenciar as notificações push para o aplicativo Z-PRO. Este recurso envia alertas diretamente para o navegador ou dispositivo do atendente, informando sobre novas mensagens e outras atividades.\n\n[API (Nível de Tenant)*](broken://pages/sFmADiHhxG3EuGkdkcaB)\n\nGuia para desenvolvedores sobre como utilizar a API do Z-PRO. A API permite que você integre a plataforma a sistemas externos, possibilitando ações como enviar mensagens ou buscar informações de atendimentos de forma programática.*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-adicionais-e-integracoes/visao-geral-ferramentas-adicionais-e-integracoes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Ferramentas Do Atendimento
Atendimento\n\n- Tela de Atendimento: Painel de Atendimentos\n- Menu dos atendimentos\n- Funcionalidades do atendimento\n- Atendimento WABA (Api Oficial): Painel de Atendimentos\n- Atendimentos via Ligação (Wavoip): Painel de Atendimentos\n- Tipos de Arquivos Suportados para Envio\n- Visualização de grupos\n- Chat Privado: Chat\n- Contatos: Lista de Contatos\n- Restrição de Acesso a Contatos\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Chat Privado\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nO Chat Privado é a ferramenta de comunicação interna do sistema Z-PRO. Ele permite que os agentes e administradores interajam entre si em tempo real, sem a necessidade de ferramentas externas, facilitando a troca de informações, o suporte entre colegas e a coordenação de equipes.\n\n#### Caso de uso\n\nUm atendente está lidando com um ticket técnico complexo e precisa de auxílio do setor de engenharia. Ele utiliza o Chat Privado, localiza o supervisor na aba de Usuários e envia uma captura de tela do erro. Para agilizar a solução, ele inicia uma Videochamada rápida para explicar os detalhes, mantendo todo o fluxo de colaboração dentro da plataforma.\n\n#### Como acessar a página\n\nNo menu lateral esquerdo, clique no Menu Atendimento e selecione a aba Chat Privado.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\nBarra Lateral (Lista de Contatos):\n\n Busca: Campo para localizar usuários ou equipes pelo nome.\n Abas Usuários/Equipes: Alterna entre a visualização de contatos individuais ou grupos de departamentos.\n Status de Presença: Uma bolinha verde ao lado do avatar indica que o colega está Online.\n\nBarra Superior (Janela de Chat):\n\n Nome e Status: Identificação de com quem você está conversando.\n Ícone de Telefone: Inicia uma chamada de áudio interna.\n Ícone de Câmera: Inicia uma videochamada interna.\n\nBarra de Envio (Rodapé):\n\n Emoji (Sorriso): Acesso à biblioteca de ícones expressivos.\n Anexo (Clipe): Permite o envio de documentos e imagens do seu computador.\n Videoconferência (Monitor): Gera e envia um link de reunião instantânea (Jitsi Meet).\n Microfone: Permite gravar e enviar mensagens de áudio.\n\n*\n\n#### Como iniciar uma conversa interna\n\nPara falar com um colega específico, mantenha a aba Usuários selecionada e clique sobre o nome desejado na lista. Caso precise falar com um departamento inteiro, mude para a aba Equipes e selecione o grupo. O histórico de mensagens será carregado automaticamente no painel central.\n\n#### Como realizar chamadas de voz ou vídeo\n\nDentro de uma conversa aberta, utilize os ícones de Telefone ou Câmera localizados no canto superior direito.\n\n* Nota: O sistema utiliza tecnologia WebRTC para chamadas diretas ou gera links de salas virtuais privativas para que os membros cliquem e entrem na conferência.\n\n#### Como enviar arquivos e documentos\n\nClique no ícone de Clipe na barra inferior, selecione o arquivo em seu dispositivo e confirme o envio. Você também pode enviar mensagens de voz segurando o ícone do Microfone, facilitando a comunicação em momentos de alta demanda de Tickets.\n\n#### Como localizar mensagens e contatos\n\nUtilize a barra de Busca acima da lista de usuários para filtrar rapidamente a pessoa ou equipe com quem deseja interagir. As mensagens enviadas e recebidas ficam armazenadas, permitindo a consulta de informações compartilhadas anteriormente.\n\n*\n\n#### Avisos e precauções\n\n{% hint style="info" %}\nAs conversas do Chat Privado são estritamente internas e não são visíveis para os clientes finais que estão em atendimento nos Canais externos.\n{% endhint %}\n\n### Configuração de WebRTC TURN (coturn)\n\nPara melhorar a qualidade e a taxa de sucesso das chamadas de áudio e vídeo no chat interno, pode ser necessário configurar um servidor TURN (coturn).\n\n📌 Esse recurso é utilizado quando a conexão direta (STUN) falha — algo comum quando os usuários estão em redes diferentes, provedores distintos ou CGNAT.\n\n⚠️ Importante: Essa configuração NÃO faz parte da infraestrutura padrão da ZPRO. A ativação do TURN (coturn) é opicional e deve ser realizada pelo próprio cliente, conforme sua necessidade.\n\n💡 Quando vale a pena configurar?\n\n Usuários em provedores diferentes\n Problemas de conexão em chamadas\n Baixa taxa de sucesso em áudio/vídeo\n Uso interno frequente de chamadas entre atendentes\n\n🛠 A configuração envolve:\n\n Instalação do coturn na VPS (Ubuntu)\n Abertura de portas no firewall\n* Definição das variáveis no .env do backend\n\n🎯 Benefício: Maior estabilidade e aceitação das chamadas internas, garantindo que o áudio/vídeo funcione mesmo em cenários de rede mais restritivos.\n\n{% file src="/files/uO0csiZW4uATZky6p6cl" %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/chat-privado.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Contatos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, supervisor e usuário\n{% endhint %}\n\nA página de Contatos é o diretório central de clientes do sistema Z-PRO. Ela funciona como um CRM integrado, permitindo o armazenamento, segmentação e gestão de toda a base de dados de pessoas que interagem com a sua empresa. Através desta tela, é possível realizar cadastros manuais, importações massivas e a organização de clientes por carteiras e etiquetas.\n\n#### Principais funções\n\n Gestão de Cadastros: Criação, edição e exclusão de fichas de clientes.\n Importação e Exportação: Ferramentas para subir listas via CSV ou baixar a base para Excel.\n Saneamento de Base: Funções para remover duplicados e validar o 9º dígito.\n\n#### Caso de uso\n\nUm gestor de vendas deseja realizar uma campanha para clientes que não compram há 30 dias. Ele acessa a página de Contatos, utiliza o filtro por Etiqueta (ex: "Inativo") e Carteira (ex: "Vendedor João"). Após segmentar a lista, ele utiliza a função Exportar Contatos para gerar um relatório de disparos ou inicia atendimentos individuais clicando no ícone de Iniciar Atendimento de cada contato.\n\n#### Como acessar a página\n\nNo menu lateral esquerdo, clique no Menu Atendimento e selecione a aba Contatos.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\nBarra de Ferramentas Superior:\n\n Utilitários: Menu com funções de manutenção (Sincronizar Contatos/Grupos, Remover Duplicados, Agrupar LID e Verificar 9º Dígito).\n\n\n\n Importar Contatos: Permite o upload de arquivos CSV/XLSX com mapeamento simples.\n\n\n\n \n\n\n Importação Inteligente: Assistente passo a passo para importar bases complexas, identificando origem e estrutura.\n\n\n\n Modelo CSV: Atalho para baixar o arquivo padrão aceito pelo sistema.\n Exportar Contatos: Gera um arquivo com os contatos visíveis na tela (respeitando os filtros aplicados).\n Adicionar Contato: Abre o formulário para cadastro manual unitário.\n\nFiltros e Colunas:\n\n Localize: Busca global por nome, e-mail ou número de telefone.\n Tags: Filtra contatos que possuem Etiquetas específicas.\n Carteiras: Filtra contatos vinculados a um atendente ou departamento específico.\n Colunas: Permite marcar quais informações aparecerão na tabela (ex: CPF, Cidade, CEP, Bloqueado).\n\n\n\n \n\n\nAções na Tabela:\n\n\n\n Balão de Mensagem (Iniciar Atendimento): Abre o menu para escolher por qual Canal você deseja enviar uma mensagem ao cliente.\n Olho (Espiar): Permite visualizar as informações do perfil do contato sem abrir um ticket.\n Lápis (Editar): Abre o modal para alterar dados cadastrais.\n Lixeira (Excluir): Remove o contato permanentemente da base.\n\n**\n\n#### Passo a passo de uso\n\n1. Criar um contato manualmente\n\n1. Clique em + Adicionar Contato.\n2. Preencha o Nome e o Número (obrigatório usar DDI + DDD + Número, ex: 5511999999999).\n3. Adicione o e-mail, vincule a uma Carteira ou adicione Tags.\n4. Se necessário, clique em Adicionar campo para criar campos personalizados (ex: "Data de Vencimento").\n5. Clique em Salvar.\n\n\n\n2. Importação massiva de contatos\n\n1. Clique em Importação Inteligente.\n2. Arraste seu arquivo (CSV, XLS, XLSX ou TXT) de até 30MB.\n3. Siga as etapas de mapeamento de colunas para garantir que o Nome e o Telefone sejam identificados corretamente pelo sistema.\n4. Ao finalizar, o sistema processará a lista e exibirá o progresso.\n\n3. Iniciar um atendimento pela lista\n\n1. Localize o contato desejado.\n2. Clique no ícone de Balão (Ações).\n3. Escolha no menu suspenso qual canal conectado será o remetente da mensagem.\n4. O sistema abrirá automaticamente a Central de Atendimentos com o chat deste contato pronto para uso.\n\n\n\n\n\n#### Detalhamento das Funções de Utilitários\n\n Sincronizar Contatos: Força a atualização da lista de contatos a partir do aparelho celular conectado.\n* Remover Duplicados: Analisa a base em busca de números repetidos e unifica os cadastros.\n* Verificar 9º Dígito:** Ajusta automaticamente números brasileiros que estão sem o dígito 9 ou que o possuem de forma incorreta.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/contatos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Restrição de Acesso a Contatos\n\nA partir da versão 3.1.4.5, foi implementada uma nova camada de segurança e privacidade para a gestão de dados de contato.\n\nAtendendo a conformidade (LGPD) e segurança da informação, agora é possível limitar o que um usuário específico pode ver e fazer com os dados dos seus clientes.\n\n*\n\n### Como Ativar a Restrição\n\nA configuração é opcional e aplicada por usuário.\n\n1. Acesse o painel Admin > Usuários.\n2. Encontre o usuário que deseja restringir e clique em "Editar" ou crie um novo usuário.\n3. Habilite ou desabilite a opção "Usuário Restrito".\n4. Salve.\n\n\n\n*\n\n### Efeitos da Restrição\n\nQuando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada da seguinte forma:\n\n\n\n#### Na Navegação Geral\n\nMenu de Contatos Oculto\n\n O usuário não terá acesso ao menu "Contatos", impedindo a visualização ou exportação da lista completa de contatos.\n\n\n\nProibido Iniciar Novas Conversas\n\n O botão "Iniciar Conversa Avulsa" na tela de Atendimentos será ocultado.\n\n\n\n#### Na Tela de Atendimento (Chat)\n\nDentro de um ticket, o usuário restrito sofrerá as seguintes limitações visuais e funcionais:\n\n Nome do Contato: Será exibido parcialmente (apenas os 5 primeiros caracteres).\n Foto do Perfil: Receberá um forte efeito de desfoque (blur).\n Dados Sensíveis: Todos os campos de detalhes do contato na barra lateral (como Telefone, E-mail, CPF, etc.) serão ocultados.\n Botão Editar Contato: O ícone de lápis para editar o contato será ocultado.\n Opções de Telefonia: Os botões de telefonia serão desabilitados.\n Ações de Mensagem: As opções "Encaminhar" e "Marcar" serão desabilitadas para impedir o vazamento de dados.\n\n{% hint style="success" %}\nObjetivo da Restrição\n\nEsta funcionalidade é desenhada para proteger os dados sensíveis dos seus clientes, limitando o acesso apenas ao necessário para a função do atendente e alinhando sua operação às melhores práticas de segurança e à LGPD.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/contatos/restricao-de-acesso-a-contatos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tela de Atendimento\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, supervisor e usuário\n{% endhint %}\n\n### Introdução\n\nEssa é uma das seções mais importantes da plataforma. é a tela principal onde sua equipe irá interagir com os clientes no dia a dia. Esta é a sua caixa de entrada unificada, projetada para gerenciar diferentes tipos de conversas em um único lugar.\n\nAs documentações abaixo detalham o funcionamento da interface para cada tipo de atendimento suportado pela plataforma.\n\n\n\n [Funcionamento do Atendimento via Chat:](/ferramentas-do-atendimento/atendimento/tela-de-atendimento.md) Este é o guia principal sobre a interface de chat. Ele cobre como aceitar uma nova conversa, enviar mensagens e arquivos, usar as ferramentas da tela de atendimento, transferir para outra fila e finalizar uma interação por texto.\n* [Particularidades do Atendimento WABA (API Oficial):](/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimento-waba-api-oficial.md) Entenda as regras específicas para atender em canais da API Oficial do WhatsApp, como a "janela de 24 horas" para resposta e como iniciar novas conversas utilizando as "Mensagens de Template" aprovadas pela Meta.\n* [Atendimentos via Ligação (Wavoip): ](/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimentos-via-ligacao-wavoip.md)Veja como funciona a interface para receber e realizar chamadas de voz do WhatsApp diretamente na plataforma Z-PRO.\n\n### Como acessar\n\nPara acessá-la, clique no ícone de *Atendimentos* no menu lateral do seu painel.\n\n\n\nVocê verá a seguinte tela:\n\n\n\n### Veja as funções que existem em cada visão:\n\nAtendimentos gerais\n\nAtendimentos no WABA - API Oficial\n\nWavoip - Ligações \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Atendimento WABA (Api Oficial)\n\nA conexão com WABA - Api Oficial do WhatsApp possuí opções exclusivas. A Api Oficial não permite que sejam abertar conversas com mensagens aleatórias, dessa forma, a plataforma recebe as mensagens e você poderá respondê-las dentro do período de 24 horas.\n\n\n\nApós esse período, a janela de conversa se fecha, e você só será capaz de conversar com o contato novamente, caso receba uma nova interação iniciada por ele.\n\nNa parte inferior da tela é onde seus usuários vão se comunicar com o cliente. À esquerda se encontram dois novos botões: envio de botões, listas e templates de texto.\n\n\n\nEnvio de botões: envio de até 3 botões de ação.\n\n\n\nEnvio de listas: envio de até 5 opções.\n\n\n\n\n\nEnvio de Templates: envio de templates pré-aprovado na sua BM da Meta.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimento-waba-api-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Atendimentos via Ligação (Wavoip)\n\nA conexão com Baileys oferece integração com Wavoip para envio e recebimento de ligações por WhatsApp.\n\n\n\nAo clicar no botão ligar, uma chamada será relizada para o contato.\n\n\n\n\n\nLigações avulsas também podem ser realizadas\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/atendimentos-via-ligacao-wavoip.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Funcionalidades do atendimento\n\n\n\n\n\n\n\n\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/funcionalidades-do-atendimento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Menu dos atendimentos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, supervisor e Usuário\n{% endhint %}\n\nA Central de Atendimentos é o núcleo operacional do sistema Z-PRO. Nesta página, o agente gerencia todas as interações com os clientes, organiza fluxos de trabalho por meio de filtros avançados e executa ações em massa para otimizar a produtividade da equipe.\n\n#### Como acessar a página\n\nNo menu lateral esquerdo, clique no Menu Atendimento e selecione a aba Atendimentos.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\n*\n\n#### Detalhamento de Filtros e Ações\n\nPara uma gestão precisa, o sistema oferece opções detalhadas de segmentação e automação de tarefas em lote:\n\nPainel de Filtros\n\n\n\nAo clicar no botão Filtros, um menu lateral é aberto com as seguintes opções de refinamento:\n\n* Opções de Visualização: Marque "Mostrar todos" para ver tickets de outros atendentes (se tiver permissão), "Somente não lidos" para focar em mensagens pendentes, ou "Inverter ordem" para ver as mensagens mais antigas primeiro.\n* Status: Refine sua busca entre tickets Abertos, Pendentes ou Fechados simultaneamente.\n* Período: Defina uma data de início (De) e fim (Até) para localizar atendimentos em um intervalo específico.\n* Filas: Selecione um ou mais departamentos (Ex: Suporte, Vendas) para filtrar apenas as demandas daquelas áreas.\n* Conexões: Filtre os atendimentos pela origem da mensagem, selecionando o Canal específico (WhatsApp, Instagram, etc).\n* Usuário: Filtre para ver os tickets atribuídos a um colaborador específico da Equipe.\n* Etiqueta: Localize contatos segmentados por Etiquetas específicas (Ex: "Cliente VIP", "Aguardando Pagamento").\n* Kanban: Filtre tickets que estão em etapas específicas do seu fluxo de Kanban.\n\n\n\n\n\nMenu de Ações\n\nO botão Ações agrupa ferramentas para execução de tarefas rápidas:\n\n* Selecionar múltiplos: Habilita caixas de seleção ao lado de cada chat para que você possa fechar ou transferir vários tickets de uma só vez.\n* Iniciar conversa avulsa: Permite enviar uma mensagem para um número que não possui um ticket aberto no momento.\n* Organizar por não respondido: Reordena a lista priorizando os clientes que enviaram mensagem e ainda não receberam retorno.\n* Ajuda: Atalho para a central de documentação e suporte.\n\n\n\n*\n\n### Elementos de Controle e Busca\n\n Abas Privados e Grupos: Alterna a visualização entre conversas individuais e chats em grupo.\n\n\n\n Barra de Busca: Localiza chats por nome do contato, número de telefone ou número do ticket (#).\n Ícone Três Riscos (Modo Compacto): Simplifica a lista, removendo o detalhamento da última mensagem e permitindo a seleção rápida de múltiplos chats para ações coletivas.\n Ícone Atualizar: Recarrega manualmente a lista de chats para sincronizar novas mensagens.\n Ícone de Pausa (Pausar Atendimento): Permite que o agente pare de receber novos tickets automaticamente.\n Nota: Este ícone só aparece se habilitado nas Configurações Gerais.\n\n\n\nAbas de Status\n\n Abertos: Conversas que já estão sob responsabilidade de um atendente.\n Pendentes: Novos contatos ou transferências que aguardam um agente aceitar o ticket.\n Na aba de Pendentes é possível clicar no ícone de olho: espiar conversa antes de mover chat para a aba "Abertos"\n\n\n\n \n\n\n Fechados: Histórico de conversas encerradas \n O sistema por defaul não aparece os tickets na aba Fechados. Para visualizar é preciso habilitar na aba Filtros\n\n\n\nA barra lateral esquerda é a ferramenta de controle da lista de chats. Abaixo, detalhamos cada componente:\n\n#### Detalhamento do Card de Atendimento\n\n\n\nCada card na lista de chats fornece um resumo imediato do ticket antes mesmo de abri-lo:\n\n Avatar e Identificação: Exibe a foto e o nome/número do contato.\n* Última Mensagem: Visualização prévia do conteúdo (texto, imagem ou arquivo) da última interação.\n* Ticket ID (#): Identificador único para rastreio do atendimento.\n* Tempo de Resposta: Localizado no canto superior direito do card, indica há quanto tempo a última mensagem foi recebida.\n* Informações de Atendimento: Exibe o nome do Agente responsável, a Conexão utilizada (ícone e nome do canal) e a Fila vinculada.\n* Indicadores Visuais: Bolinhas coloridas indicam a origem do canal e ícones pequenos podem representar etiquetas ou prioridades atribuídas.\n\nPassando o cursor no chat aparece os seguintes ícones\n\n\n\n* Fixar conversa: Mantém o chat permanentemente no topo da lista para acesso prioritário.\n* Marcar como não lido: Adiciona um alerta visual de pendência no ticket para retorno posterior.\n* Resolver atendimento: Encerra o ticket e move a conversa automaticamente para a aba Fechados.\n\n*\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nModo Leitura: Tickets na aba Pendentes não permitem resposta imediata. Você deve clicar no botão Aceitar dentro do chat para assumir o ticket e habilitar o campo de escrita.\n{% endhint %}\n\n{% hint style="info" %}\nAs configurações de filtro permanecem salvas durante a sua sessão atual, a menos que você clique em "Limpar" no topo do painel de filtros.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/menu-dos-atendimentos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tipos de Arquivos Suportados para Envio\n\nO Z-PRO permite o envio de diversos tipos de arquivos (mídias, documentos, etc.) durante os atendimentos. No entanto, os formatos aceitos dependem diretamente do tipo de canal (API) que está sendo utilizado.\n\nAbaixo, detalhamos os formatos suportados pelo Z-PRO para cada tipo de conexão.\n\n\n\n### APIs Não Oficiais (Baileys, WWebJS, etc.)\n\n Imagens: .jpg, .jpeg, .png (e outros formatos image/*)\n* Documentos: .pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .txt\n* Áudio e Vídeo: .mp4, .mp3, .ogg, .mpeg, .mkv\n* Compactados: .zip, .rar\n* Arquivos de Design: .ai, .eps, .psd, .cdr, .key\n* Dados e Outros: .csv, .xml, .ofx, .kml, .pfx, .p2k\n\n*\n\n### API Oficial (WABA)\n\nA API Oficial do WhatsApp (WABA), gerenciada diretamente pela Meta, é mais restrita e aceita apenas os seguintes formatos de mídia para envio:\n\n Áudio: .aac, .amr, .mp3, .m4a, .ogg\n Documentos: .pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .txt\n Imagens: .jpeg, .png, .webp\n Vídeo: .mp4, .3gp\n\n*\n\n{% hint style="info" %}\nNão encontrou o formato que precisa?**\n\nSe você utiliza um formato de arquivo específico que não está listado, especialmente para as APIs não oficiais, você pode sugerir a inclusão em nosso roadmap público. Nossa equipe analisará a viabilidade.\n\nSugerir nova extensão no Roadmap (Upvoty)\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/tipos-de-arquivos-suportados-para-envio.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Visualização de grupos\n\nEsta documentação explica como habilitar a visualização e gestão de Grupos de WhatsApp dentro do painel de atendimento do Z-PRO.\n\nPor padrão, o sistema pode ocultar grupos ou não gerar tickets para eles a fim de evitar poluição visual e sobrecarga de notificações. Para visualizar as mensagens, é necessário ajustar as configurações administrativas primeiro.\n\n*\n\n### Configuração Inicial (Painel Admin)\n\nAntes de visualizar os grupos na tela de chat, o Administrador deve definir como o sistema deve comportar-se em relação a eles.\n\n1. Acesse o menu Configurações e API (ou Configurações Gerais).\n2. Na aba Geral, localize as seguintes opções:\n\n\n\n* Ignorar Mensagens de Grupo:\n * Ativado (Verde): O sistema NÃO abrirá tickets (conversas) na aba de atendimento quando chegarem mensagens de grupos.\n * Desativado (Cinza): O sistema abrirá um ticket novo (ou atualizará o existente) sempre que houver mensagem no grupo, movendo-o para o topo da lista.\n* Mostrar Grupos para todos os usuários:\n * Ativado (Verde): Todos os atendentes poderão visualizar e interagir com os grupos vinculados ao número conectado.\n * Desativado (Cinza): A visualização dos grupos fica restrita (geralmente ao Admin ou responsável direto).\n\n*\n\n### 2. Visualizando no Atendimento\n\nApós realizar as configurações acima, você poderá acessar as conversas de grupo na tela de operação.\n\n1. Acesse o menu Atendimento.\n2. Na barra lateral esquerda (onde ficam os contatos), observe que existem duas abas/ícones no topo:\n 👤 Ícone de Usuário: Exibe apenas conversas privadas (1x1).\n 👥 Ícone de Grupo: Exibe apenas as conversas de grupos.\n\nAo clicar no ícone de Grupos (destacado na imagem), a lista será atualizada mostrando todos os grupos que o seu número participa. Basta clicar sobre um deles para ler e responder as mensagens.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/atendimento/tela-de-atendimento/visualizacao-de-grupos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Comunicação e marketing\n\n- Campanhas (Disparo em Massa): Campanhas de Envio\n- Envio em Massa: Envio de mensagens massivas\n- WhatsApp - Templates: Envio de mensagens massivas para Api Oficial\n- WhatsApp - Sem Variáveis: Envio de mensagens massivas para API Não Oficial\n- WhatsApp - Com Variáveis: Envio de mensagens massivas para API Não Oficial\n- SMS: Envio de mensagens massivas\n- Galeria\n- Gestão de grupos: Gestão de Grupos\n- Grupos e Participantes: Gerar Grupos em Massa e Listar Participantes\n- Manipular Grupos: Alterar Dados Dos Grupos Em Massa\n- Manipular Usuários: Gerenciar Usuários em Massa\n- Números Banidos: Banimento de Número\n- Palavras Proibidas: Gerenciar Palavras Proibidas Nos Grupos\n- Mensagem de Saudação: Adicione Mensagens de Saudação Aos Grupos\n- Mensagem de Despedida: Adicione Mensagens de Despedida Aos Grupos\n- Mensagens Rápidas: Respostas Rápidas\n- Redes Sociais - Comentários\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Campanhas (Disparo em Massa)\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\n\\nEssa ferramenta te permite multiplas possibilidades de abordagem. Aqui é possível fazer Disparos Programados de WhatsApp.\n\nAcesse essa funcionalidade clicando no ícone Campanha do menu lateral do seu painel.\n\n\n\nVocê verá a seguinte tela:\n\n\n\n## Criar Campanha\n\nClique em Adicionar no canto superior da tela\n\n\n\nClique em Atualizar Listagem para verificar o status atual da campanha\n\n\n\nClique em Ordenar por ID no canto superior da tela, para mudar a ordem das campanhas\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Nome da Campanha | Defina a forma como irá identificar essa campanha de marketing. Esse nome estará visível apenas para os Administradores. |\n| Data/Hora Início | Determine a data e hora de início do envio dessa campanha. |\n| Enviar por | Escolha qual canal/conexão será responsável por esse envio. |\n| Delay | Defina o tempo de envio entre cada mensagem. Lembre-se que essa janela de tempo é contada em segundos. |\n| Mídia Composição Mensagem | Você pode inserir um arquivo de mídia para ser enviado junto à campanha. |\n| 1ª, 2ª e 3ª Mensagem | Crie o texto que será enviado, podendo ser até 3 mensagens diferentes, que o sistema irá enviar aleatoriamente. Essas mensagens podem conter o nome personalizado do cliente e emojis. |\n| Visualização | Visualize como ficará a sua campanha vista pelo celular. Aqui você consegue ver as 3 mensagens de forma separada. |\n\nAs mensagens sempre serão enviadas em horário comercial e dias úteis. Clique em Salvar para finalizar o cadastro da campanha e pronto!\n\n{% hint style="warning" %}\nAtenção: A Ordem de Envio das Mensagens é Aleatória\n\nAo configurar uma campanha com múltiplas mensagens (1ª, 2ª e 3ª Mensagem), o sistema fará o envio de apenas uma delas de forma aleatória para cada contato.\n{% endhint %}\n\n## Gerencie as Campanhas \n\nNa parte inferior do painel de Campanhas, você pode visualizar informações como: Nome da Campanha, Data de Início, Status, Quantidade de Contatos, Quantidade de Mensagens Pendente Envio e Entrega, Quantidade de Mensagens Recebidas e Lidas.\n\n\n\nAlém dessas informações, você encontra o campo de Ações. Conheça um pouco mais cada uma delas abaixo\n\n\n\n## Lista de Contatos da Campanha\n\nClique no botão Lista de Contatos da Campanha\n\n\n\nEm seguida, você verá a seguinte tela:\n\n\n\nNo topo da tela é possível visualizar o Nome da Campanha, Data de Início e Status. Além disso, também há o botão Listar Campanhas, para voltar a tela inicial de Campanhas.\n\nLogo abaixo você tem os botões para Atualizar os Dados, Remover todos os Contatos da Campanha e Incluir Contatos.\n\nClicando em Incluir Contatos, se abrirá um pop up para buscar os contatos que deseja incluir na campanha. Veja o exemplo:\n\n\n\nConheça os tipos de filtro de busca:\n\n| Campo | Descrição |\n| ------------------------ | ------------------------------------------------------------------------------ |\n| Início e Final | Janela temporal onde os contatos foram criados. |\n| Estado (s) | Filtre os contatos através dos estados cadastrados. |\n| Etiqueta (s) | Filtre os contatos através das etiquetas atribuidas. |\n| Carteira | Escolha os usuários aos quais esses contatos estão vinculados. |\n| Filtrar Nome ou Telefone | Use o campo de busca para procurar os contatos por nome ou número do WhatsApp. |\n\nPara ativar os filtros, clique no botão Gerar. Abaixo você tem a lista de contatos já cadastrados na sua plataforma. Na caixa de seleção, escolha os contatos que deseja incluir na campanha e clique em Adicionar para finalizar.\n\n## Programar Envio\n\nClique no botão Programar Envio\n\n\n\nAssim que acionado, o status da campanha muda de Pendente para Programado. Além disso, o botão de programar muda para Cancelar Campanha. Se desejar cancelar o envio, basta clicar nessa opção.\n\n\n\nVocê pode Duplicar Campanhas no botão abaixo:\n\n\n\nOu Baixar Relatórios Completos da campanha:\n\n\n\n## Editar e Excluir \n\nO botão de editar reabre o pop up de criação da campanha, para alguma correção de informações ou conteúdo. Já o botão com a lixeira exclui a campanha permanentemente.\n\n\n\n{% hint style="warning" %}\nIntervalo Fixo vs. Aleatório\n\nA funcionalidade de Campanha utiliza um intervalo de tempo fixo e pré-definido entre cada envio.\n\nO seu principal diferencial é a flexibilidade para enviar variações de mensagens e associar dados específicos da campanha a cada disparo.\n\nSe a sua necessidade é ter um intervalo aleatório entre os envios (ex: entre 10 e 30 segundos), a função correta a ser utilizada é a de Disparo em Massa.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/campanhas-disparo-em-massa.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Envio em Massa\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nO sistema oferece duas modalidades distintas: o disparo via API Oficial (WABA), que exige o uso de templates aprovados pela Meta, e o disparo via APIs não oficiais (conexão por QR Code), que permite maior flexibilidade no conteúdo das mensagens.\n\n#### Principais funções\n\n Envio de campanhas para listas de números via upload de CSV ou inserção manual.\n Disparos segmentados por Etiquetas (Tags), colunas do Kanban ou Contatos selecionados.\n Envio programado para Grupos de WhatsApp através de IDs.\n Controle de intervalo entre mensagens para evitar bloqueios.\n\n#### Caso de Uso\n\nUma empresa deseja anunciar uma promoção para 500 clientes que estão na coluna "Interessados" do seu Kanban. Em vez de enviar manualmente, o administrador utiliza o Disparo em Massa, seleciona a coluna do Kanban desejada e o sistema realiza o envio automático para todos os contatos daquela segmentação.\n\n\n\n#### Como acessar a página\n\n1. No menu lateral, clique em Comunicação e Marketing;\n2. Selecione a aba Envio em Massa.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\n#### Explicação dos campos e ícones\n\n Tempo de Disparo: Define o intervalo (em segundos) entre o envio de uma mensagem e outra.\n Números / IDs: Campo para inserir os destinatários manualmente ou via importação.\n Selecionar Template: (Apenas API Oficial) Lista os modelos de mensagens pré-aprovados pela Meta.\n Selecionar Etiqueta: Filtra contatos que possuem uma tag específica.\n Selecionar Kanban: Filtra contatos que possuem cards em uma coluna específica do quadro.\n* Mídia: Espaço para anexar imagens, áudios (gravados ou arquivo) e documentos ao disparo.\n\n### Tutorial envio em massa\n\n{% embed url="https://www.loom.com/share/77639de581024127bf94f8ad4d118fee" %}\n\n#### Passo a passo de uso\n\n1. Disparo via API Oficial (WABA)\n\nEste método é o mais seguro e requer um Template HSM aprovado.\n\n1. Na aba de API Oficial, defina o Tempo de Disparo.\n2. Suba sua lista de números ou cole-os manualmente (Formato: 55DD9XXXXXXXX).\n3. Escolha o Template aprovado na lista suspensa.\n4. Clique em Enviar.\n\n{% hint style="info" %}\nDica de Importação: Use um arquivo CSV com apenas uma coluna contendo os números. O sistema processará a lista automaticamente.\n{% endhint %}\n\n{% hint style="warning" %}\nTemplates: Na API Oficial, se o seu template tiver variáveis (ex: Olá, {{1}}), certifique-se de que sua lista de importação está preparada para preencher esses campos.\n{% endhint %}\n\n2. Disparo via APIs Não Oficiais (QR Code)\n\nUtilizado para envios mais flexíveis, sem necessidade de templates.\n\n1. Selecione a Conexão (WhatsApp conectado via QR Code) que realizará o disparo.\n2. Escolha o destino: Manual, Contatos, Grupos, Etiqueta ou Kanban.\n3. Se for Grupos, insira os IDs dos grupos (obtidos no menu Gestão de Grupos).\n4. Digite sua mensagem e, se desejar, anexe uma Mídia.\n5. Clique em Enviar.\n\n*\n\n#### Detalhamento: Como obter IDs de Grupos\n\nPara disparar em massa para grupos, você deve primeiro capturar os IDs:\n\n1. Vá em Grupos > Gestão de Grupos em Massa.\n2. Selecione a conexão de WhatsApp e clique em Listar ID dos Grupos.\n3. Copie os IDs ou exporte a planilha para usar no disparador.\n\n*\n\n#### Avisos e precauções\n\n{% hint style="danger" %}\nRisco de Banimento (API Não Oficial): Ao usar conexões não oficiais, evite tempos de disparo muito curtos (como 0 a 1 segundo) para listas grandes. Isso pode sinalizar comportamento de bot ao WhatsApp e resultar no banimento do chip.\n{% endhint %}\n\n{% hint style="info" %}\nSempre utilize o formato internacional: DDI + DDD + Número (Ex: 5511999999999).\n{% endhint %}\n\n### Tutorial envio em massa para grupos\n\n{% embed url="https://www.loom.com/share/f3e8380bb17742a4b9a5896998fcd6e0" %}\n\n#### Passo a passo de uso\n\nPasso 1: Extrair os IDs dos Grupos\n\n1. No menu Gestão de Grupos, selecione a Conexão desejada.\n2. Clique no botão "Listar ID dos Grupos".\n3. Com a lista exibida, você pode copiar os IDs manualmente ou clicar em "Exportar CSV".\n\n{% hint style="info" %}\nPara o disparo, o sistema aceita apenas os IDs. Se copiar manualmente, remova os nomes dos grupos. Se usar o CSV, exclua a coluna de nomes e mantenha apenas a coluna dos IDs.\n{% endhint %}\n\nPasso 2: Configurar o Disparo\n\n1. Navegue até o menu Comunicação e Marketing > Disparo em Massa.\n2. Selecione novamente a Conexão de WhatsApp que fará o envio.\n3. Defina o Tempo de Disparo (Ex: entre 1 e 5 segundos).\n\nPasso 3: Inserir Destinatários e Mensagem\n\n1. Cole os IDs dos grupos no campo de contatos ou faça o upload do arquivo CSV formatado apenas com os IDs.\n2. Digite o texto da sua campanha no campo de mensagem.\n3. Clique em Enviar.\n\nPasso 4: Conferir o Envio\n\nPara validar se as mensagens foram entregues:\n\n1. Vá até a tela de Atendimentos.\n2. Clique na aba Grupos.\n3. Verifique as mensagens enviadas (elas aparecerão inicialmente como pendentes e depois serão entregues aos grupos selecionados).\n\n*\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nFormatação de IDs: O disparador não reconhece nomes de grupos. Certifique-se de que o campo de destinatários contém apenas os códigos técnicos (IDs) separados por vírgula.\n\nIntervalo de Segurança: Ao disparar para muitos grupos, utilize tempos de intervalo maiores (acima de 3 segundos) para garantir a estabilidade da conexão do WhatsApp.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
SMS\n\nVocê verá a seguinte tela:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------------- | ----------------------------------------------------------------------------------------- |\n| Mínimo (segundos) | Escolha o mínimo de duração que esse disparo terá. |\n| Máximo (segundos) | Do mesmo modo, escolha o máximo de duração que esse disparo terá. |\n| Números (separados por vírgula) | Insira manualmente os números que receberão o disparo. |\n| Importar Números do CSV | Caso não queira inserir manualmente, selecione um arquivo Excel com os números desejados. |\n\nAlém disso, você tem os botões que podem ser acionados.\n\n| Descrição | Descrição |\n| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao acionar essa opção, você pode selecionar os contatos já cadastrados no sistema. | |\n| Incluir mensagem que será enviada | |\n\nAo final, clique em Enviar e pronto. Disparo de WhatsApp enviado!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/sms.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp - Com Variáveis\n\nVocê verá a seguinte tela:\n\n\n\nPara usar as variáveis você deverá incluí-las separadas por virgula no campo de preenchimento do números:\n\n55119123456789,variavel1,variavel2,variavel3\n\nInsira sua mensagem/descrição de mídia e use as variáveis entre chaves duplas.\n\nPor exemplo: Olá, {{var1}}! Seu estado é {{var2}} e sua idade é {{var3}}...\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| WhatsApp ID | Caso tenha mais de um canal conectado, escolha qual deles será usado no disparo. |\n| Mínimo (segundos) | Escolha o mínimo de duração que esse disparo terá. |\n| Máximo (segundos) | Do mesmo modo, escolha o máximo de duração que esse disparo terá. |\n| Números (separados por vírgula) | Insira manualmente os números que receberão o disparo. No caso dos grupos, você deverá informar a id do grupo que podem ser extraídos de forma rápida na sessão Grupos. |\n| Importar Números do CSV | Caso não queira inserir manualmente, selecione um arquivo Excel com os números desejados. |\n\nAlém disso, você tem os botões que podem ser acionados.\n\n| Descrição | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao selecionar essa opção, o disparo será enviado para os grupos de WhatsApp em que seu número está presente. | |\n| Ao selecionar essa opção, o disparo será enviado para os contatos pertencentes a essa etiqueta. | |\n| Ao acionar essa opção, abrirá um campo para que você insira o texto que deseja para o disparo. | |\n| Ao selecionar essa opção, abrirá um campo para que você insira a URL da mídia e sua descrição. | |\n| Ao acionar essa opção, abrirá um campo para que você insira a URL do Àudio. | |\n| Ao selecionar essa opção, aparecerá um botão para o upload do arquivo e um campo para a descrição. Além disso, você terá a opção de marcar se é um áudio gravado, assim não precisa da descrição. | |\n\nAo final, clique em Enviar e pronto. Disparo de WhatsApp enviado!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/whatsapp-com-variaveis.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp - Sem Variáveis\n\nVocê verá a seguinte tela:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| WhatsApp ID | Caso tenha mais de um canal conectado, escolha qual deles será usado no disparo. |\n| Mínimo (segundos) | Escolha o mínimo de duração que esse disparo terá. |\n| Máximo (segundos) | Do mesmo modo, escolha o máximo de duração que esse disparo terá. |\n| Números (separados por vírgula) | Insira manualmente os números que receberão o disparo. No caso dos grupos, você deverá informar a id do grupo que podem ser extraídos de forma rápida na sessão Grupos. |\n| Importar Números do CSV | Caso não queira inserir manualmente, selecione um arquivo Excel com os números desejados. |\n\nAlém disso, você tem os botões que podem ser acionados.\n\n| Descrição | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao acionar essa opção, você pode selecionar os contatos já cadastrados no sistema. | |\n| Ao selecionar essa opção, o disparo será enviado para os grupos de WhatsApp em que seu número está presente. | |\n| Ao selecionar essa opção, o disparo será enviado para os contatos pertencentes a essa etiqueta. | |\n| Ao acionar essa opção, abrirá um campo para que você insira o texto que deseja para o disparo. | |\n| Ao selecionar essa opção, abrirá um campo para que você insira a URL da mídia e sua descrição. | |\n| Ao acionar essa opção, abrirá um campo para que você insira a URL do Àudio. | |\n| Ao selecionar essa opção, aparecerá um botão para o upload do arquivo e um campo para a descrição. Além disso, você terá a opção de marcar se é um áudio gravado, assim não precisa da descrição. | |\n\nAo final, clique em Enviar e pronto. Disparo de WhatsApp enviado!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/whatsapp-sem-variaveis.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
WhatsApp - Templates\n\nVocê verá a seguinte tela:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------------- | ----------------------------------------------------------------------------------------- |\n| WhatsApp ID | Caso tenha mais de um canal conectado, escolha qual deles será usado no disparo. |\n| Mínimo (segundos) | Escolha o mínimo de duração que esse disparo terá. |\n| Máximo (segundos) | Do mesmo modo, escolha o máximo de duração que esse disparo terá. |\n| Números (separados por vírgula) | Insira manualmente os números que receberão o disparo. |\n| Importar Números do CSV | Caso não queira inserir manualmente, selecione um arquivo Excel com os números desejados. |\n\nAlém disso, você tem os botões que podem ser acionados.\n\n| Descrição | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao acionar essa opção, você pode selecionar os contatos já cadastrados no sistema. | |\n| Ao selecionar essa opção, o disparo será enviado para os grupos de WhatsApp em que seu número está presente. | |\n| Ao selecionar essa opção, o disparo será enviado para os contatos pertencentes a essa etiqueta. | |\n| Ao acionar essa opção, abrirá um campo para que você insira o texto que deseja para o disparo. | |\n| Ao selecionar essa opção, abrirá um campo para que você insira a URL da mídia e sua descrição. | |\n| Ao acionar essa opção, abrirá um campo para que você insira a URL do Àudio. | |\n| Ao selecionar essa opção, aparecerá um botão para o upload do arquivo e um campo para a descrição. Além disso, você terá a opção de marcar se é um áudio gravado, assim não precisa da descrição. | |\n\nAo final, clique em Selecionar template, escolha o template (podendo usar variáveis do sistema) e execute o disparo de WhatsApp!\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa/whatsapp-templates.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Galeria\n\nA Galeria é um repositório centralizado de arquivos dentro do Z-PRO. Com ela, você pode deixar documentos, imagens e vídeos importantes salvos na nuvem do sistema, permitindo que qualquer atendente os envie rapidamente durante uma conversa, sem a necessidade de fazer upload do computador local repetidamente.\n\n*\n\n### 1. Gerenciando a Galeria (Upload de Arquivos)\n\nPrimeiro, é necessário abastecer a galeria com os materiais que sua equipe utilizará.\n\n1. No menu lateral esquerdo, clique no ícone "Galeria"\n\n\n\n2. Nesta tela, você verá a lista de todos os arquivos já cadastrados, podendo pesquisar, editar ou excluir itens existentes.\n\n\n\n3. Para inserir um novo item, clique no botão "Enviar arquivos".\n4. Faça o upload do arquivo desejado e defina uma Descrição para o arquivo (este nome facilitará a busca pelo atendente)\n5. Clique em "Enviar" para salvar.\n\n\n\n*\n\n### 2. Enviando Arquivos da Galeria no Atendimento\n\nCom os arquivos salvos, o envio durante o atendimento torna-se muito mais ágil.\n\n1. Dentro da tela de atendimento (Ticket), clique no ícone de anexo (três pontos).\n2. Selecione a nova opção "Enviar arquivo da Galeria".\n\n\n\n3. Uma janela se abrirá listando os arquivos disponíveis. Localize o arquivo que deseja (você pode usar a busca pelo nome ou filtro)\n\n\n\n4. Pronto! O arquivo será enviado imediatamente para o cliente na conversa.\n\n{% hint style="success" %}\nDica de Produtividade: Utilize a Galeria para armazenar catálogos de produtos, PDFs de apresentação da empresa, tabelas de preços e manuais de instrução. Isso garante que todos os atendentes enviem sempre a versão mais atualizada do documento.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/galeria.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gestão de grupos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\n\\nPara acessá-lo, clique no ícone de Grupos no menu lateral do seu painel.\n\n\n\nVocê verá as seguintes opções na tela:\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Grupos e Participantes\n\nAo clicar nessa opção, você verá a seguinte tela:\n\n\n\n## Gerador de Grupos \n\nClique no botão Criar Grupos em Massa, no canto esquerdo da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Conexão | Caso haja mais de um canal conectado, você escolherá um deles para esse grupo. Lembre-se que o número correspondente estará no grupo como Administrador. |\n| Nome do Grupo | Selecione como esse grupo se chamará, para visualização dos contatos adicionados. |\n| Número do Participante | Adicione o primeiro participante. Nas próximas configurações você pode dar permissão de Administrador para esse primeiro participante. Recomendaos que seja um funcionário da empresa. |\n| Quantidade de Grupos | Digite um número correspondente a quantidade de grupos que serão criados com essas configurações. |\n\nAlém disso, há o botão de Definir Contato / Selecionar Contato. Com essa opção acionada, você pode adicionar contatos já previamente cadastrados na sua plataforma. Ao final, clique em Salvar para finalizar o cadastro do grupo e pronto!\n\n## Listar Id de Grupos \n\nNo campo Conexão, caso haja mais de um canal conectado, você escolherá um deles para visualizar as informações.\n\n\n\nAo final, clique em Listar ID GRUPOS, para ter acesso as ids dos grupos.\n\n\n\n## Listar Participantes \n\nNo campo Conexão, caso haja mais de um canal conectado, você escolherá um deles para visualizar as informações.\n\nAssim que selecionado, o campo de Grupos será desbloqueado e a lista de todos os grupos criados na plataforma irá aparecer. Veja o exemplo:\n\n\n\nAo final, clique em Listar Participantes, para ver quais são os números que estão no grupo selecionado.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/grupos-e-participantes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Manipular Grupos\n\nAo clicar nessa opção, você verá a seguinte tela:\n\n\n\nAssim como na aba anterior, aqui você encontra os campos Conexão e Grupos. Selecione o canal desejado e o grupo que deseja manipular.\n\nAssim que os campos estiverem preenchidos, você você poderá utilizar os seguintes botões:\n\n| Descrição | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao acionar essa opção, se abrirá um campo para preenchimento do novo nome. | |\n| Ao selecionar essa opção, aparecerá um campo para adicionar uma nova descrição. | |\n| Ao acionar essa opção, se abrirá um campo para que cole a URL da imagem do grupo. | |\n| Ao selecionar essa opção, aparecerá um botão para fazer upload da imagem do grupo. | |\n| Ao acionar essa opção, aparecerá um botão para permitir que somente Administradores possam enviar mensagens para o grupo. | |\n\nAo final, clique em Alterar, para salvar as informações alteradas.\n\n### \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/manipular-grupos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Manipular Usuários\n\nClicando nessa aba, você verá a seguinte tela:\n\n\n\nAqui você também encontra os campos Conexão e Grupos. Novamente, selecione o canal desejado e o grupo que deseja. A diferença nesse caso, é que as ações a seguir manipularão os contatos.\n\nAssim que os campos Conexão e Grupos estiverem preenchidos, você poderá utilizar os seguintes botões:\n\n| Descrição | Descrição |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |\n| Ao selecionar essa opção, aparecerá dois novos campos: um para adicionar os números manualmente e outro para importar uma lista Excel. Os contatos adicionados aqui serão promovidos para Administradores do grupo. | |\n| Ao acionar essa opção, aparecerá dois novos campos: um para adicionar os números manualmente e outro para importar uma lista Excel. Os contatos adicionados aqui serão removidos da função Administrador. | |\n| Ao selecionar essa opção, aparecerá dois novos campos: um para adicionar os números manualmente e outro para importar uma lista Excel. Os contatos adicionados aqui serão incluídos no grupo. | |\n| Ao acionar essa opção, aparecerá dois novos campos: um para adicionar os números manualmente e outro para importar uma lista Excel. Os contatos adicionados aqui serão removidos do grupo. | |\n\nCaso qualquer uma das opções seja selecionada, aparecerá um novo botão para importar os contatos já cadastrados na plataforma. Veja o exemplo:\n\n\n\nAo final, clique em Alterar, para salvar as informações alteradas.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/manipular-usuarios.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Mensagem de Despedida\n\nAo clicar nessa opção, você verá a seguinte tela:\n\n\n\nAqui você poderá criar uma lista com mensagens de despedida que serão adicionados aos grupos correspondentes.\n\n## Adicionar Mensagem de Despedida\n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Despedida | Escreva aqui a mensagem de despedida que será enviada |\n| WhatsApp ID | Escolha qual canal deseja atribuir para essa mensagem de despedida. Caso tenha dois números conectados, você pode escolher enviar a mensagem em apenas um deles. |\n| Grupo | Aqui você pode selecionar o grupo ao qual essa mensagem será enviada. |\n\nAo final clique em Salvar e pronto! Mensagem de despedida criada com sucesso.\n\n## Gerenciar Mensagens de Despedida \n\nVocê pode usar o campo de busca para pesquisar as mensagens cadastradas. Essa função é muito útil quando há um grande número de mensagens de despedida.\n\n\n\nAbaixo você consegue ver informações como: mensagem de despedida, quem realizou esse cadastro, a qual o grupo essa saudação será enviada e a data do cadastro dessa mensagem no sistema.\n\n\n\nEm Ações você pode Editar as mesmas informações do cadastro da mensagem de despedida ou Excluir a mesma.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/mensagem-de-despedida.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Mensagem de Saudação\n\nAo clicar nessa opção, você verá a seguinte tela:\n\n\n\n## Adicionar Saudação \n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Saudação | Escreva aqui a mensagem de saudação que será enviada |\n| WhatsApp ID | Escolha qual canal deseja atribuir para essa saudação. Caso tenha dois números conectados, você pode escolher enviar a mensagem em apenas um deles. |\n| Grupo | Aqui você pode selecionar o grupo ao qual essa mensagem será enviada. |\n\nAo final clique em Salvar e pronto! Saudação criada com sucesso.\n\n## Gerenciar Saudações \n\nVocê pode usar o campo de busca para pesquisar as mensagens cadastradas. Essa função é muito útil quando há um grande número de saudações.\n\n\n\nAbaixo você consegue ver informações como: mensagem cadastrada, quem realizou esse cadastro, a qual o grupo essa saudação será enviada e a data do cadastro dessa mensagem no sistema.\n\n\n\nEm Ações você pode Editar as mesmas informações do cadastro da saudação ou Excluir a mesma.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/mensagem-de-saudacao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Números Banidos\n\nAo clicar nessa opção, você verá a seguinte tela:\n\n\n\nAqui é onde você poderá criar uma lista de números que não serão adicionados em grupos ou receberão qualquer disparo efetuado pela sua plataforma. Assim, você evita que suas mensagens sejam denunciadas por contatos sem interesse.\n\n## Adicionar Número Banido\n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Número de Ban | Adicione o número que deseja banir dos disparos futuros. |\n| WhatsApp ID | Escolha qual canal deseja atribuir para esse banimento. Caso tenha dois números conectados, você pode escolher banir o contato em apenas de um deles. |\n| Grupo | Aqui você pode selecionar o grupo do qual esse número será banido. |\n\nAo final clique em Salvar e pronto! Banimento criado com sucesso.\n\n## Gerenciar Números Banidos\n\nVocê pode usar o campo de busca para pesquisar o contato banido. Essa função é muito útil quando há uma grande lista de banimento.\n\n\n\nAbaixo você consegue ver informações como: número do contato banido, quem realizou o banimento, a qual grupo esse número pertencia e a data do banimento.\n\n\n\nEm Ações você pode Editar as mesmas informações do cadastro do banimento ou Excluir esse ban.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/numeros-banidos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Palavras Proibidas\n\nClicando nessa aba, você verá a seguinte tela:\n\n\n\n## Adicionar Palavras Proibidas \n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Palavra (minúscula) | Adicione a palavra que deseja proibir no grupo. |\n| WhatsApp ID | Escolha qual canal deseja atribuir para essa proibição. Caso tenha dois números conectados, você pode escolher banir a palavra em apenas de um deles. |\n| Grupo | Aqui você pode selecionar o grupo do qual essa palavra será banida. |\n\nAo final clique em Salvar e pronto! Proibição criada com sucesso.\n\n## Gerenciar Palavras Proibidas\n\nVocê pode usar o campo de busca para pesquisar a palavra proibida. Essa função é muito útil quando há uma grande lista de proibição.\n\n\n\nAbaixo você consegue ver informações como: palavra banida, quem realizou esse cadastro, qual o grupo onde essa palavra está proibida e a data de cadastro dessa palavra no sistema.\n\n\n\nEm Ações você pode Editar as mesmas informações do cadastro da palavra ou Excluir a mesma.\n\n\n\n## Ligar Vigia de Palavras\n\nClique em Ligar Vigia de Palavras no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| -------------- | ------------------------------------------------------------- |\n| Conexão | Selecione a conexão que deverá remover as palavras proibidas. |\n| Ligar/Desligar | Ativar ou desativar o sistema de vigia para a conexão. |\n\nAo final clique em Salvar e pronto! Proibição criada com sucesso.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/gestao-de-grupos/palavras-proibidas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Mensagens Rápidas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Supervisor\n{% endhint %}\n\nAs mensagens rápidas são uma forma de agilizar o atendimento, através de textos predefinidos. Assim, é possível criar mensagens com diferentes propósitos, como: Boas vindas, Tabela de preços/serviços ou Sondagem, por exemplo.\n\nPara acessar essa seção basta clicar no ícone de Mensagens Rápidas, no menu lateral do seu painel.\n\n\n\nEm seguida você verá a seguinte tela:\n\n\n\n## Nova Mensagem Rápida\n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Chave | Insira uma palavra chave para identificar essa mensagem. Lembre-se que essa palavra será a forma como os usuários irão identificar a mensagem durante o atendimento. |\n| Mensagem | Aqui é onde você vai desenvolver esse texto. Utilize emojis ou arquivos para facilitar a compreensão ou tornar o texto mais didático. |\n| Arquivo | Aqui você poderá anexar arquivos para serem enviados. |\n| Áudio Gravado | |\n\nClique em Salvar para finalizar o cadastro do seu atalho e pronto!\n\n## Gerenciar Mensagens Rápidas\n\nNa parte inferior do painel de Mensagens Rápidas, você pode visualizar as seguintes informações: Chave, Mensagem, Arquivo e Áudio Gravado.\n\n\n\nEm Ações você pode Editar as mesmas informações do cadastro ou Excluir a mensagem rápida.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/mensagens-rapidas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Redes Sociais - Comentários\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e usuário\n{% endhint %}\n\nAs páginas de gestão de comentários permitem centralizar a interação com o público das principais redes sociais (Instagram, Facebook, TikTok e YouTube) diretamente no painel Z-PRO. Através desta funcionalidade, o usuário visualiza as publicações e responde aos comentários sem a necessidade de alternar entre diferentes aplicativos ou abas.\n\n#### Principais funções\n\n Centralização de Canais: Gestão de múltiplas redes sociais em uma única interface.\n Visualização de Mídia: Exibição da imagem ou vídeo da publicação selecionada para contexto.\n Interação em Tempo Real: Leitura e resposta de comentários de forma ágil.\n\n#### Caso de uso\n\nUma empresa realiza uma campanha de lançamento no Instagram e no YouTube. O gestor de mídias sociais utiliza o Z-PRO para monitorar as dúvidas dos clientes nos comentários de ambas as redes. Ao identificar uma pergunta sobre preço no Instagram, ele clica em "Responder" e envia a informação instantaneamente, garantindo um tempo de resposta reduzido e maior engajamento.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Comunicação e Marketing e selecione a aba correspondente à rede social desejada: Instagram, Facebook, TikTok ou YouTube.\n\n\n\n#### Você verá a seguinte tela:\n\n(O layout e funcionamento são idênticos para todas as redes sociais citadas)\n\n\n\nExplicação dos campos e ícones\n\n Conexão: Menu suspenso para selecionar a conta da rede social que está Conectada ao sistema. \n\n{% hint style="warning" %}\nO canal precisa estar criado em CANAIS\n{% endhint %}\n\n Botão Carregar publicações: Realiza a busca das postagens mais recentes da conta selecionada.\n Publicação: Lista as postagens encontradas para que o usuário escolha qual deseja monitorar.\n Buscar por ID da publicação: Campo para inserir manualmente o código identificador de uma postagem específica.\n Botão Buscar comentários: Carrega todos os comentários vinculados à publicação selecionada.\n Card de Visualização (Esquerda): Exibe a mídia da postagem (imagem/vídeo) e fornece um ícone de Link Externo para abrir a publicação original na rede social.\n Lista de Comentários (Direita): Exibe o nome do usuário (@), a data/hora do comentário e o texto enviado.\n Link Responder: Abre o modal para digitar e enviar uma resposta ao comentário selecionado.\n\n\n\n**\n\n#### Passo a passo de uso\n\n1. Selecionar a conta: Escolha a conta desejada no campo Conexão.\n2. Localizar a postagem: Clique em Carregar publicações e selecione a postagem no campo Publicação. Caso tenha o ID em mãos, utilize o campo de busca por ID.\n3. Carregar interações: Clique em Buscar comentários. A lista de interações aparecerá no lado direito da tela.\n4. Responder ao público: Clique em Responder no comentário desejado. Um modal será aberto com o campo de texto.\n5. Enviar resposta: Digite sua mensagem e clique no botão Responder. A resposta será publicada automaticamente na rede social original.\n\n\n\n#### Detalhamento\n\nA integração permite responder apenas a comentários de nível primário. O sistema exibe o histórico de data e hora para auxiliar na priorização das respostas mais antigas.\n\n#### Avisos e precauções\n\n{% hint style="warning" %}\nPermissões de API: Certifique-se de que sua conta de rede social possui as permissões de "Gerenciamento de Comentários" ativas nas configurações de desenvolvedor da plataforma (Meta, TikTok ou Google).\n{% endhint %}\n\n{% hint style="info" %}\nPode haver um pequeno delay (atraso) entre a publicação do comentário na rede social e a sua aparição no painel Z-PRO, dependendo do tempo de resposta da API de cada plataforma.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/redes-sociais-comentarios.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Conta - Meu perfil\n\nGerencie suas informações pessoais, foto de perfil e senha de acesso ao sistema.\n\n### Atualizando o perfil\n\n\n\n Edite seu nome, e-mail e telefone na seção Meu Perfil\n Clique na foto para atualizar sua imagem de perfil (máximo 5MB)\n Clique em Salvar perfil para confirmar as alterações\n\n### Alterando a senha\n\n\n\n Informe a senha atual e a nova senha com no mínimo 6 caracteres\n* Confirme a nova senha e clique em Alterar senha\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/conta-meu-perfil.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Gestão\n\n- Agenda\n- Funil de oportunidades: Gestão de Oportunidades\n- 1. Configurando seus Funis e Etapas\n- 2. Criando uma nova oportunidade\n- 3. Visualizando seus funis e oportunidades\n- 4. Automatizando seu Funil com Ações e Fluxos\n- 5. Ações em tickets (Follow-up Automático)\n- Kanban de atendimento\n- Tarefas: To Do List\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Agenda\n\nAgenda\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador e Usuário\n{% endhint %}\n\nA página Agenda é a ferramenta central de organização de compromissos e automação de notificações do sistema Z-PRO. Através dela, é possível realizar o agendamento de consultas, visualizar o cronograma em formato de calendário e configurar réguas de lembretes automáticos via WhatsApp para reduzir o absenteísmo.\n\n#### Principais funções\n\n Gestão de Consultas: Registro detalhado de compromissos com clientes.\n Visualização em Calendário: Painel mensal para controle visual de datas.\n Lembretes Automáticos: Configuração de disparos de mensagens com antecedência programada.\n Integração com Contatos: Vinculação direta com a base de dados do sistema.\n\n#### Caso de uso\n\nUma clínica de estética utiliza a Agenda para marcar procedimentos. Ao criar uma "Nova Consulta" para uma cliente na próxima terça-feira, o sistema identifica a regra de lembrete configurada para "24 horas antes" e envia automaticamente uma mensagem pelo Canal WhatsApp selecionado, confirmando o horário e diminuindo as faltas não justificadas.\n\n#### Como acessar a página\n\nNo menu lateral, clique no Menu Gestão e selecione a aba Agenda.\n\n\n\n#### Você verá a seguinte tela:\n\nA página é dividida em três sub-abas principais: Consultas, Calendário e Lembretes.\n\n\n\nExplicação dos campos e ícones (Aba Consultas)\n\n Botão + Nova Consulta: Abre o formulário para criar um novo agendamento.\n Título: Nome identificador do compromisso.\n Contato: Nome do cliente vinculado à consulta.\n Data/Hora: Momento exato do início do compromisso.\n Status: Indica a situação atual (ex: Pendente, Confirmado, Cancelado).\n Ações (Ícones):\n Lápis: Editar os dados da consulta.\n Lixeira: Excluir o agendamento permanentemente.\n\n*\n\n#### Detalhamento das Funcionalidades\n\n1. Criar uma Nova Consulta\n\nAo clicar em + Nova Consulta, o sistema exibe um formulário detalhado:\n\n* Título (Obrigatório): Assunto da consulta.\n* Descrição: Detalhamento adicional sobre o compromisso.\n* Contato: Campo de busca para selecionar um Contato já cadastrado.\n* Nome/Telefone do contato: Caso o contato não exista na base, estes campos permitem o preenchimento manual para o envio do lembrete.\n* Data e Hora início/fim: Definição do período de duração.\n* Status: Classificação da consulta.\n* Observações internas: Notas que não são enviadas ao cliente, visíveis apenas para a equipe.\n\n\n\n2. Visualização por Calendário\n\nA aba Calendário oferece uma visão macro de todos os agendamentos do mês. É possível navegar entre os meses e clicar sobre um evento específico para ver seus detalhes.\n\n\n\n3. Configuração de Lembretes Automáticos\n\nNa aba Lembretes, o administrador define as regras de automação que serão aplicadas a todas as consultas.\n\n\n\n* Nome: Identificação da regra (ex: Lembrete 24h antes).\n* Horas antes do evento: Define com quanto tempo de antecedência o sistema deve realizar o disparo.\n* Tipo de mensagem: Escolha entre "Mensagem de texto" (comum) ou "Template WABA" (para API Oficial).\n* Mensagem: Campo para escrita do texto. Você pode usar variáveis dinâmicas como:\n {{nome}}: Nome do cliente.\n {{data}}: Data da consulta.\n {{hora}}: Horário da consulta.\n {{titulo}}: Assunto da consulta.\n* Canal WhatsApp: Seleciona por qual Conexão a mensagem será enviada.\n\n\n\n*\n\n#### Funcionamento da Automação\n\nO motor de automação do Z-PRO realiza uma verificação a cada 15 minutos para identificar consultas que se enquadram nas regras de lembretes configuradas.\n\n Segurança: O sistema garante que cada lembrete específico (ex: regra de 24h) seja enviado apenas uma única vez por consulta, evitando duplicidade de mensagens para o cliente.\n Status Ativo: As regras de lembrete só funcionam se a chave "Ativo" estiver habilitada no cadastro da regra.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/agenda.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Funil de oportunidades\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nA funcionalidade "Funil de Oportunidades" é uma ferramenta para gerenciar processos de negócio de forma visual e automatizada.\n\nEla pode ser utilizada para diferentes fluxos, como um funil de vendas, um processo de onboarding de clientes ou esteiras de suporte com múltiplas etapas. A documentação desta funcionalidade está dividida em três partes: Configuração, Gerenciamento e Automação.\n\n### Vídeo Demonstrativo\n\nAssista ao vídeo abaixo para uma demonstração completa de como utilizar o Funil de Oportunidades na prática.\n\n{% embed url="https://youtu.be/tWOr-6LNdBg" %}\n\n### Documentação\n\nA documentação do Funil foi dividida em uma jornada de 4 etapas para facilitar o aprendizado, desde a criação da estrutura até a automação completa do processo.\n\n 1. Configurando seus Funis e Etapas O ponto de partida. Aprenda a criar a estrutura do seu processo, configurando os funis e as etapas (colunas) que servirão como base para sua operação.\n 2. Como Criar uma Nova Oportunidade Com a estrutura pronta, o próximo passo é adicionar oportunidades ao funil. Esta documentação detalha as maneiras de criar uma nova oportunidade e explica cada campo do formulário.\n 3. Visualizando e Gerenciando Oportunidades Aprenda a acompanhar o progresso utilizando as três telas de visualização: o Painel de Controle (visão analítica), o Kanban (fluxo de trabalho) e o Calendário (visão temporal).\n 4. Automatizando seu Funil com Ações e Fluxos O guia avançado sobre automação. Aprenda a configurar Ações e Fluxos para que o sistema envie mensagens e mova oportunidades automaticamente, com base em regras de tempo.\n [*5.Ações em Tickets (Follow-up Automático)](/ferramentas-do-atendimento/gestao/funil-de-oportunidades/5.-acoes-em-tickets-follow-up-automatico.md) Como criar automações de follow-up (como enviar mensagens ou adicionar etiquetas) para reengajar clientes que não respondem a um ticket após um tempo determinado.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
1. Configurando seus Funis e Etapas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nEsta documentação detalha o primeiro passo para utilizar o Funil de Oportunidades: a criação da sua estrutura de trabalho.\n\nAqui, você aprenderá a configurar os Funis (as áreas gerais do seu processo, ex: "Vendas") e as Etapas (as colunas que representam cada fase do processo, ex: "Novo Contato", "Em Negociação").\n\n*\n\n#### Passo 1: Acessando a Área de Configuração\n\n1. No menu lateral do Painel Admin, clique no ícone "Funil".\n\n\n\n1. No menu superior que aparecerá, clique na aba "Funis".\n\n\n\n#### Passo 2: Criando um Novo Funil\n\nO "Funil" é o contêiner principal que agrupará suas etapas.\n\n1. Na tela de "Funis", clique no botão "Novo Funil".\n\n\n\n2. Na janela que aparecer, digite o nome do seu funil (ex: "Funil de Vendas Padrão") \n\n#### Passo 3: Adicionando Etapas ao Funil\n\n1. Clique no botão \[+ADICIONAR]\n2. Adicione o nome da etapa e escolha a cor que esta etapa terá\n\n\n\n3. Repita o processo para todas as etapas que desejar (ex: "Proposta Enviada", "Negociação", "Ganhos", "Perdidos").\n4. Clique em salvar que seu funil estará criado com as etapas\n\n\n\n#### Passo 4: Gerenciando Funis e Etapas Existentes\n\nApós a criação, você pode editar, reordenar ou excluir funis e etapas a qualquer momento utilizando os ícones de ação ao lado de cada item.\n\n* Editar: Clique no ícone de lápis para renomear um funil ou uma etapa.\n* Excluir: Clique no ícone de lixeira para remover um funil\n\n*\n\n### Próximo Passo\n\nCom a estrutura do seu funil criada, o próximo passo é aprender a gerenciar as oportunidades no dia a dia. Para isso, consulte a próxima documentação:\n\n📚 Criando uma nova oportunidade\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades/1.-configurando-seus-funis-e-etapas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
2. Criando uma nova oportunidade\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nEsta documentação detalha as duas formas de criar uma nova oportunidade no Z-PRO, explica cada campo que precisa ser preenchido \n\n*\n\n#### Existem duas maneiras de iniciar a criação de uma oportunidade:\n\nMétodo 1: A Partir de um Atendimento\n\nEste é o método mais comum, pois a oportunidade já fica vinculada a uma conversa existente.\n\n1. Na tela de Atendimentos, com uma conversa aberta, localize a barra lateral de informações do contato.\n2. Clique na aba "Funil".\n3. Clique no botão para criar uma nova oportunidade.\n\n\n\nMétodo 2: Diretamente pelo Kanban\n\nEste método é útil para adicionar oportunidades que não nasceram de um atendimento imediato.\n\n1. No menu lateral, acesse "Funil" e clique na aba "Kanban".\n2. Clique no botão "+" localizado no canto superior direito da tela ou em uma das colunas.\n\n\n\n*\n\n#### Preenchendo os Dados da Oportunidade\n\nAmbos os métodos acima abrirão a janela "Nova Oportunidade". Preencha os seguintes campos:\n\n Nome: Um título para identificar a oportunidade (ex: "Projeto Site Novo - Empresa X").\n Funil & Etapa: Selecione em qual funil e em qual etapa (coluna) esta oportunidade será criada.\n Responsável: Escolha o usuário/atendente que será o dono desta oportunidade.\n Contato: Atribua a oportunidade a um contato já existente na sua agenda.\n Previsão de fechamento: Defina uma data prevista para a conclusão.\n Valor: O valor monetário da negociação.\n Descrição: Um campo livre para detalhar a oportunidade.\n Status: Defina o status inicial como Aberto, Ganho ou Perdido.\n\n\n\nAo final, você terá três botões: Cancelar, Salvar (para criar apenas a oportunidade no Z-PRO) e "Criar evento no Google Calendar".\n\n*\n\n#### Criando um Evento Vinculado no Google Calendar (Opcional)\n\n{% hint style="warning" %}\nAviso: Para esta função estar disponível, a integração com o Google Calendar precisa ser configurada previamente pelo Administrador. Consulte o guia: Integração com Google Calendar\n{% endhint %}\n\nAo clicar em "Criar evento no Google Calendar" após preencher os dados da oportunidade, uma nova janela aparecerá para que você agende o evento diretamente na agenda do responsável. Os campos são:\n\n* Selecionar agenda: Escolha a agenda do usuário onde o evento será criado.\n* Título do evento: Puxa automaticamente o título da oportunidade.\n* Data de início / Data de fim: Defina a data e hora do evento.\n* Descrição: Puxa automaticamente a descrição da oportunidade.\n* Localização: Adicione um local físico ou link para a reunião.\n* E-mail dos participantes: Adicione os e-mails de outros convidados.\n\nApós preencher, clique em "Criar evento".\n\n\n\n*\n\n#### Próximos Passos: Visualizando suas Oportunidades\n\nApós criar a oportunidade, você pode visualizá-la e gerenciá-la em três telas diferentes. Consulte as documentações abaixo para mais detalhes:\n\n Painel de Controle Uma visão analítica, com métricas e gráficos sobre suas oportunidades.\n Kanban Uma visão de fluxo de trabalho, onde você pode arrastar e soltar os cards entre as etapas.\n Calendário Uma visão temporal, que exibe suas oportunidades com base nas datas de fechamento previstas.*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades/2.-criando-uma-nova-oportunidade.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
3. Visualizando seus funis e oportunidades\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nApós criar suas oportunidades, o Z-PRO oferece três telas distintas para visualizá-las e gerenciá-las. Cada tela exibe os mesmos dados, mas em formatos diferentes, otimizados para propósitos específicos: análise de dados, gerenciamento de fluxo de trabalho e planejamento temporal.\n\nPara acessá-las, clique no ícone "Funil" no menu lateral e escolha a aba desejada.\n\n*\n\n#### 1. Painel de Controle: A Visão Analítica\n\nO Painel de Controle é a sua central de inteligência, projetada para fornecer uma visão macro e analítica de todas as suas oportunidades. Utilize esta tela para entender a saúde do seu funil e a performance da equipe.\n\nPrincipais Componentes:\n\n* Filtros: Permitem segmentar os dados por período de tempo, funil específico, etapa, status ou responsável.\n* Cards de Resumo: Exibem os totais gerais, como o número de oportunidades abertas e o valor total em negociação.\n* Gráficos: Mostram a distribuição visual das oportunidades por etapa do funil.\n* Lista de Oportunidades: Uma tabela detalhada com todas as oportunidades que correspondem ao filtro aplicado.\n\n\n\n#### 2. Kanban: A Visão de Fluxo de Trabalho\n\nEsta é a sua visão de fluxo de trabalho. O Kanban exibe suas oportunidades como "cards" distribuídos em colunas que representam as etapas do seu funil. É a tela ideal para o gerenciamento ativo do dia a dia.\n\n{% hint style="info" %}\nAviso: Qual Kanban Utilizar?\n\nO Z-PRO possui duas visualizações de Kanban distintas, cada uma com um propósito diferente:\n\n* Kanban de Oportunidades (Esta Página): Utiliza as Etapas do Funil para organizar as oportunidades de negócio. É a ferramenta para a gestão de processos comerciais.\n\n* [Kanban de Atendimentos](/ferramentas-do-atendimento/gestao/kanban-de-atendimento.md): Utiliza Etiquetas (Tags) para organizar visualmente os atendimentos em andamento. É ideal para a gestão operacional da equipe de suporte. Consulte a documentação aqui.\n {% endhint %}\n\n* Filtro para visualização\n\n* Ação Principal: Arraste e solte (drag and drop) os cards de uma coluna para outra para atualizar o progresso de uma oportunidade de forma rápida e visual.\n\n* Ações Adicionais: Dentro de um card, você pode visualizar as informações resumidas do contato e retomar o atendimento.\n\n\n\n#### 3. Calendário: A Visão Temporal\n\nEsta é a sua visão temporal. O Calendário exibe as oportunidades e suas tarefas associadas com base em suas datas de fechamento previstas ou prazos. É útil para planejar suas atividades e follow-ups.\n\n* Ação Principal: Clique em um dia específico no calendário para listar as oportunidades com vencimento naquela data ou para adicionar novas.\n\n\n\nAo clicar no dia, você poderá listar as oportunidades ou adicionar novas:\n\n\n\n*\n\n### Próximo Passo\n\nAgora que você sabe como criar e gerenciar suas oportunidades, o passo final é aprender a automatizar o processo.\n\n📚 4. Automatizando seu Funil com Ações e Fluxos\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades/3.-visualizando-seus-funis-e-oportunidades.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
4. Automatizando seu Funil com Ações e Fluxos\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nEsta documentação detalha o uso da aba "Ação", a central de automação do Funil de Oportunidades.\n\nAqui, você aprenderá a configurar tarefas automáticas de duas formas: como Ações Individuais ou como um Fluxo de Ações (uma sequência de tarefas). Também explicaremos como verificar o histórico de execuções através dos Logs.\n\n### Conceitos Fundamentais\n\nAntes de configurar, é crucial entender as duas regras principais sobre como as Ações funcionam:\n\n{% hint style="danger" %}\nRegra 1: O Cálculo de Tempo é Baseado na DATA DE CRIAÇÃO da Oportunidade\n\nQuando você define que uma ação ocorrerá em "2 dias", significa dois dias após a oportunidade ter sido criada, e não dois dias após ela ter entrado na etapa atual.\n{% endhint %}\n\n A Regra da "Mudança de Etapa"\n Ao configurar múltiplas ações para o mesmo dia, a ação de "Mudar de Etapa" deve ser sempre a última a ser executada.\n\n### A Tela de "Ações": Visão Geral\n\nAo acessar a aba "Ação", você encontrará a interface principal de gerenciamento, que contém:\n\n\n\n Botões Principais:\n + NOVO: Para adicionar uma Ação individual e pontual.\n Novo Fluxo: Para criar um agrupador que conterá uma sequência de ações.\n Ver Logs: Para visualizar o histórico de todas as ações executadas.\n Filtros: Permitem pesquisar uma ação pelo nome ou filtrar a lista por funil, etapa ou tipo de ação.\n Lista de Ações e Fluxos: Uma tabela com todas as automações criadas, exibindo as colunas: Nome, Funil, Etapa, Tipo de Ação, Dias para Disparar, Conexão, Ativo e os botões para Editar ou Excluir.\n Dica: Na coluna "Tipo de Ação", o item será identificado como "Fluxo" se for um agrupador, ou pelo tipo específico (ex: "Enviar Mensagem") se for uma ação individual.\n\n### Opção 1: Criando uma Ação Individual (+ NOVO)\n\nUse esta opção para criar uma única tarefa automatizada.\n\n1. Clique no botão + NOVO.\n2. Preencha os campos no pop-up que aparecer:\n Nome: Um nome para identificar esta ação (ex: "Enviar mensagem de boas-vindas").\n Funil e Etapa: Escolha o funil e a etapa onde esta ação será acionada.\n Tipo de Ação: Selecione o que a automação fará. Campos adicionais aparecerão conforme sua escolha:\n Enviar Mensagem: Selecione a mensagem a ser enviada\n Mudar Etapa: Defina a etapa de destino\n Mudar Status: Defina o status de destino: Aberto, Ganho ou Perdido\n Adicionar Etiqueta: Defina a etiqueta a ser aplicada\n Adicionar Carteira: Defina a carteira de contatos\n Dias para Disparar: Informe o número de dias (a partir da criação da oportunidade) para a ação ser executada.\n Descrição: Um campo para detalhamento interno.\n3. Clique em Salvar. A ação aparecerá na lista geral.\n\n\n\n### Opção 2: Criando um Fluxo com Múltiplas Ações\n\nUse esta opção para organizar uma sequência de várias ações que ocorrerão em uma mesma etapa do funil.\n\n1. Clique no botão Novo Fluxo.\n2. Preencha os dados do "agrupador": Nome do fluxo, Funil e Etapa aos quais ele pertence, e uma Descrição.\n\n\n\n1. Clique no botão + Adicionar Ação.\n2. O pop-up para criar uma ação aparecerá.\n\n 1. Selecione o tipo de ação\n\n \n\n 1. Configure a ação com o nome da ação, detalhe da ação e dias para disparar \n\n \n3. Repita os passos para adicionar quantas ações forem necessárias dentro daquele Fluxo.\n\n### Verificando os Logs de Execução\n\nPara auditar e verificar se suas automações estão sendo executadas corretamente, utilize os logs.\n\n1. Clique no botão Ver Logs.\n2. Uma tela exibirá o histórico de todas as ações, com as seguintes informações: Data da execução, Oportunidade, Contato, Número, Email, Ação executada e o Status ("success" se foi realizada com sucesso).\n\n\n\n{% hint style="warning" %}\nAtenção aos seguintes pontos:\n\n Ao criar uma Ação, os "Tipos de Ação" chamados "Fluxo" e "Funil" atualmente não possuem funcionalidade e não devem ser utilizados.\n Ao criar um Novo Fluxo, o nome inicial pode ser sobrescrito pelo nome da primeira ação criada. Após a criação, você pode clicar em editar e renomear o fluxo para o nome que desejar.\n {% endhint %}\n\n### Exemplos Práticos\n\nAbaixo, apresentamos dois cenários para ilustrar o uso de Ações Individuais e de Fluxos.\n\n#### Exemplo 1: Mudar o Status para "Perdido" (Ação Individual)\n\nObjetivo: Mudar o status de uma oportunidade para "Perdido" automaticamente após 30 dias.\n\nComo configurar:\n\n1. Na tela "Ação", clique no botão + NOVO.\n2. Preencha os campos da seguinte forma:\n Nome: Mover para Perdido após 30 dias\n Funil: Selecione o seu funil de vendas.\n Etapa: Selecione a etapa "Negociação".\n Tipo de Ação: Mudar Status (e então selecione o status "Perdido").\n Dias para disparar: 30 (Lembre-se: 30 dias após a criação da oportunidade).\n3. Clique em Salvar.\n\n#### Exemplo 2: Criar uma Cadência de Follow-up (Fluxo de Ações)\n\nObjetivo: Na etapa "Proposta Enviada", enviar uma mensagem de follow-up após 3 dias e, no mesmo dia, mover a oportunidade para a etapa "Follow-up 1".\n\nComo configurar:\n\n1. Na tela "Ação", clique no botão Novo Fluxo.\n2. Preencha os dados do Fluxo:\n Nome: Follow-up da Proposta\n Funil: Selecione o seu funil de vendas.\n Etapa: Selecione a etapa "Proposta Enviada".\n3. Dentro do fluxo, clique em + Adicionar Ação para criar a primeira ação (a mensagem):\n Descrição: Enviar mensagem Follow-up 1\n Dias para disparar: 3 (Lembre-se: 3 dias após a criação da oportunidade).\n Tipo de Ação: Enviar Mensagem (e então selecione a mensagem desejada).\n4. Clique novamente em + Adicionar Ação para criar a segunda ação (a mudança de etapa):\n Descrição: Mover para etapa Follow-up 1\n Dias para disparar: 3 (O mesmo número de dias, para executar no mesmo momento).\n Tipo de Ação: Mudar de Etapa (e então selecione a etapa "Follow-up 1").\n (Lembre-se da regra: a ação de "Mudar de Etapa" deve ser a última do conjunto para o mesmo dia).\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades/4.-automatizando-seu-funil-com-acoes-e-fluxos.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
5. Ações em tickets (Follow-up Automático)\n\nA funcionalidade "Ações em Tickets" (disponível a partir da v3.1.4.5) permite criar automações de follow-up para reengajar clientes.\n\nDiferente das "Ações de Fluxo" (que disparam quando um card é movido), estas ações são baseadas no tempo. Elas são disparadas quando um ticket fica um número X de horas sem resposta do cliente, desde que a última mensagem tenha sido enviada por um atendente (saída do Z-PRO).\n\nO sistema monitora tickets nos status Aberto, Pendente e Fechado, e executa a ação que você configurar.\n\n{% hint style="info" %}\nLógica da Automação\n\nEsta automação só será disparada se a última mensagem no ticket foi do atendente (saída do Z-PRO) e o cliente não respondeu dentro do tempo estipulado. O sistema verifica esta condição em tickets Abertos, Pendentes e Fechados.\n{% endhint %}\n\n### Como Configurar\n\nPara acessar e criar as novas ações, siga os passos:\n\n1. No menu principal, acesse Funil.\n2. Na parte superior, clique na nova aba Ações em tickets.\n3. Clique no botão "Adicionar" para criar uma nova regra.\n\n\n\n\n\n### Preenchendo os Campos da Ação\n\nAo criar ou editar uma ação, você verá os seguintes campos:\n\n\n\n Nome da ação: Um nome para sua identificação (ex: "Follow-up 24h", "Mover para Perdido 48h").\n* Tempo (em horas): O número de horas que o sistema deve aguardar pela resposta do cliente antes de disparar a ação.\n* Tipo de ação: O que deve acontecer após o tempo de espera ser atingido.\n* Descrição: Detalhamento da ação.\n\n*\n\n### Tipos de Ações Disponíveis\n\nAtualmente, você pode configurar as seguintes ações automáticas:\n\n\n\n#### 1. Enviar Mensagem\n\nEsta ação envia uma mensagem de texto automática para o cliente, reabrindo o ticket se necessário.\n\n Como usar: Selecione a "Ação" como "Enviar Mensagem". Escreva o texto no campo "Mensagem" e escolha a "conexão" (canal) por onde a mensagem deve ser enviada.\n Caso de Uso: Perfeito para reengajar um cliente com uma mensagem de follow-up (ex: "Olá! Conseguiu verificar a proposta que enviei?").\n\n\n\n \n\n\n#### 2. Adicionar Etiqueta\n\nEsta ação aplica uma etiqueta (Tag) específica ao contato.\n\n Como usar: Selecione a "Ação" como "Adicionar Etiqueta" e, em seguida, escolha a "Etiqueta" desejada no campo que aparecerá.\n Caso de Uso: Útil para classificar clientes inativos. Por exemplo, se um cliente não responde em 72 horas, o sistema pode adicionar automaticamente a etiqueta "Cliente Frio".\n\n\n\n#### 3. Adicionar Carteira\n\nEsta ação atribui o contato (lead) a uma carteira de usuário específica.\n\n Como usar: Selecione a "Ação" como "Adicionar Carteira" e, em seguida, escolha o "Usuário" (atendente) que se tornará o dono desse contato.\n *Caso de Uso: Se um lead de prospecção não responde ao atendente atual, a ação pode movê-lo automaticamente para a carteira de um gerente ou de um especialista em recuperação.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/funil-de-oportunidades/5.-acoes-em-tickets-follow-up-automatico.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Kanban de atendimento\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nO Kanban é uma ferramenta que você pode utilizar para ter um melhor Controle Visual de Atendimentos. O kanbans são totalmente personalizáveis, sendo assim, você pode criar quantos forem necessários para melhor funcionamento dos seus setores de atendimento.\n\n{% hint style="info" %}\nAviso: Qual Kanban Utilizar?\n\nO Z-PRO possui duas visualizações de Kanban distintas, cada uma com um propósito diferente:\n\n Kanban de Atendimentos (Esta Página): Utiliza Etiquetas (Tags) para organizar visualmente os atendimentos em andamento. É ideal para a gestão operacional da equipe de suporte.\n Kanban de Oportunidades: Utiliza as Etapas do Funil para organizar as oportunidades de negócio. É a ferramenta para a gestão de processos comerciais. Consulte a documentação aqui.\n {% endhint %}\n\nPara acessá-lo, clique no ícone de Kanban no menu lateral do seu painel.\n\n\n\nInicialmente você verá a seguinte tela:\n\n\n\nAqui se encontrarão os kanbans criados em Configurações ou um controle visual dos atendimentos com etiquetas definidas.\n\n### Aba Kanban\n\nVocê verá a seguinte tela:\n\n\n\nAqui se encontrarão os kanbans criados em Configurações. Esse é um dos exemplos de kanbans possíveis, mas as possibilidades são diversas. Você pode utilizá-lo para visualizar os atendimentos por categoria.\n\nEssa função auxilia não só na organização dos seus tickets, como também potencializa o uso do seu painel, transformando-o num CRM poderoso.\n\nQuando inserido o Kanban, assim como foi mostrado na seção Atendimento, os contatos se organizarão de forma semelhante a essa:\n\n\n\nAqui será possível ver: Foto de Perfil, Nome do Cliente, Número do WhatsApp e Número do Ticket de Atendimento. Logo abaixo estão as ações de retomar o atendimento e retirar o kanban atribuído, respectivamente.\n\n\n\nLembrando que você também pode mover esses contatos de acordo com o andamento do atendimento. Assim, os dados do kanban estarão sempre atualizados. Não se esqueça de, ao final das alterações, clicar em Save.\n\n### Aba Etiquetas\n\nVocê verá a seguinte tela:\n\n\n\nAqui se encontrarão os cards criados de acordo com as etiquetas definidas para cada atendimento. Ele serve apenas para visualização, e não é possível salvar etiquetas ao manipular os cards. \n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/kanban-de-atendimento.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Tarefas\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nAs tarefas são uma forma de organizar o dia-a-dia dos colaboradores. Assim, é possível que eles criem uma rotina de atividades, categorizando-as por prioridade, data limite de realização, usuário responsável, etc.\n\nPara acessá-lo, clique no ícone de Tarefas no menu lateral do seu painel.\n\n\n\nVocê verá a seguinte tela:\n\n\n\n## Adicionar Tarefa \n\nClique em Adicionar no canto superior da tela.\n\n\n\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\n\n\n\nRecorrência de Tarefas:\n\n\n\nConheça os campos de preenchimento:\n\n| Campo | Descrição |\n| ------------------------ | ------------------------------------------------------------------- |\n| Nome | Insira um nome para essa tarefa. |\n| Descrição | Nesse campo você irá descrever qual a ação deve ser realizada. |\n| Data Limite | Prazo final para cumprir a tarefa. |\n| Responsável | Escolha o Usuário que será responsável por cumprir essa demanda. |\n| Recorrência | Período que a tarefa se repetirá |\n| Quantidade de repetições | Número de repetições |\n| Status | |\n| Prioridade | |\n| Comentários | Pode adicionar comentários ou instruções extras. |\n\nClique em Salvar para finalizar o cadastro da tarefa e pronto!\n\n## Gerenciar Tarefas \n\nVocê pode utilizar o campo de pesquisa para procurar alguma tarefa mais antiga, seja por nome, descrição ou palavra chave utilizada na descrição.\n\n\n\nVocê também pode filtrar as tarefas usando as opções abaixo:\n\n\n\nNa parte inferior do painel de Tarefas, você poderá visualizar as informações das tarefas.\n\n\n\nEm Ações você pode:\n\n| Descrição | Aparência |\n| --------------- | ------------------------------------------------------------------- |\n| Concluir Tarefa | |\n| Duplicar Tarefa | |\n| Editar Tarefa | |\n| Excluir Tarefa | |\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/gestao/tarefas.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Home e Dashboard\n\n- Home: Dashboard\n- Dashboard\n- Barra de ferramenta geral\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/home-e-dashboard.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Barra de ferramenta geral\n\n{% hint style="warning" %}\nDisponível para o perfil: Todos os perfis\n{% endhint %}\n\nA Barra de Ferramentas Superior é um componente global e permanente do sistema Z-PRO. Localizada no canto superior direito de todas as telas, ela reúne utilitários essenciais para a operação, permitindo que o usuário gerencie notificações, tarefas e comunicações rápidas sem interromper sua navegação atual.\n\n#### Caso de uso\n\nDurante a análise de um Dashboard, um gestor percebe a necessidade de delegar uma ação imediata. Sem sair da tela de métricas, ele utiliza o ícone de Lista de Tarefas na barra superior para criar um lembrete ou utiliza o Avião de Papel para iniciar uma nova conversa com um parceiro comercial, mantendo o foco na análise principal.\n\n#### Como acessar a página\n\nA barra de ferramentas é fixada no topo da interface, estando sempre acessível independentemente do módulo que o usuário esteja utilizando.\n\n\n\n*\n\n#### Detalhamento dos Ícones e Funcionalidades\n\nAbaixo, cada recurso da barra de ferramentas é explicado com sua respectiva forma de uso:\n\n1. Bolinha Verde (Status do Usuário)\n\nIndica que o Usuário está ativo e com conexão estável com o servidor do Z-PRO. Caso a cor mude ou o ícone desapareça, pode indicar problemas de conexão local ou necessidade de reautenticação.\n\n2. Ícone de Relógio (Histórico de Ações)\n\nFornece um log de auditoria simplificado das operações realizadas pelo usuário na sessão.\n\n* Como usar: Ao clicar, um painel lateral exibe ações como DELETE (exclusão), POST (criação) ou PUT (edição). Cada registro mostra o recurso afetado (ex: tickets, mensagens) e há quanto tempo ocorreu.\n* Atualização: Clique no ícone de seta circular no topo do painel para carregar novas ações registradas.\n\n\n\n3. Ícone de Linguagem (Seleção de Idioma)\n\nPermite traduzir a interface do sistema para diferentes idiomas de forma global.\n\n* Como usar: Clique na sigla do idioma atual (ex: PT). Uma lista suspensa será exibida com opções como Inglês, Espanhol, Alemão, entre outros. Ao selecionar, o sistema aplica a tradução imediatamente.\n\n\n\n4. Ícone de Sino (Notificações)\n\nCentraliza alertas de novos Tickets aguardando atendimento ou interações no Chat Privado.\n\n* Funcionamento: O círculo vermelho com número indica a quantidade de notificações não lidas. Ao clicar, o sistema exibe os detalhes e permite navegar diretamente para a conversa em questão.\n\n\n\n5. Balão de Mensagem (Mensagens Internas/Avisos)\n\nEspaço reservado para comunicados enviados diretamente pelo Superadmin do sistema.\n\n* Como usar: Utilize este ícone para ler informativos sobre atualizações do sistema, manutenções programadas ou avisos administrativos gerais da plataforma.\n\n6. Ícone de Prancheta (Lista de Tarefas)\n\nFerramenta de organização pessoal para o colaborador.\n\n* Como usar: Ao clicar, abre-se um resumo das tarefas pendentes. Caso precise de uma gestão completa, clique no botão "Ver todas as tarefas" para ser redirecionado à página de Tarefas do sistema.\n\n\n\n7. Ícone de Avião de Papel (Nova Conversa Avulsa)\n\nPermite iniciar um chat com um contato que ainda não possui um atendimento aberto, utilizando um Canal específico.\n\n* Passo a passo:\n 1. Clique no ícone.\n 2. Selecione a Sessão WhatsApp (canal) desejada.\n 3. Digite o Número do destinatário (com código do país).\n 4. Selecione um Template caso for o canal WABA\n 5. Clique em Enviar\n\n\n\n8. Ligação Wavoip\n\nComo usar: Clique no ícone e irá aparecer um botão de ligação no canto inferior esquerdo. \n\n\n\nAo clicar nesse ícone irá abrir um discador para realizar a ligação.\n\n\n\n{% hint style="info" %}\nPara ter o ícon de ligações Wavoip é preciso ter o canal configurado em: \n{% endhint %}\n\n9. Tutorias\n\nComo usar: Clique no ícone para verificar os vídeos de tutorial que foram adicionados.\n\n\n\n10.Ícone de Headset (Chat com Suporte)\n\nCanal de comunicação direta com a equipe de suporte do Z-PRO.\n\n* Como usar: Clique para abrir uma janela de chat flutuante. É possível enviar mensagens de texto e arquivos para sanar dúvidas técnicas sobre a plataforma.\n\n\n\n{% hint style="warning" %}\nConfiguração de Tenant: O ícone de Chat com Suporte pode não estar visível para todos os usuários se não tiver sido habilitado nas configurações da empresa (Tenant).\n{% endhint %}\n\n11.Avatar de Usuário (Perfil e Sessão)\n\n\n\nLocalizado na extremidade direita da barra, este ícone exibe a inicial do usuário e centraliza informações de conta, status de licença e gerenciamento de sessão.\n\n* Identificação do Usuário: No topo do menu, são exibidos o nome completo, e-mail de acesso e a tag correspondente ao perfil de acesso (ex: admin, user).\n* Informações de Sistema: Exibe a versão atual do software Z-PRO e o status da Licença (Ativa ou Inativa).\n* Status de Disponibilidade (Online): Indica o estado atual do atendente no sistema.\n* Meu Perfil: Atalho direto para a página de Configurações de Perfil, onde é possível alterar senha, foto e dados pessoais.\n* Limpar cookies: Executa a limpeza dos arquivos temporários de navegação exclusivos do sistema.\n Uso: Recomendado para resolver problemas de carregamento de interface ou atualizar permissões recém-alteradas sem a necessidade de deslogar.\n Sair:** Encerra a sessão atual do usuário e retorna para a tela de login.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/home-e-dashboard/barra-de-ferramenta-geral.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Dashboard\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nA página de Dashboard oferece uma visão analítica e centralizada de toda a operação de atendimento no sistema Z-PRO. Através de indicadores de desempenho (KPIs) e gráficos em tempo real, os gestores podem monitorar produtividade, tempos de resposta e a distribuição de demandas por diversos critérios.\n\n#### Principais funções\n\n Monitoramento em Tempo Real: Visualização instantânea do fluxo de conversas.\n Análise de Produtividade: Métricas individuais por agente de atendimento.\n Controle de Prazos: Acompanhamento de tempos médios de espera e atendimento.\n Segmentação de Dados: Filtros por período, canais, filas e status.\n\n#### Caso de uso\n\nUm gestor de atendimento utiliza o Dashboard no início do dia para identificar o volume de Demanda Receptiva do período anterior. Ao notar um aumento no TME (Tempo Médio de Espera), ele analisa o gráfico Por Usuário para identificar quais atendentes estão com maior carga de trabalho e decide redistribuir os Tickets para equilibrar a operação.\n\n#### Como acessar a página\n\nClique no Menu Principal e selecione a aba Dashboard.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\nCabeçalho e Filtros:\n\n Filtros de Período: Atalhos rápidos para visualizar dados de Hoje, 7 dias, 30 dias ou 90 dias.\n Calendário (De/Até): Permite selecionar um intervalo de datas personalizado.\n Chave Conversas/Grupos: Altera a visualização das métricas entre atendimentos individuais e atividades em grupos.\n Ícone Atualizar: Recarrega os dados do dashboard para exibir as informações mais recentes.\n Botão Personalizar: Permite que o usuário reorganize a posição dos gráficos e widgets na tela conforme sua preferência.\n\nCards de Métricas Principais:\n\n Total de Atendimentos: Soma total de interações no período selecionado.\n Demanda Ativa: Atendimentos iniciados pelos atendentes da empresa.\n Demanda Receptiva: Atendimentos iniciados pelos clientes.\n Novos Contatos: Quantidade de clientes que interagiram pela primeira vez.\n TMA (Tempo Médio de Atendimento): Média de tempo de duração das conversas.\n TME (Tempo Médio de Espera): Média de tempo que o cliente aguardou até ser atendido.\n\nGráficos de Distribuição:\n\n Por Fila: Distribuição percentual dos atendimentos entre os departamentos (Filas).\n Por Status: Divisão entre atendimentos Encerrados, Em aberto e Pendentes.\n Por Canal: Volume de atendimentos segmentados por Canais (WhatsApp, Instagram, Facebook, etc).\n\n\n\n*\n\n#### Passo a passo de uso\n\n1. Definir Período: Selecione o intervalo de tempo desejado nos filtros superiores para carregar a base de dados.\n2. Alternar Visão: Utilize a chave seletora para alternar entre métricas de Conversas (padrão) ou Grupos, se necessário.\n3. Analisar Tendências: Observe o gráfico de Evolução por Período para identificar picos de demanda em dias ou horários específicos.\n4. Avaliar Desempenho: Role a página até a tabela de Desempenho por Usuário para comparar as métricas entre os membros da sua Equipe.\n5. Reorganizar Layout: Clique em Personalizar, arraste os widgets para as posições desejadas e salve para fixar sua visualização preferida.\n\n#### Detalhamento da Tabela de Desempenho\n\nA tabela final detalha a performance individual de cada Usuário:\n\n* Pendentes/Atendendo/Resolvidos: Status atual das conversas de cada agente.\n* Avaliação: Média das notas atribuídas pelos clientes ao final do atendimento.\n* TME/TMA Individual:* Permite identificar gargalos técnicos ou necessidade de treinamento em agentes específicos.\n\n\n\n \n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/home-e-dashboard/dashboard.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Home\n\n{% hint style="warning" %}\nDisponível para o perfil: Administrador, Supervisor e Usuário\n{% endhint %}\n\nA página Home é o ponto de partida do sistema Z-PRO após o login. Ela funciona como um cockpit de navegação, oferecendo atalhos visuais e informações resumidas para facilitar o início da jornada de trabalho do colaborador.\n\n#### Principais funções\n\n Navegação Ágil: Atalhos diretos para os módulos mais utilizados.\n Histórico de Navegação: Exibição de páginas visitadas recentemente.\n Central de Avisos: Painel com informações rápidas e dicas sobre os recursos do sistema.\n Identificação de Perfil: Exibição clara do nome do usuário e nível de acesso.\n\n#### Caso de uso\n\nAo iniciar o turno, um atendente utiliza a página Home para acessar instantaneamente a tela de Atendimentos ou verificar o Chat Privado em busca de comunicados internos. Em vez de navegar por todos os menus laterais, ele utiliza os cards centrais para economizar tempo e otimizar a produtividade.\n\n#### Como acessar a página\n\nClique no Menu Principal e na aba Home.\n\n\n\n#### Você verá a seguinte tela:\n\n\n\nExplicação dos campos e ícones\n\n Banner de Saudação: Exibe o nome do usuário logado e o seu nível de permissão (ex: User ou Admin).\n Cards de Acesso Principal:\n Páginas Recentes: Lista as últimas telas acessadas pelo usuário, permitindo um retorno rápido a uma atividade interrompida.\n Informações Rápidas: Seção informativa com lembretes \n *Acesso Rápido: Menu lateral direito com links em lista para Campanhas, Dashboard e outros recursos essenciais.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/ferramentas-do-atendimento/home-e-dashboard/home.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Home
Integrando Apis Externas Evolution Wuzapi Z Api Uazapi
Integrando APIs Externas (Evolution, Wuzapi, Z-API, Uazapi)\n\n{% hint style="warning" %}\nA instalação, manutenção e o funcionamento de todas as APIs e ferramentas de terceiros (sejam de código aberto ou serviços pagos) são de inteira responsabilidade do assinante.\n\nNosso suporte não presta assistência para a configuração ou falhas de softwares externos. O Z-PRO não oferece nenhuma garantia sobre a estabilidade, segurança ou funcionamento de qualquer ferramenta de terceiro.\n{% endhint %}\n\nEsta documentação fornece o guia técnico para integrar e configurar APIs de conexão não oficiais externas com a sua plataforma Z-PRO.\n\nO foco é mostrar o passo a passo para a integração, caso queira aprender como instalar as APIs, clique nos links:\n\n Evoluiton API\n Wuzapi (Meow)\n Z-API\n Uazapi\n\n## Tutorial em Vídeo para integração:\n\n{% embed url="https://www.youtube.com/live/YPqliPPUPfs" %}\n\n## Passo a passo:\n\n### Pré-requisito: Habilitando as Integrações no Painel Admin\n\nPor padrão, as opções de conexão com APIs externas não são visíveis por padrão. É necessário habilitar no painel do Administrador.\n\n1. Acesse o painel Admin.\n2. Navegue até o menu Configurações > Integrações.\n\n\n\n3. Preencha as informações (URL e Chave Global/Token) para cada API que deseja disponibilizar.\n\n\n\nSomente após esta configuração, a opção de canal correspondente aparecerá no painel dos canais.\n\n*\n\n### 1. Integração com Evolution API\n\nA Evolution API é uma solução auto-hospedada (self-hosted) e gratuita, baseada na tecnologia Baileys.\n\n{% hint style="info" %}\nTutorial de como instalar a Evolution API: https://www.youtube.com/watch?v=ibXm0HHbhhs\n{% endhint %}\n\nPasso 1: Configuração no Painel Admin\n\n1. Navegue até Configurações > Integrações > Evolution API.\n2. Preencha os seguintes campos:\n * URL da API: A URL base da sua instalação da Evolution API.\n * Global API Key: A chave de autenticação (API\_KEY) definida durante a instalação da sua Evolution.\n\n{% hint style="warning" %}\nAtenção: Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.\n{% endhint %}\n\nPasso 2: Criando o Canal\n\n1. Acesse o painel Admin do tenant desejado.\n2. Navegue até Canais > Adicionar Canal. A opção "Evolution API" estará visível.\n3. Dê um nome à conexão e salve. O Z-PRO irá criar a instância e configurar o webhook automaticamente na sua Evolution API.\n\nObservações Importantes:\n\n* Conectando uma Instância Existente: Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o mesmo nome exato da instância. O sistema irá sincronizar e configurar o webhook.\n* Nomenclatura: Não utilize caracteres especiais (como \_) no nome da instância, pois isso pode causar falhas na sincronização.\n* Nome da Instância: Uma vez criado, o nome da instância não pode ser alterado.\n\n*\n\n### 2. Integração com Wuzapi (Meow)\n\nWuzapi (também conhecida como Meow) é outra solução auto-hospedada (self-hosted) e gratuita.\n\n{% hint style="info" %}\nTutorial de como instalar a Wuzapi (Meow): https://www.youtube.com/watch?v=s7G1ZuQLw0Y&t=2s\n{% endhint %}\n\nPré-requisito na Instalação do Wuzapi\n\n No arquivo de configuração (.env) da sua instalação do Wuzapi, é obrigatório preencher a variável API\_URL com a URL pública onde sua instância do Wuzapi está acessível.\n\nPasso 1: Configuração no Painel Admin\n\n1. Navegue até Configurações > Integrações > Wuzapi.\n2. Preencha os seguintes campos:\n URL da API: A URL base da sua instalação do Wuzapi.\n Chave Global: O token de administrador definido na variável APP\_ADMIN\_TOKEN do arquivo .env do seu Wuzapi.\n\nPasso 2: Criando o Canal\n\n1. Acesse o painel Admin e navegue até Canais > Adicionar Canal. A opção "Wuzapi" estará visível.\n2. Dê um nome à conexão e salve. A instância será criada no seu Wuzapi e o webhook será configurado automaticamente. O painel do Z-PRO permitirá gerar tanto o QR Code quanto o Paring Code.\n\n**\n\n### 3. Integração com Z-API\n\nA Z-API é uma solução não oficial paga e gerenciada por uma empresa externa. https://www.z-api.io/\n\nPré-requisito na Plataforma Z-API\n\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\n\nPasso 1: Configuração no Painel Admin\n\n1. Navegue até Configurações > Integrações > Z-API.\n2. Preencha os seguintes campos:\n URL da API: A URL padrão do serviço (https://api.z-api.io).\n Chave Global: O seu "Token de Segurança" gerado nas configurações da sua conta na Z-API.\n\nPasso 2: Criando o Canal\n\n1. Acesse o painel Admin e navegue até Canais > Adicionar Canal. A opção "Z-API" estará visível.\n2. Preencha os campos com as credenciais da instância que você criou na plataforma Z-API:\n ID da Instância\n Token da Instância\n3. Salve. A partir deste momento, você poderá gerar o QR Code e gerenciar a conexão diretamente pelo painel do Z-PRO.\n\n**\n\n### 4. Integração com Uazapi\n\nA Uazapi também é uma solução não oficial paga e gerenciada. https://uazapi.dev/\n\nPasso 1: Configuração no Painel Admin\n\n1. Navegue até Configurações > Integrações > Uazapi.\n2. Preencha os seguintes campos:\n URL da API: A URL do servidor da sua conta Uazapi.\n Chave Global: O "Admin Token" fornecido no painel da sua conta Uazapi.\n\nPasso 2: Criando o Canal\n\nA integração com a Uazapi oferece duas possibilidades:\n\n A) Criar uma Nova Instância:\n 1. No painel Admin, vá em Canais > Adicionar Canal e selecione "Uazapi".\n 2. Dê um nome para a nova instância (ex: "Cliente A").\n 3. Deixe os campos ID da Instância e Token em branco.\n 4. Salve. O Z-PRO irá criar a nova instância na sua conta Uazapi e preencherá as credenciais automaticamente.\n B) Conectar a uma Instância Existente:\n 1. Siga os mesmos passos acima, mas desta vez preencha os campos ID da Instância e Token com as informações da instância já existente na sua conta Uazapi.\n\n*\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/integrando-apis-externas-evolution-wuzapi-z-api-uazapi.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Primeiro Acesso
Instalar Z-PRO\n\n- 1. Preparar ambiente\n- 2. Instalação automática\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/primeiro-acesso/instalar-z-pro.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
1. Preparar ambiente\n\n### Link para aula completa - portal do assinante\n\nNesta aula, vamos cobrir os dois pré-requisitos fundamentais que você precisa preparar antes de instalar o Z-PRO: a contratação de um servidor (VPS) e a configuração de um domínio.\n\n#### ⚠️ Requisitos\n\n1- VPS\n\n 4 vcpus\n 16 gb de RAM\n Latência até 50 ms\n SSD ou NVME à partir de 200gb\n Ubuntu 20.04, 22.04 ou 24.04 LTS sem Painel\n Arquitetura AMD\n\n2- Opções sugeridas (avaliar latência antes da contratação):\n\n https://www.hostinger.com.br/\u200b\u200b\n https://www.hetzner.com/\n https://www.digitalocean.com/\u200b\n https://aws.amazon.com/\n https://www.ovhcloud.com/pt/\u200b\n\n\u200bServidores que NÃO devem ser usados\n\n1. Hostgator\n2. Contabo\n\n3- Domínio: https://registro.br/\u200b\u200b\n\n**\n\n#### Passo a passo do vídeo\n\n### Passo 1: Contratação do Servidor (VPS)\n\nA primeira etapa é ter um servidor na nuvem.\n\n Ação: Contrate um plano de VPS. Recomendamos o uso do sistema operacional Ubuntu 20.04, 22.04 ou 24.04 LTS sem Painel.\n Localização: Dê preferência a um servidor localizado no Brasil para garantir baixa latência.\n Ao Final: Após a contratação, o provedor irá fornecer um endereço de IP para sua VPS. Guarde este número.\n\n### Passo 2: Configuração do Domínio\n\nO Z-PRO utiliza dois subdomínios: um para a interface (front-end) e outro para a API (back-end).\n\n Ação: Acesse a zona de DNS do seu domínio.\n Crie dois Apontamentos do Tipo “A”:\n 1. Front-end: Crie um subdomínio (ex: app) apontando para o IP da sua VPS.\n 2. Back-end: Crie outro subdomínio (ex: api) apontando para o mesmo IP da sua VPS.\n Aviso para Cloudflare: Se você usa o Cloudflare, lembre-se de desativar o proxy (clicar na “nuvem laranja” para deixá-la cinza).\n\n### Passo 3: Verificação da Propagação (DNS Checker)\n\nApós criar os apontamentos, é preciso aguardar a propagação.\n\n Ação: Use uma ferramenta online como o *DNS Checker https://dnschecker.org/\\n para verificar seus dois subdomínios. O processo está concluído quando a maioria dos locais exibir o IP correto.\n\n### Encerramento\n\nCom a VPS contratada e os domínios apontados, seu ambiente está pronto! Na próxima aula, vamos conectar ao servidor e rodar o instalador.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/primeiro-acesso/instalar-z-pro/1.-preparar-ambiente.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
2. Instalação automática\n\n### Link para aula completa - portal do assinante\n\n### Pré-requisitos para instalação\n\n Ambiente Pronto: Garanta que você já concluiu a Aula 1, com o servidor VPS contratado e os dois subdomínios (front-end e back-end) apontados para o IP correto.\n Instalador Baixado: Faça o download do pacote do instalador (zpro_passaporte_shell.zip) disponível nessa aula e descompacte o arquivo em seu computador.\n\n### Passo 1: Conexão com o Servidor (via SSH)\n\nPara interagir com o servidor, você precisará de um cliente SSH.\n\n Ação: Use um programa como o Bitvise (para Windows) ou o terminal para conectar.\n Dados para Conexão:\n Host: O IP da sua VPS.\n Porta: 22\n Usuário: root\n Senha: A senha de root que você definiu ao criar a VPS.\n\n### Passo 2: Atualização Inicial do Servidor\n\nAntes de instalar, é uma boa prática atualizar os pacotes do sistema operacional.\n\n Ação: Após conectar, execute o comando abaixo e aguarde a conclusão.\n apt update && apt upgrade -y\n Em seguida, reinicie o servidor para aplicar as atualizações:\n reboot\n Aguarde e reconecte-se ao servidor via SSH.\n\n### Passo 3: Upload do Instalador\n\n Ação: Use o SFTP (disponível no Bitvise ou outro cliente) para enviar a pasta descompactada (zpro_passaporte_shell) para o diretório /root do seu servidor.\n\n### Passo 4: Execução do Instalador\n\nAgora vamos rodar o script de instalação.\n\n Ação: No seu terminal SSH, execute os seguintes comandos em ordem:\n 1. cd ~\n 2. sudo chmod +x ./zpro_passaporte_shell/zpro (Torna o arquivo executável).\n 3. cd ./zpro_passaporte_shell (Entra na pasta do instalador).\n 4. sudo ./zpro (Executa o instalador).\n\n### Passo 5: Iniciar a Instalação no Menu\n\nO último comando abrirá um menu interativo no terminal.\n\n Ação: Pressione a tecla 1 e Enter para selecionar “Instalar instância primária”.\n Informe os dados solicitados:\n Seu e-mail.\n Seu subdomínio do front-end (ex: app.seudominio.com.br).\n Seu subdomínio do back-end (ex: api.seudominio.com.br).\n\n### Passo 6: Ações de Segurança Pós-Instalação (Obrigatório)\n\nAo final do processo, o sistema estará instalado, mas você deve realizar ações de segurança.\n\n Ação: Utilize os dados de acesso fornecidos ao final da instalação para alterar todas as senhas padrão e segredos.\n\nAtenção: A segurança do seu ambiente é sua responsabilidade.\n\n Configure Backups: Ative uma rotina de backups periódicos no seu servidor.\n* Crie uma rotina de segurança, a cada 6 meses, alteres esses dados\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/primeiro-acesso/instalar-z-pro/2.-instalacao-automatica.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Onboarding - novos assinantes\n\n## Primeiros Passos Após a Assinatura\n\nEste guia detalha a sequência de ações recomendadas após a confirmação da sua assinatura Z-PRO, desde o recebimento dos seus acessos até a instalação da plataforma. Seguir estes passos na ordem correta é fundamental para um processo de onboarding eficiente.\n\n{% embed url="https://youtu.be/-dRLmAo3r6M" %}\n\n### Passo 1: Verifique seu E-mail\n\nApós a compra, você receberá dois e-mails automáticos com as informações mais importantes para começar:\n\n1. Acesso à Portal do assinante: Um link para acessar sua área de membros exclusiva. Nela, você encontrará as videoaulas com o passo a passo, vídeo- aulas e arquivos necessários para as próximas etapas.\n2. Código de Licença: Uma chave de licença única. Guarde esta chave em um local seguro. Ela será utilizada após a instalação do sistema para validar e ativar sua assinatura.\n\n### Passo 2: Prepare o Ambiente (Pré-requisito Obrigatório)\n\nAntes de solicitar a instalação, é obrigatório preparar o ambiente onde o Z-PRO será instalado. Você pode verificar os requisitos aqui.\n\nAcesse a Portal do assinante e assista às aulas iniciais que ensinam como:\n\n Contratar um Servidor VPS: Escolher e contratar um servidor VPS que atenda aos Requisitos de Uso da plataforma.\n Configurar seu Domínio: Registrar e apontar um domínio ou subdomínio para o IP do seu novo servidor.\n\nA equipe de instalação não poderá iniciar o procedimento sem que estas duas etapas estejam concluídas.\n\n### Passo 3: Escolha o Método de Instalação\n\nCom o servidor e o domínio prontos, você tem duas opções para instalar o Z-PRO:\n\n#### Opção 1: Agendamento de instalação com a Equipe Z-PRO\n\nEsta é a opção para quem prefere que nossa equipe técnica realize o procedimento.\n\nComo Solicitar: A solicitação deve ser feita exclusivamente via https://suporte.zdg.com.br/, nosso portal oficial de suporte. Abra um chamado "Agendar instalação" e forneça as informações do seu servidor e domínio conforme orientado nas aulas.\n\n Senha e login do painel da VPS\n 1. Mínimo 16gb de RAM e 4vcpus\n 2. AMD\n 3. Ubuntu 20.04 ou 22.04\n 4. A VPS deverá ser formata e não deve conter nenhuma instalação prévia\n 5. Acesso SSH ao usuário ROOT e IP da VPS\n Senha e login do painel DNS (domínio)\n Subdomínio de front e back que pretende usar, apontados para o IP da VPS (Tipo A)\n E-mail de compra do Z-PRO\n Número de Whatsapp\n\nPrazo: O prazo para a conclusão da instalação pela equipe é de 2 a 5 dias úteis, contados a partir do envio dos dados corretos no ticket.\n\n#### Opção 2: Auto-instalação\n\nPara usuários que desejam iniciar imediatamente e possuem familiaridade com ambientes de servidor.\n\n Recursos: O script de auto-instalação e o vídeo tutorial com o passo a passo estão disponíveis na Portal do assinante\n Disponibilidade: O acesso a estes recursos é liberado imediatamente após a confirmação do pagamento, permitindo que você instale a plataforma a qualquer momento.\n\n### Recursos Adicionais Importantes\n\n Diretrizes da Plataforma: Recomendamos a leitura completa da nossa seção de Diretrizes da Plataforma, onde você encontra os Termos de Uso, Política de Privacidade e as boas práticas de segurança.\n Canal de Avisos no Telegram: Na área de membros, você encontrará o link para nosso canal exclusivo de avisos. Mantenha as notificações ativas para ser informado sobre atualizações e novidades importantes.\n Roadmap Público: Você pode acompanhar o desenvolvimento de novas funcionalidades e sugerir melhorias em nosso roadmap aberto, disponível em: https://roadmap.zdg.com.br/\n\nApós a instalação ser concluída, você receberá os acessos e poderá começar a utilizar o Z-PRO.\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/primeiro-acesso/onboarding-novos-assinantes.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Primeiro Acesso ao Sistema\n\n{% embed url="https://youtu.be/Ov_LNKxdAJA" %}\n\n## 1. Realizando o Primeiro Login\n\nApós a conclusão da instalação pela equipe Z-PRO, você receberá no Tomticket todos os dados de acesso e as credenciais da sua nova instância. Abaixo, detalhamos cada uma dessas informações.\n\n#### Dados Recebidos Após a Instalação\n\n URL Front-end e Back-end: Os endereços de acesso à sua plataforma e à sua API. A URL do Front-end é a que você usará para acessar o sistema.\n Login e Senha (Superadmin): Suas credenciais de administrador mestre da plataforma.\n Login e Senha (Usuário Padrão): Credenciais de um usuário de atendimento, criado para testes iniciais.\n Acesso ao Portainer: URL, usuário e senha para acessar a interface de gerenciamento dos contêineres Docker da sua aplicação.\n Senha (Usuário deployzdg): Senha do usuário do sistema operacional do servidor\n Credenciais do Banco de Dados: Nome do banco de dados, usuário e senha de acesso.\n Senha do Redis: Senha de acesso ao serviço Redis, utilizado para gerenciamento de cache e filas.\n Status do Firewall: Confirmação de que o firewall do servidor foi ativado com as portas necessárias liberadas.\n\n#### Passos para o Primeiro Acesso\n\n1. Acesse a URL do Front-end informada no ticket.\n2. Utilize as credenciais do Superadmin para fazer o login.\n3. Imediatamente após o login, o primeiro passo funcional dentro do sistema é validar sua assinatura. Acesse o painel "Assinatura" para inserir sua chave de licença.\n\n\n\n## 2. Entendendo os Níveis de Acesso\n\nPara garantir a segurança e a organização do Z-PRO, o sistema é dividido em três níveis hierárquicos de permissão. É fundamental entender a diferença entre eles:\n\n#### 1. Superadmin\n\n Acesso: Tem controle total sobre o sistema.\n Função: Cria planos, gerencia assinaturas, configura integrações globais (como Typebot e WABA), personaliza a marca (White-label) e cria os Tenants (empresas clientes).\n\nVisão dos módulos do painel superadmin:\n\n\n\n#### 2. Admin e supervisor (Tenant / Cliente)\n\n Acesso: Restrito apenas aos dados da própria empresa.\n Função: Gerencia os atendentes (usuários), cria departamentos (filas), configura o Chatbot e visualiza relatórios de atendimento.\n Limitação: Não consegue ver dados de outras empresas nem alterar configurações do servidor.\n\nVisão dos módulos do painel admin:\n\n\n\n#### 3. Usuário (Atendente)\n\n Acesso: Operacional.\n Função: Utiliza o Chat, Kanbans, Tarefas e Agendamentos.\n Limitação: Não tem acesso às configurações administrativas (nem do Superadmin, nem do Admin, a menos que permitido).\n\n\n\n## 3. Conectando um canal\n\n### Passo 1: Crie um Usuário Administrador\n\n1. Ainda no painel Superadmin, acesse o menu "TENANTS E LICENCIAMENTO" na aba "Usuários Tenants".\n\n\n\n2. Clique em "Novo usuário".\n\n\n\n3. Preencha os dados e crie o perfil "Administrador"\n\n\n\n4. Clique em "Salvar".\n\n📚 *Consulte a documentação completa sobre criação de usuários no painel do superadmin: [Usuário](/configuracao-superadmin/tenants-e-licenca/usuarios-por-tenant.md)\n\n### Passo 2: Faça Login com o Usuário Admin\n\nAgora, vamos acessar o painel de gerenciamento do atendimento.\n\n1. Faça logout da sua conta Superadmin (canto superior direito)\n\n\n\n2. Na mesma tela de login, utilize o e-mail e a senha do usuário "Admin" que você acabou de criar.\n\nVocê notará que o painel é diferente. Este é o Painel Admin, onde toda a operação de atendimento acontece.\n\n\n\n### Passo 3: Adicione um Novo Canal\n\n\n\n### Passo 4: Teste a Conexão\n\nCom o canal conectado, você já pode receber e enviar mensagens.\n\nNo menu lateral, clique em *"Atendimentos". Esta é a sua caixa de entrada unificada.\n\n\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/primeiro-acesso/primeiro-acesso-ao-sistema.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n
Webrtc Turn Setup
Publicado com HonKit
Instalação: Evolution API
[warning]
Aviso Importante: Responsabilidade sobre a Instalação e Suporte
A Evoluiton API é uma solução de software de código aberto.
Isso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante .
A equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.
1. Prepare o Ambiente
Antes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:
Após instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando . Ele precisa estar ativo para que a mágica aconteça.
2. Baixe o Script de Instalação
Para facilitar sua vida, preparamos um pacote com tudo que você precisa.
3. Execute os Comandos no Terminal
Agora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.
Navegue até a pasta onde você descompactou os arquivos.
Clique com o botão direito do mouse dentro da pasta e selecione a opção "Abrir no Terminal" ou "Open in Terminal" .
O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:
& "C:\\Program Files\\Git\\bin\\bash.exe"
Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:
./evolution.sh
Pronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.
4. Acessando e Conectando sua API
Com tudo instalado, é hora de acessar o painel de controle.
Abra seu navegador e acesse: http://localhost:8081
Clique em "Manager" . O sistema pedirá uma Chave Global (Global API Key).
Para encontrá-la, abra o arquivo evolution.sh com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.
Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code .
Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.
O último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.
No painel Admin , navegue até Configurações > Integrações > Evolution .
Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\_IP\\\\_DE\\\\_SERVIDOR:5555 ).
Preencha a Chave Global com o APP\_ADMIN\_TOKEN definido no seu arquivo .env.
Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Evoluiton" .
Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.
Tutorial:
Conteúdo incorporado
Integrações > Evolution API.\n\n\n\n2. Insira a URL da API (Ex: https://api.seuservidor.com).\n3. Cole a sua Global Key.\n4. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\n\n{% hint style="warning" %}\nAtenção: Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.\n{% endhint %}\n\nObservações Importantes:\n\n Conectando uma Instância Existente: Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o mesmo nome exato da instância. O sistema irá sincronizar e configurar o webhook.\n Nomenclatura: Não utilize caracteres especiais (como \_) no nome da instância, pois isso pode causar falhas na sincronização.\n Nome da Instância: Uma vez criado, o nome da instância não pode ser alterado.\n\n### 3. Adicionar um canal \n\nPasso passo geral aqui: Como conectar um canal (sessão/número)\n\n### 4. Gerar o QR Code\n\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\n\n\n\n\n\n### 5. Escanear no Aparelho\n\n1. Abra o WhatsApp no seu celular.\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\n3. Clique em Conectar um dispositivo.\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\n\n### 6. Confirmar a Conexão\n\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\n\n\n\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\n\n{% hint style="warning" %}\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n">
Canais.\n2. Clique no botão Adicionar Canal.\n3. No campo "Tipo de Canal", selecione a opção WhatsApp OAuth.\n4. Selecione o Aplicativo Meta: Você verá um menu suspenso para escolher o aplicativo.\n Selecione o aplicativo nativo fornecido pela plataforma (ex: teste login incorporado tech provider zdg ou ZDG App).\n (Nota: Caso sua empresa seja um Tech Provider aprovado pela Meta, você poderá selecionar seu próprio App configurado previamente).\n5. Clique no botão azul Conectar via WhatsApp OAuth.\n\n### Etapa 2: Autenticação com a Meta e Leitura do QR Code\n\nAo clicar em conectar, uma janela pop-up oficial do Facebook/Meta será aberta. Atenção: Tenha o seu celular com o WhatsApp Business em mãos.\n\n\n\n1. Na janela da Meta, clique em Continuar e faça o login com seu Facebook.\n2. Siga as instruções da tela para selecionar ou criar a sua conta do WhatsApp Business e seu Gerenciador de Negócios.\n3. Insira o Número: Digite o número de telefone exato que está no seu WhatsApp Business.\n4. Aprovação no Celular:\n Abra o aplicativo WhatsApp Business no seu celular.\n Você receberá uma notificação da Meta solicitando a conexão.\n Aceite a notificação. O aplicativo solicitará que você faça a leitura de um QR Code (ou aprove o compartilhamento de conversas) diretamente na tela do computador.\n5. Após confirmar no celular, a janela da Meta será finalizada e o canal aparecerá como Conectado no ZPRO.\n\nPronto! Seu número já está operando em Modo de Coexistência. As mensagens chegarão tanto no seu celular quanto na tela de atendimento do Z-PRO. Como esta é uma conexão via API Oficial, você não sofrerá com bloqueios relacionados ao uso de sistemas de terceiros.\n\n### Etapa 4: Configuração de Pagamento na Meta\n\nEmbora a conexão já esteja funcionando para receber e responder mensagens dentro da janela de 24 horas, há um passo final recomendado pela Meta.\n\nAo conectar seu WhatsApp Business, a Meta realizará uma análise final da sua empresa. Após isso, para que você possa enviar mensagens ativas (templates/campanhas de massa) fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento na Meta.\n\n1. Acesse o seu painel do Gerenciador de Negócios da Meta.\n 1. https://business.facebook.com/billing_hub/accounts\n2. Vá nas configurações de conta do WhatsApp Business.\n3. Encontre a conta de WhatsApp que foi conectada e adicione um *Cartão de Crédito.\n4. A partir desse momento, sua conta estará 100% apta para receber, responder e iniciar novas conversas (disparos) através do ZPRO.\n\nPara testar, envie uma mensagem de outro número para o seu WhatsApp Business. Você verá a mensagem chegando instantaneamente no seu celular e na aba "Pendentes" na tela de atendimento do seu ZPRO!\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse 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.\n">