Visão Geral
A área Configurações é o painel central de parametrização do tenant (a empresa cliente) dentro do PanÐá Zap. É onde o Administrador ajusta o comportamento de roteamento de tickets, regras de bots e automações, comportamento das conversas, horário de atendimento, integrações de e-mail (SMTP), segurança de login (A2F), integrações de API, auditoria e diversas ferramentas de manutenção de dados. A sub-aba Geral concentra a maior parte das opções e organiza tudo em 5 categorias, que aparecem também no menu “Nesta página” à esquerda da tela:- Tickets e Visibilidade: controla quem pode ver quais tickets.
- Bot e Chatbot: regras de interação automatizada e comportamento em mídias sociais.
- Organização e Distribuição: configurações técnicas de exibição, roteamento e integrações externas.
- Atendimento e Recursos: controle de ferramentas do chat e regras de inatividade (timeouts).
- Ações do Sistema: comandos manuais de sincronização e correção de dados.
Como usar a tela Geral
Abra a tela
Encontre a opção
Altere e salve
Visibilidade e Roteamento de Tickets
Comportamento de Bots e Automação
Configurações de Mensagens e Conversas
Horário de Atendimento
O módulo de Horário de Atendimento define a jornada de trabalho da empresa e o que acontece quando um contato escreve fora desse período.Abra a tela
Configurando a Agenda
Mensagem Fora do Horário
Feriados
Prioridade
Salve
Catálogo Completo de Configurações Gerais
Esta é a referência integral de todas as opções disponíveis na sub-aba Geral de Configurações, organizada exatamente como aparecem no menu “Nesta página” do painel: 5 categorias, algumas delas subdivididas em blocos temáticos. Use esta seção como fonte de consulta quando precisar entender o efeito exato de um campo específico.1. Tickets e Visibilidade
Controla quem pode ver quais tickets.2. Bot e Chatbot
Regras de interação automatizada e comportamento em mídias sociais.3. Organização e Distribuição
Configurações técnicas de exibição, roteamento e integrações externas, agrupadas em 5 blocos.Listagem e ordenação
Janela de 24h e WABA
Telefonia e identificadores
- Regra por DDD (padrão): adiciona o 9 em DDDs menores que 30 e remove em DDDs 30 ou maiores (comportamento histórico da telefonia brasileira).
- Sempre com 9: o celular sempre mantém o 9º dígito, que nunca é removido; recomendado para números atuais.
Carteira e acesso a dados
- Definida pelo admin (padrão): o administrador digita a senha e a informa manualmente ao usuário.
- Trocar no 1º acesso: o administrador define uma senha temporária, e o usuário é obrigado a criar a própria senha no primeiro login.
- Convite por e-mail: o formulário de cadastro nem pede senha: o novo usuário recebe um link por e-mail (válido por 7 dias) para criar a própria senha. Esta opção exige o SMTP do tenant configurado (ver seção SMTP).
Integrações e fluxo externo
4. Atendimento e Recursos
Controle de ferramentas do chat e regras de inatividade (timeouts), agrupadas em 5 blocos.Atendimento
Reabertura e agendamento
Áudio e mídia
Notificações
Limites
Região e idioma
Card com a descrição “País, moeda e idioma das mensagens automáticas que seus clientes recebem”. Fica entre Atendimento e Recursos e Ações do Sistema e aparece para o Administrador (e para o Perfil Personalizado com acesso a Configurações); Supervisores e Atendentes não o veem. Seus campos são seletores, por isso não entram na contagem “N de M ativas” das categorias.5. Ações do Sistema
Comandos manuais de sincronização e correção de dados. Cada ação roda pelo botão Executar da própria linha e pede confirmação antes.Mesclagem manual de par (juntar dois cadastros da mesma pessoa)
Use quando você confirmou que dois cadastros são a mesma pessoa e o par não aparece na lista da auditoria, como na conversa dividida em dois atendimentos descrita em O Problema da Duplicidade por LID.Descubra o ID de cada cadastro
/contatos/. O cadastro que fica é o que tem o telefone real; o duplicado é o que tem o código no lugar do número.Encerre o atendimento do cadastro duplicado
Rode a auditoria
Mescle o par
- O cadastro que fica recebe o código do duplicado e os atendimentos dele, e mantém o próprio nome e o próprio nome de perfil.
- O duplicado não é apagado: o número dele é trocado por uma marca de mesclagem e ele fica bloqueado, o que permite desfazer em Reverter mesclagens.
- Cada mensagem continua no atendimento em que entrou. Com Mostrar histórico de mensagens ligado e o Tipo de Listagem de Mensagens em Padrão (ou Histórico Completo), a conversa do atendimento aberto mostra todas as mensagens em ordem, com a divisória Ticket #número cada vez que a mensagem troca de atendimento.
- Mensagens enviadas depois pelo celular para essa pessoa passam a cair no cadastro certo. A chave É LID (contato de identificação do dispositivo) desse cadastro pode ligar sozinha quando isso acontece: é esperado e não muda o envio pelas conexões Meow.
- A tela avisa que o sistema precisa ser reiniciado depois da consolidação: o PanÐá Zap faz esse reinício automaticamente todos os dias de manhã cedo, e não é preciso pedir.
Revisão antes de achar que é erro (Consolidar duplicatas LID)
API (Configurações)
Quem usa: Administrador (configuração e gestão das chaves). É um recurso técnico, normalmente operado pelo Administrador em conjunto com um desenvolvedor ou parceiro técnico responsável pela integração externa. O que é: a página API é o ambiente de integração técnica entre o PanÐá Zap e sistemas externos, como CRMs, sites institucionais, ERPs ou plataformas de automação de marketing. Nela o Administrador gera chaves (tokens) de acesso, consulta a documentação técnica dos endpoints disponíveis e testa requisições em tempo real sem precisar sair do painel. Os pilares desta tela são:- Gestão de Tokens: criação de APIs e geração de novos tokens.
- Documentação de rotas: lista dos endpoints e parâmetros aceitos por cada rota, com a URL base da sua API.
- Sandbox: ambiente de teste para validar requisições antes de usá-las em produção.
Acesse a tela
Crie uma nova integração
Nomeie a integração
Selecione a Sessão
Salve
Copie o token agora
Autentique as chamadas
Teste no Sandbox
Configure Webhooks (opcional)
- O botão Postman no topo da tela abre a coleção de requisições do PanÐá Zap no Postman, útil para desenvolvedores explorarem os endpoints rapidamente.
- Os ícones de ação de cada API permitem: Gerar novo token (gera um novo token e invalida o anterior), Editar (altera o nome e a chave API ativa; a sessão não muda) e Excluir (remove a integração e invalida o acesso externo permanentemente). A listagem mostra apenas o Prefixo do token e a URL de integração, que pode ser copiada; o token completo não pode ser revelado depois de criado.
- Ao configurar webhooks, filtre apenas os eventos estritamente necessários para sua integração: isso reduz o tráfego de dados desnecessário e facilita a manutenção do lado externo.
- No atendimento, as mensagens enviadas pela API aparecem com o autor Sistema e a dica Mensagem enviada pela API (integração externa)., e não com o nome de um usuário (nos canais oficiais do WhatsApp, Instagram e Messenger, isso vale para as mensagens de texto). Veja “Comportamentos que vale conhecer” em Caixa de Entrada.
Log de Auditoria
Quem usa: Administrador. Recomenda-se restringir o acesso a esta tela apenas a perfis de alta confiança na organização, dado o nível de detalhe técnico e sensível que ela expõe. O que é: a central de transparência e segurança do PanÐá Zap. Nela o Administrador rastreia detalhadamente cada interação realizada na plataforma: quem executou a ação, em qual momento, de qual endereço IP e qual recurso foi afetado. Os cinco pilares desta tela são:- Rastreabilidade total: monitoramento de criações, edições e exclusões de dados.
- Segurança e conformidade: registro de endereços IP e histórico de acessos.
- Filtragem avançada: localização de eventos específicos por usuário, período ou tipo de entidade.
- Inspeção técnica: visualização do corpo técnico (payload) das requisições realizadas ao sistema.
- Exportação de dados: geração de arquivos CSV para auditorias externas.
Acesse o Log de Auditoria
Filtre o evento
tickets ou users), Usuário e o intervalo de Data inicial e Data final. A ação Abrir marca cada abertura de um aplicativo da tela Aplicativos feita pelo contato ou pelo atendimento (veja Aplicativos).Aplique o filtro
Leia a tabela de resultados
Veja os detalhes técnicos
Exporte, se necessário
tickets e pela ação Atualizar, o log revela exatamente qual usuário fez a alteração, o horário exato e o IP utilizado, permitindo corrigir o processo interno.
Dicas e observações importantes:
- Verifique regularmente se o IP registrado condiz com a localização habitual do colaborador e se o Status apresenta muitos códigos diferentes de 200: isso pode indicar tentativas de acesso indevido ou falhas de integração.
Importar Histórico de Conversas
Quem usa: Administrador. O que é: ferramenta de migração de dados que traz para dentro do painel conversas realizadas externamente pelo aplicativo WhatsApp Business. É voltada para empresas que acabaram de implantar o sistema e querem manter a continuidade do histórico de relacionamento com seus clientes, agora centralizado na plataforma.Exporte a conversa no celular
Acesse a ferramenta de importação
Selecione o Canal de Destino
Defina o Contato
Faça o upload do arquivo
.txt da conversa e, opcionalmente, os arquivos de mídia (fotos, áudios e vídeos) incluídos na exportação, e mostra uma pré-visualização com o total de mensagens e de arquivos de mídia.Confirme quem é a sua empresa
Importe
- Status do Ticket: todo atendimento criado via importação nasce com status Fechado.
- Marcador Visual: as mensagens importadas recebem a tag interna imported, permitindo à equipe diferenciar histórico legado de atendimento nativo da plataforma.
- Responsabilidade: os tickets importados não têm nenhum atendente humano atribuído inicialmente.
.zip e a quantidade de mídias contidas nele; arquivos grandes podem demorar mais.Visibilidade de Tickets para Usuários
Quem usa: Administrador (configura as regras globais e o cadastro de cada usuário). Impacto direto no dia a dia de Supervisores e, principalmente, Atendentes, cuja visão de tickets é moldada por estas regras. O que é: conjunto de regras e campos de configuração que determinam quais atendimentos cada colaborador pode visualizar. A parametrização correta aqui é fundamental para organizar a distribuição de demanda e garantir a privacidade das informações entre setores ou níveis hierárquicos diferentes.Como funciona por perfil (regra base, definida na criação do usuário)
- Notificações seguem a mesma visibilidade dos tickets: o usuário só recebe som, badge e prévia de mensagem de conversas que ele realmente pode abrir na tela de Atendimentos, nunca de um ticket fora do seu escopo.
- Conversas com o robô (chatbot): ficam ocultas da lista de atendimentos apenas enquanto estão em interação com o robô. Assim que o ChatFlow encaminha a conversa para uma fila, ela passa a aparecer normalmente para quem tem acesso a essa fila.
- Carteira: o dono da carteira visualiza e é avisado dos atendimentos do seu contato, mesmo que esse atendimento não esteja em nenhuma das filas dele.
- Prazo de propagação: qualquer alteração de permissão feita no cadastro de um usuário leva até 30 segundos para valer em toda a sessão dele.
Ajuste as regras globais
Refine por usuário
- Para Supervisores (Visualização por Departamento): se marcada, o supervisor vê apenas os tickets das filas (departamentos) às quais foi associado. Se desmarcada, mantém a visão global de admin. Este campo só pode ser alterado por um Administrador: o próprio supervisor não consegue editar essa opção em seu próprio cadastro.
- Usuário Restrito (privacidade de dados do contato, LGPD): quando habilitado, o usuário continua atendendo, mas os dados dos contatos ficam protegidos: o menu Contatos some, o nome do contato aparece só parcialmente (5 primeiros caracteres), a foto fica desfocada, telefone, e-mail e demais dados ficam ocultos, o botão de editar contato e as opções de telefonia deixam de aparecer e o botão Nova Conversa da barra superior fica oculto. Não confunda com a restrição por fila ou canal.
- Administradores e Supervisores sem restrição de visualização (sem Visualização por Departamento, Supervisor restrito ao canal e Remover privilégios de visualização do supervisor) sempre têm visibilidade total: as restrições aqui descritas aplicam-se principalmente ao dia a dia do perfil Atendente. Com Não visualizar Tickets já atribuídos a outros usuários ligada, eles continuam abrindo os atendimentos dos colegas, mas na lista precisam marcar Mostrar todos ou filtrar por fila para vê-los.
- Alterações feitas em Configurações Gerais impactam todos os usuários do sistema simultaneamente; alterações feitas no cadastro individual (Administração → Usuários) afetam só aquela pessoa.
- Um link direto para um atendimento fora do escopo do usuário (vindo de uma notificação antiga, de um favorito salvo ou compartilhado manualmente) não funciona como atalho para contornar as restrições de fila, canal ou departamento: o servidor bloqueia o acesso mesmo assim.
- Regras de quem pode criar/editar usuários (permissão de gestão, restrição de hierarquia) são um assunto à parte da visibilidade de tickets, tratado na documentação de Usuários e Perfis de Acesso.
Transbordo de Mensagem
Quem usa: Administrador (habilita a regra). Afeta diretamente Atendentes com carteira de clientes atribuída, cujos tickets podem ser redirecionados a colegas quando eles estão offline. O que é: funcionalidade criada para garantir que um cliente não fique sem resposta caso o atendente responsável pelo seu ticket (atendimento carteirizado) esteja offline. Quando ativa, o sistema monitora o status do usuário responsável e, se ele não estiver online no momento em que o cliente enviar uma nova mensagem, o PanÐá Zap redistribui automaticamente o ticket para outro membro da equipe que esteja online, seguindo uma lógica de distribuição balanceada.Acesse Configurações Gerais
Habilite a opção
Salve
- Verificação do atendente atual: o sistema confere o status do usuário “dono” do ticket. Se estiver online, o transbordo não acontece e o ticket permanece com ele.
- Busca por atendentes elegíveis: se o dono estiver offline, o sistema procura um substituto. Para ser elegível, o atendente precisa: estar com status online, pertencer à mesma empresa, ter permissão de acesso à fila (WhatsApp) do ticket em questão e não estar marcado como Fora do rodízio de atendimentos no cadastro de usuários.
- Balanceamento de carga: entre os elegíveis, o sistema conta quantos tickets individuais (que não são de grupo) cada atendente já recebeu naquele dia, e atribui o ticket a quem tiver o menor número de tickets recebidos no dia.
- Execução: o ticket é transferido para o atendente selecionado, a tela de atendimentos de todos é atualizada em tempo real (via socket), e a ação fica registrada em log para auditoria.
- O transbordo só acontece se o dono do ticket estiver offline.
- A distribuição prioriza o atendente online que menos recebeu tickets naquele dia, não é aleatória nem por ordem de entrada.
- A contagem de balanceamento considera apenas tickets individuais; conversas em grupo não entram nessa conta.
- Quando a transferência por carteira está ativa, ela tem prioridade sobre a Distribuição Automática padrão da fila.
Tipo de Listagem de Mensagens
Quem usa: Administrador (define a opção para toda a empresa). Impacto direto em Atendentes e, em menor grau, Supervisores: é o que determina quanto contexto de conversa cada um enxerga ao abrir um ticket. O que é: configuração que define o que o atendente enxerga ao abrir uma conversa: só as mensagens do atendimento atual, o histórico completo do contato, ou algo intermediário com regras de privacidade por fila. Fica em Configurações → Geral, na seção “Organização e Distribuição”.Acesse a configuração
Localize o campo
Escolha a opção
Aplicação imediata
As 5 opções disponíveis
1. Padrão O comportamento depende de outra opção da mesma seção, Mostrar histórico de mensagens (chamada de “Agrupar Tickets” na nota da tela). Se ela estiver desligada, o atendente vê apenas as mensagens trocadas dentro da fila atual com aquele contato/canal (mensagens da mesma pessoa em outra fila não aparecem). Se estiver ligada, o atendente vê todo o histórico do contato/canal, independentemente da fila. É a opção mais conservadora: não muda o comportamento clássico da plataforma. Indicada quando a empresa já decidiu como quer o comportamento de Mostrar histórico de mensagens e só quer que a listagem siga essa mesma lógica. 2. Histórico por Fila Mostra o histórico do contato/canal filtrado pelas filas em que o atendente está vinculado. É o modo mais usado em operações onde supervisores ou agentes só podem enxergar conversas das filas em que participam. A privacidade é mantida em dois níveis: filtro pelas filas do próprio usuário, e filtro pela “fila de origem” de cada mensagem (cada mensagem carrega a fila em que estava no momento em que foi enviada/recebida; se o ticket mudou de fila depois, as mensagens antigas continuam marcadas com a fila original e ficam ocultas para quem não tem acesso a ela).- Atendente sem nenhuma fila atribuída: vê a conversa vazia.
- Atendente com filas, e o ticket atual está numa fila permitida: vê só as mensagens daquele ticket que pertencem às suas filas; mensagens herdadas de fila não permitida ficam ocultas mesmo dentro do próprio ticket aberto.
- Atendente com filas, mas o ticket atual não está em fila permitida: ainda assim vê, de outros atendimentos do mesmo contato/canal, as mensagens que pertenceram às filas dele.
- Administrador (e Perfil Personalizado com a permissão Ver todos os atendimentos): ignora esses filtros e vê o histórico completo do contato/canal.
O que cada perfil enxerga em cada opção
A tabela abaixo cobre as quatro primeiras opções; o comportamento de Histórico por Usuário está descrito logo acima.Benefícios e quando usar
- A configuração afeta apenas o que aparece dentro de uma conversa já aberta. Ela não muda quais conversas aparecem na lista lateral de tickets: isso depende de outras configurações (permissões por canal, filtros de chatbot, restrição por carteira etc.).
- Em conversas de grupo, o sistema carrega mais mensagens por página (90) do que em conversas individuais (30).
- Na prática, escolher “Padrão” com Mostrar histórico de mensagens ligada mostra o mesmo conteúdo que “Histórico Completo”. A diferença real é que Histórico Completo independe dessa opção, enquanto Padrão sempre a segue.
- Mensagens offline (mensagens pendentes de envio guardadas pela plataforma) são exibidas independentemente do modo escolhido, mas apenas na primeira página da conversa.
Carência Pós-Atendimento
Quem usa: Administrador (configura). Afeta diretamente os Atendentes, pois a conversa pode voltar automaticamente para o destino escolhido. O que é: quando ativada, esta configuração faz com que o atendimento reabra automaticamente em Abertos caso o cliente responda dentro de um período definido após o encerramento, sem passar pelo chatbot. O destino da conversa reaberta é escolhido em Para quem enviar. Depois que esse período (carência) termina, a resposta do cliente volta ao fluxo normal (fila de pendentes e/ou chatbot).Acesse Configurações Gerais
Ative a chave
Informe o tempo
Escolha o destino
Salve
- O prazo é configurável: defina um tempo compatível com o ritmo real de resposta dos seus clientes.
- Não se aplica a conversas em grupo nem ao canal Webchat.
- Se a conversa foi encerrada pelo próprio robô (chatbot), a regra de carência não entra em ação: a resposta sempre volta para o robô nesse caso específico.
SMTP
Quem usa: Administrador. O que é: tela onde o administrador do tenant configura o servidor de saída de e-mails (SMTP) exclusivo da sua operação. Essa configuração é o que permite ao sistema disparar notificações automáticas, alertas e, principalmente, e-mails de recuperação de senha para os usuários vinculados ao tenant.Acesse a tela de SMTP
Reúna os dados do provedor
Habilite o SMTP
Preencha o formulário
Salve antes de testar
Teste o envio
Revise em caso de falha
- Por segurança, nunca compartilhe ou registre a senha real do e-mail em anotações, tickets de suporte ou qualquer documento fora do próprio formulário do sistema.
Autenticação de Dois Fatores (A2F)
Quem usa: Administrador (configura). Depois de habilitada, o A2F afeta o login de todos os usuários do tenant: Administradores, Supervisores e Atendentes. O que é: módulo de segurança avançada que adiciona uma camada extra de proteção ao processo de login. Além da senha habitual, o sistema passa a exigir que o usuário informe um código de verificação dinâmico, enviado por um canal de comunicação à escolha do administrador. Isso reduz o risco de acessos não autorizados mesmo em casos de exposição/vazamento de senha.Acesse o subitem A2F
Habilite o A2F
Escolha o canal
Configure o envio
- WhatsApp: em Conexão WhatsApp, selecione qual dos seus canais de WhatsApp conectados fará o disparo dos códigos.
- SMS: em Provedor SMS, selecione o provedor (Comtele, ConectaStartup ou Livson / BHI).
- E-mail: o código é enviado para o e-mail de cada usuário.
Configure a mensagem de segurança
{code} onde o código deve aparecer: o sistema substitui esse termo pelo código gerado a cada tentativa de acesso. Exemplo: Seu código de verificação é: {code}.Se a conexão escolhida for um canal oficial (WABA), o campo de mensagem dá lugar ao Template WABA: selecione um template aprovado na Meta.Salve
- O usuário insere e-mail e senha na tela de login, normalmente.
- O sistema valida as credenciais e dispara instantaneamente o código para o canal configurado (WhatsApp, SMS ou e-mail, conforme o que foi escolhido na configuração de canal).
- Uma nova tela surge no navegador solicitando o código recebido.
- O acesso ao painel só é liberado após a inserção correta dos dígitos.
- Cadastro de telefone dos usuários: para os canais WhatsApp e SMS, garanta que todos os usuários tenham um número de telefone válido preenchido em seus perfis: sem isso, eles não recebem o código. Pelo mesmo raciocínio, se o canal escolhido for E-mail, vale o cuidado equivalente de manter o e-mail de cada usuário atualizado e correto no cadastro.
- Antes de ativar o A2F para a empresa toda, teste o fluxo com um único usuário para confirmar que o canal e a mensagem estão funcionando como esperado.
Acesso à API: Criar Usuário
Além da tela de gestão de integrações (ver API (Configurações)), a API externa do PanÐá Zap tem uma rota para criar usuários de forma programática, útil para sincronizar o cadastro da equipe a partir de um sistema de RH, ERP ou script de provisionamento interno. Autenticação: todas as chamadas usam o mesmo padrão de token descrito na seção de API, no cabeçalho:password depende da configuração Senha de novos usuários (ver catálogo completo, categoria “Carteira e acesso a dados”): se o tenant usa o modo “Convite por e-mail”, o SMTP do tenant precisa estar configurado (ver seção SMTP) para que o link de criação de senha seja entregue ao novo usuário.
