Use este guia quando você precisar configurar, entender ou validar **Como gerenciar permissões por papel** na IAra.
## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

<!-- iara-context-media:agentes-times-papeis-seguranca-frame-003 -->
**Na tela:** As permissões por papel ficam em **Configurações > Funções personalizadas**.

![funções personalizadas.](https://app.digi2b.com/storage/file/4dyqfka1jw7k5aws2mp93g2m5z9m)

## Guia detalhado

Funções personalizadas são conjuntos de permissões reutilizáveis que você pode atribuir a colegas de equipe em seu espaço de trabalho IAra. Isso facilita a atualização de permissões para vários membros da equipe ao mesmo tempo.

## **Crie uma nova função personalizada**

Para criar uma nova função, vá para *Configurações > Funções personalizadas* e clique em **Adicionar função personalizada**.

Insira um nome, uma descrição e as permissões necessárias para sua função:

Escreva uma descrição clara que diga aos colegas de equipe exatamente quais permissões e habilidades essa função lhes concede na IAra.

Em seguida, salve sua nova função.

## Atribua funções aos seus colegas de equipe

Para atribuir uma função a um colega de equipe, acesse *Configurações > Agentes* e clique no **botão Editar** ao lado do colega de equipe cuja função você deseja alterar.

Para atribuir uma função ao seu colega de equipe, clique no **menu suspenso** em Funções e selecione a **função** desejada.

**Observação:** Seu colega de equipe deve estar vinculado a uma caixa de entrada antes de fazer essas alterações.

Em seguida, salve suas alterações.

## **Editar ou excluir funções personalizadas**

Para editar uma função, vá para *Configurações > Funções personalizadas* e clique no **botão Editar** ao lado da **função** que você deseja editar.

Edite o nome, a descrição e as permissões da função.

Para excluir uma função, vá para *Configurações > Funções personalizadas* e clique no **botão Excluir** ao lado da **função** que você deseja excluir.

Confirme para excluir a função.

## Visão geral dos níveis de permissão

Aqui estão os níveis de permissão disponíveis e seus escopos de acesso correspondentes:

### Detalhamento do nível de permissão:

* **Gerenciar todas as conversas**: acesso total a todas as conversas nas caixas de entrada atribuídas

* **Gerenciar conversas próprias e não atribuídas**: acesso somente a tarefas pessoais e conversas não atribuídas

* **Gerenciar conversas participantes**: acesso limitado a conversas atribuídas pessoalmente e participadas

* **Gerenciar contatos**: acesso total aos recursos de gerenciamento de contatos

* **Gerenciar relatórios**: acesso para visualizar relatórios

* **Gerenciar base de conhecimento**: acesso total para criar, editar e gerenciar conteúdo da base de conhecimento

Esses níveis de permissão podem ser combinados para criar funções personalizadas que atendam às necessidades específicas da sua equipe.

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.