Como Configurar Times e Permissões

Tutorial Interativo

Em breve: Vídeo interativo com Clueso estará disponível aqui. Por enquanto, siga o guia passo a passo abaixo.

Visão Geral

O sistema de times do gu1 permite organizar sua equipe e controlar o acesso a dados dentro da organização:

Segmentação de dados: Cada time vê apenas suas próprias entidades e alertas
Colaboração focada: Membros trabalham juntos em casos específicos
Controle de acesso: Permissões granulares por perfil e time
Métricas por time: Acompanhe performance e produtividade

Recomendação: Organize times por cliente, produto, região ou função (ex: Onboarding, Monitoramento, Fraude).

Estrutura Hierárquica

Organização
├── Admin (acesso total)
├── Time A: Onboarding LATAM
│   ├── Lead (Analyst)
│   ├── Analyst 1
│   ├── Analyst 2
│   └── Viewer (Consultor externo)
├── Time B: Monitoramento Transacional
│   ├── Lead (Analyst)
│   ├── Analyst 1
│   └── Analyst 2
└── Time C: Fraude e AML
    ├── Senior Analyst
    ├── Analyst 1
    └── Analyst 2

Importante: Usuários Admin têm acesso a todos os dados da organização, independentemente do time. Use esse perfil com cuidado.

Criando um Time

Acesse Team Settings

Navegue até Settings > Teams no menu lateral.

Clique em 'Create Team'

Botão no canto superior direito (azul).

Preencha as Informações

Informações básicas:

Nome: Nome descritivo (ex: “Onboarding - Brasil”)
Slug: Identificador único (auto-gerado, editável)
Descrição: Propósito do time (opcional, mas recomendado)

Tipo de time:

Operational: Times de análise e operações diárias
Compliance: Times focados em compliance e auditoria
Fraud: Especialistas em detecção de fraude
Custom: Outro tipo personalizado

Configure Permissões (Opcional)

Permissões avançadas:

Pode criar regras?
Pode aprovar/rejeitar entidades?
Pode visualizar dados de outros times?
Pode exportar dados?

Por padrão, permissões são herdadas do perfil do usuário (Admin, Analyst, Viewer). Configure aqui apenas se precisar de exceções.

Adicione Membros

Selecione usuários existentes da organização
Ou envie novos convites diretamente
Defina um Team Lead (opcional)

Salve

Clique em Create Team para finalizar.

Tipos de Times

Operational

Times de operação diária

Onboarding de clientes
Análise de transações
Revisão de alertas
KYC/KYB padrão

Permissões típicas:

Criar e editar entidades
Resolver alertas
Criar investigações

Compliance

Compliance e auditoria

Revisão de políticas
Auditoria de decisões
Relatórios regulatórios
Enhanced Due Diligence

Permissões típicas:

Visualizar todos os dados
Aprovar/rejeitar decisões críticas
Exportar relatórios
Configurar regras

Fraud

Detecção e investigação de fraude

Análise de padrões suspeitos
Investigações complexas
Casos de alto risco
Colaboração com autoridades

Permissões típicas:

Acesso a ferramentas avançadas
Criar investigações prioritárias
Visualizar grafos de relacionamento
Executar integrações externas

Custom

Times personalizados

Projetos especiais
Clientes específicos
Testes e homologação
Consultores externos

Permissões típicas:

Configuradas caso a caso
Podem variar muito
Geralmente mais restritivas

Gerenciando Membros

Adicionar Membros a um Time

Durante Convite
Usuário Existente
Em Lote

Ao convidar um novo usuário:

Vá em Settings > Team > Invite Member
Preencha email e perfil
Selecione o(s) time(s) no dropdown “Assign to Teams”
Envie o convite

O usuário já entrará nos times selecionados ao aceitar.

Para adicionar múltiplos usuários:

Settings > Teams > Time específico
Tab “Members” > “Bulk Add”
Selecione múltiplos usuários (com Ctrl/Cmd + clique)
Clique em Add Selected

Ou use a API:

curl -X POST https://api.gu1.ai/teams/{team_id}/members/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "user_ids": ["uuid1", "uuid2", "uuid3"]
  }'

Remover Membros

Atenção: Remover um usuário de todos os times não revoga seu acesso à organização. Para remover completamente, vá em Settings > Team (membros) > Remove from Organization.

Para remover de um time específico:

Settings > Teams > Time específico
Tab “Members”
Clique nos três pontos ao lado do usuário
Remove from Team

Perfis e Permissões

Matriz de Permissões

Ação	Admin	Analyst	Viewer
Visualizar entidades do time	✅	✅	✅
Visualizar outras entidades	✅	❌	❌
Criar entidades	✅	✅	❌
Editar entidades	✅	✅	❌
Deletar entidades	✅	❌	❌
Criar alertas	✅	✅	❌
Resolver alertas	✅	✅	❌
Criar investigações	✅	✅	❌
Aprovar/Rejeitar	✅	✅*	❌
Criar regras	✅	✅**	❌
Publicar regras	✅	❌	❌
Configurar integrações	✅	❌	❌
Gerenciar times	✅	❌	❌
Gerenciar membros	✅	❌	❌
Ver relatórios do time	✅	✅	✅
Ver relatórios gerais	✅	❌	❌
Exportar dados	✅	✅***	❌
Configurar webhooks	✅	❌	❌
Gerenciar API keys	✅	❌	❌

*Requer aprovação de Admin para casos críticos **Pode criar, mas não publicar ***Apenas dados do próprio time

Permissões Personalizadas

Como configurar permissões granulares

Para casos especiais, você pode configurar permissões customizadas:

Settings > Teams > Time específico
Tab “Permissions”
Habilite “Custom Permissions”
Configure cada permissão individualmente:

{
  "entity": {
    "create": true,
    "read": true,
    "update": true,
    "delete": false,
    "crossTeamView": false
  },
  "alert": {
    "create": true,
    "resolve": true,
    "dismiss": false,
    "assignToOthers": false
  },
  "investigation": {
    "create": true,
    "close": false,
    "approve": false
  },
  "rule": {
    "create": true,
    "publish": false,
    "delete": false
  },
  "report": {
    "view": true,
    "export": false,
    "crossTeamData": false
  }
}

Complexidade: Permissões customizadas aumentam a complexidade. Use apenas quando estritamente necessário.

Fluxos de Trabalho Colaborativos

Atribuição Automática de Alertas

Configure para distribuir alertas automaticamente entre membros do time:

Acesse Alert Routing

Settings > Alert Routing

Crie Regra de Roteamento

{
  "name": "Distribuir PEPs para time Compliance",
  "condition": {
    "alertType": "aml",
    "entityType": "person",
    "entityProperties": {
      "isPEP": true
    }
  },
  "action": {
    "assignTo": {
      "team": "compliance-team",
      "strategy": "round_robin"
    }
  }
}

Estratégias de distribuição:

round_robin: Distribuição uniforme (revezamento)
least_busy: Atribui para quem tem menos alertas pendentes
random: Aleatório
skill_based: Baseado em expertise (requer configuração)

Teste a Regra

Use o simulador para validar antes de ativar.

Ative

Clique em Enable Rule.

Escalação Automática

Configure para escalar casos não resolvidos:

{
  "name": "Escalar alertas High não resolvidos",
  "trigger": {
    "alertPriority": "high",
    "status": "in_review",
    "ageInHours": 24
  },
  "action": {
    "escalate": {
      "to": "senior-analysts",
      "notify": true,
      "message": "Alerta não resolvido há 24h"
    }
  }
}

Notificações do Time

Configure canais de comunicação para o time:

Slack

Integração com Slack

Settings > Integrations > Slack
Conecte seu workspace
Escolha canal (ex: #compliance-alerts)
Configure eventos:
- Novo alerta crítico
- Investigação criada
- Decisão tomada

Microsoft Teams

Integração com Teams

Settings > Integrations > Teams
Conecte seu tenant
Escolha canal (ex: “Fraude - Alertas”)
Configure eventos (similar ao Slack)

Email

Notificações por email

Settings > Notifications > Email
Configure templates
Escolha frequência:
- Instantâneo
- Digest diário
- Digest semanal

Webhook

Sistema customizado

Settings > Webhooks
Configure endpoint
Escolha eventos
Teste a integração

Métricas por Time

Acompanhe performance em Reports > Team Analytics:

KPIs Principais

Produtividade
Qualidade
Colaboração
Risco

Alertas resolvidos (por dia/semana)
Tempo médio de resolução (por prioridade)
Backlog (alertas pendentes)
Taxa de throughput (alertas/analista/dia)
Horários de pico (quando mais alertas são resolvidos)

Comparação entre Times

Benchmarking: Compare métricas entre times para identificar melhores práticas e oportunidades de melhoria.

Performance Comparison - Últimos 30 dias

┌─────────────────┬───────────┬───────────┬──────────┐
│ Time            │ Alertas   │ Avg Time  │ False +  │
├─────────────────┼───────────┼───────────┼──────────┤
│ Onboarding LATAM│ 1,245     │ 3.2h      │ 18%      │
│ Monitoramento   │ 2,891     │ 5.7h      │ 34%      │ ⚠️
│ Fraude e AML    │ 456       │ 8.1h      │ 12%      │
└─────────────────┴───────────┴───────────┴──────────┘

Insights:
⚠️ Time "Monitoramento" tem alta taxa de falsos positivos
   → Sugestão: Revisar regras para reduzir ruído

✅ Time "Fraude e AML" tem melhor precisão
   → Documentar melhores práticas e compartilhar

Boas Práticas

Tamanho Ideal de Time

Recomendação: 5-10 membros por time

Muito pequeno (< 3): Falta de redundância, alto risco de gargalo
Ideal (5-10): Boa colaboração, distribuição de carga, cobertura
Muito grande (> 15): Dificuldade de coordenação, perda de foco

Se seu time crescer muito, considere dividir por:

Cliente/produto
Região geográfica
Tipo de risco (KYC, AML, Fraude)

Rotação de Casos

Evite sobrecarga distribuindo casos uniformemente:

Use round-robin para distribuição inicial
Monitore carga por analista em Team Dashboard
Reatribua casos se alguém estiver sobrecarregado
Configure escalação automática para casos antigos

{
  "max_concurrent_alerts_per_analyst": 15,
  "auto_reassign_after_hours": 48,
  "vacation_mode": {
    "enabled": true,
    "redirect_to": "team_lead"
  }
}

Onboarding de Novos Membros

Checklist para novos analistas:

✅ Enviar convite com perfil correto (Viewer → Analyst após treinamento)
✅ Atribuir a time apropriado
✅ Compartilhar estes tutoriais interativos
✅ Dar acesso a casos arquivados para estudo
✅ Shadow: observar analista experiente por 1-2 dias
✅ Primeiro caso: atribuir alertas Low priority
✅ Revisão: Team lead revisa primeiras 10-20 decisões
✅ Autonomia: após aprovação, processar casos sozinho

Treinamento: Use modo Viewer por 1-2 semanas para novos membros se familiarizarem antes de dar permissões de edição.

Documentação Interna

Crie um playbook do time com:

Procedimentos padrão para cada tipo de alerta
Critérios de decisão (quando aprovar/rejeitar/escalar)
Contatos importantes (compliance officer, legal, etc.)
FAQs com casos comuns
Escalation matrix (quem contactar em cada situação)

Armazene em:

Wiki interna (Notion, Confluence)
Google Docs compartilhados
Ou use a seção “Team Notes” no próprio gu1

Revisões Periódicas

Agende reuniões regulares:Diárias (15 min - Stand-up):

Casos bloqueados
Alertas críticos
Ajuda necessária

Semanais (1h - Review):

Métricas da semana
Casos complexos resolvidos
Ajustes de regras
Feedback de processos

Mensais (2h - Retro):

Performance geral
Melhores práticas
Treinamentos necessários
Planejamento do próximo mês

Próximos Passos

Convidar Membros

Adicione sua equipe à organização

Criar Regras

Configure regras específicas para cada time

Gerenciar Alertas

Aprenda o workflow de revisão de alertas

API de Times

Gerencie times via API

Precisa de Ajuda?

Documentação: Navegue por nossas guias completas
Email: [email protected]
Dashboard: Acesse sua conta em app.gu1.ai

Última atualização: Janeiro 2025

Começando

Referência API

Ingestão de Dados

Entidades

Conheça Seu Negócio (KYB)

Conheça Seu Cliente (KYC)

Monitoramento de Transações

Tutoriais Interativos

​Tutorial Interativo

​Visão Geral

​Estrutura Hierárquica

​Criando um Time

​Tipos de Times

Operational

Compliance

Fraud

Custom

​Gerenciando Membros

​Adicionar Membros a um Time

​Remover Membros

​Perfis e Permissões

​Matriz de Permissões

​Permissões Personalizadas

​Fluxos de Trabalho Colaborativos

​Atribuição Automática de Alertas

​Escalação Automática

​Notificações do Time

Slack

Microsoft Teams

Email

Webhook

​Métricas por Time

​KPIs Principais

​Comparação entre Times

​Boas Práticas

​Próximos Passos

Convidar Membros

Criar Regras

Gerenciar Alertas

API de Times

​Precisa de Ajuda?

Tutorial Interativo

Visão Geral

Estrutura Hierárquica

Criando um Time

Tipos de Times

Gerenciando Membros

Adicionar Membros a um Time

Remover Membros

Perfis e Permissões

Matriz de Permissões

Permissões Personalizadas

Fluxos de Trabalho Colaborativos

Atribuição Automática de Alertas

Escalação Automática

Notificações do Time

Métricas por Time

KPIs Principais

Comparação entre Times

Boas Práticas

Próximos Passos

Precisa de Ajuda?