Operação (Gestão comercial)
- Etiquetas: Cadastro de Etiquetas
- Fechamentos: Mensagens de Fechamento Personalizadas
- Filas: Cadastro de Filas
- Horários de Atendimento
- Notas: Notas do Atendimento
- Produtos WooCommerce
-
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
-
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=
-
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 -
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
-
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=
-
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
-
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=
-
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
-
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=
-
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
-
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=
-
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
-
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=
-
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
-
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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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
-
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=
-
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
-
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=
-
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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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
-
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=
-
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 -
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
-
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=
-
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
-
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=
-
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 -
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
-
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=
-
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
-
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 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
-
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
-
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
-
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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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
-
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=
-
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=
-
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
-
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=
-
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
-
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=
-
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
-
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=
-
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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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=
-
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
-
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=
-
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\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the 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
-
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=
-
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
-
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=
-
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