Papéis e permissões

As 25 permissões do ChatMade, os dois papéis que vêm prontos, como montar um papel sob medida e qual permissão abre qual tela.

Esta página é para quem decide quem vê o quê. No ChatMade, permissão não é dada pessoa a pessoa: você monta um papel com um conjunto de permissões e atribui esse papel a quem for.

Onde fica

Main Menu → Human Agents (“Menu principal → Atendentes humanos”), aba Roles (“Papéis”). Exige a permissão manage_users para chegar na tela, e manage_roles para criar, editar ou excluir papel.

Os dois papéis que vêm prontos

Nome	Descrição na tela	O que tem
Admin	“Full access to all features”	Todas as permissões
Agent	“Access to assigned chats and the unclaimed AI queue”	Quatro permissões: `view_assigned_chats`, `manage_assigned_chats`, `view_unassigned_chats`, `view_people`

O Agent é o papel padrão, e por isso é o único com a etiqueta Default: o botão Edit permissions (“Editar permissões”) dele fica desligado, com a dica “Cannot edit default role”, e não há botão de excluir.

Atenção: o Admin não é protegido. Ele pode ser editado e até excluído — o único bloqueio é não conseguir excluir um papel que esteja atribuído a alguém. Se você tirar permissão do Admin sem perceber, o resultado é uma organização em que ninguém consegue mais mexer em nada. Antes de editar o Admin, crie outro papel completo.

As 25 permissões

Chave	Descrição na tela
`view_all`	Can view all resources
`manage_users`	Can manage users
`manage_roles`	Can manage roles
`manage_agents`	Can manage chat agents
`view_agents`	Can view chat agents
`view_analytics`	Can view analytics
`view_assigned_chats`	Can view assigned chats only
`manage_assigned_chats`	Can manage assigned chats
`view_unassigned_chats`	Can view unassigned AI chats
`manage_knowledge`	Can manage knowledge base
`view_knowledge`	Can view knowledge base
`manage_ai_config`	Can manage AI configuration
`view_ai_config`	Can view AI configuration
`view_all_chats`	Can view all chat history
`manage_all_chats`	Can manage all chat sessions
`view_people`	Can view the people directory
`manage_organization`	Can manage organization settings
`view_organization`	Can view organization details
`manage_subscription`	Can manage subscription plans and billing
`view_subscription`	Can view subscription details
`view_tickets`	Can view tickets
`manage_tickets`	Can manage tickets
`approve_ticket_actions`	Can approve AI-proposed ticket resolutions
`manage_ticket_connectors`	Can manage ticket investigation connectors
`super_admin`	Has all permissions

Atenção: duas dessas permissões — manage_subscription e view_subscription — não fazem nada neste sistema. Elas pertencem a um módulo separado que não está presente, e a tela que elas controlariam não existe. Marcar ou desmarcar não muda nada. Sobram 23 permissões com efeito real.

Bom saber: na tela de edição de papel, o rótulo de cada caixa de marcação é a própria chave técnica — você lê view_assigned_chats, não “Ver conversas atribuídas”. Não existe tradução nem nome amigável. A descrição em inglês aparece embaixo, em letra menor. É por isso que esta tabela existe.

Criar um papel sob medida

Abra Main Menu → Human Agents (“Menu principal → Atendentes humanos”), aba Roles (“Papéis”).
Clique no cartão pontilhado Create a custom role (“Criar um papel sob medida”), com a linha “Pick exactly which permissions a group of agents gets”.
No modal Create Role, preencha Name (“Nome”, obrigatório) e Description (“Descrição”).
Na lista Permissions (“Permissões”), marque o que esse papel deve ter.
Clique em Create (“Criar”).

Sem nenhuma permissão marcada, você lê Please select at least one permission.

Cada cartão de papel mostra o nome, a descrição, e sob o título PERMISSIONS uma pastilha por permissão — de novo, pela chave técnica. Os botões são Edit permissions (“Editar permissões”) e Delete role (“Excluir papel”).

Qual permissão abre qual tela

Esta tabela é a que resolve a dúvida na prática. Basta uma das permissões listadas para o item aparecer no menu e a tela abrir.

Tela	Rótulo no menu	Permissões que abrem
Agentes de IA	AI Agents	`manage_agents` ou `view_agents`
Atendentes humanos	Human Agents	`manage_users`
Caixa de entrada	Inbox	`view_all_chats`, `view_assigned_chats` ou `view_unassigned_chats`
Chamados	Tickets	`view_tickets` ou `manage_tickets`
Pessoas	People	`view_people`, ou qualquer permissão de conversa
Conhecimento	Knowledge	`manage_knowledge` ou `view_knowledge`
Central de ajuda	Help center	`manage_knowledge`
Análises	Analytics	`view_analytics`
Organização	Organization	`manage_organization` ou `view_organization`
Chamados (configuração)	Ticketing	`manage_organization`
Integrações	Integrations	`manage_organization`
Aplicativos de widget	Widget Apps	`manage_organization`
Configuração de IA	AI Configuration	`manage_ai_config` ou `view_ai_config`
Configurações do usuário	User Settings	Todo mundo

Bom saber: a Central de ajuda exige manage_knowledge — a permissão de gerenciar, não a de ver. Quem tem só view_knowledge enxerga a base de conhecimento mas não a central de ajuda. É de propósito.

O menu e a checagem de acesso leem a mesma lista. Isso significa que um link visível nunca leva a uma recusa: se você vê o item, você entra.

As permissões que fazem coisas dentro da tela

Algumas permissões não abrem tela nenhuma — elas liberam ações:

manage_all_chats ou manage_assigned_chats — assumir e repassar conversa. Sem uma delas, a pessoa só lê.
manage_tickets — criar, editar, resolver e reabrir chamado. E também mandar resposta visível para o cliente: quem só tem view_tickets escreve nota interna, mas recebe erro ao tentar falar com o cliente.
approve_ticket_actions — aprovar ou rejeitar uma resolução proposta pela IA. É uma fronteira de confiança separada de propósito: gerenciar chamado no dia a dia não implica poder homologar o que a IA decidiu.
manage_ticket_connectors — gerenciar conectores de investigação.
super_admin — passa por cima de todas as checagens.

Atenção: a permissão manage_ticket_connectors tem uma pegadinha. A API aceita ela ou manage_organization para mexer em conector. Mas a tela onde os conectores ficam — Settings → Ticketing — só abre para quem tem manage_organization. Na prática, dar só manage_ticket_connectors a alguém não deixa essa pessoa chegar na tela. Se você quer que alguém configure conector pelo painel, dê manage_organization.

Papéis criados sozinhos

Se aparecerem na sua lista papéis com nomes como Agent (all chats) ou Admin (assigned only), com descrições no formato Agent, scoped to all chats, eles não vieram de você.

São gerados quando alguém marca as caixas Which chats can they see? (“Quais conversas essa pessoa vê?”) no formulário de usuário. O ChatMade procura um papel que dê exatamente aquele conjunto de permissões e, não achando, cria um.

Os quatro escopos são: all chats, all chats, no AI queue, assigned + AI queue e assigned only. Papéis com super_admin nunca são reescopados.

Excluir um papel

Botão Delete role (“Excluir papel”), com a confirmação “Are you sure you want to delete ‘{nome}’?” e “This action cannot be undone.”

Um papel atribuído a alguém não pode ser excluído — a resposta é Cannot delete role that is assigned to users. Mude as pessoas de papel antes.

Próximo passo

Veja como o time trabalha no dia a dia em Caixa de entrada.