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 Ā· 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 nuĢ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
3.1.5.x
3.1.5.4
š UPDATE OFICIAL (HOMOLOG) | v3.1.5.4 - 17/03/2026
š BACKUP OBRIGATĆRIO! Crie um ponto de recuperação ou faƧa backup da VPS/Banco de Dados antes de rodar este update.
ā ļø BREAKING CHANGES / NOVIDADES
Ligação de Ć”udio e vĆdeo entre usuĆ”rios (chat interno)
Adicionado rota para criar ticket para canal webmail (CreateTicketWebmail)
Inativar usuƔrio
Campanha com WABA (Templates)
Agendamento para WABA na tela de Automação > Agendamentos (Templates)
Rota API: GetAllSessionApis
Responder e-mail na tela de atendimento (webmail nativo)
HorƔrio de envio das campanhas
Envio de template WABA nas aƧƵes do funil
Aviso de carregamento do histórico (ao espiar conversa)
Opção de otimização de performance para uso com muitos usuÔrios (Superadmin - Customizar - Marca - Modelo de Socket)
š AJUSTES:
correção encaminhar mensagem
correção groq cloud global provider
correção campanhas waba com botões
correção rota showcontacts API (Z-API)
correção carregamento de cores Galeria
correção contador de não lidos WABA
correção disparo em massa em grupos + UAZAPI
correção adição de tempalte na ação (fluxo)
correção estilo mensagem rapida (darkmode)
correção editar/deletar mensagem chat interno
correção invalid token (relogar)
correção kanban iniciar conversa
correção botão + chatgpt WABA Chatbot
correção kanban iniciar conversa
3.1.5.3
š UPDATE OFICIAL (HOMOLOG) | v3.1.5.3 - 24/02/2026
ā ļø BREAKING CHANGES
Global provider para WABA depreciado
š Novidades
Suporte recebimento do revoke com coex (mensagem deletada)
Adicionado gravação e mensagem de ligação no atendimento usando WAVOIP
Adicionado nome + id do canal na tela de APIs
Nova interface de carregamento dos emails no atendimento (novos emails recebidos)
Campo de dados no contato melhorado (tabs - atendimento)
Adicionado suporte ao campo name (nome) para templates WABA
Adicionado opção para setar APP ID na configuração do canal WABA (facilitar criação de template)
Adicionado opção para enviar mensagem de aviso de fechamento de janela com WABA
Envio de mĆdias WABA usando o media\_id (weblink serĆ” usado caso o primeiro mĆ©todo falhe)
Dados de faturamento e dados extra de uso para WABA (configuraƧƵes - meta - facebook login - waba)
Recebimento do evento edit para COEX e WABA
Visibilidade de menus opção para ocultar contatos (usuÔrio)
Suporte para GPT-5 e superiores
š AJUSTES:
correção ordenação da lista de mensagens antigas da WABA
correção uso das rotas de API com UAZAPI e grupos com hĆfen na id
correção socket na transferência de filas dentro do chatbot (atualização do front)
correção renderização de mensagem com link + salto de linha
correção migração de tenants entre VPS
novos logs para acompanhar upload de media (uso de media ID) para WABA
correção gravação do WAVOIP (por token)
renderização de vĆdeos no atendimento
recebimento de mensagens para gpt-5 ou superiores
3.1.5.2
š UPDATE OFICIAL (HOMOLOG) | v3.1.5.2 - 06/02/2026
š BACKUP OBRIGATĆRIO! Crie um ponto de recuperação ou faƧa backup da VPS/Banco de Dados antes de rodar este update.
š Novidades
API Externa:
Nova rota: RequestNewQrCode (Solicita novo QR Code programaticamente).
Nova rota: GetMessageByMessageId (Busca detalhes de uma mensagem especĆfica).
Chatbot Nativo:
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).
WABA: Palavra-gatilho agora pode corresponder a uma frase inteira.
Disparo em Massa:
Opção para selecionar múltiplos canais simultaneamente.
Opção para fechar o ticket automaticamente após o envio (WABA).
Relatórios de envio integrados à tela.
Atendimento e Operação:
TransferĆŖncia Ćgil: Permite transferir tickets entre filas e canais diretamente pelo painel de atendimento.
Ordenação: Nova opção para ordenar tickets por "Respondidos".
Album Message: Suporte para envio/recebimento de Ć”lbuns de mĆdia (WhatsApp Web, Baileys, Wuzapi e Evolution).
Scroll AutomÔtico: Opção para desativar a rolagem automÔtica ao receber nova mensagem.
Leitura de Tickets: O sistema não marca mais como "lido" automaticamente durante a seleção múltipla de tickets.
Notas Internas: Adicionado suporte para anexar mĆdias nas notas.
Sistema e IntegraƧƵes:
Groq Cloud: Adicionado Global Provider para integração de IA.
WAVOIP: Controle de ligaƧƵes via token (sem necessidade de login de usuƔrio).
Home: Popup de notificações não lidas ao acessar a dashboard.
Uazapi: Melhoria no status de conexão e revalidação.
Contatos: Alerta de duplicidade ao tentar inserir um contato manual que jĆ” existe.
š§ Ajustes e CorreƧƵes
WABA:
Correção de socket na marcação de mensagens.
Correção na transferência entre chatbots nativos.
Correção nas listagens em Configurações > Meta.
Correção do fechamento automÔtico (Configurações Gerais).
Canais NĆ£o Oficiais (Uazapi/Z-API/Evolution):
Correção na criação de mensagem de mĆdia e arquivos URL em grupos (Uazapi).
Correção na função listGroupInfo (Uazapi).
Correção no envio de mensagem rĆ”pida com mĆdia (Z-API).
Correção no envio de Base64 (Evolution).
Chatbot:
Correção no bloqueio do chatbot para Instagram Nativo.
Correção na interação de palavra-chave para fechamento automÔtico.
Correção na formatação de números no Typebot (Canais não oficiais).
Geral:
Correção no socket de compartilhamento de grupos.
Correção no campo de horÔrio de atendimento.
Correção no serviço de e-mail (Gmail).
Correção na transferência entre canais no painel.
Correção na abertura de ticket jÔ existente via tela de Contatos.
Correção no disparo em massa via WAVOIP.
3.1.5.1
š UPDATE OFICIAL (HOMOLOG) | v3.1.5.1 - 22/01/2026
š BACKUP OBRIGATĆRIO! Crie um ponto de recuperação ou faƧa backup da VPS/Banco de Dados antes de rodar este update.
ā ļø BREAKING CHANGES
Baileys: Atualize fora do expediente. Pode ser necessƔrio reler o QRCode.
Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.
š Novidades
Autenticação de 2 fatores: DisponĆvel em ConfiguraƧƵes > ConfiguraƧƵes Gerais > Autenticação 2FA.
Webhook secundƔrio para Waba COEX: Permite setar uma url secundƔria.
Melhoria visual menu configuraƧƵes PWA: Ajustes de layout.
Listagem de mensagens: Opções padrão, por ticket, por fila e completo (beta).
AƧƵes no chat interno: Deletar, editar, reagir e encaminhar mensagens.
VariĆ”vel : DisponĆvel no chatbot interno.
CatĆ”logo de mĆdias: Visualização de links e documentos no atendimento.
Setagem do user no envio da mensagem avulsa: Define usuÔrio caso não exista no ticket.
Nome do arquivo recebido: MantĆ©m original se disponĆvel + código aleatório.
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.
š§ Ajustes e CorreƧƵes
CorreƧƵes chatbot WABA, Baileys, Insta, Evo e Telegram.
Correção ack uazapi.
Melhoria no controle de updates da pƔgina de sessƵes.
Correção campos extra no contato.
Mensagem rƔpida na troca do ticket.
Ajuste na variƔvel no chatbot interno.
Resetar password tela de login.
Listagem das tarefas apenas por data.
Correção download arquivos uazapi e zapi.
3.1.5.0
š UPDATE OFICIAL (HOMOLOG) | v3.1.5.0 - 15/01/2026
š BACKUP OBRIGATĆRIO! Crie um ponto de recuperação ou faƧa backup da VPS/Banco de Dados antes de rodar este update.
ā ļø BREAKING CHANGES
Baileys: Atualize fora do expediente. Pode ser necessƔrio reler o QRCode.
Frontend: Suporte a VUE2 descontinuado. Apenas VUE3 agora.
š Novidades
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.
Nova PÔgina Home: Implementação de uma nova tela inicial ao realizar o login no sistema.
Visualização Admin: Nova opção de filtro para administradores visualizarem "Todos os Tickets + Fechados"
š§ Ajustes e CorreƧƵes
Interação de boas vindas chatbot + instagram nativo
Recebimento de PDF no insta nativo
Histórico de mensagens nos tickets
Atualização de oportunidade no atendimento (status)
Correção de Ćndices crĆticos Waba
Chatbot + captura de variƔvel
Contagem de mensagens recebidas no chat interno
CorreƧƵes gerais chatbot
Correção migração entre vps + tabela settings
Correção API botões e listas WABA
Correção atualizar nomes ao receber mensagem (waba)
> 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">
\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">