.\n3. Ao carregar a página, o ícone do chat aparecerá no canto direito, e você já pode testar o envio de mensagens.\n\n*\n\n### Solução de Problemas: Chat não conecta ou Status não fica verde\n\nSe o status em Integrações > Webchat não ficar verde, ou se as mensagens não chegarem, pode ser um problema de firewall ou de comunicação entre os serviços. Siga os passos abaixo no SSH:\n\nExecute no SSH:\n\n# 1. Desative o firewall temporariamente para testar\nsudo ufw disable\nsudo su deployzdg\ncd /home/deployzdg/zpro.io/backend\nnano .env\n\n# 2. Adicione a flag abaixo ao documento .env:\nSECURE_URL=*\n\n# 5. Confirme também se está definido corretamente porta e dominio do chat no mesmo arquivo:\nWSS_URL=[https://webchat.seusiteaqui.com.br](https://webchat.seusiteaqui.com.br)\nWSS_PORT=NUMERO_DA_PORTA\n\n# 6. Salve o documento, feche e reinicie o Z-PRO\npm2 stop all\npm2 flush\npm2 start all\n\n\nApós este processo, faça um novo teste no painel do Z-PRO.\n\n{% hint style="warning" %}\n Lembre-se de reativar seu firewall após o teste.\n\nSe o chat funcionar apenas com o firewall desativado, significa que você precisa liberar a porta que escolheu durante a instalação\n{% endhint %}\n\n\n---\n\n# Agent Instructions: Querying This Documentation\n\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\n\nPerform an HTTP GET request on the current page URL with the ask query parameter:\n\n\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md?ask=\n\n\nThe question should be specific, self-contained, and written in natural language.\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\n\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\n
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
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
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
.\\n3. Ao carregar a página, o ícone do chat aparecerá no canto direito, e você já pode testar o envio de mensagens.\\n\\n*\\n\\n### Solução de Problemas: Chat não conecta ou Status não fica verde\\n\\nSe o status em Integrações > Webchat não ficar verde, ou se as mensagens não chegarem, pode ser um problema de firewall ou de comunicação entre os serviços. Siga os passos abaixo no SSH:\\n\\nExecute no SSH:\\n\\n# 1. Desative o firewall temporariamente para testar\\nsudo ufw disable\\nsudo su deployzdg\\ncd /home/deployzdg/zpro.io/backend\\nnano .env\\n\\n# 2. Adicione a flag abaixo ao documento .env:\\nSECURE_URL=*\\n\\n# 5. Confirme também se está definido corretamente porta e dominio do chat no mesmo arquivo:\\nWSS_URL=[https://webchat.seusiteaqui.com.br](https://webchat.seusiteaqui.com.br)\\nWSS_PORT=NUMERO_DA_PORTA\\n\\n# 6. Salve o documento, feche e reinicie o Z-PRO\\npm2 stop all\\npm2 flush\\npm2 start all\\n\\n\\nApós este processo, faça um novo teste no painel do Z-PRO.\\n\\n{% hint style=\"warning\" %}\\n Lembre-se de reativar seu firewall após o teste.\\n\\nSe o chat funcionar apenas com o firewall desativado, significa que você precisa liberar a porta que escolheu durante a instalação\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.8","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md","articles":[]},{"title":"Webmail (Gmail)\\n\\nA integração de Webmail com o Gmail permite que você centralize sua comunicação por e-mail diretamente no Z-PRO. Com essa configuração, sua equipe poderá receber as mensagens na caixa de entrada unificada e responder aos e-mails diretamente pelo painel de atendimento.\\n\\nPara que a integração funcione corretamente (tanto para recebimento quanto para envio de respostas), é necessário configurar um aplicativo no Google Cloud Console e gerar uma Senha de App no Gmail. Siga o passo a passo abaixo:\\n\\n#### Passo 1: Criar o Aplicativo no Google Cloud Console\\n\\n1. Acesse o Google Cloud Console e faça login com a conta do Google que deseja vincular.\\n2. Crie um Novo Projeto e dê um nome a ele (ex: \"ZPRO Email\").\\n3. Na barra de pesquisa superior, busque por \"Gmail API\" e clique em Ativar.\\n4. Antes de criar as credenciais, você precisa configurar a tela de permissão. No menu lateral, vá em Tela de consentimento OAuth.\\n5. Selecione a opção \"Externo\" (se aplicável), clique em Criar e preencha os dados obrigatórios, como o nome do app e o e-mail de suporte.\\n6. Após criar a tela de consentimento, é necessário colocar o aplicativo em produção. Clique em Publicar App.\\n\\n#### Passo 2: Gerar as Credenciais OAuth\\n\\n1. No menu do Google Cloud, vá até Credenciais e clique em Criar Credenciais -> ID do cliente OAuth.\\n2. No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.\\n3. Na seção \"URIs de redirecionamento autorizados\", você deve adicionar a URL do seu frontend acompanhada do callback do Gmail.\\n Exemplo: https://app.seudominio.com.br/gmail_callback.html.\\n4. Clique em Criar. O Google irá gerar o seu ID do Cliente e o seu Client Secret. Mantenha essa tela aberta para copiar os dados.\\n\\n#### Passo 3: Configurar o Canal no Z-PRO\\n\\n1. Acesse o painel Admin do Z-PRO, vá no menu Canais e adicione um novo canal do tipo Webmail.\\n2. Dê um nome para o canal (ex: \"Suporte Gmail\").\\n3. Importante: Salve o canal antes de prosseguir para a próxima etapa.\\n4. Após salvar, clique para Editar o canal que você acabou de criar e vá na opção Configurar OAuth.\\n5. Uma tela do Google será aberta. Selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação.\\n6. Ao voltar para a edição do canal, o status deverá constar como \"Autenticado\". Clique em Conectar.\\n\\nNeste momento, o Z-PRO já estará apto a receber os e-mails.\\n\\n#### Passo 4: Configurar o SMTP para Envio de Respostas\\n\\nPara que você consiga enviar as respostas pelo painel de atendimento, é obrigatório configurar a saída (SMTP) utilizando uma Senha de App do Google.\\n\\n1. Acesse as configurações da sua Conta do Google (myaccount.google.com).\\n2. Vá na aba Segurança e certifique-se de que a Verificação em duas etapas (2FA) está ativada.\\n3. Na barra de pesquisa das configurações do Google, busque por \"Senhas de app\".\\n4. Crie uma nova senha (dê um nome como \"ZPRO SMTP\") e o Google gerará uma senha de 16 letras.\\n5. Retorne ao Z-PRO, edite o seu canal de Webmail e preencha a configuração de SMTP:\\n Usuário: Seu endereço de e-mail remetente.\\n Senha: Cole a Senha de App de 16 letras gerada no Google (certifique-se de remover os espaços entre as letras).\\n6. Salve as configurações.\\n\\n{% hint style=\"warning\" %}\\nSe o sistema gerar algum erro de autenticação ou falha na hora de enviar a mensagem, exclua a senha anterior no painel do Google e recrie uma nova Senha de App. Depois, basta atualizar a nova senha nas configurações do canal no Z-PRO e salvar novamente.\\n{% endhint %}\\n\\n{% embed url=\"https://www.loom.com/share/29429819aae543faacbfb44c2901c31d\" %}\\n\\n**\\n\\n#### Como Receber e Responder E-mails na Tela de Atendimento\\n\\nCom a integração finalizada, o fluxo de comunicação via e-mail ocorrerá de forma nativa na sua caixa de entrada unificada:\\n\\n Recebendo um e-mail: Toda vez que um cliente enviar uma mensagem para a sua conta do Gmail vinculada, ela chegará automaticamente na tela de Atendimentos do Z-PRO, gerando um novo ticket de conversa.\\n Enviar um e-mail: Para enviar um e-mail, clicar no icone na tela de atendimento e preencha os dados de envio.\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.9","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md","articles":[]},{"title":"Whatsapp Baileys (Não oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA conexão via Baileys é uma solução de integração não oficial baseada em uma biblioteca de código aberto que emula o protocolo do WhatsApp Web. Ao contrário da API Oficial (WABA), a Baileys permite que você conecte um número de telefone comum ao sistema Z-PRO sem a necessidade de aprovação prévia da Meta ou de uma conta empresarial verificada.\\n\\n## Passo a passo para conexão\\n\\n### 1. Adicionar um canal Baileys\\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 2. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal como \"Baileys\", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 3. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 4. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.10","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md","articles":[]},{"title":"WhatsApp Evolution API (Não Oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA Evolution API é uma solução de integração não oficial de alto desempenho, que atua como um gateway entre o WhatsApp e o sistema Z-PRO. Diferente das bibliotecas simples, ela oferece uma camada extra de gerenciamento e robustez para as instâncias de WhatsApp conectadas via QR Code, permitindo uma operação mais estável em cenários de grande volume de mensagens\\n\\nA Evolution API permite que o sistema gerencie as sessões de forma desacoplada. Isso significa que, mesmo que a interface do Z-PRO sofra uma atualização, as instâncias no servidor da API permanecem conectadas, reduzindo a necessidade de novos pareamentos frequentes.\\n\\n## Passo a passo para conexão\\n\\n### 1. Instalar Evoluiton API\\n\\nAntes de qualquer configuração no painel Z-PRO, a Evolution API deve estar devidamente instalada e rodando em seu servidor.\\n\\n Siga as instruções técnicas contidas na página: Instalação: Evolution API\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > Evolution API.\\n\\n\\n\\n2. Insira a URL da API (Ex: https://api.seuservidor.com).\\n3. Cole a sua Global Key.\\n4. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n{% hint style=\"warning\" %}\\nAtenção: Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.\\n{% endhint %}\\n\\nObservações Importantes:\\n\\n Conectando uma Instância Existente: Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o mesmo nome exato da instância. O sistema irá sincronizar e configurar o webhook.\\n Nomenclatura: Não utilize caracteres especiais (como \\_) no nome da instância, pois isso pode causar falhas na sincronização.\\n Nome da Instância: Uma vez criado, o nome da instância não pode ser alterado.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.11","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md","articles":[{"title":"Instalação: Evolution API\\n\\n{% hint style=\"warning\" %}\\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\\n\\nA Evoluiton API é uma solução de software de código aberto.\\n\\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\\n\\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\\n{% endhint %}\\n\\n#### 1. Prepare o Ambiente\\n\\nAntes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:\\n\\n Git: Essencial para executar nosso script. Faça o download aqui.\\n Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.\\n\\nApós instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.\\n\\n#### 2. Baixe o Script de Instalação\\n\\nPara facilitar sua vida, preparamos um pacote com tudo que você precisa.\\n\\n Baixe aqui o arquivo evolution.rar.\\n Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo: C:\\\\Evolution).\\n\\n#### 3. Execute os Comandos no Terminal\\n\\nAgora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.\\n\\n1. Navegue até a pasta onde você descompactou os arquivos.\\n2. Clique com o botão direito do mouse dentro da pasta e selecione a opção \"Abrir no Terminal\" ou \"Open in Terminal\".\\n3. O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:\\n\\n \\n & \"C:\\\\Program Files\\\\Git\\\\bin\\\\bash.exe\"\\n\\n4. Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:\\n\\n \\n ./evolution.sh\\n\\n\\nPronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.\\n\\n#### 4. Acessando e Conectando sua API\\n\\nCom tudo instalado, é hora de acessar o painel de controle.\\n\\n1. Abra seu navegador e acesse: http://localhost:8081\\n2. Clique em \"Manager\". O sistema pedirá uma Chave Global (Global API Key).\\n3. Para encontrá-la, abra o arquivo evolution.sh com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.\\n4. Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.\\n5. Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.\\n\\n#### 5. Integração com Z-PRO\\n\\nO último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.\\n\\n1. No painel Admin, navegue até Configurações > Integrações > Evolution.\\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555).\\n3. Preencha a Chave Global com o APP\\_ADMIN\\_TOKEN definido no seu arquivo .env.\\n4. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção \"Evoluiton\".\\n5. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\\n\\n### Tutorial:\\n\\n{% embed url=\"https://www.youtube.com/watch?v=cQewqCSez5I\" %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.11.1","depth":5,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md","articles":[]}]},{"title":"WhatsApp Oficial OAuth (login)\\n\\n#### O que é o Modo de Coexistência?\\n\\nAo utilizar este método, você conecta o seu número à API Oficial da Meta sem precisar desconectá-lo do seu aparelho celular. O WhatsApp passará a funcionar simultaneamente no aplicativo WhatsApp Business do seu smartphone e no painel do Z-PRO. É a união da estabilidade da API Oficial com a praticidade de manter o celular ativo.\\n\\n{% embed url=\"https://youtu.be/v-eVzsAwJXQ\" %}\\n\\n{% hint style=\"danger\" %}\\nNOVA URL OAUTH: https://oauth.techprovider.com.br\\n{% endhint %}\\n\\n*\\n\\n### Etapa 0: Ativação do Canal no Painel Super Admin\\n\\nA liberação do recurso OAuth é feita por empresa (Tenant). Se você é o assinante do ZPRO, siga estes passos. Se você é um cliente ou está usando apenas o acesso demo do sistema, solicite essa liberação ao suporte e pule para a etapa 1.\\n\\nFaça login no sistema com seu usuário Super Admin.\\n\\nNo menu lateral, acesse Tenants (Empresas) e clique em Editar na empresa desejada.\\n\\n\\n\\nRole a página até encontrar a opção OAuth (Login Incorporado) e ative a chave.\\n\\n\\n\\n{% hint style=\"danger\" %}\\nNOVA URL OAUTH: [https://oauth.techprovider.com.br**](https://oauth.techprovider.com.br)\\n{% endhint %}\\n\\nVolte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.\\n\\n\\n\\n{% hint style=\"warning\" %}\\nMetal URL: https://oauth.techprovider.com.br\\n\\nInstagram Webhook \\n\\n• URL: https://oauth.techprovider.com.br/instagram-webhook \\n\\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\\n\\nMessenger Webhook \\n\\n• URL: https://oauth.techprovider.com.br/messenger-webhook \\n\\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\\n{% endhint %}\\n\\nClique em Salvar.\\n\\n### Etapa 1: Criando a Conexão no Painel Admin\\n\\nCom o recurso liberado, acesse a conta da empresa (Admin normal) para realizar a conexão.\\n\\n\\n\\n1. No menu lateral, acesse Administração > Canais.\\n2. Clique no botão Adicionar Canal.\\n3. No campo \"Tipo de Canal\", selecione a opção WhatsApp OAuth.\\n4. Selecione o Aplicativo Meta: Você verá um menu suspenso para escolher o aplicativo.\\n Selecione o aplicativo nativo fornecido pela plataforma (ex: teste login incorporado tech provider zdg ou ZDG App).\\n (Nota: Caso sua empresa seja um Tech Provider aprovado pela Meta, você poderá selecionar seu próprio App configurado previamente).\\n5. Clique no botão azul Conectar via WhatsApp OAuth.\\n\\n### Etapa 2: Autenticação com a Meta e Leitura do QR Code\\n\\nAo clicar em conectar, uma janela pop-up oficial do Facebook/Meta será aberta. Atenção: Tenha o seu celular com o WhatsApp Business em mãos.\\n\\n\\n\\n1. Na janela da Meta, clique em Continuar e faça o login com seu Facebook.\\n2. Siga as instruções da tela para selecionar ou criar a sua conta do WhatsApp Business e seu Gerenciador de Negócios.\\n3. Insira o Número: Digite o número de telefone exato que está no seu WhatsApp Business.\\n4. Aprovação no Celular:\\n Abra o aplicativo WhatsApp Business no seu celular.\\n Você receberá uma notificação da Meta solicitando a conexão.\\n Aceite a notificação. O aplicativo solicitará que você faça a leitura de um QR Code (ou aprove o compartilhamento de conversas) diretamente na tela do computador.\\n5. Após confirmar no celular, a janela da Meta será finalizada e o canal aparecerá como Conectado no ZPRO.\\n\\nPronto! Seu número já está operando em Modo de Coexistência. As mensagens chegarão tanto no seu celular quanto na tela de atendimento do Z-PRO. Como esta é uma conexão via API Oficial, você não sofrerá com bloqueios relacionados ao uso de sistemas de terceiros.\\n\\n### Etapa 4: Configuração de Pagamento na Meta\\n\\nEmbora a conexão já esteja funcionando para receber e responder mensagens dentro da janela de 24 horas, há um passo final recomendado pela Meta.\\n\\nAo conectar seu WhatsApp Business, a Meta realizará uma análise final da sua empresa. Após isso, para que você possa enviar mensagens ativas (templates/campanhas de massa) fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento na Meta.\\n\\n1. Acesse o seu painel do Gerenciador de Negócios da Meta.\\n 1. https://business.facebook.com/billing_hub/accounts\\n2. Vá nas configurações de conta do WhatsApp Business.\\n3. Encontre a conta de WhatsApp que foi conectada e adicione um *Cartão de Crédito.\\n4. A partir desse momento, sua conta estará 100% apta para receber, responder e iniciar novas conversas (disparos) através do ZPRO.\\n\\nPara testar, envie uma mensagem de outro número para o seu WhatsApp Business. Você verá a mensagem chegando instantaneamente no seu celular e na aba \"Pendentes\" na tela de atendimento do seu ZPRO!\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.12","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md","articles":[]},{"title":"Whatsapp Uazapi\\n\\nA Uazapi também é uma solução não oficial paga e gerenciada. https://uazapi.dev/\\n\\n## Passo a passo para conexão\\n\\n### 1. Contratar a Uazapi\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://uazapi.dev/\\n\\nPré-requisito na Plataforma Z-API\\n\\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL do servidor da sua conta Uazapi.\\n2. Chave Global: O \"Admin Token\" fornecido no painel da sua conta Uazapi.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\nA integração com a Uazapi oferece duas possibilidades:\\n\\n A) Criar uma Nova Instância:\\n 1. No painel Admin, vá em Canais > Adicionar Canal e selecione \"Uazapi\".\\n 2. Dê um nome para a nova instância (ex: \"Cliente A\").\\n 3. Deixe os campos ID da Instância e Token em branco.\\n 4. Salve. O Z-PRO irá criar a nova instância na sua conta Uazapi e preencherá as credenciais automaticamente.\\n B) Conectar a uma Instância Existente:\\n 1. Siga os mesmos passos acima, mas desta vez preencha os campos ID da Instância e Token com as informações da instância já existente na sua conta Uazapi.\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.13","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md","articles":[]},{"title":"WhatsApp WebJs (Não oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA conexão via WebJS é uma solução de integração não oficial baseada na biblioteca whatsapp-web.js. Diferente de outras integrações, ela funciona através da automação e simulação de uma instância real do WhatsApp Web em um navegador interno no servidor. Isso permite que o sistema utilize todas as funcionalidades da interface web original sem a necessidade da API Oficial (WABA).\\n\\nA biblioteca WebJS opera simulando a navegação de um usuário real no WhatsApp Web. Por rodar um navegador em segundo plano (headless browser), essa conexão pode exigir um pouco mais de processamento do servidor em comparação à Baileys, mas oferece uma fidelidade maior aos recursos disponíveis na versão oficial para navegador do WhatsApp.\\n\\n## Passo a passo para conexão\\n\\n### 1. Adicionar um canal\\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 2. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal como \"WebJS\", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 3. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 4. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.14","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md","articles":[]},{"title":"WhatsApp WUZAPI Meow API\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA WUZAPI (Meow API) diferencia-se de outras bibliotecas por ser desenvolvida em Go (Golang), uma linguagem de programação conhecida por sua alta performance e eficiência no gerenciamento de concorrência. Tecnicamente, a solução funciona como um serviço headless (sem interface gráfica), o que reduz drasticamente o consumo de memória RAM e processamento no servidor em comparação com emuladores de navegador.\\n\\n## Passo a passo para conexão\\n\\n### 1. Instalar WUZAPI (Meow API)\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso instalar essa API\\n\\n Siga as instruções técnicas contidas na página: Instalação: Wuzapi (Meow)\\n\\nPré-requisito na Instalação do Wuzapi\\n\\n No arquivo de configuração (.env) da sua instalação do Wuzapi, é obrigatório preencher a variável API\\_URL com a URL pública onde sua instância do Wuzapi está acessível.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL base da sua instalação do Wuzapi.\\n2. Chave Global: O token de administrador definido na variável APP\\_ADMIN\\_TOKEN do arquivo .env do seu Wuzapi.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.15","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md","articles":[{"title":"Instalação: Wuzapi (Meow)\\n\\n{% hint style=\"warning\" %}\\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\\n\\nA Wuzapi (Meow) é uma solução de software de código aberto.\\n\\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\\n\\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\\n{% endhint %}\\n\\nEste guia fornece o passo a passo técnico para realizar uma instalação auto-hospedada (self-hosted) da Wuzapi (Meow), uma API de conexão não oficial para WhatsApp.\\n\\nAo final deste processo, você terá uma instância da Wuzapi funcional em seu próprio servidor, pronta para ser integrada à sua plataforma Z-PRO.\\n\\n{% hint style=\"info\" %}\\nVisão Geral do Processo de Instalação:\\n\\n1. Preparação do Ambiente: Atualizar o servidor e instalar as dependências (Git, PM2, Go).\\n2. Instalação do Wuzapi: Clonar o repositório e compilar a aplicação.\\n3. Configuração: Ajustar o arquivo de variáveis de ambiente (.env).\\n4. Execução e Gerenciamento: Iniciar a API e configurá-la como um serviço persistente com PM2.\\n5. Integração com Z-PRO: Conectar a nova instância ao seu painel.\\n {% endhint %}\\n\\n\\\\n1. Preparação do Ambiente do Servidor\\n\\nEstes comandos preparam seu servidor Ubuntu com todas as ferramentas necessárias para a instalação.\\n\\n1. Atualizar o Servidor e Instalar o Git:\\n\\n codeBash\\n\\n \\n sudo apt update && sudo apt upgrade -y && sudo apt install git -y\\n sudo apt install npm\\n\\n2. Instalar o PM2:\\\\n O PM2 é um gerenciador de processos que manterá a API da Wuzapi rodando como um serviço.\\n\\n codeBash\\n\\n \\n npm install -g pm2\\n\\n3. Instalar a Linguagem Go (GoLang):\\\\n A Wuzapi é construída em Go, portanto a linguagem precisa ser instalada no servidor.\\n\\n codeBash\\n\\n \\n # Baixa o pacote de instalação\\n wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz\\n\\n # Remove instalações antigas (se houver)\\n sudo rm -rf /usr/local/go\\n\\n # Extrai os arquivos para o local correto\\n sudo tar -C /usr/local -xzf go1.21.1.linux-amd64.tar.gz\\n\\n # Adiciona o Go ao PATH do sistema\\n echo \\'export PATH=$PATH:/usr/local/go/bin\\' >> ~/.bashrc\\n source ~/.bashrc\\n\\n # Verifica a instalação\\n go version\\n\\n\\n O terminal deve retornar a versão do Go instalada (ex: go version go1.21.1 linux/amd64).\\n\\n*\\n\\n#### 2. Instalação da Aplicação Wuzapi\\n\\nAgora, vamos baixar o código-fonte da Wuzapi e compilá-lo.\\n\\n1. Clonar o Repositório:\\\\n Este comando baixa a versão da Wuzapi compatível com o Z-PRO.\\n\\n codeBash\\n\\n \\n git clone https://github.com/pedroherpeto/wuzapi.git\\n\\n2. Acessar o Diretório:\\n\\n codeBash\\n\\n \\n cd wuzapi\\n\\n3. Baixar Dependências:\\n\\n codeBash\\n\\n \\n go mod tidy\\n\\n4. Compilar a Aplicação:\\\\n Este comando cria o arquivo executável chamado wuzapi.\\n\\n codeBash\\n\\n \\n go build -o wuzapi\\n\\n\\n*\\n\\n#### 3. Configuração do Arquivo .env\\n\\nAntes de iniciar a API, é fundamental configurar as variáveis de ambiente, principalmente as de acesso ao banco de dados.\\n\\n1. Acesse e edite o arquivo .env.example para criar seu arquivo de configuração. É comum renomeá-lo para .env.\\n2. Preencha as variáveis do banco de dados (DB\\_HOST, DB\\_USER, DB\\_PASSWORD, DB\\_NAME, DB\\_PORT).\\n\\n{% hint style=\"success\" %}\\nDica de Configuração: É uma prática comum utilizar as mesmas credenciais do banco de dados da sua instalação Z-PRO. Ao fazer isso, a Wuzapi criará suas próprias tabelas no mesmo banco de dados, simplificando o gerenciamento.\\n{% endhint %}\\n\\n*\\n\\n#### 4. Execução e Gerenciamento com PM2\\n\\nCom a aplicação compilada e configurada, vamos iniciá-la.\\n\\n1. Execução para Teste (Opcional):\\\\n Você pode iniciar a API manualmente para um teste rápido. O comando abaixo a iniciará na porta 5555.\\n\\n codeBash\\n\\n \\n ./wuzapi -port 5555\\n\\n\\n Para confirmar que está funcionando, acesse http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555 no navegador.\\n2. Iniciando como um Serviço com PM2:\\\\n Este comando iniciará a Wuzapi e garantirá que ela reinicie automaticamente em caso de falhas ou após o boot do servidor.\\n\\n codeBash\\n\\n \\n # Inicia o serviço\\n pm2 start ./wuzapi --name \"wuzapi\" -- -port 5555\\n\\n # Salva a lista de processos do PM2\\n pm2 save\\n\\n # Configura o PM2 para iniciar com o sistema\\n pm2 startup\\n\\n3. Verificando os Logs:\\\\n Para acompanhar os logs da aplicação em tempo real, use o comando:\\n\\n codeBash\\n\\n \\n pm2 logs wuzapi\\n\\n\\n*\\n\\n#### 5. Integração com Z-PRO\\n\\nO último passo é conectar sua nova instância da Wuzapi ao painel do Z-PRO.\\n\\n1. No painel Admin, navegue até Configurações > Integrações > Wuzapi.\\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555).\\n3. Preencha a Chave Global com o APP\\_ADMIN\\_TOKEN definido no seu arquivo .env.\\n\\n\\n\\n1. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção \"Wuzapi\".\\n\\n\\n\\n1. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\\n\\n*\\n\\n#### Tutorial em Vídeo**\\n\\nPara uma demonstração visual detalhada de todos os passos descritos nesta documentação, assista à gravação completa.\\n\\n{% embed url=\"https://www.youtube.com/watch?t=1s&v=s7G1ZuQLw0Y\" %}\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.15.1","depth":5,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md","articles":[]}]},{"title":"Whatsapp Z-API\\n\\nA Z-API é uma solução não oficial paga e gerenciada por uma empresa externa. https://www.z-api.io/\\n\\n## Passo a passo para conexão\\n\\n### 1. Contratar a Z-API\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://www.z-api.io/\\n\\nPré-requisito na Plataforma Z-API\\n\\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL padrão do serviço (https://api.z-api.io).\\n2. Chave Global: O seu \"Token de Segurança\" gerado nas configurações da sua conta na Z-API.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\\\nConfiguração adicional para a Z-API: \\n\\n ID da Instância\\n Token da Instância\\n\\n\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.16","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md","articles":[]}]},{"title":"Equipes\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e supervisor\\n{% endhint %}\\n\\nA página de Equipes é o local central para a organização dos agentes de atendimento. Através dela, o administrador segmenta os colaboradores por especialidade, departamento ou função, permitindo uma distribuição de tickets mais eficiente e organizada.\\n\\n#### Principais funções\\n\\n Segmentação de Atendimento: Criação de departamentos (ex: Comercial, Suporte, Financeiro).\\n Gestão de Membros: Vinculação de usuários específicos a cada equipe.\\n Controle de Visibilidade: Ativação ou desativação de equipes conforme a demanda.\\n Organização Visual: Personalização de cada equipe com fotos identificadoras.\\n\\n#### Caso de uso\\n\\nUma empresa que possui diferentes fluxos de atendimento utiliza a página de Equipes para separar o setor de Suporte Técnico do Setor de Vendas. Assim, ao realizar a transferência de um Ticket, o sistema direciona a demanda apenas para os Usuários vinculados à equipe selecionada, otimizando o tempo de resposta.\\n\\n#### Como acessar a página\\n\\nPara acessar, clique no Menu Administração e selecione a aba Equipes.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\n Campo de Busca: Permite localizar uma equipe específica pelo nome.\\n Botão + Nova Equipe: Abre o formulário para criação de um novo grupo de atendimento.\\n ID: Identificador único da equipe no banco de dados.\\n Nome: Nome atribuído à equipe (ex: Suporte, Vendas).\\n Status: Indica se a equipe está Ativa (apta a receber tickets) ou Inativa.\\n Membros: Exibe a quantidade de usuários vinculados àquela equipe.\\n Ações:\\n Ícone Gerenciar Membros (Usuário com +): Abre a tela para adicionar ou remover atendentes da equipe.\\n Ícone Editar (Lápis): Permite alterar o nome, foto ou status da equipe.\\n Ícone Excluir (Lixeira): Remove a equipe permanentemente do sistema.\\n\\n*\\n\\n#### Passo a passo de uso\\n\\nCriar uma nova equipe\\n\\n1. Acesse o menu Equipes e clique no botão + Nova Equipe.\\n2. Insira o Nome da equipe no campo correspondente.\\n3. Mantenha a chave Ativa habilitada para que a equipe fique disponível para uso imediato.\\n4. Clique em Salvar.\\n\\n\\n\\nGerenciar membros da equipe\\n\\n1. Na listagem de equipes, identifique a equipe desejada e clique no ícone Gerenciar Membros (ícone de usuário com um sinal de \"+\").\\n2. Selecione os Usuários que farão parte deste time.\\n3. Confirme a operação para salvar as alterações.\\n\\n#### Detalhamento\\n\\nAs equipes criadas nesta página serão refletidas diretamente no Chat Privado \\n\\n\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nAtenção: Ao excluir uma equipe, certifique-se de que não existam tickets pendentes vinculados a ela, pois isso pode causar inconsistência na distribuição dos atendimentos em aberto.\\n{% endhint %}\\n\\n{% hint style=\"info\" %}\\nA foto da equipe deve respeitar o limite de 5MB**. Formatos recomendados: PNG ou JPG.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/equipes.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.2","depth":3,"path":"docs/configuracao-administrador/administracao-painel-admin/equipes.md","ref":"docs/configuracao-administrador/administracao-painel-admin/equipes.md","articles":[]},{"title":"Usuários\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador\\n{% endhint %}\\n\\nA página de Usuários é o centro de gestão de acessos do sistema Z-PRO. Nela, o administrador realiza o cadastro de novos colaboradores, define níveis de hierarquia através de perfis, controla permissões de visibilidade de módulos e estabelece jornadas de trabalho por meio da configuração de horários.\\n\\n#### Principais funções\\n\\n Gestão de Identidade: Cadastro e edição de credenciais de acesso (e-mail e senha).\\n Hierarquia de Acesso: Atribuição de perfis (Administrador, Supervisor, Atendente ou Personalizado).\\n Controle de Módulos: Definição manual de quais menus cada usuário pode visualizar.\\n Integração de Telefonia: Configuração de ramais SIP e permissões para chamadas via WaVoIP.\\n Jornada de Trabalho: Estabelecimento de horários de atendimento individuais por usuário.\\n\\n#### Caso de uso\\n\\nUma empresa contrata um novo colaborador para o setor de suporte. O administrador cria o usuário e, em vez de dar acesso total, seleciona o perfil Atendente. Nas Permissões de Menu, ele habilita apenas \"Chat Privado\", \"Tarefas\" e \"Contatos\". Além disso, configura o Horário de Atendimento para que o sistema impeça o recebimento de novos Tickets fora do expediente do colaborador.\\n\\n#### Como acessar a página\\n\\nCaminho clicando no Menu Administração e na aba Usuários.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\nColunas da Tabela:\\n\\n Nome/E-mail: Identificação do colaborador e sua credencial de login.\\n Perfil: Badge que indica o nível de acesso (Admin, Supervisor, Atendente ou Perfis Customizados).\\n Status: Indica se o usuário está Ativo ou Inativo no sistema.\\n Online: Chave seletora que mostra se o usuário está logado no momento.\\n\\nAções (Ícones):\\n\\n Ícone Gerenciar Filas (Vínculo): Permite vincular o usuário às Filas de Atendimento.\\n Ícone Canais (Smartphone): Define quais Canais de Comunicação o usuário pode operar.\\n Ícone Editar (Lápis): Abre o modal completo de edição de dados e permissões.\\n Ícone Equipes (Pessoa com x): Inativa o usuário\\n Ícone Excluir (Lixeira): Remove o usuário permanentemente do sistema.\\n\\n*\\n\\n#### Passo a passo de uso\\n\\n1. Criar um novo usuário\\n\\n1. Clique no botão + Novo Usuário no canto superior direito.\\n2. Preencha os dados básicos: Nome, E-mail, Senha e Telefone.\\n3. Perfil: Escolha entre as opções fixas ou a opção Personalizado (ver detalhamento abaixo).\\n\\n\\n\\nUsuário Restrito: Quando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada. Explicação mais abaixo.\\n\\nPermissões de Menu: Marque os módulos que o colaborador terá acesso (Ex: Envio em Massa, Kanban, Campanhas).\\n\\n\\n\\n2. Configurar Telefonia (Opcional)\\n\\nBloquear WaVoIP:se desejar impedir que o usuário realize chamadas pela plataforma.\\n\\n\\n\\nConfig SIP: habilite a chave se houver integração com telefonia IP.\\n\\n\\n\\nPreencha os dados do servidor, usuário e senha fornecidos pelo seu provedor VoIP.\\n\\n3. Definir Horário de Atendimento\\n\\n1. Expanda a seção Horário de Atendimento.\\n2. Defina para cada dia da semana se o usuário está \"Aberto\" ou \"Fechado\".\\n3. Configure os turnos (1º e 2º período). O usuário só aparecerá como disponível para novos atendimentos dentro destes intervalos.\\n\\n\\n\\n*\\n\\n### Detalhamento\\n\\n#### Perfis de Acesso\\n\\nO Z-PRO permite uma granularidade avançada através dos Perfis de Acesso:\\n\\n Administrador: Possui acesso total e irrestrito a todas as configurações e dados.\\n Supervisor: Nível intermediário, focado em monitoramento e gestão de filas/relatórios.\\n Atendente: Focado na operação direta de chats e contatos.\\n Personalizado: Ao selecionar esta opção, surge o campo Perfil de Acesso, onde você pode escolher um template de permissões pré-criado.\\n\\nGerenciar Perfis\\n\\nAo clicar no botão Gerenciar Perfis no topo da tela, o sistema abre uma área exclusiva para a criação de novos templates de permissões reutilizáveis\\n\\n### Usuário Restrito\\n\\nQuando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada da seguinte forma:\\n\\nMenu de Contatos Oculto: O usuário não terá acesso ao menu \"Contatos\", impedindo a visualização ou exportação da lista completa de contatos.\\n\\n\\n\\nProibido Iniciar Novas Conversas\\n\\n O botão \"Iniciar Conversa Avulsa\" na tela de Atendimentos será ocultado.\\n\\n\\n\\n#### Na Tela de Atendimento (Chat)\\n\\nDentro de um ticket, o usuário restrito sofrerá as seguintes limitações visuais e funcionais:\\n\\n Nome do Contato: Será exibido parcialmente (apenas os 5 primeiros caracteres).\\n Foto do Perfil: Receberá um forte efeito de desfoque (blur).\\n Dados Sensíveis: Todos os campos de detalhes do contato na barra lateral (como Telefone, E-mail, CPF, etc.) serão ocultados.\\n Botão Editar Contato: O ícone de lápis para editar o contato será ocultado.\\n Opções de Telefonia: Os botões de telefonia serão desabilitados.\\n Ações de Mensagem: As opções \"Encaminhar\" e \"Marcar\" serão desabilitadas para impedir o vazamento de dados.\\n\\n{% hint style=\"success\" %}\\nObjetivo da Restrição\\n\\nEsta funcionalidade é desenhada para proteger os dados sensíveis dos seus clientes, limitando o acesso apenas ao necessário para a função do atendente e alinhando sua operação às melhores práticas de segurança e à LGPD.\\n{% endhint %}\\n\\n**\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nAtenção: Ao inativar um usuário, ele perderá o acesso imediato ao painel, porém seus dados e histórico de atendimentos permanecem salvos no banco de dados para auditoria.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.3","depth":3,"path":"docs/configuracao-administrador/administracao-painel-admin/usuarios.md","ref":"docs/configuracao-administrador/administracao-painel-admin/usuarios.md","articles":[{"title":"Perfis de Acesso\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador\\n{% endhint %}\\n\\nA página de Perfis de Acesso permite a criação de templates de permissões reutilizáveis e granulares. Em vez de configurar cada usuário individualmente, o administrador define um perfil padrão (ex: \"Suporte Nível 1\") e o atribui a vários colaboradores.\\n\\n#### Caso de uso\\n\\nUma empresa deseja criar um perfil específico para estagiários que apenas respondem chats, mas não podem excluir contatos ou exportar relatórios. O administrador cria o perfil \"Estagiário\", desmarca as opções de \"Excluir\" e \"Exportar\", e vincula todos os novos estagiários a este template. Se futuramente a empresa decidir que estagiários podem acessar o Kanban, basta editar o perfil uma única vez.\\n\\n#### Como acessar a página\\n\\nCaminho clicando no Menu Administração, aba Usuários e no botão superior direito Gerenciar Perfis.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\n Botão + Novo Perfil: Abre o formulário para criação de um novo template de acesso.\\n Nome do Perfil: Identificação do template (ex: Atendente Noturno).\\n Contador de Usuários: Exibe quantos colaboradores estão vinculados àquele perfil no momento.\\n Ícone Editar (Lápis): Permite alterar as permissões e o nome do perfil.\\n Ícone Excluir (Lixeira): Remove o perfil do sistema\\n\\n**\\n\\n#### Passo a passo de uso\\n\\n1. Criar um Perfil com IA (Copiloto)\\n\\n1. Clique em + Novo Perfil.\\n2. No campo Sugerir com IA, descreva o que o usuário fará. Exemplo: \"Atendente que responde tickets e vê contatos, mas não pode deletar nada nem exportar\".\\n3. Clique em Sugerir. O Copiloto marcará automaticamente os campos correspondentes.\\n4. Revise as marcações manuais antes de salvar.\\n\\n\\n\\n2. Configuração Manual\\n\\n1. Insira o Nome do perfil e uma Descrição opcional.\\n2. Navegue pelas seções de Módulos Visíveis para definir o que aparecerá no menu lateral do usuário.\\n3. Navegue pela seção Permissões para definir as ações permitidas (ex: resolver ticket, deletar mensagem).\\n4. Clique em Salvar.\\n\\n3. Atribuir o Perfil ao Usuário\\n\\n1. Volte para a página de Usuários.\\n2. Edite o usuário desejado, mude o campo Perfil para Personalizado.\\n3. No novo campo que surgirá (Perfil de acesso), selecione o template criado.\\n\\n*\\n\\n#### Detalhamento das Permissões\\n\\nAbaixo estão os agrupamentos de permissões disponíveis para configuração:\\n\\nMódulos Visíveis (Sidebar)\\n\\n* Principal: Ter acesso aos menus atendimento, chat-privado, contatos, mensagens-rápidas, painel-atendimento, tarefas e wavoip.\\n* Organização: Ter acesso aos menus agenda, campanhas, funil, galeria, grupo e kanban.\\n* Configuração: Ter acesso aos menus agendamentos, aniversários, auto-resposta, avaliações, chat-flow, etiquetas, fechamento, filas, horário-Atendimento, notas e protocolos.\\n* Relatórios: Ter acesso aos menus audit-log, dashboard, log- ligação e relatórios.\\n* Integrações e Canais: Ter acesso aos menus api-service, sessões e woocommerce-produtos.\\n* Redes Sociais: Ter acesso aos menus de gestão de comentários do facebook, instagram, tiktok e youtube, além de menções no instagram.\\n* Administração: Ter acesso aos menus de equipes e usuários.\\n\\n\\n\\n\\n\\nPermissões de Ação\\n\\n* Atendimentos: Permissões para atribuir tickets (assign), usar o copiloto de IA (copilot), criar (create), deletar (delete), reabrir (reopen), resolver (resolve), visualizar todos (view\\_all) e visualizar via chatbot (view\\_chatbot).\\n* Contatos: Permissões para criar (create), deletar (delete), editar (edit), exportar base (export) e visualizar todos os detalhes (view\\_full).\\n* Mensagens: Permissões para deletar mensagens enviadas (delete), encaminhar mensagens (forward) e gerenciar respostas rápidas públicas (quickreplies\\_manage\\_public).\\n* Tarefas: Permissões para criar (create), deletar (delete), editar (edit) e visualizar todas (view\\_all).\\n* Kanban e Funil: Permissões para visualizar o painel de atendimentos geral (attendance\\_panel\\_view\\_all), gerenciar o funil (funnel\\_manage) e gerenciar o kanban (kanban\\_manage).\\n* Relatórios: Permissões para exportar dados (export) e visualizar relatórios (view).\\n* Configurações: Permissão para acessar as configurações gerais do sistema (settings\\_general).\\n* Módulos Diversos: Permissões para gerenciar horários (business\\_hours), campanhas (campaigns), chatflow (chat\\_flow), motivos de fechamento (closure\\_reasons), galeria (gallery), grupos (groups), envios em massa (mass\\_send), notas (notes), notificações (notifications), acesso ao chat privado (private\\_chat), protocolos (protocols), filas (queues), avaliações (ratings), mensagens agendadas (scheduled\\_messages) e etiquetas (tags).\\n* Administração Avançada: Permissões para gerenciar serviços de API (api\\_service\\_access), visualizar logs de auditoria (audit\\_log\\_view), gerenciar sessões/canais (sessions\\_manage) e gerenciar ou visualizar usuários (users\\_manage / users\\_view).\\n* VoIP: Permissões para uso do serviço WaVoIP (voip\\_wavoip) e acesso ao webphone (voip\\_webphone).\\n\\n\\n\\n\\n\\n*\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nRegra de Exclusão: Um perfil que esteja sendo utilizado por pelo menos um usuário ativo não poderá ser excluído. Para deletá-lo, você deve primeiro reatribuir esses usuários a outro perfil.\\n{% endhint %}\\n\\n{% hint style=\"danger\" %}\\nSegurança: Ao usar a sugestão por IA, sempre revise manualmente se as permissões críticas (como tickets_delete ou audit_log_view) foram marcadas corretamente para evitar exposição de dados sensíveis.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.3.1","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md","ref":"docs/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md","articles":[]}]}]},"previous":{"title":"[🔘 WABA Interativo\\n\\n## POST /v2/api/external/{ApiID}/sendButtonWABA\\n\\n> SendButtonWABA\\n\\n\\n\\n## POST /v2/api/external/{ApiID}/sendListWABA\\n\\n> SendListWABA\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the query parameter:\\n\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n](docs/central-do-assinante/referencia-da-api/waba-interativo.md)","level":"1.5.3.25","depth":3,"ref":"","articles":[]},"articles":[{"title":"Administração - Painel Admin\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1","depth":2,"path":"docs/configuracao-administrador/administracao-painel-admin.md","ref":"docs/configuracao-administrador/administracao-painel-admin.md","articles":[{"title":"Canais de comunicação\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e supervisor\\n{% endhint %}\\n\\nA capacidade de centralizar múltiplos canais de comunicação em uma única plataforma é uma das principais funcionalidades do Z-PRO. Esta documentação oferece uma visão geral sobre os tipos de canais que você pode conectar, ajudando você a decidir quais são os mais adequados para a sua operação.\\n\\n#### Como acessar a página\\n\\nPara acessar, clique no Menu Administração e selecione a aba Canais.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\n*\\n\\n### Opções de Conexão- Tipo de Canal\\n\\nO Z-PRO oferece suporte a múltiplos canais simultâneos. Abaixo, listamos as tecnologias disponíveis para conexão:\\n\\n#### 1. Meta Oficial\\n\\n\\n\\n[WhatsApp Oficial (OAuth): ](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md)Conexão na API oficial via QR-CODE, com coexistência entre Whatsapp business e o zpro, usando o app de integração nativo do ZPRO. É a conexão mais prática e segura disponível. Necessário ter um número WhatsApp business.\\n\\n[Instagram Direct e Facebook Messenger](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md) via API Oficial (Login do Facebook), sem necessidade de hubs externos (BETA)\\n\\n[Waba: WhatsApp Oficial - Cloud API](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md): Conexão via app próprio, que deve ser configurado no facebook developers. Não depende de celular ligado e oferece risco reduzido de banimento. Ideal para médias e grandes operações.\\n\\n#### 2. Whatsapp não oficial\\n\\n\\n\\nSimula o WhatsApp Web/Desktop. Depende de um aparelho celular conectado. O Z-PRO disponibiliza diversos \"motores\" para garantir compatibilidade com diferentes tipos de chip:\\n\\n* Baileys\\n* WebJs\\n* Evolution\\n* Wuzapi\\n* Z-API\\n* Uazapi\\n\\n{% hint style=\"info\" %}\\nQual a diferença técnica?\\\\nPara entender profundamente os prós e contras de cada tipo de conexão e decidir qual é a melhor para o seu negócio, leia nosso artigo comparativo:\\\\n👉 [API Oficial vs. APIs Não Oficiais: Guia Completo](https://www.google.com/url?sa=E\\&q=https%3A%2F%2Fajuda.zdg.com.br%2Fconheca-o-z-pro%2Frecursos-e-integracoes-do-z-pro%2Fapi-oficial-do-whatsapp-vs.-apis-nao-oficiais)\\n{% endhint %}\\n\\n#### 3. Outros\\n\\n\\n\\n* Telegram: Conexão via Bot Token oficial. Extremamente estável e funciona 100% na nuvem.\\n* WebMail: Conexão via protocolo IMAP/SMTP para transformar e-mails recebidos em tickets de atendimento.\\n* WebChat: Widget de chat ao vivo para instalar no seu site institucional.\\n* Hub Notificame: API terceira para Instagram Direct e Facebook Messenger.\\n\\n*\\n\\n### Ações Gerais da Tela\\n\\nNo topo da página, você encontra dois botões principais para a organização do seu painel:\\n\\n1. Alterar Ordem de Visualização: Permite reorganizar a disposição dos cards na tela podendo organizar por: Padrão, A–Z, por tipo, Agrupado, por provedor ou por status\\n\\n\\n\\n2. Adicionar Canal: Botão para iniciar uma nova conexão.\\n\\n 👉 Clique aqui para ver o passo a passo de como conectar um novo canal\\n\\n**\\n\\n### Gerenciando um Canal Conectado\\n\\nApós a ativação de uma conexão, o sistema disponibiliza um menu de ações rápidas para a gestão técnica e operacional do canal. Estas opções permitem o controle de fluxo de mensagens e a manutenção da integridade da comunicação.\\n\\n\\n\\nOpções Gerais (Disponíveis para todos os canais)\\n\\n Editar: Permite alterar o nome de identificação da conexão e ajustar parâmetros técnicos internos.\\n Definir como padrão: Estabelece o canal como a conexão prioritária para o envio de mensagens automáticas e notificações do sistema.\\n Transferir Canal: Possibilita a migração da gestão do canal entre diferentes estruturas do painel.\\n Fechar tickets abertos: Executa o encerramento em lote de todos os atendimentos ativos (status \"Aberto\") vinculados exclusivamente a este canal.\\n Fechar tickets pendentes: Executa o encerramento em lote de todos os atendimentos que aguardam aceite (status \"Pendente\") nesta conexão.\\n Excluir: Remove permanentemente a conexão do sistema.\\n\\nFunções Específicas e Exclusividades\\n\\nO sistema exibe ícones e funções adicionais de acordo com a tecnologia do canal conectado:\\n\\n Revalidar Webhook: Esta função é essencial para restabelecer a sincronia de dados entre a plataforma de origem e o Z-PRO.\\n Canais compatíveis: Disponível para Evolution, Hub, Meow, Instagram, Messenger, UAZAPI e Z-API.\\n Canais WABA (Meta): Para conexões oficiais, o menu exibe as opções específicas Revalidar Webhook Waba e Revalidar Webhook Secundário Waba, garantindo a redundância e estabilidade do recebimento de mensagens oficiais.\\n\\n{% hint style=\"info\" %}\\nQual a diferença do webhook do aplicativo para o do telefone?\\n\\nO webhook principal é o do aplicativo, e o secundário é o do telefone.\\n\\nFunciona assim: imagine que você tem um único aplicativo na Meta e dentro dele conecta 3 números diferentes.\\n\\nNa Meta, o aplicativo permite apenas 1 webhook principal cadastrado — esse é o chamado webhook de aplicativo.\\n\\nPorém, cada número pode precisar ser utilizado em um tenant diferente dentro da plataforma.\\n\\nComo o webhook principal é único, não seria possível direcionar cada número diretamente para tenants diferentes usando apenas ele.\\n\\nPor isso utilizamos o webhook secundário: ele mantém a assinatura e a validação do webhook principal do aplicativo, mas faz o redirecionamento das mensagens de cada telefone para o tenant correto.\\n\\nAssim, conseguimos usar vários números do mesmo aplicativo em tenants diferentes sem conflito.\\n{% endhint %}\\n\\n Gerar Widget: Botão exclusivo para conexões do tipo Site. Permite gerar o código de integração para embutir o chat em páginas web externas.\\n\\n{% hint style=\"warning\" %}\\nAtenção: As ações de \"Fechar tickets\" são irreversíveis e afetam o histórico imediato do dashboard. Utilize estas funções apenas para limpezas de fila ou manutenções operacionais.\\n{% endhint %}\\n\\n*\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1","depth":3,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao.md","articles":[{"title":"Como conectar um canal (sessão/número)\\n\\nNo menu lateral do seu painel, clique em ADMINISTRAÇÃO, aba Canais.\\n\\n\\n\\nVocê verá a seguinte tela:\\n\\n\\n\\nAqui é onde você fará a conexão com os números oficiais da sua empresa, para realizar os atendimentos.\\n\\n## Nova conexão \\n\\nClique em Adicionar Canal no canto superior da tela.\\n\\n\\n\\nAssim que selecionar esse botão, um pop up se abrirá para que você preencha as informações. Veja o exemplo:\\n\\n\\n\\n### 1. Escolha do Tipo de Canal\\n\\nAo clicar em \"Adicionar Canal\", a primeira etapa é selecionar a tecnologia de conexão. Cada tipo possui características específicas de estabilidade e recursos.\\n\\nPara detalhes técnicos e passo a passo de conexão (QR Code ou Token) de cada tipo, consulte as documentações específicas:\\n\\nWhatsApp Oficial (OAuth)\\n\\nInstagram Direct e Facebook Messenger\\n\\nWaba: WhatsApp Oficial - Cloud API\\n\\nPara essa documentação vamos passar o tutorial para conectar APIs não oficiais\\n\\n\\n\\n### 2. Preencha dos dados \\n\\n#### Código de pareamento\\n\\n\\n\\nApenas para o canal tipo BAILEYS, WebJS e Meow\\n\\nOpção caso não seja possível ler o QR Code\\n\\n#### Nome\\n\\n\\n\\nInsira um nome para identificar esse canal.\\n\\n Canal padrão: Define se este será o canal principal para envios automáticos do sistema.\\n\\n#### Atribuições\\n\\n\\n\\nEm **ChatFlow você pode escolher o Fluxo (BOT) que usará como padrão para o atendimento desse número. Voce pode atribuir apenas um fluxo para cada número/conexão.\\n\\nEm Fila você pode escolher uma Fila que usará como padrão para o atendimento desse número.\\n\\nEm Usuário você pode escolher uma Usuário que usará como padrão para o atendimento desse número.\\n\\nEssa função você só consegue habilitar depois de criar o canal*\\n\\n#### Importar mensagem do Aparelho\\n\\nApenas para o canal tipo BAILEYS (QR CODE)\\n\\n\\n\\n### Wavoip\\n\\n\\n\\nAtivação da ligação por meio de Chamadas VoIP\\n\\nDocumentação completa: Wavoip - Ligações pelo WhatsApp\\n\\n#### Mensagem de Despedida do Atendimento\\n\\n\\n\\nMensagem enviada assim que finaliza um atendimento nesse botão:\\n\\n\\n\\n#### Informações com IAs\\n\\nPara integrar ad inteligencias artificiais com o canal que está sendo criado é preciso adicionar as informações específicas de cada IA. Verificar os campos necessários em cada aba abaixo.\\n\\n{% hint style=\"warning\" %}\\nÉ necessário ativar a integração do seu Z-PRO com a IA desejada dentro do Painel do Admin - Configurações gerais para que seja possível ativar dentro do Canal criado\\n\\nBots e IA\\n{% endhint %}\\n\\n\\n\\nAssim que habilitar a integração com Bots IA, ela aparecerá na criação do canal para colocar as informações:\\n\\n\\n\\n### Webhook do canal\\n\\nDispara notificações para uma URL exclusiva deste canal, em paralelo ao webhook geral do tenant\\n\\n\\n\\n### Pix\\n\\nConfiguração padrão pré-salva para o botão PIX. Os campos são carregados automaticamente ao abrir o envio e podem ser alterados antes de enviar.\\n\\n\\n\\n### Recursos do canal\\n\\n\\n\\n\\n\\n| Opção | Descrição e Funcionamento |\\n| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\\n| Habilitar avaliação automática | Envio automático de pesquisa de satisfação.Ao resolver um ticket, o sistema envia automaticamente a mensagem de avaliação configurada para o cliente, sem necessidade de ação manual do atendente. |\\n| Habilitar transcrição de áudio | Conversão de voz para texto.Os áudios recebidos no chat serão processados e transcritos para texto, facilitando a leitura e a indexação do conteúdo. |\\n| Habilitar auto distribuir | Balanceamento de carga entre a equipa.Novos tickets que chegam sem dono definido serão distribuídos automaticamente e de forma equitativa entre os atendentes que estiverem online no sistema. |\\n| Habilitar destruição de mensagem | Privacidade e limpeza de dados.Quando uma mensagem é apagada na interface do chat (pelo utilizador ou admin), ela é removida permanentemente da base de dados do sistema, e não apenas ocultada visualmente. |\\n| Habilitar envio de mensagem para aniversariantes | Marketing e relacionamento automático.Envia automaticamente uma mensagem de felicitações (definida no campo abaixo desta opção) na data de aniversário do contacto.• Nota: Esta função ignora as configurações de horário de atendimento, garantindo que os parabéns sejam enviados mesmo fora do expediente. |\\n| Ignorar Horário de Atendimento | Ignora o horário de atendimento do sistema para este canal. |\\n| Redistribuição Automática de Tickets | Redistribui automaticamente tickets de usuários que ficarem offline por mais do que o tempo configurado. |\\n| Posição na fila | Quando um novo atendimento entra na fila como pendente, o sistema envia uma mensagem automática informando a posição do cliente e o tempo médio de espera. Herdar: segue a configuração global do tenant. Ativado: sobrescreve o global e usa a configuração deste canal. Desativado: sobrescreve o global e não envia. O gatilho dispara apenas uma vez por ticket, depois que o chatbot/flow termina. Se o ticket for atribuído a um agente automaticamente ou se um chatbot assumir, a mensagem não é enviada. Escopo da posição: contagem na mesma fila (queue) do ticket; se não houver fila, conta pelo canal. Canais suportados: WhatsApp Web, Baileys, WABA, Instagram, Messenger, Webchat, Telegram, Evolution, Z-API, UazAPI, Meow, Hub. |\\n| Habilitar desligamento automático das integrações externas | Transição suave de Robô para Humano.Quando um atendente abre ou assume um ticket, o sistema desativa automaticamente as integrações de IA (ChatGPT, Typebot, Dify, N8N, DialogFlow) para aquela conversa, evitando que o robô interrompa o atendimento humano. |\\n| Habilitar espera no processamento de mensagens com integrações externas | Fila de processamento para Chatbots.Evita que o bot se confunda quando o cliente envia várias mensagens seguidas. O sistema processará uma mensagem de cada vez, aguardando a resposta da integração (ex: Typebot) antes de processar a frase seguinte do cliente. |\\n| Habilitar Web Push | Notificações do Sistema.Ativa o envio de notificações push (alertas de navegador ou PWA) para avisar os utilizadores sobre novas mensagens ou atividades no painel, mesmo quando a aba não está em primeiro plano. |\\n| Contingência | Se ativo: o canal recebe mensagens. Se inativo: permanece conectado mas não recebe mensagens. |\\n| Palavra-chave para fechamento automático | Ao receber esta palavra-chave o ticket será encerrado automaticamente. |\\n\\nVocê pode habilitar uma palavra chave para fechamento automático do atendimento. Essa é uma palavra chave que ao ser recebida irá encerrar o ticket automaticamente.\\n\\n### Configurações adicionais (Proxy)\\n\\nApenas para o canal tipo BAILEYS, WebJS, Meow, Evolution API, Uazapi**\\n\\n\\n\\n{% content-ref url=\"/pages/vh9IxgE5vP6vALpCouvj\" %}\\nProxy IPv4 no Proxy-Seller\\n{% endcontent-ref %}\\n\\n### Ações finais\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.1","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero.md","articles":[{"title":"Distribuição Automática de Atendimentos\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e supervisor\\n{% endhint %}\\n\\nA distribuição automática de atendimentos atribui novas conversas aos seus atendentes de forma automática, agilizando o primeiro contato e balanceando a carga de trabalho da equipe.\\n\\nO Z-PRO oferece duas formas nativas para configurar esta automação: diretamente na configuração de um Canal ou como uma etapa dentro de um Fluxo de Chatbot.\\n\\n*\\n\\n#### Método 1: Pela Configuração do Canal\\n\\nEste método distribui todas as novas conversas que chegam em um canal específico assim que elas são criadas.\\n\\n* Quando Usar: Ideal para operações de atendimento direto, onde você quer que o cliente fale com um atendente o mais rápido possível.\\n* Como Funciona a Lógica: O sistema prioriza a distribuição para um atendente que esteja online e associado à fila principal do canal. Se não houver nenhum atendente online na fila designada, a regra transborda, e o sistema atribui o ticket a qualquer outro atendente que esteja online na plataforma, independentemente da fila dele.\\n* Como Configurar:\\n 1. No painel Admin, acesse \"Canais\".\\n 2. Edite o canal desejado e ative a opção \"Habilitar auto histribuir\".\\n\\n\\n\\n*\\n\\n#### Método 2: Pelo Chatbot\\n\\nEste método permite que a distribuição ocorra em um momento específico do fluxo de conversa do chatbot.\\n\\n Quando Usar: Perfeito para cenários onde o chatbot primeiro qualifica o cliente (coleta informações) e só depois transfere para um atendente humano.\\n Como Funciona a Lógica: Você adiciona uma ação de \"Autodistribuir Ticket\" em seu fluxo. Ao chegar nesta etapa, o sistema distribui o atendimento para um atendente que pertença à fila em questão (a fila onde o chatbot está operando), utilizando o método que você definir.\\n Opções de Distribuição:\\n Aleatório (Random): Escolhe um atendente online da fila de forma aleatória.\\n Balanceado (Balanced): Escolhe o atendente online com o menor número de atendimentos recebidos no dia.\\n Como Configurar:\\n 1. Acesse \"Chatbot\" e edite o fluxo desejado.\\n 2. Clique balão \"Configurações\"\\n 3. Encontra a opção \"Auto distribuir atendimento\"\\n 4. Selecionando o método de distribuição.\\n\\n\\n\\n*\\n\\n{% hint style=\"info\" %}\\nNota sobre Distribuição Avançada**\\n\\nPara regras de negócio mais complexas, é possível utilizar uma ferramenta externa como o n8n, que pode receber os dados do ticket via Webhook e utilizar a API do Z-PRO para atribuir o atendente com base na sua lógica personalizada.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.1.1","depth":5,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md","articles":[]}]},{"title":"Como configurar a API Oficial do WhatsApp (WABA)\\n\\nEsta documentação detalha o processo completo para configurar a API Oficial do WhatsApp (também conhecida como WABA ou Cloud API) e conectá-la à plataforma Z-PRO.\\n\\nSeguir os passos na ordem correta é fundamental para garantir uma instalação bem-sucedida. \\n\\n### Live - Criação de App no facebook developers e integração com a API Oficial, Instagram e Facebook\\n\\n{% embed url=\"https://youtu.be/MpMQsRT6ba4\" %}\\n\\n## Tutorial passo-a-passo:\\n\\n### Vídeo 1: Criar número de telefone\\n\\n{% embed url=\"https://youtu.be/tS1vTy_x1Oc\" %}\\n\\n### Vídeo 2: Configurando número na Meta\\n\\n{% embed url=\"https://youtu.be/F4K-X0-nx7s\" %}\\n\\n### Vídeo 3: Configurando WABA no Z-PRO\\n\\n{% embed url=\"https://youtu.be/iTkpUxweMYM\" %}\\n\\n### Vídeo 4: Configurando Webhook de callback\\n\\n{% embed url=\"https://youtu.be/w6UL_EEUKKg\" %}\\n\\n### Vídeo 5: Registrar o número e criar templates de mensagens\\n\\n{% embed url=\"https://youtu.be/i55tBINrYfw\" %}\\n\\n*\\n\\n## Documentação das etapas:\\n\\n## Etapa 1: Pré-requisitos e Preparação\\n\\nAntes de começar, você precisará de dois itens essenciais:\\n\\n1. Uma conta no Facebook.\\n2. Um número de telefone (pode ser virtual ou um chip físico).\\n\\n{% hint style=\"danger\" %}\\nAVISO SOBRE O NÚMERO DE TELEFONE\\n\\n* Você não pode usar o mesmo número no aplicativo normal do WhatsApp e na API Oficial.\\n* Se você deseja usar um número que já possui uma conta de WhatsApp, é obrigatório excluir permanentemente a conta de WhatsApp associada a ele antes de continuar. Não basta apenas deletar o aplicativo.\\n Para testes, recomendamos fortemente a compra de um número virtual.\\n {% endhint %}\\n\\n\\n\\n## Etapa 2: Criação e Configuração do Aplicativo na Meta\\n\\nNesta etapa, vamos criar o aplicativo no ambiente da Meta que será responsável por gerenciar a API.\\n\\n1. Acesse o Facebook for Developers: Faça o login com sua conta do Facebook em https://developers.facebook.com/ \\n\\n\\n\\n2. Crie um Novo Aplicativo:\\n\\n Clique em \"Criar Aplicativo\".\\n\\n\\n\\n Selecione \"Outros\"\\n Selecione o tipo \"Business\".\\n\\n\\n\\n Dê um nome ao seu aplicativo (ex: \"Waba Cloud API\") e associe-o à sua conta do Gerenciador de Negócios (BM).\\n\\n3. Adicione o Produto WhatsApp: No painel do seu novo aplicativo, encontre e adicione o produto \"WhatsApp\".\\n\\n\\n\\n4. Configure as Informações Básicas:\\n\\n Acesse \"Configurações do app\" > \"Básico\".\\n\\n\\n\\n Preencha os campos \"URL da Política de Privacidade\" e \"URL dos Termos de Serviço\".\\n\\n5. Ative o Aplicativo: No topo da página, mude o status do aplicativo de \"Em desenvolvimento\" para \"Ao vivo\".\\n\\n\\n\\n*\\n\\n## Etapa 3: Cadastrando e Verificando seu Número de Telefone\\n\\nAgora, vamos adicionar e verificar o número de telefone que será usado pela API.\\n\\n1. No menu do seu aplicativo, vá para \"WhatsApp\" > \"Configuração da API\".\\n\\n\\n\\n2. Adicione um Número de Telefone: Clique no botão para adicionar um novo número.\\n\\n\\n\\n3. Preencha os Dados: Insira as informações da sua empresa e o número de telefone que você preparou na Etapa 1.\\n4. Verifique o Número: Escolha receber o código de verificação por SMS ou ligação telefônica e insira o código recebido.\\n5. Adicione a forma de pagamento\\n\\n\\n\\n6. Registre o Número com PIN (Passo Obrigatório):\\n\\n Após a verificação, a Meta exige um registro de segurança com um PIN de 6 dígitos. Este passo é realizado via API. (token provisório)\\n\\n\\n\\n Utilize uma ferramenta como o Postman e o endpoint \"Registrar Fone\" (disponível em nossa coleção) para enviar o PIN de 6 dígitos ao seu número. https://www.postman.com/meta/whatsapp-business-platform/request/kkn2spv/register-phone\\n Este passo é crucial para que o número seja ativado com sucesso.\\n\\n{% hint style=\"info\" %}\\nA explicação detalhada da etapa do postman está no vídeo https://www.youtube.com/watch?v=sLp5P9Qb50w\\n{% endhint %}\\n\\n\\n\\n## Etapa 4: Gerando um Token de Acesso Permanente\\n\\nO token gerado pelo painel do desenvolvedor é temporário e expira em 24 horas. Para uma conexão estável com o Z-PRO, você precisa de um token permanente.\\n\\n1. Acesse as Configurações do Negócio: Navegue até seu Gerenciador de Negócios (BM).\\n2. Vá para \"Usuários\" > \"Usuários do sistema\".\\n\\n\\n\\n3. Crie um Usuário do Sistema: Adicione um novo usuário do sistema com a função de \"Admin\".\\n4. Atribua Ativos: Com o novo usuário selecionado, clique em \"Atribuir Ativos\".\\n5. Selecione \"Aplicativos\", escolha o aplicativo que você criou na Etapa 2 e conceda a permissão de \"Gerenciar App\".\\n6. Gere o Token: Ainda com o usuário selecionado, clique em \"Gerar novo token\".\\n Selecione o seu aplicativo.\\n Defina a expiração como \"Nunca\".\\n Marque as permissões necessárias (pelo menos whatsapp_business_management e whatsapp_business_messaging).\\n Clique em \"Gerar Token\", copie o código e guarde-o em um local seguro, pois ele não será exibido novamente.\\n\\n*\\n\\n## Etapa 5: Conectando a API no Z-PRO e Ativando Webhooks\\n\\nCom tudo pronto no ambiente da Meta, o passo final é configurar a conexão dentro do Z-PRO.\\n\\nVídeo detalhado na nossa área de membros: https://portal.zdg.com.br/270021-sistema-zpro/5179477-conectar-api-oficial\\n\\n1. Conecte o Canal no Z-PRO (Para Enviar Mensagens):\\n\\n * No painel Admin do Z-PRO, acesse \"Canais\" e adicione um novo canal do tipo \"WABA\".\\n\\n \\n\\n Preencha os campos com as informações obtidas no painel da Meta: Whatsapp - Configuração da API\\n ID do número de telefone\\n * ID da conta do WhatsApp Business\\n * O Token Permanente que você gerou na Etapa 4.\\n * Clique em Salvar. Neste momento, você já estará apto a enviar mensagens.\\n2. Ative os Webhooks no Z-PRO (Para Receber Mensagens):\\n\\n * No painel Admin do Z-PRO, vá para \"Configurações\" > \"Integração Meta\".\\n * Copie a URL do Webhook e o Token de Verificação.\\n * Volte ao painel do seu aplicativo na Meta, em \"WhatsApp\" > \"Configuração da API\".\\n\\n \\n\\n Clique em \"Editar\" na seção de Webhooks.\\n Cole a URL e o Token copiados do Z-PRO e clique em \"Verificar e Salvar\".\\n * Após verificar, clique em \"Gerenciar\" e assine (subscribe) todos os eventos de webhook disponíveis (especialmente messages).\\n\\n \\n\\n### Encerramento\\n\\nCom os webhooks ativos, sua plataforma está pronta para enviar e receber mensagens através da API Oficial do WhatsApp. Esta é a conexão mais estável e segura, recomendada para todas as operações.\\n\\n### Possíveis erros\\n\\nSolução de Problemas: Evite falhas de comunicação com o Webhook da Meta (Erro ETIMEDOUT)\\n\\nOs erros AxiosError do tipo \"ETIMEDOUT\" registrados no log indicam que a comunicação com o servidor da Meta (Webhook) está sofrendo atraso de resposta — geralmente causado por alta latência de rede.\\n\\nIsso ocorre quando o ping entre sua VPS e o domínio graph.facebook.com ultrapassa 40 ms, resultando em falhas do tipo TIMEDOUT nas requisições.\\n\\nPara prevenir esse problema, é importante definir uma rota pública estável em sua VPS. Se você utiliza a Hostinger, por exemplo, o caminho é:\\n\\n1. Acesse o painel da Hostinger.\\n2. Vá até Configurações → Rede → DNS.\\n3. Defina um DNS fixo recomendado, como:\\n 1.1.1.1 (Cloudflare)\\n 8.8.8.8 (Google)\\n\\nEssas configurações ajudam a garantir uma rota mais direta e estável entre a VPS e a infraestrutura da Meta, reduzindo atrasos e eliminando o erro de timeout nos logs.\\n\\n\\n\\n## Links de apoio - Meta API\\n\\nComo configurar a API Oficial do WhatsApp (WABA)\\n\\n{% embed url=\"https://ajuda.zdg.com.br/api-oficial-waba/como-configurar-a-api-oficial-do-whatsapp-waba\" %}\\n\\nGuia Verificação do app (tech provider)\\n\\nhttps://comunidade.zdg.com.br/geral/coexistence-whatsapp/\\n\\nGuia Configuração coexistência:\\n\\n{% embed url=\"https://ajuda.zdg.com.br/api-oficial-waba/api-oficial-cadastro-incorporado-e-coexistencia-waba-beta\" %}\\n\\nConfiguração login incorporado:\\n\\n{% embed url=\"https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/facebook-login-incorporado-waba-insta-messenger\" %}\\n\\nConfiguração instagram nativo:\\n\\n{% embed url=\"https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/facebook-e-instagram-nativo/canal-instagram-nativo-beta\" %}\\n\\nConfiguração facebook messenger nativo:\\n\\n{% embed url=\"https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/facebook-e-instagram-nativo/canal-facebook-messenger-nativo-beta\" %}\\n\\nGuia da Meta para configuração do login incorporado:\\\\nhttps://developers.facebook.com/docs/facebook-login/facebook-login-for-business/\\ Guia da Meta para configuração da coexistência:\\\\nhttps://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users\\n\\nCentral de ajuda e suporte técnico meta:**\\n\\nhttps://developers.facebook.com/support/\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.2","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-configurar-a-api-oficial-do-whatsapp-waba.md","articles":[]},{"title":"E-mail (IMAP/SMTP)\\n\\nA conexão via IMAP/SMTP permite integrar qualquer provedor de e-mail externo (Outlook, Yahoo, Hostgator, Locaweb, servidores próprios, etc.) ao painel de atendimento do Z-PRO. Através desta configuração, o sistema será capaz de receber e-mails como tickets de atendimento e responder aos clientes diretamente pela interface de chat.\\n\\n#### Passo 1: Informações Iniciais\\n\\nAo adicionar um novo canal, selecione o tipo Email (IMAP/SMTP).\\n\\n Nome do Canal: Insira um nome para identificar esta conta (ex: E-mail Comercial).\\n Canal Padrão: Defina se esta será a conta principal de envio de e-mails do sistema.\\n\\n\\n\\n#### Passo 2: Configuração SMTP (Envio)\\n\\nEsta seção configura a saída das mensagens. Os dados variam conforme o seu provedor.\\n\\n Servidor SMTP: O endereço do servidor de saída.\\n Exemplos comuns: smtp.seudominio.com.br ou mail.seudominio.com.br.\\n Porta SMTP: Geralmente utiliza-se 587 (para conexão TLS) ou 465 (para conexão SSL).\\n Conexão Segura (SSL/TLS): Ative este campo caso seu provedor exija uma conexão criptografada.\\n Usuário: O endereço de e-mail completo de autenticação (ex: [email protected]).\\n Senha / App Password: A senha da conta de e-mail ou uma \"senha de aplicativo\" gerada no painel do provedor.\\n E-mail remetente (from): O endereço que aparecerá para o cliente ao receber sua mensagem.\\n E-mail de resposta (replyTo): O endereço que receberá as respostas caso o cliente responda ao e-mail manualmente.\\n\\n\\n\\n#### Passo 3: Configuração IMAP (Recebimento)\\n\\nEsta seção configura a entrada das mensagens no sistema.\\n\\n Detecção Automática: Insira seu e-mail e clique em Detectar. O sistema tentará encontrar as configurações de host e porta automaticamente.\\n Host IMAP: O endereço do servidor de entrada.\\n Exemplos comuns: imap.seudominio.com.br ou mail.seudominio.com.br.\\n Porta IMAP: Geralmente utiliza-se 993 (com TLS/SSL ativo) ou 143 (sem segurança).\\n TLS/SSL: Ative para garantir a segurança no recebimento.\\n Usuário IMAP: Geralmente o mesmo e-mail do SMTP. Você pode clicar no botão Igual ao SMTP para preenchimento rápido.\\n Caixa (mailbox): A pasta que o sistema deve monitorar. O padrão é INBOX.\\n Intervalo (segundos): Tempo de espera entre cada verificação de novos e-mails. O recomendado é 30 segundos.\\n\\n\\n\\n#### Passo 4: Configurações Avançadas\\n\\n Validar certificado TLS: Mantenha ativo para garantir que o sistema verifique a autenticidade do servidor de e-mail.\\n Keepalive / IDLE: Mantém a conexão com o servidor de e-mail sempre \"viva\", permitindo o recebimento de mensagens quase instantaneamente.\\n Assinatura (HTML): Insira aqui o texto de assinatura que será anexado ao final de todos os e-mails enviados. Aceita formatação HTML.\\n Exemplo:
Atenciosamente, Equipe de Suporte
\\n\\n\\n\\n#### Passo 5: Webhook do Canal\\n\\n Habilitar Webhook do Canal: Se ativado, o sistema disparará notificações para uma URL específica sempre que um novo e-mail for processado por esta conta.\\n\\n\\n\\n**\\n\\n#### Avisos e Observações\\n\\n1. Firewall: Certifique-se de que o seu servidor de e-mail permite conexões externas para as portas configuradas (587, 465, 993).\\n2. Senhas de Aplicativo: Alguns provedores (como Outlook/Office 365) exigem a criação de uma \"Senha de Aplicativo\" caso a Autenticação de Dois Fatores (2FA) esteja ativa na conta.\\n3. Limite de Anexos: O tamanho dos arquivos enviados e recebidos via e-mail respeitará o limite imposto pelo seu provedor de e-mail (geralmente entre 10MB e 25MB).\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/e-mail-imap-smtp.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.3","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/e-mail-imap-smtp.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/e-mail-imap-smtp.md","articles":[]},{"title":"Hub NotificaMe (Face, Insta, WebChat e Email)\\n\\nTemos a possibilidade de utilizar a API da plataforma externa Hub NotificaMe A. Para utilizar estes canais, é necessário primeiro criar uma conta e contratar um plano diretamente no site deles, pois o pagamento é feito ao fornecedor do serviço.\\n\\nAtravés desta integração, você pode conectar e gerenciar os seguintes tipos de canais na sua caixa de entrada do Z-PRO:\\n\\n Facebook Messenger\\n Instagram Direct\\n Webchat (oferecido pela Hub NotificaMe)\\n E-mail\\n\\nImportante: Embora a plataforma Hub NotificaMe ofereça outros tipos de canais, apenas os listados acima foram implementados e são suportados oficialmente dentro do Z-PRO.\\n\\n*\\n\\n#### Como Configurar a Integração\\n\\nVídeo de como acessar o hub notificame: https://youtu.be/JfYQaCqcuXE\\n\\n{% hint style=\"info\" %}\\n Como Usar o Cupom de Desconto na Hub NotificaMe\\n\\nO processo para aplicar nosso cupom de desconto no site da Hub NotificaMe foi atualizado.\\n\\nAgora, o campo para inserir o cupom aparecerá na tela de checkout, após você selecionar o plano e prosseguir para a página de pagamento.\\n\\nLembramos que nosso cupom ZDG40 oferece um desconto especial, reduzindo o valor de R$ 120 para R$ 50*.\\n{% endhint %}\\n\\n\\n\\nApós criar sua conta na Hub NotificaMe, é possível conectar os canais no Z-PRO seguindo estes passos:\\n\\n### Como conectar no Z-PRO: \\n\\n Antes de conectar ao hub, você deve contratar o seu plano no Hub Notificame e informar nas configurações\\n\\n\\n\\n\\n\\n\\n\\nA conexão do Notificame trabalha com a integração com ChatGPT\\n\\n\\n\\nA conexão do Notificame trabalha com a integração com TypeBot\\n\\n\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Dify.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com N8N. \\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Ollama.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com LM Studio.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Grok.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Gemini.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Deepseek.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Qwen.\\n\\n\\n\\nA conexão com Notificame trabalha com a integração com Claude.\\n\\n\\n\\nA conexão de Notificame trabalha com a integração com Mensagem de Despedida e Variáveis (X)\\n\\n\\n\\n\\n\\nVocê pode habilitar uma palavra chave para fechamento automático do atendimento. Essa é uma palavra chave que ao ser recebida irá encerrar o ticket automaticamente.\\n\\n\\n\\nA conexão com Notificame tabalha com integração com a Google-Speech-To-Text para transcrever áudios.\\n\\n\\n\\nA conexão de WhatsApp trabalha com a envio de avaliações automáticas\\n\\n\\n\\nA conexão de WhatsApp trabalha com auto distribuição de atendimentos (sobrescreve opções de fila)\\n\\n\\n\\nVocê pode habilitar desligamento automático das integrações externas ao abrir um ticket no atendimento: habilitando esta opção, ao abrir um atendimento as interações do ChatGPT, Typebot, Dify, N8N e DialogFlow serão desligadas.\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/hub-notificame-face-insta-webchat-e-email.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.4","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/hub-notificame-face-insta-webchat-e-email.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/hub-notificame-face-insta-webchat-e-email.md","articles":[]},{"title":"Instagram e Facebook Messenger via OAuth (login)\\n\\nEssa é a forma mais rápida e recomendada de realizar a integração com Instagram e Facebook Messenger, pois dispensa a necessidade de criar e aprovar um aplicativo próprio no painel de desenvolvedores da Meta.\\n\\n{% embed url=\"https://youtu.be/_6SmcZ96_cM\" %}\\n\\n*\\n\\n### Etapa 0: Liberação no Painel Super Admin (Para ambos os canais)\\n\\nA liberação da integração via aplicativo nativo precisa ser feita individualmente para cada empresa (Tenant) dentro do painel global. Esta etapa serve tanto para o Messenger quanto para o Instagram.\\n\\n1. Faça o login no Z-PRO com o seu usuário Super Admin.\\n2. Acesse o menu Tenants e clique em Editar na empresa onde deseja ativar os canais.\\n\\n\\n\\nRole a página até encontrar a seção de Autenticação (OAuth).\\n\\n1. Habilite a chave de ativação do OAuth.\\n2. Preencha os campos com as informações do aplicativo nativo:\\n\\n * URL / Domínio: \\n\\n https://oauth.techprovider.com.br\\n\\n * Webhook do Messenger:\\n\\n https://oauth.techprovider.com.br/messenger-webhook/\\n\\n * Webhook do Instagram: \\n\\n https://oauth.techprovider.com.br/instagram-wehbhook/\\n\\n * Chave Secreta (é a mesma tanto para instagram quanto para messenger):\\n\\n 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\\n3. Clique em Salvar.\\n\\n\\n\\nObs: Volte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.\\n\\n\\n\\nClique em Salvar.\\n\\n*\\n\\n### Etapa 1: Permissões de ADM da Página do Facebook (Especificamente para o canal Facebook Messenger)\\n\\nAntes de ir para a tela de canais fazer a conexão, existe uma regra obrigatória apenas para o Facebook Messenger.\\n\\n(Se você vai conectar apenas o Instagram, pule para a Etapa 2).\\n\\n{% hint style=\"danger\" %}\\nATENÇÃO: O ACESSO DE ADM VIA GERENCIADOR DE NEGÓCIOS NÃO É SUFICIENTE PARA O MESSENGER\\n{% endhint %}\\n\\nPara conectar o Messenger ao Z-PRO, o seu perfil pessoal do Facebook precisa estar adicionado como Administrador Direto da Página (Com perfil pessoal do facebook).\\n\\nTer \"Acesso Total\" através do Portfólio Empresarial (Gerenciador de Negócios / Meta Business Suite) não é suficiente para liberar a conexão. Se houver apenas esse acesso via portfólio / gerenciador, o sistema retornará um erro na hora de conectar.\\n\\n#### Como corrigir e se adicionar como Administrador da Página do Facebook:\\n\\nSe você já tem o acesso gerencial da página, siga estes passos no Facebook para se dar a permissão correta:\\n\\n1. Abra o Facebook e mude para o perfil da Página (Logar como a página).\\n2. Acesse as Configurações da página.\\n3. No menu lateral, clique em Acesso à Página (ou Configuração da Página > Acesso à Página).\\n4. Na primeira seção, chamada \"Pessoas com acesso do Facebook\", clique em Adicionar novo.\\n5. Pesquise pelo seu perfil pessoal (o perfil que você usa para logar no Facebook) e conceda Controle Total.\\n6. Volte para o seu perfil pessoal do Facebook, abra suas notificações e Aceite o convite.\\n\\n\\n\\n### Etapa 2: Criando as Conexões no Painel Admin\\n\\nCom o OAuth liberado no Tenant (e as permissões do Facebook ajustadas, caso vá usar o Messenger), vamos realizar a conexão final no painel de atendimento.\\n\\nAcesse o Z-PRO com o seu usuário Administrador da conta (Tenant) e vá em Administração > Canais > Adicionar Canal.\\n\\n#### Conectando o Instagram\\n\\n\\n\\nO processo do Instagram é extremamente simples e não exige configurações avançadas de página.\\n\\n1. No tipo de canal, selecione Instagram.\\n2. No campo \"Aplicativo Meta\", clique no menu suspenso e selecione a integração OAuth que liberamos no Super Admin (meta.zdg.com.br).\\n3. Clique no botão azul Conectar via Instagram OAuth.\\n4. No Pop-up da Meta: Uma janela do Facebook será aberta. Siga as etapas na tela para vincular a conta do Instagram Business.\\n Dica: Certifique-se de estar logado na sua conta do Instagram Business em outra aba do mesmo navegador para que o pop-up a reconheça e faça a vinculação automaticamente.\\n\\n#### Opção B: Conectando o Facebook Messenger\\n\\n\\n\\n1. No tipo de canal, selecione Facebook.\\n2. No campo \"Aplicativo Meta\", clique no menu suspenso e selecione a integração Oauth que liberamos no super-admin (meta.zdg.com.br).\\n3. Clique no botão azul Conectar via Facebook OAuth.\\n4. No Pop-up da Meta: Uma janela do Facebook será aberta.\\n Faça o login com o seu perfil pessoal (aquele que colocamos como administrador da página na Etapa 2).\\n Clique em Continuar como \\[Seu Nome].\\n Selecione a Página que você deseja conectar ao ZPRO e conceda as permissões solicitadas.\\n\\n#### Pronto!\\n\\nSe tudo estiver correto, a janela pop-up se fechará e o seu canal (Instagram ou Messenger) aparecerá como Conectado na sua lista de canais.\\n\\nA partir de agora, todas as mensagens e directs dos canais instagram / facebook messenger chegarão diretamente na sua tela de atendimento do ZPRO!\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.5","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/instagram-e-facebook-messenger-via-oauth-login.md","articles":[]},{"title":"Telegram\\n\\n### Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### Especificação Telegram:\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/telegram.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.6","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/telegram.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/telegram.md","articles":[]},{"title":"Wavoip - Ligações pelo WhatsApp\\n\\n#### Pré-requisitos\\n\\n Uma conta ativa no Z-PRO.\\n Uma conta ativa no Wavoip.\\n O celular com o WhatsApp que será conectado em mãos.\\n\\n#### Passo 1: Criar Dispositivo no Wavoip\\n\\n1. Acesse o site wavoip.com e faça login (ou crie sua conta).\\n2. No painel principal, clique em Adicionar dispositivos.\\n3. Escolha o plano desejado (Ex: Whatsapp Desktop Gratuito ou Enterprise) e clique em Criar dispositivo.\\n\\n\\n\\n#### Passo 2: Obter o Token de Acesso\\n\\n1. Após criar o dispositivo, você será direcionado para a Dashboard do dispositivo.\\n2. Localize o campo Token no topo da tela.\\n3. Clique no ícone de copiar (ou selecione e copie o código manualmente).\\n\\n\\n\\n#### Passo 3: Configurar o Canal no Z-PRO\\n\\n1. Acesse o seu painel do Z-PRO.\\n2. Vá até o menu de Canais (ou Conexões).\\n3. Localize a conexão de WhatsApp que você deseja habilitar para ligações.\\n4. Abra as configurações de edição desta conexão (ícone de engrenagem ou editar).\\n5. Role a janela de configurações até encontrar o campo dedicado ao Wavoip.\\n6. Cole o Token que você copiou no passo anterior dentro deste campo.\\n7. Clique em Salvar.\\n\\n\\n\\n#### Passo 4: Conectar o Dispositivo (QR Code)\\n\\n1. Após salvar, observe que um ícone de telefone (telefone azul) aparecerá no card da sua conexão (geralmente ao lado das opções de configurações).\\n2. Clique neste ícone de telefone.\\n\\n\\n\\n1. Uma janela se abrirá com um botão para gerar o QR Code ou já exibindo o código diretamente.\\n2. Pegue o seu celular, abra o WhatsApp, vá em *Aparelhos Conectados > Conectar um aparelho.\\n3. Escaneie o QR Code exibido na tela do Wavoip/Z-PRO.\\n\\n\\n\\nApós realizar a leitura o seu Z-PRO está integrado ao Wavoip. Você poderá realizar e receber chamadas de voz utilizando o número de WhatsApp conectado diretamente pela interface do sistema.\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/wavoip-ligacoes-pelo-whatsapp.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.7","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/wavoip-ligacoes-pelo-whatsapp.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/wavoip-ligacoes-pelo-whatsapp.md","articles":[]},{"title":"Webchat\\n\\nA partir da versão 3.1.10, o Z-PRO oferece uma funcionalidade de Webchat nativo, permitindo que você incorpore uma janela de chat diretamente no seu site ou no site dos seus clientes, com as mensagens chegando diretamente na plataforma.\\n\\n\\n\\nPara funcionar, ele requer a instalação de um novo serviço no seu servidor (via autoinstalador) e a configuração de um subdomínio.\\n\\nDownload example.html para embedar o widget gerado: \\n\\n{% file src=\"/files/Z4IQM1DOefM5aazKRQK3\" %}\\n\\n{% hint style=\"info\" %}\\nAntes de Começar: Crie um Subdomínio\\n\\nAntes de rodar o instalador, você DEVE criar um novo subdomínio (ex: chat.meusite.com.br) e apontá-lo (com um registro \\'A\\') para o IP da sua VPS onde o Z-PRO está instalado.\\n{% endhint %}\\n\\n*\\n\\n{% embed url=\"https://www.youtube.com/watch?v=R46iwR5CLvU\" %}\\n\\n### Passo a Passo: Instalação e Configuração\\n\\nO processo é dividido em duas etapas: criar o canal no Z-PRO e rodar o autoinstalador no servidor.\\n\\n#### Passo 1: Criar o Canal no Z-PRO\\n\\nPrimeiro, crie o canal que receberá as mensagens do webchat.\\n\\n1. Acesse o painel Admin > Canais.\\n2. Clique em \"Adicionar\" e selecione a opção \\'Webchat\\'.\\n3. Dê um nome (ex: \"Chat do Site\") e salve.\\n4. Após salvar, clique no botão \"Conectar\" para ativá-lo.\\n\\n#### Passo 2: Rodar o Autoinstalador no Servidor\\n\\nAgora, vamos instalar o serviço de socket do webchat na sua VPS.\\n\\n1. Certifique-se de que seu autoinstalador está atualizado (substitua a pasta zpro_passaporte_shell pela mais recente no root da sua VPS).\\n2. Acesse o SSH da sua VPS e entre na pasta do autoinstalador.\\n3. Execute o autoinstalador (ex: ./zpro).\\n4. Escolha a Opção 5 - Instalar Webchat.\\n5. O script irá perguntar:\\n * Qual instância: Escolha a instância do Z-PRO que usará o webchat (geralmente a \\'1\\').\\n * Porta: Informe uma porta livre na sua VPS (ex: 5431, 5001). Anote esta porta.\\n * Domínio: Informe o subdomínio que você criou (ex: chat.meusite.com.br).\\n * E-mail: Um e-mail para o certificado SSL (Let\\'s Encrypt).\\n6. Aguarde o processo. O script irá criar um proxy reverso, configurar o SSL e liberar a porta no firewall.\\n\\n#### Passo 3: Gerar o Widget (Código de Incorporação)\\n\\nCom o canal criado e o serviço instalado, volte ao painel Z-PRO para gerar o código do seu chat.\\n\\n1. Acesse Admin > Configurações > Integrações.\\n2. Selecione a aba \\'Webchat\\'.\\n3. O sistema deve exibir a mensagem \"Webchat configurado e pronto para uso\" com um status verde.\\n (Se não aparecer, aguarde alguns instantes e atualize a página. Se persistir, consulte a seção \"Solução de Problemas\" abaixo).*\\n4. Gere um Token de Autenticação: Clique no botão para gerar um token seguro.\\n5. Selecione o Canal: No campo abaixo, escolha o canal \\'Webchat\\' que você criou no Passo 1.\\n6. Clique em \\'Gerar Widget\\'.\\n\\n#### Passo 4: Incorporar o Webchat no seu Site\\n\\n1. O sistema irá gerar um código JavaScript (.\\n3. Ao carregar a página, o ícone do chat aparecerá no canto direito, e você já pode testar o envio de mensagens.\\n\\n*\\n\\n### Solução de Problemas: Chat não conecta ou Status não fica verde\\n\\nSe o status em Integrações > Webchat não ficar verde, ou se as mensagens não chegarem, pode ser um problema de firewall ou de comunicação entre os serviços. Siga os passos abaixo no SSH:\\n\\nExecute no SSH:\\n\\n# 1. Desative o firewall temporariamente para testar\\nsudo ufw disable\\nsudo su deployzdg\\ncd /home/deployzdg/zpro.io/backend\\nnano .env\\n\\n# 2. Adicione a flag abaixo ao documento .env:\\nSECURE_URL=*\\n\\n# 5. Confirme também se está definido corretamente porta e dominio do chat no mesmo arquivo:\\nWSS_URL=[https://webchat.seusiteaqui.com.br](https://webchat.seusiteaqui.com.br)\\nWSS_PORT=NUMERO_DA_PORTA\\n\\n# 6. Salve o documento, feche e reinicie o Z-PRO\\npm2 stop all\\npm2 flush\\npm2 start all\\n\\n\\nApós este processo, faça um novo teste no painel do Z-PRO.\\n\\n{% hint style=\"warning\" %}\\n Lembre-se de reativar seu firewall após o teste.\\n\\nSe o chat funcionar apenas com o firewall desativado, significa que você precisa liberar a porta que escolheu durante a instalação\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.8","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webchat.md","articles":[]},{"title":"Webmail (Gmail)\\n\\nA integração de Webmail com o Gmail permite que você centralize sua comunicação por e-mail diretamente no Z-PRO. Com essa configuração, sua equipe poderá receber as mensagens na caixa de entrada unificada e responder aos e-mails diretamente pelo painel de atendimento.\\n\\nPara que a integração funcione corretamente (tanto para recebimento quanto para envio de respostas), é necessário configurar um aplicativo no Google Cloud Console e gerar uma Senha de App no Gmail. Siga o passo a passo abaixo:\\n\\n#### Passo 1: Criar o Aplicativo no Google Cloud Console\\n\\n1. Acesse o Google Cloud Console e faça login com a conta do Google que deseja vincular.\\n2. Crie um Novo Projeto e dê um nome a ele (ex: \"ZPRO Email\").\\n3. Na barra de pesquisa superior, busque por \"Gmail API\" e clique em Ativar.\\n4. Antes de criar as credenciais, você precisa configurar a tela de permissão. No menu lateral, vá em Tela de consentimento OAuth.\\n5. Selecione a opção \"Externo\" (se aplicável), clique em Criar e preencha os dados obrigatórios, como o nome do app e o e-mail de suporte.\\n6. Após criar a tela de consentimento, é necessário colocar o aplicativo em produção. Clique em Publicar App.\\n\\n#### Passo 2: Gerar as Credenciais OAuth\\n\\n1. No menu do Google Cloud, vá até Credenciais e clique em Criar Credenciais -> ID do cliente OAuth.\\n2. No tipo de aplicativo, escolha Aplicativo da Web e defina um nome.\\n3. Na seção \"URIs de redirecionamento autorizados\", você deve adicionar a URL do seu frontend acompanhada do callback do Gmail.\\n Exemplo: https://app.seudominio.com.br/gmail_callback.html.\\n4. Clique em Criar. O Google irá gerar o seu ID do Cliente e o seu Client Secret. Mantenha essa tela aberta para copiar os dados.\\n\\n#### Passo 3: Configurar o Canal no Z-PRO\\n\\n1. Acesse o painel Admin do Z-PRO, vá no menu Canais e adicione um novo canal do tipo Webmail.\\n2. Dê um nome para o canal (ex: \"Suporte Gmail\").\\n3. Importante: Salve o canal antes de prosseguir para a próxima etapa.\\n4. Após salvar, clique para Editar o canal que você acabou de criar e vá na opção Configurar OAuth.\\n5. Uma tela do Google será aberta. Selecione a conta de e-mail desejada, conceda as permissões necessárias e conclua a autenticação.\\n6. Ao voltar para a edição do canal, o status deverá constar como \"Autenticado\". Clique em Conectar.\\n\\nNeste momento, o Z-PRO já estará apto a receber os e-mails.\\n\\n#### Passo 4: Configurar o SMTP para Envio de Respostas\\n\\nPara que você consiga enviar as respostas pelo painel de atendimento, é obrigatório configurar a saída (SMTP) utilizando uma Senha de App do Google.\\n\\n1. Acesse as configurações da sua Conta do Google (myaccount.google.com).\\n2. Vá na aba Segurança e certifique-se de que a Verificação em duas etapas (2FA) está ativada.\\n3. Na barra de pesquisa das configurações do Google, busque por \"Senhas de app\".\\n4. Crie uma nova senha (dê um nome como \"ZPRO SMTP\") e o Google gerará uma senha de 16 letras.\\n5. Retorne ao Z-PRO, edite o seu canal de Webmail e preencha a configuração de SMTP:\\n Usuário: Seu endereço de e-mail remetente.\\n Senha: Cole a Senha de App de 16 letras gerada no Google (certifique-se de remover os espaços entre as letras).\\n6. Salve as configurações.\\n\\n{% hint style=\"warning\" %}\\nSe o sistema gerar algum erro de autenticação ou falha na hora de enviar a mensagem, exclua a senha anterior no painel do Google e recrie uma nova Senha de App. Depois, basta atualizar a nova senha nas configurações do canal no Z-PRO e salvar novamente.\\n{% endhint %}\\n\\n{% embed url=\"https://www.loom.com/share/29429819aae543faacbfb44c2901c31d\" %}\\n\\n**\\n\\n#### Como Receber e Responder E-mails na Tela de Atendimento\\n\\nCom a integração finalizada, o fluxo de comunicação via e-mail ocorrerá de forma nativa na sua caixa de entrada unificada:\\n\\n Recebendo um e-mail: Toda vez que um cliente enviar uma mensagem para a sua conta do Gmail vinculada, ela chegará automaticamente na tela de Atendimentos do Z-PRO, gerando um novo ticket de conversa.\\n Enviar um e-mail: Para enviar um e-mail, clicar no icone na tela de atendimento e preencha os dados de envio.\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.9","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/webmail-gmail.md","articles":[]},{"title":"Whatsapp Baileys (Não oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA conexão via Baileys é uma solução de integração não oficial baseada em uma biblioteca de código aberto que emula o protocolo do WhatsApp Web. Ao contrário da API Oficial (WABA), a Baileys permite que você conecte um número de telefone comum ao sistema Z-PRO sem a necessidade de aprovação prévia da Meta ou de uma conta empresarial verificada.\\n\\n## Passo a passo para conexão\\n\\n### 1. Adicionar um canal Baileys\\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 2. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal como \"Baileys\", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 3. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 4. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.10","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-baileys-nao-oficial.md","articles":[]},{"title":"WhatsApp Evolution API (Não Oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA Evolution API é uma solução de integração não oficial de alto desempenho, que atua como um gateway entre o WhatsApp e o sistema Z-PRO. Diferente das bibliotecas simples, ela oferece uma camada extra de gerenciamento e robustez para as instâncias de WhatsApp conectadas via QR Code, permitindo uma operação mais estável em cenários de grande volume de mensagens\\n\\nA Evolution API permite que o sistema gerencie as sessões de forma desacoplada. Isso significa que, mesmo que a interface do Z-PRO sofra uma atualização, as instâncias no servidor da API permanecem conectadas, reduzindo a necessidade de novos pareamentos frequentes.\\n\\n## Passo a passo para conexão\\n\\n### 1. Instalar Evoluiton API\\n\\nAntes de qualquer configuração no painel Z-PRO, a Evolution API deve estar devidamente instalada e rodando em seu servidor.\\n\\n Siga as instruções técnicas contidas na página: Instalação: Evolution API\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > Evolution API.\\n\\n\\n\\n2. Insira a URL da API (Ex: https://api.seuservidor.com).\\n3. Cole a sua Global Key.\\n4. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n{% hint style=\"warning\" %}\\nAtenção: Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.\\n{% endhint %}\\n\\nObservações Importantes:\\n\\n Conectando uma Instância Existente: Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o mesmo nome exato da instância. O sistema irá sincronizar e configurar o webhook.\\n Nomenclatura: Não utilize caracteres especiais (como \\_) no nome da instância, pois isso pode causar falhas na sincronização.\\n Nome da Instância: Uma vez criado, o nome da instância não pode ser alterado.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.11","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial.md","articles":[{"title":"Instalação: Evolution API\\n\\n{% hint style=\"warning\" %}\\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\\n\\nA Evoluiton API é uma solução de software de código aberto.\\n\\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\\n\\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\\n{% endhint %}\\n\\n#### 1. Prepare o Ambiente\\n\\nAntes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:\\n\\n Git: Essencial para executar nosso script. Faça o download aqui.\\n Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.\\n\\nApós instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.\\n\\n#### 2. Baixe o Script de Instalação\\n\\nPara facilitar sua vida, preparamos um pacote com tudo que você precisa.\\n\\n Baixe aqui o arquivo evolution.rar.\\n Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo: C:\\\\Evolution).\\n\\n#### 3. Execute os Comandos no Terminal\\n\\nAgora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.\\n\\n1. Navegue até a pasta onde você descompactou os arquivos.\\n2. Clique com o botão direito do mouse dentro da pasta e selecione a opção \"Abrir no Terminal\" ou \"Open in Terminal\".\\n3. O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:\\n\\n \\n & \"C:\\\\Program Files\\\\Git\\\\bin\\\\bash.exe\"\\n\\n4. Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:\\n\\n \\n ./evolution.sh\\n\\n\\nPronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.\\n\\n#### 4. Acessando e Conectando sua API\\n\\nCom tudo instalado, é hora de acessar o painel de controle.\\n\\n1. Abra seu navegador e acesse: http://localhost:8081\\n2. Clique em \"Manager\". O sistema pedirá uma Chave Global (Global API Key).\\n3. Para encontrá-la, abra o arquivo evolution.sh com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.\\n4. Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.\\n5. Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.\\n\\n#### 5. Integração com Z-PRO\\n\\nO último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.\\n\\n1. No painel Admin, navegue até Configurações > Integrações > Evolution.\\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555).\\n3. Preencha a Chave Global com o APP\\_ADMIN\\_TOKEN definido no seu arquivo .env.\\n4. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção \"Evoluiton\".\\n5. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\\n\\n### Tutorial:\\n\\n{% embed url=\"https://www.youtube.com/watch?v=cQewqCSez5I\" %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.11.1","depth":5,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md","articles":[]}]},{"title":"WhatsApp Oficial OAuth (login)\\n\\n#### O que é o Modo de Coexistência?\\n\\nAo utilizar este método, você conecta o seu número à API Oficial da Meta sem precisar desconectá-lo do seu aparelho celular. O WhatsApp passará a funcionar simultaneamente no aplicativo WhatsApp Business do seu smartphone e no painel do Z-PRO. É a união da estabilidade da API Oficial com a praticidade de manter o celular ativo.\\n\\n{% embed url=\"https://youtu.be/v-eVzsAwJXQ\" %}\\n\\n{% hint style=\"danger\" %}\\nNOVA URL OAUTH: https://oauth.techprovider.com.br\\n{% endhint %}\\n\\n*\\n\\n### Etapa 0: Ativação do Canal no Painel Super Admin\\n\\nA liberação do recurso OAuth é feita por empresa (Tenant). Se você é o assinante do ZPRO, siga estes passos. Se você é um cliente ou está usando apenas o acesso demo do sistema, solicite essa liberação ao suporte e pule para a etapa 1.\\n\\nFaça login no sistema com seu usuário Super Admin.\\n\\nNo menu lateral, acesse Tenants (Empresas) e clique em Editar na empresa desejada.\\n\\n\\n\\nRole a página até encontrar a opção OAuth (Login Incorporado) e ative a chave.\\n\\n\\n\\n{% hint style=\"danger\" %}\\nNOVA URL OAUTH: [https://oauth.techprovider.com.br**](https://oauth.techprovider.com.br)\\n{% endhint %}\\n\\nVolte mais acima, na seção de liberação de canais, certifique-se de que o WhatsApp, Facebook e Instagram estão habilitados para este tenant.\\n\\n\\n\\n{% hint style=\"warning\" %}\\nMetal URL: https://oauth.techprovider.com.br\\n\\nInstagram Webhook \\n\\n• URL: https://oauth.techprovider.com.br/instagram-webhook \\n\\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\\n\\nMessenger Webhook \\n\\n• URL: https://oauth.techprovider.com.br/messenger-webhook \\n\\n• Segredo: 2f5b5b457e2febbc3c2333e2ebc84df926a45c36f76f3bedc0d1994f749413f1\\n{% endhint %}\\n\\nClique em Salvar.\\n\\n### Etapa 1: Criando a Conexão no Painel Admin\\n\\nCom o recurso liberado, acesse a conta da empresa (Admin normal) para realizar a conexão.\\n\\n\\n\\n1. No menu lateral, acesse Administração > Canais.\\n2. Clique no botão Adicionar Canal.\\n3. No campo \"Tipo de Canal\", selecione a opção WhatsApp OAuth.\\n4. Selecione o Aplicativo Meta: Você verá um menu suspenso para escolher o aplicativo.\\n Selecione o aplicativo nativo fornecido pela plataforma (ex: teste login incorporado tech provider zdg ou ZDG App).\\n (Nota: Caso sua empresa seja um Tech Provider aprovado pela Meta, você poderá selecionar seu próprio App configurado previamente).\\n5. Clique no botão azul Conectar via WhatsApp OAuth.\\n\\n### Etapa 2: Autenticação com a Meta e Leitura do QR Code\\n\\nAo clicar em conectar, uma janela pop-up oficial do Facebook/Meta será aberta. Atenção: Tenha o seu celular com o WhatsApp Business em mãos.\\n\\n\\n\\n1. Na janela da Meta, clique em Continuar e faça o login com seu Facebook.\\n2. Siga as instruções da tela para selecionar ou criar a sua conta do WhatsApp Business e seu Gerenciador de Negócios.\\n3. Insira o Número: Digite o número de telefone exato que está no seu WhatsApp Business.\\n4. Aprovação no Celular:\\n Abra o aplicativo WhatsApp Business no seu celular.\\n Você receberá uma notificação da Meta solicitando a conexão.\\n Aceite a notificação. O aplicativo solicitará que você faça a leitura de um QR Code (ou aprove o compartilhamento de conversas) diretamente na tela do computador.\\n5. Após confirmar no celular, a janela da Meta será finalizada e o canal aparecerá como Conectado no ZPRO.\\n\\nPronto! Seu número já está operando em Modo de Coexistência. As mensagens chegarão tanto no seu celular quanto na tela de atendimento do Z-PRO. Como esta é uma conexão via API Oficial, você não sofrerá com bloqueios relacionados ao uso de sistemas de terceiros.\\n\\n### Etapa 4: Configuração de Pagamento na Meta\\n\\nEmbora a conexão já esteja funcionando para receber e responder mensagens dentro da janela de 24 horas, há um passo final recomendado pela Meta.\\n\\nAo conectar seu WhatsApp Business, a Meta realizará uma análise final da sua empresa. Após isso, para que você possa enviar mensagens ativas (templates/campanhas de massa) fora da janela de 24 horas, é obrigatório cadastrar uma forma de pagamento na Meta.\\n\\n1. Acesse o seu painel do Gerenciador de Negócios da Meta.\\n 1. https://business.facebook.com/billing_hub/accounts\\n2. Vá nas configurações de conta do WhatsApp Business.\\n3. Encontre a conta de WhatsApp que foi conectada e adicione um *Cartão de Crédito.\\n4. A partir desse momento, sua conta estará 100% apta para receber, responder e iniciar novas conversas (disparos) através do ZPRO.\\n\\nPara testar, envie uma mensagem de outro número para o seu WhatsApp Business. Você verá a mensagem chegando instantaneamente no seu celular e na aba \"Pendentes\" na tela de atendimento do seu ZPRO!\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.12","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-oficial-oauth-login.md","articles":[]},{"title":"Whatsapp Uazapi\\n\\nA Uazapi também é uma solução não oficial paga e gerenciada. https://uazapi.dev/\\n\\n## Passo a passo para conexão\\n\\n### 1. Contratar a Uazapi\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://uazapi.dev/\\n\\nPré-requisito na Plataforma Z-API\\n\\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL do servidor da sua conta Uazapi.\\n2. Chave Global: O \"Admin Token\" fornecido no painel da sua conta Uazapi.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\nA integração com a Uazapi oferece duas possibilidades:\\n\\n A) Criar uma Nova Instância:\\n 1. No painel Admin, vá em Canais > Adicionar Canal e selecione \"Uazapi\".\\n 2. Dê um nome para a nova instância (ex: \"Cliente A\").\\n 3. Deixe os campos ID da Instância e Token em branco.\\n 4. Salve. O Z-PRO irá criar a nova instância na sua conta Uazapi e preencherá as credenciais automaticamente.\\n B) Conectar a uma Instância Existente:\\n 1. Siga os mesmos passos acima, mas desta vez preencha os campos ID da Instância e Token com as informações da instância já existente na sua conta Uazapi.\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.13","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-uazapi.md","articles":[]},{"title":"WhatsApp WebJs (Não oficial)\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA conexão via WebJS é uma solução de integração não oficial baseada na biblioteca whatsapp-web.js. Diferente de outras integrações, ela funciona através da automação e simulação de uma instância real do WhatsApp Web em um navegador interno no servidor. Isso permite que o sistema utilize todas as funcionalidades da interface web original sem a necessidade da API Oficial (WABA).\\n\\nA biblioteca WebJS opera simulando a navegação de um usuário real no WhatsApp Web. Por rodar um navegador em segundo plano (headless browser), essa conexão pode exigir um pouco mais de processamento do servidor em comparação à Baileys, mas oferece uma fidelidade maior aos recursos disponíveis na versão oficial para navegador do WhatsApp.\\n\\n## Passo a passo para conexão\\n\\n### 1. Adicionar um canal\\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 2. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal como \"WebJS\", localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 3. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 4. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.14","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-webjs-nao-oficial.md","articles":[]},{"title":"WhatsApp WUZAPI Meow API\\n\\n{% hint style=\"danger\" %}\\nAtenção: Risco de Banimento\\\\nO uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da API Oficial (WABA).\\n{% endhint %}\\n\\nA WUZAPI (Meow API) diferencia-se de outras bibliotecas por ser desenvolvida em Go (Golang), uma linguagem de programação conhecida por sua alta performance e eficiência no gerenciamento de concorrência. Tecnicamente, a solução funciona como um serviço headless (sem interface gráfica), o que reduz drasticamente o consumo de memória RAM e processamento no servidor em comparação com emuladores de navegador.\\n\\n## Passo a passo para conexão\\n\\n### 1. Instalar WUZAPI (Meow API)\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso instalar essa API\\n\\n Siga as instruções técnicas contidas na página: Instalação: Wuzapi (Meow)\\n\\nPré-requisito na Instalação do Wuzapi\\n\\n No arquivo de configuração (.env) da sua instalação do Wuzapi, é obrigatório preencher a variável API\\_URL com a URL pública onde sua instância do Wuzapi está acessível.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL base da sua instalação do Wuzapi.\\n2. Chave Global: O token de administrador definido na variável APP\\_ADMIN\\_TOKEN do arquivo .env do seu Wuzapi.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\nEstabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.15","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api.md","articles":[{"title":"Instalação: Wuzapi (Meow)\\n\\n{% hint style=\"warning\" %}\\nAviso Importante: Responsabilidade sobre a Instalação e Suporte\\n\\nA Wuzapi (Meow) é uma solução de software de código aberto.\\n\\nIsso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.\\n\\nA equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.\\n{% endhint %}\\n\\nEste guia fornece o passo a passo técnico para realizar uma instalação auto-hospedada (self-hosted) da Wuzapi (Meow), uma API de conexão não oficial para WhatsApp.\\n\\nAo final deste processo, você terá uma instância da Wuzapi funcional em seu próprio servidor, pronta para ser integrada à sua plataforma Z-PRO.\\n\\n{% hint style=\"info\" %}\\nVisão Geral do Processo de Instalação:\\n\\n1. Preparação do Ambiente: Atualizar o servidor e instalar as dependências (Git, PM2, Go).\\n2. Instalação do Wuzapi: Clonar o repositório e compilar a aplicação.\\n3. Configuração: Ajustar o arquivo de variáveis de ambiente (.env).\\n4. Execução e Gerenciamento: Iniciar a API e configurá-la como um serviço persistente com PM2.\\n5. Integração com Z-PRO: Conectar a nova instância ao seu painel.\\n {% endhint %}\\n\\n\\\\n1. Preparação do Ambiente do Servidor\\n\\nEstes comandos preparam seu servidor Ubuntu com todas as ferramentas necessárias para a instalação.\\n\\n1. Atualizar o Servidor e Instalar o Git:\\n\\n codeBash\\n\\n \\n sudo apt update && sudo apt upgrade -y && sudo apt install git -y\\n sudo apt install npm\\n\\n2. Instalar o PM2:\\\\n O PM2 é um gerenciador de processos que manterá a API da Wuzapi rodando como um serviço.\\n\\n codeBash\\n\\n \\n npm install -g pm2\\n\\n3. Instalar a Linguagem Go (GoLang):\\\\n A Wuzapi é construída em Go, portanto a linguagem precisa ser instalada no servidor.\\n\\n codeBash\\n\\n \\n # Baixa o pacote de instalação\\n wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz\\n\\n # Remove instalações antigas (se houver)\\n sudo rm -rf /usr/local/go\\n\\n # Extrai os arquivos para o local correto\\n sudo tar -C /usr/local -xzf go1.21.1.linux-amd64.tar.gz\\n\\n # Adiciona o Go ao PATH do sistema\\n echo \\'export PATH=$PATH:/usr/local/go/bin\\' >> ~/.bashrc\\n source ~/.bashrc\\n\\n # Verifica a instalação\\n go version\\n\\n\\n O terminal deve retornar a versão do Go instalada (ex: go version go1.21.1 linux/amd64).\\n\\n*\\n\\n#### 2. Instalação da Aplicação Wuzapi\\n\\nAgora, vamos baixar o código-fonte da Wuzapi e compilá-lo.\\n\\n1. Clonar o Repositório:\\\\n Este comando baixa a versão da Wuzapi compatível com o Z-PRO.\\n\\n codeBash\\n\\n \\n git clone https://github.com/pedroherpeto/wuzapi.git\\n\\n2. Acessar o Diretório:\\n\\n codeBash\\n\\n \\n cd wuzapi\\n\\n3. Baixar Dependências:\\n\\n codeBash\\n\\n \\n go mod tidy\\n\\n4. Compilar a Aplicação:\\\\n Este comando cria o arquivo executável chamado wuzapi.\\n\\n codeBash\\n\\n \\n go build -o wuzapi\\n\\n\\n*\\n\\n#### 3. Configuração do Arquivo .env\\n\\nAntes de iniciar a API, é fundamental configurar as variáveis de ambiente, principalmente as de acesso ao banco de dados.\\n\\n1. Acesse e edite o arquivo .env.example para criar seu arquivo de configuração. É comum renomeá-lo para .env.\\n2. Preencha as variáveis do banco de dados (DB\\_HOST, DB\\_USER, DB\\_PASSWORD, DB\\_NAME, DB\\_PORT).\\n\\n{% hint style=\"success\" %}\\nDica de Configuração: É uma prática comum utilizar as mesmas credenciais do banco de dados da sua instalação Z-PRO. Ao fazer isso, a Wuzapi criará suas próprias tabelas no mesmo banco de dados, simplificando o gerenciamento.\\n{% endhint %}\\n\\n*\\n\\n#### 4. Execução e Gerenciamento com PM2\\n\\nCom a aplicação compilada e configurada, vamos iniciá-la.\\n\\n1. Execução para Teste (Opcional):\\\\n Você pode iniciar a API manualmente para um teste rápido. O comando abaixo a iniciará na porta 5555.\\n\\n codeBash\\n\\n \\n ./wuzapi -port 5555\\n\\n\\n Para confirmar que está funcionando, acesse http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555 no navegador.\\n2. Iniciando como um Serviço com PM2:\\\\n Este comando iniciará a Wuzapi e garantirá que ela reinicie automaticamente em caso de falhas ou após o boot do servidor.\\n\\n codeBash\\n\\n \\n # Inicia o serviço\\n pm2 start ./wuzapi --name \"wuzapi\" -- -port 5555\\n\\n # Salva a lista de processos do PM2\\n pm2 save\\n\\n # Configura o PM2 para iniciar com o sistema\\n pm2 startup\\n\\n3. Verificando os Logs:\\\\n Para acompanhar os logs da aplicação em tempo real, use o comando:\\n\\n codeBash\\n\\n \\n pm2 logs wuzapi\\n\\n\\n*\\n\\n#### 5. Integração com Z-PRO\\n\\nO último passo é conectar sua nova instância da Wuzapi ao painel do Z-PRO.\\n\\n1. No painel Admin, navegue até Configurações > Integrações > Wuzapi.\\n2. Preencha a URL da API com o endereço do seu servidor (ex: http://SEU\\\\\\\\_IP\\\\\\\\_DE\\\\\\\\_SERVIDOR:5555).\\n3. Preencha a Chave Global com o APP\\_ADMIN\\_TOKEN definido no seu arquivo .env.\\n\\n\\n\\n1. Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção \"Wuzapi\".\\n\\n\\n\\n1. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.\\n\\n*\\n\\n#### Tutorial em Vídeo**\\n\\nPara uma demonstração visual detalhada de todos os passos descritos nesta documentação, assista à gravação completa.\\n\\n{% embed url=\"https://www.youtube.com/watch?t=1s&v=s7G1ZuQLw0Y\" %}\\n\\n\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.15.1","depth":5,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-wuzapi-meow-api/instalacao-wuzapi-meow.md","articles":[]}]},{"title":"Whatsapp Z-API\\n\\nA Z-API é uma solução não oficial paga e gerenciada por uma empresa externa. https://www.z-api.io/\\n\\n## Passo a passo para conexão\\n\\n### 1. Contratar a Z-API\\n\\nAntes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: https://www.z-api.io/\\n\\nPré-requisito na Plataforma Z-API\\n\\n Diferente das outras APIs, a instância precisa ser criada primeiro no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.\\n\\n### 2. Configuração no Painel Administrativo\\n\\n1. Acesse o menu Configurações > Integrações > WuzAPI\\n\\n\\n\\n1. URL da API: A URL padrão do serviço (https://api.z-api.io).\\n2. Chave Global: O seu \"Token de Segurança\" gerado nas configurações da sua conta na Z-API.\\n3. Clique no botão Verificar Status da API. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.\\n\\n### 3. Adicionar um canal \\n\\nPasso passo geral aqui: Como conectar um canal (sessão/número)\\\\nConfiguração adicional para a Z-API: \\n\\n ID da Instância\\n Token da Instância\\n\\n\\n\\n### 4. Gerar o QR Code\\n\\nApós salvar as configurações iniciais do canal, localize o card do canal e clique no botão Novo QR Code. Um modal será aberto exibindo o código.\\n\\n\\n\\n\\n\\n### 5. Escanear no Aparelho\\n\\n1. Abra o WhatsApp no seu celular.\\n2. Vá em Configurações (ou Ajustes) > Dispositivos Conectados.\\n3. Clique em Conectar um dispositivo.\\n4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.\\n\\n### 6. Confirmar a Conexão\\n\\nAguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para CONNECTED.\\n\\n\\n\\nO QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em Novo QR Code dentro do modal para gerar uma nova imagem.\\n\\n{% hint style=\"warning\" %}\\n*Estabilidade: Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.1.16","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md","ref":"docs/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-z-api.md","articles":[]}]},{"title":"Equipes\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e supervisor\\n{% endhint %}\\n\\nA página de Equipes é o local central para a organização dos agentes de atendimento. Através dela, o administrador segmenta os colaboradores por especialidade, departamento ou função, permitindo uma distribuição de tickets mais eficiente e organizada.\\n\\n#### Principais funções\\n\\n Segmentação de Atendimento: Criação de departamentos (ex: Comercial, Suporte, Financeiro).\\n Gestão de Membros: Vinculação de usuários específicos a cada equipe.\\n Controle de Visibilidade: Ativação ou desativação de equipes conforme a demanda.\\n Organização Visual: Personalização de cada equipe com fotos identificadoras.\\n\\n#### Caso de uso\\n\\nUma empresa que possui diferentes fluxos de atendimento utiliza a página de Equipes para separar o setor de Suporte Técnico do Setor de Vendas. Assim, ao realizar a transferência de um Ticket, o sistema direciona a demanda apenas para os Usuários vinculados à equipe selecionada, otimizando o tempo de resposta.\\n\\n#### Como acessar a página\\n\\nPara acessar, clique no Menu Administração e selecione a aba Equipes.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\n Campo de Busca: Permite localizar uma equipe específica pelo nome.\\n Botão + Nova Equipe: Abre o formulário para criação de um novo grupo de atendimento.\\n ID: Identificador único da equipe no banco de dados.\\n Nome: Nome atribuído à equipe (ex: Suporte, Vendas).\\n Status: Indica se a equipe está Ativa (apta a receber tickets) ou Inativa.\\n Membros: Exibe a quantidade de usuários vinculados àquela equipe.\\n Ações:\\n Ícone Gerenciar Membros (Usuário com +): Abre a tela para adicionar ou remover atendentes da equipe.\\n Ícone Editar (Lápis): Permite alterar o nome, foto ou status da equipe.\\n Ícone Excluir (Lixeira): Remove a equipe permanentemente do sistema.\\n\\n*\\n\\n#### Passo a passo de uso\\n\\nCriar uma nova equipe\\n\\n1. Acesse o menu Equipes e clique no botão + Nova Equipe.\\n2. Insira o Nome da equipe no campo correspondente.\\n3. Mantenha a chave Ativa habilitada para que a equipe fique disponível para uso imediato.\\n4. Clique em Salvar.\\n\\n\\n\\nGerenciar membros da equipe\\n\\n1. Na listagem de equipes, identifique a equipe desejada e clique no ícone Gerenciar Membros (ícone de usuário com um sinal de \"+\").\\n2. Selecione os Usuários que farão parte deste time.\\n3. Confirme a operação para salvar as alterações.\\n\\n#### Detalhamento\\n\\nAs equipes criadas nesta página serão refletidas diretamente no Chat Privado \\n\\n\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nAtenção: Ao excluir uma equipe, certifique-se de que não existam tickets pendentes vinculados a ela, pois isso pode causar inconsistência na distribuição dos atendimentos em aberto.\\n{% endhint %}\\n\\n{% hint style=\"info\" %}\\nA foto da equipe deve respeitar o limite de 5MB**. Formatos recomendados: PNG ou JPG.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/equipes.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.2","depth":3,"path":"docs/configuracao-administrador/administracao-painel-admin/equipes.md","ref":"docs/configuracao-administrador/administracao-painel-admin/equipes.md","articles":[]},{"title":"Usuários\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador\\n{% endhint %}\\n\\nA página de Usuários é o centro de gestão de acessos do sistema Z-PRO. Nela, o administrador realiza o cadastro de novos colaboradores, define níveis de hierarquia através de perfis, controla permissões de visibilidade de módulos e estabelece jornadas de trabalho por meio da configuração de horários.\\n\\n#### Principais funções\\n\\n Gestão de Identidade: Cadastro e edição de credenciais de acesso (e-mail e senha).\\n Hierarquia de Acesso: Atribuição de perfis (Administrador, Supervisor, Atendente ou Personalizado).\\n Controle de Módulos: Definição manual de quais menus cada usuário pode visualizar.\\n Integração de Telefonia: Configuração de ramais SIP e permissões para chamadas via WaVoIP.\\n Jornada de Trabalho: Estabelecimento de horários de atendimento individuais por usuário.\\n\\n#### Caso de uso\\n\\nUma empresa contrata um novo colaborador para o setor de suporte. O administrador cria o usuário e, em vez de dar acesso total, seleciona o perfil Atendente. Nas Permissões de Menu, ele habilita apenas \"Chat Privado\", \"Tarefas\" e \"Contatos\". Além disso, configura o Horário de Atendimento para que o sistema impeça o recebimento de novos Tickets fora do expediente do colaborador.\\n\\n#### Como acessar a página\\n\\nCaminho clicando no Menu Administração e na aba Usuários.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\nColunas da Tabela:\\n\\n Nome/E-mail: Identificação do colaborador e sua credencial de login.\\n Perfil: Badge que indica o nível de acesso (Admin, Supervisor, Atendente ou Perfis Customizados).\\n Status: Indica se o usuário está Ativo ou Inativo no sistema.\\n Online: Chave seletora que mostra se o usuário está logado no momento.\\n\\nAções (Ícones):\\n\\n Ícone Gerenciar Filas (Vínculo): Permite vincular o usuário às Filas de Atendimento.\\n Ícone Canais (Smartphone): Define quais Canais de Comunicação o usuário pode operar.\\n Ícone Editar (Lápis): Abre o modal completo de edição de dados e permissões.\\n Ícone Equipes (Pessoa com x): Inativa o usuário\\n Ícone Excluir (Lixeira): Remove o usuário permanentemente do sistema.\\n\\n*\\n\\n#### Passo a passo de uso\\n\\n1. Criar um novo usuário\\n\\n1. Clique no botão + Novo Usuário no canto superior direito.\\n2. Preencha os dados básicos: Nome, E-mail, Senha e Telefone.\\n3. Perfil: Escolha entre as opções fixas ou a opção Personalizado (ver detalhamento abaixo).\\n\\n\\n\\nUsuário Restrito: Quando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada. Explicação mais abaixo.\\n\\nPermissões de Menu: Marque os módulos que o colaborador terá acesso (Ex: Envio em Massa, Kanban, Campanhas).\\n\\n\\n\\n2. Configurar Telefonia (Opcional)\\n\\nBloquear WaVoIP:se desejar impedir que o usuário realize chamadas pela plataforma.\\n\\n\\n\\nConfig SIP: habilite a chave se houver integração com telefonia IP.\\n\\n\\n\\nPreencha os dados do servidor, usuário e senha fornecidos pelo seu provedor VoIP.\\n\\n3. Definir Horário de Atendimento\\n\\n1. Expanda a seção Horário de Atendimento.\\n2. Defina para cada dia da semana se o usuário está \"Aberto\" ou \"Fechado\".\\n3. Configure os turnos (1º e 2º período). O usuário só aparecerá como disponível para novos atendimentos dentro destes intervalos.\\n\\n\\n\\n*\\n\\n### Detalhamento\\n\\n#### Perfis de Acesso\\n\\nO Z-PRO permite uma granularidade avançada através dos Perfis de Acesso:\\n\\n Administrador: Possui acesso total e irrestrito a todas as configurações e dados.\\n Supervisor: Nível intermediário, focado em monitoramento e gestão de filas/relatórios.\\n Atendente: Focado na operação direta de chats e contatos.\\n Personalizado: Ao selecionar esta opção, surge o campo Perfil de Acesso, onde você pode escolher um template de permissões pré-criado.\\n\\nGerenciar Perfis\\n\\nAo clicar no botão Gerenciar Perfis no topo da tela, o sistema abre uma área exclusiva para a criação de novos templates de permissões reutilizáveis\\n\\n### Usuário Restrito\\n\\nQuando esta opção está ativa para um usuário, a experiência dele na plataforma será limitada da seguinte forma:\\n\\nMenu de Contatos Oculto: O usuário não terá acesso ao menu \"Contatos\", impedindo a visualização ou exportação da lista completa de contatos.\\n\\n\\n\\nProibido Iniciar Novas Conversas\\n\\n O botão \"Iniciar Conversa Avulsa\" na tela de Atendimentos será ocultado.\\n\\n\\n\\n#### Na Tela de Atendimento (Chat)\\n\\nDentro de um ticket, o usuário restrito sofrerá as seguintes limitações visuais e funcionais:\\n\\n Nome do Contato: Será exibido parcialmente (apenas os 5 primeiros caracteres).\\n Foto do Perfil: Receberá um forte efeito de desfoque (blur).\\n Dados Sensíveis: Todos os campos de detalhes do contato na barra lateral (como Telefone, E-mail, CPF, etc.) serão ocultados.\\n Botão Editar Contato: O ícone de lápis para editar o contato será ocultado.\\n Opções de Telefonia: Os botões de telefonia serão desabilitados.\\n Ações de Mensagem: As opções \"Encaminhar\" e \"Marcar\" serão desabilitadas para impedir o vazamento de dados.\\n\\n{% hint style=\"success\" %}\\nObjetivo da Restrição\\n\\nEsta funcionalidade é desenhada para proteger os dados sensíveis dos seus clientes, limitando o acesso apenas ao necessário para a função do atendente e alinhando sua operação às melhores práticas de segurança e à LGPD.\\n{% endhint %}\\n\\n**\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nAtenção: Ao inativar um usuário, ele perderá o acesso imediato ao painel, porém seus dados e histórico de atendimentos permanecem salvos no banco de dados para auditoria.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.3","depth":3,"path":"docs/configuracao-administrador/administracao-painel-admin/usuarios.md","ref":"docs/configuracao-administrador/administracao-painel-admin/usuarios.md","articles":[{"title":"Perfis de Acesso\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador\\n{% endhint %}\\n\\nA página de Perfis de Acesso permite a criação de templates de permissões reutilizáveis e granulares. Em vez de configurar cada usuário individualmente, o administrador define um perfil padrão (ex: \"Suporte Nível 1\") e o atribui a vários colaboradores.\\n\\n#### Caso de uso\\n\\nUma empresa deseja criar um perfil específico para estagiários que apenas respondem chats, mas não podem excluir contatos ou exportar relatórios. O administrador cria o perfil \"Estagiário\", desmarca as opções de \"Excluir\" e \"Exportar\", e vincula todos os novos estagiários a este template. Se futuramente a empresa decidir que estagiários podem acessar o Kanban, basta editar o perfil uma única vez.\\n\\n#### Como acessar a página\\n\\nCaminho clicando no Menu Administração, aba Usuários e no botão superior direito Gerenciar Perfis.\\n\\n\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\nExplicação dos campos e ícones\\n\\n Botão + Novo Perfil: Abre o formulário para criação de um novo template de acesso.\\n Nome do Perfil: Identificação do template (ex: Atendente Noturno).\\n Contador de Usuários: Exibe quantos colaboradores estão vinculados àquele perfil no momento.\\n Ícone Editar (Lápis): Permite alterar as permissões e o nome do perfil.\\n Ícone Excluir (Lixeira): Remove o perfil do sistema\\n\\n**\\n\\n#### Passo a passo de uso\\n\\n1. Criar um Perfil com IA (Copiloto)\\n\\n1. Clique em + Novo Perfil.\\n2. No campo Sugerir com IA, descreva o que o usuário fará. Exemplo: \"Atendente que responde tickets e vê contatos, mas não pode deletar nada nem exportar\".\\n3. Clique em Sugerir. O Copiloto marcará automaticamente os campos correspondentes.\\n4. Revise as marcações manuais antes de salvar.\\n\\n\\n\\n2. Configuração Manual\\n\\n1. Insira o Nome do perfil e uma Descrição opcional.\\n2. Navegue pelas seções de Módulos Visíveis para definir o que aparecerá no menu lateral do usuário.\\n3. Navegue pela seção Permissões para definir as ações permitidas (ex: resolver ticket, deletar mensagem).\\n4. Clique em Salvar.\\n\\n3. Atribuir o Perfil ao Usuário\\n\\n1. Volte para a página de Usuários.\\n2. Edite o usuário desejado, mude o campo Perfil para Personalizado.\\n3. No novo campo que surgirá (Perfil de acesso), selecione o template criado.\\n\\n*\\n\\n#### Detalhamento das Permissões\\n\\nAbaixo estão os agrupamentos de permissões disponíveis para configuração:\\n\\nMódulos Visíveis (Sidebar)\\n\\n* Principal: Ter acesso aos menus atendimento, chat-privado, contatos, mensagens-rápidas, painel-atendimento, tarefas e wavoip.\\n* Organização: Ter acesso aos menus agenda, campanhas, funil, galeria, grupo e kanban.\\n* Configuração: Ter acesso aos menus agendamentos, aniversários, auto-resposta, avaliações, chat-flow, etiquetas, fechamento, filas, horário-Atendimento, notas e protocolos.\\n* Relatórios: Ter acesso aos menus audit-log, dashboard, log- ligação e relatórios.\\n* Integrações e Canais: Ter acesso aos menus api-service, sessões e woocommerce-produtos.\\n* Redes Sociais: Ter acesso aos menus de gestão de comentários do facebook, instagram, tiktok e youtube, além de menções no instagram.\\n* Administração: Ter acesso aos menus de equipes e usuários.\\n\\n\\n\\n\\n\\nPermissões de Ação\\n\\n* Atendimentos: Permissões para atribuir tickets (assign), usar o copiloto de IA (copilot), criar (create), deletar (delete), reabrir (reopen), resolver (resolve), visualizar todos (view\\_all) e visualizar via chatbot (view\\_chatbot).\\n* Contatos: Permissões para criar (create), deletar (delete), editar (edit), exportar base (export) e visualizar todos os detalhes (view\\_full).\\n* Mensagens: Permissões para deletar mensagens enviadas (delete), encaminhar mensagens (forward) e gerenciar respostas rápidas públicas (quickreplies\\_manage\\_public).\\n* Tarefas: Permissões para criar (create), deletar (delete), editar (edit) e visualizar todas (view\\_all).\\n* Kanban e Funil: Permissões para visualizar o painel de atendimentos geral (attendance\\_panel\\_view\\_all), gerenciar o funil (funnel\\_manage) e gerenciar o kanban (kanban\\_manage).\\n* Relatórios: Permissões para exportar dados (export) e visualizar relatórios (view).\\n* Configurações: Permissão para acessar as configurações gerais do sistema (settings\\_general).\\n* Módulos Diversos: Permissões para gerenciar horários (business\\_hours), campanhas (campaigns), chatflow (chat\\_flow), motivos de fechamento (closure\\_reasons), galeria (gallery), grupos (groups), envios em massa (mass\\_send), notas (notes), notificações (notifications), acesso ao chat privado (private\\_chat), protocolos (protocols), filas (queues), avaliações (ratings), mensagens agendadas (scheduled\\_messages) e etiquetas (tags).\\n* Administração Avançada: Permissões para gerenciar serviços de API (api\\_service\\_access), visualizar logs de auditoria (audit\\_log\\_view), gerenciar sessões/canais (sessions\\_manage) e gerenciar ou visualizar usuários (users\\_manage / users\\_view).\\n* VoIP: Permissões para uso do serviço WaVoIP (voip\\_wavoip) e acesso ao webphone (voip\\_webphone).\\n\\n\\n\\n\\n\\n*\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nRegra de Exclusão: Um perfil que esteja sendo utilizado por pelo menos um usuário ativo não poderá ser excluído. Para deletá-lo, você deve primeiro reatribuir esses usuários a outro perfil.\\n{% endhint %}\\n\\n{% hint style=\"danger\" %}\\nSegurança: Ao usar a sugestão por IA, sempre revise manualmente se as permissões críticas (como tickets_delete ou audit_log_view) foram marcadas corretamente para evitar exposição de dados sensíveis.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.1.3.1","depth":4,"path":"docs/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md","ref":"docs/configuracao-administrador/administracao-painel-admin/usuarios/perfis-de-acesso.md","articles":[]}]}]},{"title":"Automação\\n\\n- Agendamentos: Visualização de Agendamentos\\n- Aniversários: Visualização de Aniversários\\n- Chat Flow\\n- Gerenciando os fluxos: Robô de Atendimento\\n- Etapas para criação do fluxo: Criando os Fluxos\\n- Possíveis erros: Chatbbot nativo\\n- Distribuição sequencial Chatbot\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/automacao.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.2","depth":2,"path":"docs/configuracao-administrador/automacao.md","ref":"docs/configuracao-administrador/automacao.md","articles":[{"title":"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","level":"1.6.2.1","depth":3,"path":"docs/configuracao-administrador/automacao/agendamentos.md","ref":"docs/configuracao-administrador/automacao/agendamentos.md","articles":[]},{"title":"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","level":"1.6.2.2","depth":3,"path":"docs/configuracao-administrador/automacao/aniversarios.md","ref":"docs/configuracao-administrador/automacao/aniversarios.md","articles":[]},{"title":"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","level":"1.6.2.3","depth":3,"path":"docs/configuracao-administrador/automacao/chat-flow.md","ref":"docs/configuracao-administrador/automacao/chat-flow.md","articles":[{"title":"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","level":"1.6.2.3.1","depth":4,"path":"docs/configuracao-administrador/automacao/chat-flow/distribuicao-sequencial-chatbot.md","ref":"docs/configuracao-administrador/automacao/chat-flow/distribuicao-sequencial-chatbot.md","articles":[]},{"title":"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","level":"1.6.2.3.2","depth":4,"path":"docs/configuracao-administrador/automacao/chat-flow/etapas-para-criacao-do-fluxo.md","ref":"docs/configuracao-administrador/automacao/chat-flow/etapas-para-criacao-do-fluxo.md","articles":[]},{"title":"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","level":"1.6.2.3.3","depth":4,"path":"docs/configuracao-administrador/automacao/chat-flow/gerenciando-os-fluxos.md","ref":"docs/configuracao-administrador/automacao/chat-flow/gerenciando-os-fluxos.md","articles":[]},{"title":"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","level":"1.6.2.3.4","depth":4,"path":"docs/configuracao-administrador/automacao/chat-flow/possiveis-erros-chatbbot-nativo.md","ref":"docs/configuracao-administrador/automacao/chat-flow/possiveis-erros-chatbbot-nativo.md","articles":[]}]}]},{"title":"Configuração\\n\\n- API\\n- Configurações Gerais Admin: Configurações\\n- Configurações Gerais: Configs Gerais\\n- Gerais: Config Gerais\\n- Visibilidade de Tickets para usuários (atendentes)\\n- Transbordo de mensagem (processo de seleção)\\n- SMTP: Config SMTP\\n- Bots e IA: Integrações externas\\n- Copiloto de IA\\n- Integrações: Integrações Externas\\n- Habilitar Webhooks: Config Webhooks\\n- Habilitar Meta: Config. Meta\\n- Habilitar Evolution: Config Evolution\\n- Habilitar Wuzapi: Config Wuzapi\\n- Habilitar Hub NotificaMe: Config Hub Notificame\\n- Habilitar SMS: Config SMS\\n- Habilitar GroqCloud: Config GroqCloud\\n- CRM: Configs. CRM\\n- Gerenciar Kanban: Como configurar e gerenciar o Kanban (Clássico)\\n- Demanda: Config Demanda\\n- Variáveis: Config. Variáveis\\n- Sessões: Listar Sessões\\n- Listar Sessões: Config Listar Sessões\\n- Log auditoria (admin)\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.3","depth":2,"path":"docs/configuracao-administrador/configuracao.md","ref":"docs/configuracao-administrador/configuracao.md","articles":[{"title":"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","level":"1.6.3.1","depth":3,"path":"docs/configuracao-administrador/configuracao/api.md","ref":"docs/configuracao-administrador/configuracao/api.md","articles":[]},{"title":"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","level":"1.6.3.2","depth":3,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin.md","articles":[{"title":"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","level":"1.6.3.2.1","depth":4,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia.md","articles":[{"title":"Copiloto de IA\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador\\n{% endhint %}\\n\\nO Copiloto de IA é um assistente inteligente integrado à tela de atendimento do Z-PRO. Ele utiliza modelos de linguagem avançados (como ChatGPT, Gemini ou Claude) para auxiliar o atendente em tempo real, analisando o sentimento das conversas, sugerindo respostas contextuais, reescrevendo textos e resumindo históricos longos.\\n\\n#### Principais funções\\n\\n Sugestão de Resposta: Gera sugestões baseadas no contexto da conversa atual.\\n Análise de Sentimento: Identifica o tom do cliente (neutro, engajado, impaciente).\\n Reescrita de Mensagem: Ajusta o tom da resposta (ex: tornar mais simpático ou formal).\\n Resumo de Conversa: Cria uma síntese de diálogos extensos para facilitar a leitura rápida.\\n\\n#### Caso de Uso\\n\\nUm atendente recebe um ticket com um histórico de 50 mensagens. Para não perder tempo lendo tudo, ele utiliza a função Resumir. Após entender o problema, ele pede uma Sugestão de Resposta ao Copiloto e usa a Reescrita para deixar a mensagem com um tom mais acolhedor antes de enviar ao cliente.\\n\\n{% embed url=\"https://www.loom.com/share/318e4ee827e240019874f51942fbe618\" %}\\n\\n\\n\\n#### Como acessar a página\\n\\n1. No menu lateral, clique em Configurações;\\n\\n\\n\\n2. Selecione a aba Bots IA;\\n3. Clique na sub-aba Copiloto de IA.\\n\\n#### Você verá a seguinte tela:\\n\\n\\n\\n\\n\\n#### Explicação dos campos e ícones\\n\\n Habilitar Copiloto: Chave para ativar ou desativar a função na tela de atendimento.\\n Provedor: Seleção da plataforma de IA (OpenAI, Anthropic, Google Gemini, Groq).\\n API Key: Campo para colar a chave secreta gerada no provedor escolhido.\\n Modelo: Identificação técnica da versão da IA (ex: gpt-4o, gemini-1.5-pro).\\n Prompt de Contexto: Espaço para descrever como a IA deve se comportar e quais informações sobre a empresa ela deve conhecer.\\n\\n**\\n\\n#### Passo a passo de uso\\n\\nPasso 1: Obter a API Key\\n\\nAntes de configurar no Z-PRO, você deve gerar uma chave no site do provedor:\\n\\n OpenAI (ChatGPT): Acesse platform.openai.com, vá em API Keys e crie uma nova.\\n Google (Gemini): Acesse o Google AI Studio, clique em Get API Key.\\n Outros: Acesse os portais de desenvolvedor da Anthropic ou Groq.\\n\\nPasso 2: Configurar o Provedor no Z-PRO\\n\\n1. Cole a API Key no campo correspondente.\\n2. Insira o Modelo exato conforme as diretrizes do provedor.\\n\\n{% hint style=\"info\" %}\\nModelos Recomendados: Para OpenAI use gpt-4o ou gpt-3.5-turbo. Para Gemini, use gemini-1.5-flash ou similar conforme a documentação oficial do provedor.\\n{% endhint %}\\n\\nPasso 3: Contextualizar o Copiloto\\n\\nNo campo Prompt, defina o papel da IA.\\n\\n Exemplo: \"Você é um assistente de suporte da empresa X. Seja direto, educado e use informações do nosso catálogo de produtos para sugerir respostas.\"\\n\\nPasso 4: Utilizar no Atendimento\\n\\nCom tudo salvo, vá até a tela de atendimento:\\n\\n1. Abra um chat e clique no ícone de três pontinhos (Mais Opções).\\n2. Selecione Copiloto.\\n\\n\\n\\n3. Use os botões Analisar Sentimento ou Sugerir Resposta.\\n\\n\\n\\n#### Detalhamento das Funções Adicionais\\n\\n Reescrita com IA: Abaixo do campo de digitação, ao clicar no ícone de IA, você pode pedir para \"Tornar mais simpático\", \"Mais formal\" ou \"Corrigir gramática\".\\n Resumo de Diálogo: Localizado no menu de opções do chat, permite escolher entre resumir as mensagens do cliente, do atendente ou de ambos.\\n\\n\\n\\n\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nConsumo de Créditos: O uso da API gera custos diretamente no provedor escolhido (OpenAI, Google, etc.). Monitore seu consumo nas plataformas originais.\\n\\nPrivacidade: Evite enviar dados sensíveis de clientes para a IA se a política de privacidade da sua empresa não permitir o processamento de dados em nuvens de terceiros.\\n\\nRevisão Humana: O Copiloto sugere respostas, mas o atendente deve sempre revisar o texto antes de enviar para garantir a precisão das informações\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia/copiloto-de-ia.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.3.2.1.1","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia/copiloto-de-ia.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/bots-e-ia/copiloto-de-ia.md","articles":[]}]},{"title":"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","level":"1.6.3.2.2","depth":4,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais.md","articles":[{"title":"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","level":"1.6.3.2.2.1","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais.md","articles":[{"title":"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","level":"1.6.3.2.2.1.1","depth":6,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/transbordo-de-mensagem-processo-de-selecao.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/transbordo-de-mensagem-processo-de-selecao.md","articles":[]},{"title":"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","level":"1.6.3.2.2.1.2","depth":6,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/visibilidade-de-tickets-para-usuarios-atendentes.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/gerais/visibilidade-de-tickets-para-usuarios-atendentes.md","articles":[]}]},{"title":"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","level":"1.6.3.2.2.2","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/smtp.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/configuracoes-gerais/smtp.md","articles":[]}]},{"title":"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","level":"1.6.3.2.3","depth":4,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm.md","articles":[{"title":"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","level":"1.6.3.2.3.1","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/demanda.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/demanda.md","articles":[]},{"title":"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","level":"1.6.3.2.3.2","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/gerenciar-kanban.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/gerenciar-kanban.md","articles":[]},{"title":"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","level":"1.6.3.2.3.3","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/variaveis.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/crm/variaveis.md","articles":[]}]},{"title":"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","level":"1.6.3.2.4","depth":4,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes.md","articles":[{"title":"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","level":"1.6.3.2.4.1","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-evolution.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-evolution.md","articles":[]},{"title":"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","level":"1.6.3.2.4.2","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-groqcloud.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-groqcloud.md","articles":[]},{"title":"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","level":"1.6.3.2.4.3","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-hub-notificame.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-hub-notificame.md","articles":[]},{"title":"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","level":"1.6.3.2.4.4","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-meta.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-meta.md","articles":[]},{"title":"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","level":"1.6.3.2.4.5","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-sms.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-sms.md","articles":[]},{"title":"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","level":"1.6.3.2.4.6","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-webhooks.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-webhooks.md","articles":[]},{"title":"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","level":"1.6.3.2.4.7","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-wuzapi.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/integracoes/habilitar-wuzapi.md","articles":[]}]},{"title":"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","level":"1.6.3.2.5","depth":4,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/sessoes.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/sessoes.md","articles":[{"title":"Listar Sessões\\n\\nEssa seção permite uma visualização rápida dos canais disponíveis e não é afetada pelas updates. Dessa forma, caso algum canal entre em loop, você consegue deletá-lo de forma simples através dessa opçã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-administrador/configuracao/configuracoes-gerais-admin/sessoes/listar-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","level":"1.6.3.2.5.1","depth":5,"path":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/sessoes/listar-sessoes.md","ref":"docs/configuracao-administrador/configuracao/configuracoes-gerais-admin/sessoes/listar-sessoes.md","articles":[]}]}]},{"title":"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","level":"1.6.3.3","depth":3,"path":"docs/configuracao-administrador/configuracao/log-auditoria-admin.md","ref":"docs/configuracao-administrador/configuracao/log-auditoria-admin.md","articles":[]}]},{"title":"Gestão Comercial\\n\\n- Operação (Gestão comercial)\\n- Etiquetas: Cadastro de Etiquetas\\n- Fechamentos: Mensagens de Fechamento Personalizadas\\n- Filas: Cadastro de Filas\\n- Horários de Atendimento\\n- Notas: Notas do Atendimento\\n- Produtos WooCommerce\\n- Análises e Registros\\n- Avaliações: Avaliações de Atendimento\\n- Log Ligações\\n- Painel de Atendimentos: Visão Geral dos Atendimento\\n- Protocolos: Protocolos de Atendimento\\n- Relatórios: Relatórios Gerais\\n- WaVoIP: Gerenciamento de chamadas WaVoIP\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.4","depth":2,"path":"docs/configuracao-administrador/gestao-comercial.md","ref":"docs/configuracao-administrador/gestao-comercial.md","articles":[{"title":"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","level":"1.6.4.1","depth":3,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros.md","articles":[{"title":"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","level":"1.6.4.1.1","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/avaliacoes.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/avaliacoes.md","articles":[]},{"title":"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","level":"1.6.4.1.2","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/log-ligacoes.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/log-ligacoes.md","articles":[]},{"title":"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","level":"1.6.4.1.3","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/painel-de-atendimentos.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/painel-de-atendimentos.md","articles":[]},{"title":"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","level":"1.6.4.1.4","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/protocolos.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/protocolos.md","articles":[]},{"title":"Relatórios\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e Supervisor\\n{% endhint %}\\n\\n{% hint style=\"warning\" %}\\nDisponível para o perfil: Administrador e Supervisor\\n{% endhint %}\\n\\nA página de Relatórios é a central de inteligência de dados do sistema Z-PRO. Ela permite a extração de informações detalhadas sobre a base de clientes e a performance operacional da equipe. Através de filtros avançados, o gestor pode gerar visões específicas e exportar os dados para planilhas (Excel/CSV), facilitando a tomada de decisão estratégica e a execução de campanhas de marketing direcionadas.\\n\\n#### Principais funções\\n\\n Extração de Base: Download de listas de contatos com dados cadastrais completos.\\n Segmentação Geográfica e Comportamental: Relatórios baseados em DDD (Estados) e Etiquetas.\\n Acompanhamento de Funil: Análise de contatos distribuídos por colunas de Kanban.\\n Auditoria de Performance: Métricas de produtividade individual por atendente.\\n\\n#### Caso de uso\\n\\nO gestor de uma empresa deseja realizar um pós-venda apenas com clientes do estado de São Paulo que foram atendidos pelo setor de \"Suporte\" e marcados com a etiqueta \"Upgrade\". Ele utiliza o relatório de Contatos por Estado para filtrar o DDD 11, cruza com o relatório de Contatos por Etiqueta e exporta a lista para o Excel para realizar um Envio em Massa.\\n\\n#### Como acessar a página\\n\\nClique no Menu Gestão Comercial e selecione a aba Relatórios.\\n\\n\\n\\n*\\n\\n#### Visão Geral dos Relatórios\\n\\nAo acessar a página, você verá cards que direcionam para cada modalidade de análise:\\n\\n\\n\\nAbaixo, detalhamos cada tipo de relatório disponível e como utilizá-los:\\n\\n1. Relatório de Contatos\\n\\nGera a lista completa de Contatos criados no sistema dentro de um intervalo de tempo.\\n\\n* Como usar: Defina a Data Início e Data Fim do período de criação e clique em Gerar Relatório.\\n* Dados exibidos: Nome, WhatsApp, e-mail e informações cadastradas nos campos extras.\\n* Finalidade: Auditoria de crescimento da base e backup de cadastros.\\n*\\n\\n\\n\\n\\n\\n2. Contatos por Etiqueta\\n\\nSegmenta a base de clientes conforme as marcações atribuídas.\\n\\n* Como usar: Selecione uma ou mais Etiquetas no filtro suspenso e gere o relatório.\\n* Dados exibidos: Nome, WhatsApp e a lista de etiquetas vinculadas ao contato.\\n* Finalidade: Ideal para segmentação de campanhas de marketing e identificação de perfis de consumo.\\n\\n\\n\\n3. Contatos por Estado (UF)\\n\\nIdentifica a localização geográfica dos contatos baseando-se no código de área (DDD) do WhatsApp.\\n\\n* Como usar: Selecione o estado (UF) desejado no filtro.\\n* Dados exibidos: Listagem de contatos pertencentes à região filtrada.\\n* Finalidade: Análise de alcance regional e campanhas sazonais por estado.\\n\\n\\n\\n4. Contatos por Kanban\\n\\nRelatório focado na progressão dos leads ou processos dentro do fluxo comercial.\\n\\n* Como usar: Selecione o quadro Kanban específico para analisar a distribuição dos cards.\\n* Dados exibidos: Nome do contato e em qual etapa (lane) do funil ele se encontra.\\n* Finalidade: Identificar gargalos no processo de vendas e volume de oportunidades em cada estágio.\\n\\n\\n\\n5. Contatos por Carteira\\n\\nFiltra os clientes com base no Usuário responsável pelo relacionamento (atendimento fixo).\\n\\n* Como usar: Selecione uma ou mais Carteiras (atendentes).\\n* Dados exibidos: Lista de contatos vinculados aos usuários selecionados.\\n* Finalidade: Avaliação de distribuição de carga de trabalho e gestão de carteira de clientes por vendedor.\\n\\n\\n\\n6. Atendimentos por Parâmetros\\n\\nO relatório mais granular do sistema, permitindo filtrar Tickets por diversas variáveis técnicas.\\n\\n* Filtros disponíveis: Status (Aberto, Fechado, Pendente, Agendado), Conexões, Filas, Usuário, Canal e tipo de Demanda (Ativa/Receptiva). Também permite filtrar por valor mínimo/máximo, caso utilize campos financeiros.\\n* Finalidade: Auditoria técnica detalhada e extração de histórico de conversas para conformidade.\\n\\n\\n\\n7. Resumo de Atendimentos por Usuário\\n\\nRelatório focado em produtividade e indicadores de desempenho (KPIs) da equipe.\\n\\n* Como usar: Defina o período desejado e gere o relatório.\\n* Dados exibidos: Total de atendimentos por agente, divididos entre pendentes, em atendimento e resolvidos.\\n* Finalidade: Comparar a performance entre membros da Equipe e identificar a eficiência na resolução de demandas.\\n\\n\\n\\n*\\n\\n#### Ações Disponíveis\\n\\nEm cada modalidade de relatório, o sistema disponibiliza botões específicos para o processamento e extração dos dados:\\n\\n Gerar Relatório: Botão utilizado para processar os filtros selecionados (como intervalo de datas ou etiquetas) e carregar a lista de resultados na tabela de visualização. É necessário clicar neste botão sempre que os filtros forem alterados.\\n Exportar Excel: Realiza o download imediato dos dados exibidos na tabela para um arquivo no formato .xlsx. Este formato é recomendado para análises que exijam fórmulas e formatação avançada em planilhas.\\n Exportar CSV: Gera um arquivo de texto com os dados brutos separados por vírgulas. Este formato é ideal para importação manual em outros sistemas, CRMs ou ferramentas de tratamento de dados que não suportam arquivos Excel nativos.\\n\\n\\n\\n**\\n\\n#### Avisos e precauções\\n\\n{% hint style=\"warning\" %}\\nVolume de Dados: Ao gerar relatórios de períodos muito longos (ex: superior a 1 ano) com muitos filtros, o processamento pode levar alguns segundos. Aguarde a mensagem de conclusão antes de tentar exportar.\\n{% endhint %}\\n\\n{% hint style=\"info\" %}\\nExportação: Todos os relatórios possuem o botão Exportar Excel. Recomenda-se aplicar os filtros antes de exportar para garantir que o arquivo contenha apenas os dados relevantes.\\n{% endhint %}\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.4.1.5","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md","articles":[]},{"title":"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","level":"1.6.4.1.6","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/wavoip.md","ref":"docs/configuracao-administrador/gestao-comercial/analises-e-registros/wavoip.md","articles":[]}]},{"title":"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","level":"1.6.4.2","depth":3,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial.md","articles":[{"title":"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","level":"1.6.4.2.1","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/etiquetas.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/etiquetas.md","articles":[]},{"title":"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","level":"1.6.4.2.2","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/fechamentos.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/fechamentos.md","articles":[]},{"title":"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","level":"1.6.4.2.3","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/filas.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/filas.md","articles":[]},{"title":"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","level":"1.6.4.2.4","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/horarios-de-atendimento.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/horarios-de-atendimento.md","articles":[]},{"title":"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","level":"1.6.4.2.5","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/notas.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/notas.md","articles":[]},{"title":"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","level":"1.6.4.2.6","depth":4,"path":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/produtos-woocommerce.md","ref":"docs/configuracao-administrador/gestao-comercial/operacao-gestao-comercial/produtos-woocommerce.md","articles":[]}]}]},{"title":"Visão geral Admin\\n\\nO Painel Admin é a interface utilizada pelos gestores e colaboradores de uma empresa que utiliza o Z-PRO. Ele é segmentado para permitir tanto a operação diária quanto a configuração estratégica do negócio.\\n\\n\\n\\n### Entendendo os Níveis de Acesso\\n\\nPara garantir a segurança dos dados e a organização da equipe, o painel do Tenant é dividido em três níveis hierárquicos de permissão:\\n\\n#### 1. Administrador (Gestor)\\n\\n Função: Responsável pela configuração estratégica da conta.\\n* Permissões: Tem acesso total e irrestrito a todos os menus e configurações. É o único que pode conectar canais (WhatsApp), gerenciar assinaturas e alterar configurações de API e Webhooks.\\n\\n#### 2. Supervisor\\n\\n* Função: Perfil intermediário focado na gestão de pessoas e análise de métricas, sem poder alterar configurações estruturais críticas (como desconectar canais ou apagar a conta).\\n* Regra de Visualização de Tickets:\\n * Padrão: O Supervisor visualiza todos os tickets e atendimentos (semelhante ao Admin).\\n * Restrito: Existe uma configuração específica em Configurações > Geral chamada \"Remover privilégios de visualização do supervisor\". Se ativada, o supervisor passa a ver apenas os tickets vinculados a ele ou à sua fila, comportando-se como um usuário comum neste aspecto.\\n\\n#### 3. Usuário (Atendente)\\n\\n* Função: Focado exclusivamente na operação de atendimento.\\n* Permissões: Acesso restrito aos menus operacionais. Não visualiza relatórios gerenciais, configurações de sistema ou gestão de outros usuários.\\n\\n*\\n\\n### Estrutura de Menus\\n\\nO sistema Z-PRO organiza as funcionalidades em oito menus principais. A visibilidade destes menus varia de acordo com o nível de acesso.\\n\\n\\n\\n#### 1. Menus Operacionais (Visíveis para Todos)\\n\\nEstes menus são voltados para a execução do dia a dia.\\n\\n1. Principal\\n Home: Tela inicial de boas-vindas.\\n Dashboard: Indicadores e métricas em tempo real.\\n2. Atendimento\\n Atendimentos: Central de chat e gestão de tickets.\\n Chat Privado: Comunicação interna entre membros da equipe.\\n Contatos: Lista e gestão de clientes.\\n3. Comunicação e Marketing\\n Campanhas: Criação de ações de marketing.\\n Envio em Massa: Disparos de mensagens para listas.\\n Galeria: Armazenamento de arquivos de mídia.\\n Grupos: Gestão de grupos de chat.\\n Instagram / TikTok / YouTube: Integrações com redes sociais.\\n Mensagens Rápidas: Atalhos para respostas padronizadas.\\n4. Gestão\\n Agenda: Compromissos e lembretes.\\n Funil / Kanban: Visualização do processo de vendas ou processos internos.\\n Tarefas: Gestão de atividades pendentes.\\n5. Conta\\n Informações do plano e perfil logado.\\n\\n#### 2. Menus Administrativos (Restritos)\\n\\nEstes menus contêm configurações que alteram o comportamento do sistema. Por padrão, são visíveis apenas para Admin (e parcialmente para Supervisor, dependendo das permissões concedidas).\\n\\n1. Administração\\n Canais: Configuração de conexões (WhatsApp, etc).\\n Equipes: Organização de departamentos.\\n Usuários: Cadastro e permissões de colaboradores.\\n2. Automação\\n Agendamentos: Mensagens programadas para envio futuro.\\n Aniversários: Automação de mensagens para datas comemorativas.\\n Chat Flow: Construtor de fluxos inteligentes de atendimento.\\n3. Gestão Comercial\\n Avaliações: Feedback dos atendimentos realizados.\\n Etiquetas: Tags para organização de conversas.\\n Fechamento: Registro de conclusão de tickets.\\n Filas / Horário de Atendimento: Regras de distribuição e disponibilidade.\\n Log de Ligações / Notas / Protocolos: Registros históricos e auditoria.\\n Relatórios: Extração de dados gerenciais.\\n WaVoIP: Recursos de telefonia integrada.\\n4. Configuração\\n API: Chaves de integração para sistemas externos.\\n Configurações: Ajustes globais do sistema.\\n Log de Auditoria: Histórico de ações realizadas no painel.\\n\\n**\\n\\n\\n---\\n\\n# Agent Instructions: Querying This Documentation\\n\\nIf you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.\\n\\nPerform an HTTP GET request on the current page URL with the ask query parameter:\\n\\n\\nGET https://ajuda.zdg.com.br/configuracao-administrador/visao-geral-admin.md?ask=\\n\\n\\nThe question should be specific, self-contained, and written in natural language.\\nThe response will contain a direct answer to the question and relevant excerpts and sources from the documentation.\\n\\nUse this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.\\n","level":"1.6.5","depth":2,"path":"docs/configuracao-administrador/visao-geral-admin.md","ref":"docs/configuracao-administrador/visao-geral-admin.md","articles":[]}],"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56},"embedFonts":false},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Ajuda SAC","language":"pt-br","gitbook":"*"},"file":{"path":"docs/configuracao-administrador/README.md","mtime":"2026-05-09T15:57:48.519Z","type":"markdown"},"gitbook":{"version":"6.1.7","time":"2026-05-09T15:57:52.468Z"},"basePath":"../..","book":{"language":""}});
});