Referência
Permissões por papel
O que Administrador, Gestor, Atendente e Leitor podem ver e fazer em cada página do Zynzap.
Cada pessoa da equipe tem um papel por empresa. O papel define o que ela vê no menu e o que pode fazer. A autorização é sempre conferida no servidor: esconder um item do menu é só conveniência.
Os quatro papéis
| Papel | Resumo |
|---|---|
| Administrador | Acesso total, inclusive cobrança, equipe, chaves de API e configurações. |
| Gestor | Opera números, conversas, campanhas, contatos e automações. Sem cobrança nem equipe. |
| Atendente | Atende as conversas dos números liberados, com respostas prontas e mídias. Não exporta nem importa a base. |
| Leitor | Consulta painéis, números e conversas, sem enviar nem alterar nada. |
Atendente vê só os números liberados
O atendente é o único papel limitado por número: ele enxerga apenas conversas, eventos e chamadas dos números liberados para ele em Equipe. Administrador, gestor e leitor veem todos os números da empresa.
Páginas por papel
✅ acessa · 👁️ somente consulta · — não aparece
| Página | Administrador | Gestor | Atendente | Leitor |
|---|---|---|---|---|
| Visão geral | ✅ | ✅ | — | 👁️ |
| Atendimento | ✅ | ✅ | ✅ (números liberados) | 👁️ |
| Funil | ✅ | ✅ | ✅ (números liberados) | 👁️ |
| Tarefas | ✅ | ✅ | ✅ | 👁️ |
| Indicadores | ✅ | ✅ | ✅ (seus números: Atendimento, Funil e Chamadas) | 👁️ |
| Dispositivos | ✅ | ✅ | 👁️ | 👁️ |
| Enviar mensagem | ✅ | ✅ | — | — |
| Campanhas | ✅ | ✅ | — | — |
| Aquecimento | ✅ | ✅ | — | — |
| Listas, Segmentos, Recuperação | ✅ | ✅ | — | — |
| Contatos | ✅ | ✅ | — | — |
| Configurações do CRM | ✅ | ✅ | — | — |
| Grupos | ✅ | ✅ | 👁️ | 👁️ |
| Diálogos, Modelos | ✅ | ✅ | — | — |
| Mídias | ✅ | ✅ | — | — |
| Fluxos | ✅ | ✅ | — | — |
| Assistente IA | ✅ (configura o provedor) | ✅ (usa) | — | — |
| Equipe | ✅ (gerencia) | 👁️ | 👁️ | 👁️ |
| API e integrações | ✅ (vê e revoga todas as chaves) | ✅ (próprias chaves) | ✅ (próprias chaves) | ✅ (próprias chaves) |
| Plano e consumo | ✅ (compra e altera) | 👁️ | — | — |
| Perfil e segurança | ✅ (+ Dados da empresa) | ✅ | ✅ | ✅ |
Permissões técnicas (escopos)
As mesmas regras valem para chaves de API: uma chave nunca passa das permissões do papel de quem a criou.
| Escopo | O que libera | Adm. | Gestor | Atendente | Leitor |
|---|---|---|---|---|---|
dashboard:read | Números do painel | ✅ | ✅ | — | ✅ |
events:read | Eventos em tempo real | ✅ | ✅ | ✅ | ✅ |
messages:send | Enviar mensagens | ✅ | ✅ | ✅ | — |
messages:revoke | Apagar mensagem para todos | ✅ | ✅ | ✅ | — |
messages:view_once | Mídias de visualização única | ✅ | ✅ | ✅ | — |
groups:read | Ver grupos | ✅ | ✅ | ✅ | ✅ |
groups:manage | Gerenciar grupos | ✅ | ✅ | — | — |
sessions:read | Ver dispositivos | ✅ | ✅ | ✅ | ✅ |
sessions:manage | Conectar/desconectar/excluir dispositivos | ✅ | ✅ | — | — |
product:inbox | Atendimento, funil, tarefas, indicadores | ✅ | ✅ | ✅ | ✅ (leitura) |
product:contacts | Contatos e CRM completo | ✅ | ✅ | — | — |
product:campaigns | Campanhas, listas, segmentos, recuperação | ✅ | ✅ | — | — |
product:warmup | Aquecimento | ✅ | ✅ | — | — |
product:media | Biblioteca de mídias e envio avulso | ✅ | ✅ | — | — |
product:templates | Modelos e diálogos | ✅ | ✅ | — | — |
product:flows | Fluxos (bots) | ✅ | ✅ | — | — |
product:ai | Assistente IA | ✅ | ✅ | — | — |
product:ai:manage | Configurar o provedor de IA | ✅ | — | — | — |
Recursos do painel (fora dos escopos)
| Recurso | Quem pode |
|---|---|
| Ver cobrança | Administrador, Gestor |
| Comprar, contratar e alterar cobrança | Administrador |
| Aprovar acesso de suporte | Administrador |
| Ver a equipe | Todos |
| Convidar, alterar e remover membros | Administrador |
| Criar chaves de API próprias | Todos (exige 2FA) |
| Ver e revogar chaves de toda a empresa | Administrador |
| Configurar IA | Administrador |
| Auditoria e Dados da empresa | Administrador |