Pular para o conteúdo principal

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:
  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.
  4. Atendimento e Recursos: controle de ferramentas do chat e regras de inatividade (timeouts).
  5. Ações do Sistema: comandos manuais de sincronização e correção de dados.
Além dessas cinco categorias, o menu “Nesta página” traz o card Região e idioma, entre Atendimento e Recursos e Ações do Sistema. Ele define o país, a moeda e o idioma das mensagens automáticas ao cliente da empresa e está descrito em Região e idioma, mais adiante nesta página.
As seções a seguir destacam os controles mais usados no dia a dia. Para a lista integral, item por item, consulte o Catálogo Completo de Configurações Gerais mais adiante nesta página: ele reúne todas as opções encontradas em Configurações → Geral, sem exceção.

Como usar a tela Geral

1

Abra a tela

No menu lateral, em Configuração, clique em Configurações. Na aba Gerais, clique em Geral.
2

Encontre a opção

Use o campo Buscar configuração… (atalho: tecla /) ou os filtros do topo: Todas, Ativadas e Alteradas agora, além de Filtrar por tema (Roteamento, Visibilidade, Janela WABA, Permissões, Notificações, Mídia, Limites e Bot). O Modo compacto deixa a lista mais densa, e Expandir tudo / Recolher tudo abre ou fecha as categorias.
3

Altere e salve

Ligue ou desligue as chaves e preencha os campos. Nada vale até você clicar em Salvar. Enquanto isso, a barra de alterações mostra quantas mudanças estão pendentes; o botão Revisar lista cada uma com os valores De e Para, e Descartar desfaz tudo.
Se você tentar sair da tela com alterações não salvas, o PanÐá Zap avisa e oferece Continuar editando, Sair sem salvar ou Salvar e sair. Quando alguma fila usa Distribuição Automática, a tela também mostra o aviso Distribuição Automática ativa em alguma fila: as opções marcadas com esse aviso têm efeito ajustado nas conversas dessas filas.

Visibilidade e Roteamento de Tickets

Para o detalhamento completo de como cada perfil (Administrador, Supervisor, Atendente, Perfil Personalizado) enxerga tickets, incluindo combinações e regras complementares, veja a seção Visibilidade de Tickets para Usuários mais adiante.

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.
1

Abra a tela

No menu lateral, em Gestão Comercial, clique em Horário Atendimento.
2

Configurando a Agenda

Em Horários por Dia, escolha para cada dia da semana: 24 horas, Agendado ou Fechado. No modo Agendado, informe os dois turnos (Manhã e Tarde), cada um com hora de início e fim. Os quatro horários precisam estar preenchidos, o início de cada turno não pode ser igual ao fim e os dois turnos não podem se sobrepor (por exemplo, manhã e tarde com pausa de almoço no meio); do contrário a tela mostra o aviso em vermelho (Os horários não podem ficar vazios, Período inválido (início igual ao fim ou hora inválida) ou Os turnos se sobrepõem (fim da manhã >= início da tarde)) e Salvar não grava. O turno que vira a noite (por exemplo, 22:00 às 02:00) é aceito e vale dentro do próprio dia: da meia-noite até 02:00 e das 22:00 até o fim do dia, e a madrugada seguinte segue o horário do dia seguinte. O ícone de ajuda ao lado de Horários por Dia mostra essa explicação.
3

Mensagem Fora do Horário

Personalize o texto enviado automaticamente a quem escreve fora da janela configurada (deixe vazio para não enviar mensagem). O envio dessa mensagem pode ser limitado por atendimento com a opção Máximo de tentativas da mensagem de horário de atendimento, em Configurações Gerais, evitando que o mesmo aviso seja repetido a cada mensagem do cliente.
4

Feriados

Em Feriados, clique em Adicionar Feriado e informe a Data e a Descrição (feriados nacionais, estaduais ou pontos facultativos da empresa). Feriados ativos bloqueiam o atendimento naquele dia, mesmo que o dia da semana esteja normalmente configurado como aberto.
5

Prioridade

Quando existem horários configurados tanto no nível da fila quanto no nível global da empresa, a regra mais específica prevalece: o horário definido na fila tem prioridade sobre o horário geral da empresa. Além disso, cada canal tem o campo Controle de horário de atendimento (na edição do canal, em Administração → Canais), com três modos: Seguir horário da empresa (padrão), Ignorar horário (atender 24h) e Somente horário da fila (ignora o horário da empresa e os feriados).
6

Salve

Clique em Salvar: horários e feriados só passam a valer depois disso.
A opção Usar horários de atendimento do usuário (catálogo completo, categoria “Notificações”) permite ainda aplicar a jornada de trabalho individual de cada colaborador, em vez de depender apenas da agenda geral ou da fila.

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

A Convenção do 9º dígito (BR) tem duas regras disponíveis:
  • 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.
Se um envio falhar por número inexistente, o sistema tenta automaticamente a variante com/sem o 9. Com Validar Contato desligada, nenhuma correção automática é aplicada.

Carteira e acesso a dados

Os 3 modos de Senha de novos usuários são:
  • 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. Cada campo pode seguir o padrão geral ou ter um valor só da sua empresa. Para seguir o padrão, escolha Usar o padrão geral: abaixo do campo a tela mostra Herdado do padrão geral e o valor que está valendo. Sem escolha própria e sem padrão geral definido, valem Brasil, real e português. Como nas demais opções da tela, nada vale até você clicar em Salvar; a mudança vale a partir daí, as mensagens já enviadas não mudam e os outros usuários conectados veem a mudança quando abrirem o painel de novo.
Sugestão de moeda por país: ao escolher um país próprio e deixar a Moeda em Usar o padrão geral, se a moeda herdada não for a do país a tela mostra Moeda de (país): (moeda), com o botão Usar esta moeda. É só uma sugestão: nada é gravado sem você clicar em Salvar.
Valores já gravados (oportunidades, valor do atendimento, preço de serviço) não são convertidos: o número continua o mesmo e só a moeda exibida muda. Ao trocar a moeda, revise esses valores.
Idioma das mensagens ao cliente e idioma da tela: quem nunca escolheu um idioma para a tela também passa a ver o painel neste idioma na próxima vez que abrir; quem já escolheu continua com o seu. Textos automáticos já gravados: trocar o idioma não reescreve os textos automáticos que já estão gravados. Para isso, use o botão Aplicar textos padrão no idioma, que passa para o idioma salvo os textos que ainda estão iguais ao padrão: pesquisa de satisfação e as notas dela, aviso de chamada recusada, encerramento automático, posição na fila e mensagens de fora do horário. Os textos que você personalizou ficam como estão, e nenhuma mensagem é enviada aos clientes. O botão usa o idioma já salvo: se você acabou de trocar o idioma, a tela avisa Salve o idioma escolhido antes de aplicar os textos padrão. Depois de salvar uma troca de idioma, a tela também oferece esse botão num aviso. A tela pede confirmação e, ao terminar, informa quantos textos passaram para o novo idioma e quantos personalizados foram mantidos.
O Idioma das respostas de IA (página Bots e IA) é um campo à parte: ele só orienta o que a IA escreve. Por padrão ele fica em Seguir a Região e acompanha o Idioma das mensagens ao cliente definido aqui, mas pode ser fixado em outro idioma.

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.
As ações Atualizar Data dos Tickets, Normalizar datas de aniversário, Consolidar duplicatas LID e Corrigir Instagram IGSID (>2^53) só aparecem para o perfil Administrador. Quem acessa as Configurações com um Perfil Personalizado vê só as outras cinco.
Validar Todos os Contatos e Scan de Contatos sem Lid percorrem a base inteira. A própria tela avisa: validar muitos números de uma vez pode causar o bloqueio do WhatsApp, e o scan, em bases muito grandes, pode demorar ou acionar o bloqueio da conta.
Consolidar duplicatas LID altera dados em massa: move atendimentos, mensagens e relacionamentos para o contato principal e deixa o contato duplicado marcado como mesclado e bloqueado (apesar de a tela falar em excluir, o cadastro não é apagado: é isso que permite desfazer). Antes de começar, a tela exige confirmar que foi feito backup do banco de dados e que você está ciente dos riscos; em seguida, Rodar auditoria (DRY_RUN) lista os pares encontrados antes de qualquer alteração. Mesclagens com trilha de auditoria podem ser desfeitas em Reverter mesclagens, da mais recente para a mais antiga. Na coluna Origem da lista, cada mesclagem indica de onde veio, como Convite do Telegram ou Automática (WhatsApp oficial) (quando o sistema juntou sozinho o cadastro que só tinha o identificador do WhatsApp oficial com o cadastro do mesmo cliente que tem o telefone; se estiver errado, use Reverter). A reversão é recusada quando o número do contato mesclado já pertence a outro contato (por exemplo, criado por uma mensagem nova desse número): mescle ou edite esse outro contato antes. Por ser uma operação sensível, combine a execução com o suporte do PanÐá Zap.

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.
1

Descubra o ID de cada cadastro

Abra a página do contato (Ver perfil completo nos detalhes do contato do atendimento, aba Perfil, ou clique no nome em Contatos) e copie o número que aparece no endereço do navegador depois de /contatos/. O cadastro que fica é o que tem o telefone real; o duplicado é o que tem o código no lugar do número.
2

Encerre o atendimento do cadastro duplicado

Se os dois cadastros têm atendimento aberto ou pendente no mesmo canal, encerre o do cadastro duplicado pelo atalho Resolver do card na lista de atendimentos (encerra na hora, sem mensagem de despedida nem pesquisa de satisfação). Com os dois abertos, a mesclagem não é aplicada.
3

Rode a auditoria

Em Configurações → Gerais → Geral, seção Ações do Sistema, abra Consolidar duplicatas LID, marque Confirmo que fiz backup do banco de dados e Estou ciente dos riscos e quero prosseguir e clique em Rodar auditoria (DRY_RUN), que só consulta e não altera nada. As duas confirmações existem porque a ferramenta também faz mesclagens em lote (Mesclagem em lote (CSV)); a mesclagem manual mexe em um par só e pode ser desfeita.
4

Mescle o par

Na tela do resultado, no quadro Mesclagem manual de par, preencha ID primary (mantém) com o cadastro que fica e ID duplicate (mescla) com o duplicado e clique em Mesclar. Deu certo quando aparece Consolidado: N tickets, N mensagens movidos.
Não clique em Consolidar N pares (APPLY) para juntar um par: esse botão mescla de uma vez todos os pares da lista, inclusive os de Pushname (mesmo nome de perfil), que podem ser pessoas diferentes. Se clicar por engano, desfaça em Reverter mesclagens.
O que acontece depois da mesclagem:
  • 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.
1

Acesse a tela

No menu lateral, em Configuração, clique em API.
2

Crie uma nova integração

Clique no botão Nova API no canto superior direito.
3

Nomeie a integração

No modal exibido, dê um Nome identificador para a integração (por exemplo, “CRM Vendas”).
4

Selecione a Sessão

Selecione a Sessão (o canal) que será usada por esta API. A sessão não pode ser alterada depois da criação. Canais como Telegram, Instagram, Messenger, Webchat, Hub e E-mail aceitam as rotas de mensagens, tickets, contatos e as funcionalidades gerais; rotas exclusivas do WhatsApp (grupos, templates WABA e interativos) não se aplicam a eles.
5

Salve

Clique em Salvar.
6

Copie o token agora

O token completo aparece uma única vez, na janela exibida logo após salvar. Copie e guarde em local seguro antes de clicar em Já copiei, fechar: depois disso ele não pode ser recuperado (a listagem mostra só o Prefixo do token). Se perder o token, use Gerar novo token.
7

Autentique as chamadas

Para usar a API, autentique todas as chamadas com o cabeçalho HTTP:
8

Teste no Sandbox

No Sandbox, selecione a API, cole o token completo no campo Token, preencha os parâmetros da rota desejada e clique em Enviar para ver a resposta do servidor na tela. Nas rotas que têm um código no endereço (por exemplo, o número de um agente ou de um evento), preencha os campos de Parâmetros do caminho: enquanto faltar algum, Enviar fica bloqueado e a tela avisa Preencha os parâmetros do caminho para enviar. Ao testar uma rota que exclui ou remove algo, o Sandbox pede confirmação antes (Excluir de verdade? Este teste executa a exclusão na sua instalação e não pode ser desfeito.): clique em Excluir para executar ou em Cancelar para desistir.
9

Configure Webhooks (opcional)

Para receber eventos em tempo real (mensagens e atendimentos, status de envio das mensagens do WhatsApp oficial direto, criação e atualização de canais, usuários, contatos, oportunidades e APIs), configure a URL de destino em Configurações → Integrações → Webhooks.
Benefícios e quando usar: use a API quando precisar automatizar o disparo de mensagens a partir de um evento de outro sistema (por exemplo, disparar uma mensagem de boas-vindas quando um negócio for marcado como “Fechado” no CRM), sincronizar cadastros de usuários e filas, ou construir integrações sob medida que a interface visual do PanÐá Zap não cobre. Os Webhooks, por sua vez, evitam que seu sistema externo precise “ficar perguntando” ao PanÐá Zap se algo mudou: o próprio PanÐá Zap avisa automaticamente quando o evento acontece.
Uma API por canal: cada integração criada em ”+ Nova API” fica vinculada a uma única Sessão (canal de WhatsApp). Se você precisa disparar por mais de um número, é necessário criar uma API separada para cada canal: não é possível reutilizar a mesma chave/token para múltiplos canais.
Dicas e observações importantes:
  • 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.
1

Acesse o Log de Auditoria

No menu lateral, em Configuração, clique em Log de Auditoria.
2

Filtre o evento

Para localizar um evento específico, use os filtros de Ação (Todas as ações, Criar, Atualizar, Deletar, Entrar, Sair, Testar, Migrar, Reparar e Abrir), Entidade (campo de texto, por exemplo 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).
3

Aplique o filtro

Clique em Filtrar para atualizar a listagem. Para remover os filtros, use o ícone X ao lado.
4

Leia a tabela de resultados

Cada linha mostra a Ação (badge amigável), o Método HTTP técnico (POST = criar, PUT = atualizar, DELETE = excluir), o Caminho (rota do sistema onde a ação ocorreu), o Status (código de resposta, onde 200 indica sucesso) e o IP de origem. As mudanças de perfil e de permissões de usuários aparecem com rótulos próprios, em violeta: Definir perfil, Definir permissões, Definir menus, Definir perfil personalizado, Ligar/desligar perfis personalizados, Criar perfil personalizado, Alterar perfil personalizado e Excluir perfil personalizado (esses rótulos não estão na lista do filtro Ação).
5

Veja os detalhes técnicos

Clique em Ver detalhes (ícone de olho) para abrir a janela Detalhes do Log, com usuário, ação, entidade, status, IP, navegador utilizado (User-Agent) e o Corpo da Requisição (os dados enviados naquela operação).
6

Exporte, se necessário

Aplique os filtros do período desejado e clique no ícone de download (Exportar CSV) ao lado do botão Filtrar: um CSV é gerado com o histórico filtrado.
Benefícios e quando usar: use o Log de Auditoria sempre que precisar investigar uma alteração indevida (por exemplo, um ticket importante encerrado por engano): filtrando pela entidade 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.
Os logs de auditoria são gerados automaticamente e não podem ser editados ou excluídos, o que garante a integridade da informação para fins de fiscalizaçã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.
1

Exporte a conversa no celular

No próprio celular, exporte a conversa desejada: WhatsApp Business → Configurações → Conversas → Histórico de conversas → Exportar conversa. Salve o arquivo .zip gerado.
2

Acesse a ferramenta de importação

No painel, acesse Configurações → Gerais → Importar histórico.
3

Selecione o Canal de Destino

Escolha em qual das suas Conexões ativas essas mensagens serão associadas: o histórico aparecerá vinculado a esse número no sistema.
4

Defina o Contato

Informe o número do contato com quem a conversa foi realizada, usando apenas dígitos, no formato DDI + DDD + Número (por exemplo, o padrão brasileiro seria 55 + DDD + número, tudo junto, sem espaços ou símbolos). Se o contato ainda não existir na base, o sistema cria um novo cadastro automaticamente durante o processo. Se preferir, use o botão de busca (Buscar contato existente) para localizar um contato já cadastrado por nome ou número.
5

Faça o upload do arquivo

Clique em Escolher arquivo .zip e envie o arquivo exportado. O sistema aceita arquivos que contenham o .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.
6

Confirme quem é a sua empresa

Em Qual remetente representa sua empresa (você), confira o remetente detectado automaticamente (marcado como “(detectado)”) ou escolha outro. Isso define quais mensagens aparecem como enviadas pela sua empresa.
7

Importe

Clique em Importar histórico, no canto inferior direito. O sistema processa as mensagens e as distribui cronologicamente no chat do contato. Ao final, o resumo mostra as mensagens criadas, as ignoradas e as mídias copiadas, com o botão para abrir o ticket criado.
Regras automáticas aplicadas à importação:
  • 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.
Benefícios e quando usar: ideal no momento de migração para a plataforma, para não perder o histórico de relacionamento já construído com os clientes fora do sistema. Também é útil para consolidar, num único lugar, conversas que ficaram fragmentadas entre o celular pessoal/corporativo e o painel.
Mensagens importadas não disparam nenhuma automação. Para evitar disparos indevidos e poluição de dados, os tickets criados por este método não acionam: ChatFlow/Chatbots, Inteligência Artificial, Webhooks externos ou integrações (como n8n), nem notificações push no navegador ou celular.
O tempo de processamento varia de acordo com o tamanho do arquivo .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.
Todas as regras aqui descritas são validadas tanto na interface quanto no servidor: um atendimento fora do alcance do usuário não pode ser aberto por link direto, notificação antiga ou qualquer outro atalho, o bloqueio acontece no back-end, não só na tela.

Como funciona por perfil (regra base, definida na criação do usuário)

Restrição por canal (vale para todos os perfis, exceto Administrador): um usuário com canais específicos atribuídos no cadastro só acessa esses canais, os demais ficam bloqueados também no servidor, não apenas ocultos na tela. Sem nenhum canal atribuído no cadastro, o usuário vê todos os canais.
Regras complementares:
  • 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.
1

Ajuste as regras globais

Para as regras globais que afetam Atendentes e Supervisores de uma vez, acesse Configurações → Gerais e ajuste os campos relacionados a visibilidade, por exemplo Visualizar Tickets sem Atendente Atribuído (ativa, todos os usuários passam a ver os atendimentos que ainda não têm atendente, de qualquer fila ou sem fila, útil para identificar falhas no transbordo ou atendimentos esquecidos pela automação) e Ativar Filtro de tickets no socket (filtra as informações diretamente no servidor antes de enviá-las à tela, essencial em operações de alto volume, pois evita que tickets fora do escopo do usuário apareçam momentaneamente na lista ou causem lentidão no carregamento).
2

Refine por usuário

Para refinar a visibilidade por usuário, acesse Administração → Usuários e edite o cadastro individual:
  • 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.
Resumo prático de combinações (o que o Atendente enxerga): Benefícios e quando usar: use estas regras para equilibrar dois objetivos que competem entre si: dar contexto suficiente ao atendente (visão de fila, de carteira) e, ao mesmo tempo, proteger a privacidade de conversas entre setores ou evitar que um atendente “roube” o atendimento de outro colega sem querer. Times grandes, com múltiplas filas (Vendas, Suporte, Financeiro), costumam se beneficiar de regras mais restritivas; times pequenos tendem a preferir visão mais aberta. Dicas e observações importantes:
  • 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.
1

Acesse Configurações Gerais

Acesse Configurações → Gerais.
2

Habilite a opção

Habilite a opção Transbordo de Mensagens.
3

Salve

Salve a alteração.
A lógica de redistribuição, passo a passo (o que acontece quando um ticket carteirizado recebe uma nova mensagem):
  1. 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.
  2. 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.
  3. 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.
  4. 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.
Benefícios e quando usar: essencial em operações que usam carteira de clientes (atendente fixo por contato) mas não têm cobertura 24/7: evita que um cliente fique esperando resposta só porque seu atendente titular está offline no momento, sem abrir mão de uma distribuição justa entre quem está disponível. Dicas e observações importantes:
  • 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”.
1

Acesse a configuração

Entre em Configurações → Geral.
2

Localize o campo

Localize a linha Tipo de Listagem de Mensagens.
3

Escolha a opção

Escolha uma das 5 opções do menu suspenso.
4

Aplicação imediata

A mudança é aplicada imediatamente para todos os usuários da empresa, sem precisar recarregar a página: vale a partir do próximo carregamento de conversa (não é necessário deslogar; basta voltar à lista de tickets e reabrir a conversa).
O valor inicial, quando a empresa nunca alterou essa opção, é Padrão.

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.
Mensagens que entraram antes de o ticket ser atribuído a uma fila (por exemplo, mensagens trocadas com o bot antes da distribuição) ficam sem fila de origem e, na opção “Histórico por Fila”, são ocultadas para atendentes não admin. Se a empresa depende de visualizar o histórico do chatbot pré-fila, essa opção pode esconder esse trecho.
Indicada para operações multifila com separação clara entre equipes (ex.: Vendas, Suporte, Financeiro), onde mensagens de uma fila não devem vazar para atendentes de outra. 3. Histórico Completo Mostra todas as mensagens trocadas com aquele contato, naquele canal, independentemente de fila e de ticket. Funciona como um único histórico contínuo por contato/canal, parecido com abrir uma conversa no WhatsApp pessoal. Não faz distinção por perfil (admin e atendente comum veem o mesmo conjunto de mensagens), e a opção Mostrar histórico de mensagens é ignorada. Indicada quando a empresa não tem requisitos de privacidade entre filas e quer dar contexto máximo ao atendente. 4. Histórico por Ticket Mostra somente as mensagens do ticket aberto no momento. Trocou de atendimento, trocou de histórico: mesmo que seja o mesmo contato, atendimentos antigos não aparecem. Não diferencia por perfil, e a opção Mostrar histórico de mensagens é ignorada. Indicada para atendimento estilo “protocolo” ou “helpdesk”, onde cada caso é tratado isoladamente e cruzar contexto de atendimentos passados é considerado indesejável (por exemplo, para evitar viés do atendente ou por regra de auditoria). 5. Histórico por Usuário Cada atendente vê só a própria conversa com o contato: respostas e notas de outros atendentes ficam ocultas. Administradores e Supervisores com visão de administrador veem tudo. Indicada quando cada atendente deve enxergar apenas o que ele mesmo conversou com o cliente.

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.
Sobre o Supervisor: na opção Histórico por Fila, mesmo o Supervisor com visão de administrador (opção Remover privilégios de visualização do supervisor desligada) continua sendo tratado como atendente comum. Se ele precisa enxergar tudo, o caminho é usar Histórico Completo para a empresa toda. Já na opção Histórico por Usuário, o Supervisor com visão de administrador vê tudo.

Benefícios e quando usar

Dicas e observações importantes:
  • 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).
1

Acesse Configurações Gerais

Acesse Configurações → Gerais → Geral, categoria Atendimento e Recursos, bloco Reabertura e agendamento.
2

Ative a chave

Ative Carência pós-atendimento: o campo Tempo de carência aparece na sequência (ao ligar, vem com 1 minuto).
3

Informe o tempo

Digite o valor e escolha a unidade: Segundos ou Minutos.
4

Escolha o destino

Em Para quem enviar, escolha para onde a conversa volta: Atendente anterior (padrão), Quem encerrou, Fila específica, Atendente específico ou Chatbot específico. Nas três últimas opções, selecione a fila, o atendente ou o chatbot no campo que aparece logo abaixo.
5

Salve

Clique em Salvar.
Como funciona na prática, por cenário: Benefícios e quando usar: evita que uma dúvida de última hora do cliente, logo após o encerramento, precise passar de novo pela triagem do chatbot ou pela fila de pendentes: mantém a continuidade com quem já conhece o caso. Útil em operações onde o mesmo assunto costuma gerar uma segunda mensagem rápida do cliente (uma confirmação, um agradecimento com nova pergunta, etc.). Dicas e observações importantes:
  • 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.
1

Acesse a tela de SMTP

Acesse Configurações → Gerais → SMTP.
2

Reúna os dados do provedor

Reúna previamente os dados técnicos fornecidos pelo seu provedor de e-mail (host, porta, usuário e senha).
3

Habilite o SMTP

Ative a chave Habilitar SMTP para permitir que o sistema use o servidor informado.
4

Preencha o formulário

Preencha os campos abaixo com os dados do seu provedor:
5

Salve antes de testar

Clique em Salvar: isso é obrigatório antes de testar, pois o sistema precisa armazenar as credenciais primeiro.
6

Teste o envio

Clique em Testar, no topo superior direito. No modal exibido, informe um e-mail de destino válido e clique em Enviar teste. Verifique a caixa de entrada (e a pasta de Spam) do endereço informado para confirmar o recebimento.
7

Revise em caso de falha

Se o teste falhar, revise host, porta e credenciais antes de tentar novamente. Quando a senha já salva aparece oculta, o campo Senha mostra Valor salvo e oculto por segurança. Para trocar, digite um novo. e o campo Host lembra que Trocar o servidor apaga a senha salva; depois, digite a senha de novo. Para testar com outro servidor, porta ou usuário, digite a senha: sem ela, o teste avisa Para testar com outro servidor, porta ou usuário, digite a senha.
Benefícios e quando usar: configure o SMTP do tenant sempre que quiser que as comunicações automáticas do sistema (recuperação de senha, notificações, convite de novos usuários por e-mail) saiam com o domínio/endereço da própria empresa cliente, em vez de um remetente genérico. É pré-requisito direto para a opção Convite por e-mail da configuração “Senha de novos usuários” (ver catálogo completo, categoria “Carteira e acesso a dados”).
Para contas Gmail ou Outlook com verificação em duas etapas habilitada, utilize uma Senha de Aplicativo gerada no painel da própria conta de e-mail, em vez da senha normal de login.
Dicas e observações importantes:
  • 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.
1

Acesse o subitem A2F

No menu lateral, clique em Configurações, selecione a aba Gerais e clique no subitem A2F.
2

Habilite o A2F

Ative o toggle Habilitar A2F para que o sistema passe a exigir a verificação adicional de todos os usuários no momento do login.
3

Escolha o canal

Em Canal, escolha por qual meio o código de segurança será enviado: WhatsApp, E-mail ou SMS.
4

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.
5

Configure a mensagem de segurança

No campo Mensagem, use a tag {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.
6

Salve

Clique em Salvar, no canto superior direito, para aplicar as regras.
Fluxo do usuário final (como cada colaborador vai experimentar o login depois de ativado):
  1. O usuário insere e-mail e senha na tela de login, normalmente.
  2. 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).
  3. Uma nova tela surge no navegador solicitando o código recebido.
  4. O acesso ao painel só é liberado após a inserção correta dos dígitos.
Benefícios e quando usar: recomendado para qualquer tenant que lide com dados sensíveis de clientes ou queira reduzir o risco de invasão por senha vazada/reutilizada: a exigência de um segundo fator torna o simples roubo de senha insuficiente para um acesso indevido. Como afeta login de todos os perfis, é uma decisão de segurança que vale a pena comunicar previamente à equipe (Supervisores e Atendentes também terão que confirmar o código a cada novo login).
Conectividade do canal é crítica: o canal escolhido para enviar os códigos de A2F precisa estar permanentemente conectado e, no caso de SMS ou WABA, com saldo disponível. Se essa conexão cair, os usuários podem ficar impedidos de logar no sistema até a reconexão.
Dicas e observações importantes:
  • 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:
Endpoint:
Use a URL de integração exibida na tela API: ela já traz o domínio e o número da sua API. Corpo da requisição (exemplo):
Para listar usuários, consultar o status e atualizar cadastros (filas, canais e demais dados), veja API de Usuários.
O comportamento do campo 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.