Operação de vendas/atendimento raramente é solo. Convide vendedores, gerentes e atendentes pro Syncro com roles diferentes (admin / manager / viewer) e permissões granulares (departamento, pipeline, visibilidade de conversas). Esse artigo cobre como adicionar usuários, configurar permissões e o que cada role pode fazer.
Pré-requisitos
-Permissão admin pra criar/editar/excluir usuários.
-Plano com cota suficiente (max_users):
-Free: 1.
-Starter: 3.
-Growth: 10.
-Scale: 50+.
Acessar usuários
1.Configurações → Usuários (rota /configuracoes/usuarios).
2.Página mostra lista de users do tenant:
-Nome, e-mail, role, departamentos.
-Status (verificado / pendente).
-Última atividade.
3.Botão Novo usuário no canto superior direito.
Convidar novo usuário
1. Clique em Novo usuário
Drawer ou modal abre.
2. Preencha dados
Básicos
-Nome (obrigatório, max 100 chars): nome completo.
-E-mail (obrigatório, max 150, único no sistema inteiro): e-mail pessoal/profissional.
-Senha (obrigatório, min 8): temporária — user troca no 1° login.
-Role (obrigatório):
-admin — controle total.
-manager — gerencia leads/conversas.
-viewer — só visualiza.
Departamentos (opcional)
Multi-select: usuário pode estar em vários departamentos.
Departamentos filtram conversas e leads que o user vê. Se você não tem departamentos cadastrados, deixe vazio.
Veja Criar departamento.
Pipelines (opcional)
Multi-select: pipelines que o usuário pode acessar.
Vazio = todos os pipelines disponíveis. Útil quando você quer isolar vendedores por pipeline (ex: time A → pipeline Vendas; time B → pipeline Suporte).
Ver todas as conversas
Toggle Ver todas as conversas (can_see_all_conversations):
- Marcado (default): usuário vê todas conversas WhatsApp/Instagram do tenant.
- Desmarcado: vê apenas conversas: -Do departamento dele. -Atribuídas a ele.
Dica: pra vendedor júnior, desmarque — restringe visibilidade. Pra gerente, marque — vê tudo da equipe.
3. Salve
Sistema:
-Cria User com tenant_id do logged user.
-Hash da senha.
-email_verified_at = NULL — user precisa verificar e-mail.
-Gera verification_token válido por 48h.
-Envia e-mail de verificação automaticamente.
-Sincroniza departments + pipelines (relação many-to-many).
Toast: "Usuário criado!".
Roles em detalhe
Admin
Tudo libre. Pode:
- Criar/editar/excluir outros usuários (incluindo outros admins).
- Acessar
/configuracoes/cobranca,/configuracoes/api-keys. - Conectar/desconectar integrações (, Google, Facebook).
- Mudar plano, cancelar assinatura.
- Ver logs de auditoria.
- Tudo que manager pode.
Atenção: cada tenant precisa de pelo menos 1 admin. Sistema bloqueia exclusão do último admin.
Manager
Operacional. Pode:
- Gerenciar leads (criar, editar, excluir, mover).
- Gerenciar conversas (atribuir, transferir, fechar).
- Criar tarefas, eventos, automações, sequências, formulários.
- Ver relatórios.
- Disparar campanhas em massa.
- Não acessa Cobrança, API Keys, gerenciamento de usuários.
- Não conecta integrações de billing (cobrança).
Viewer
Read-only. Pode:
- Ver leads, conversas, tarefas, relatórios.
- Não cria nem edita nada.
- Composer do chat desabilitado (não envia mensagens).
- Não dispara campanhas.
Dica: Viewer é útil pra estagiário que está aprendendo, investidor querendo acompanhar, auditoria que precisa visualizar sem modificar.
Editar usuário existente
1.Em /configuracoes/usuarios, clique no nome ou ícone editar.
2.Drawer abre com dados atuais.
3.Modifique:
-Nome.
-E-mail (cuidado — re-verificação).
-Role.
-Departamentos.
-Pipelines.
-can_see_all_conversations.
4.Salve.
Atenção: você não pode editar seu próprio role (segurança). Pra mudar, peça pra outro admin.
Excluir usuário
1.Lista → ícone lixeira.
2.Confirma.
3.Sistema:
-Verifica se não é você mesmo (bloqueia auto-exclusão).
-Verifica se não é último admin (bloqueia).
-Verifica tenant_id (impede excluir user de outro tenant).
-Reatribui leads atribuídos pra "Sem responsável" (não deleta leads).
-Mantém histórico de mensagens enviadas pelo user (só marca user_id NULL).
-Exclui registro do user.
Tarefas atribuídas ficam sem responsável — admin pode reatribuir.
Tipos de departamento
Departamentos servem pra organizar visibilidade:
Departamentos típicos
-Vendas — vendedores. -Suporte — atendentes pós-venda. -Marketing — quem cria automações. -Cobrança — financeiro.
Estratégia de distribuição
Cada departamento tem:
-assignment_strategy:
-round_robin — distribui leads em rodízio entre members.
-least_busy — atribui ao user com menos leads ativos.
-default_ai_agent_id — agente IA padrão pra conversas atribuídas.
Veja Criar departamento.
Limite de plano
Cada plano tem max_users:
| Plano | Limite |
|---|---|
| Trial | 1 |
| Starter | 3 |
| Growth | 10 |
| Scale | 50+ |
Sistema bloqueia criação se atingiu limite. Faça upgrade pra adicionar mais.
Veja Fazer upgrade.
E-mail de verificação
Ao criar user, sistema envia e-mail com:
-Mensagem de boas-vindas. -Link pra confirmar conta. -Senha temporária (a que admin definiu).
User clica no link → confirma → faz login → senha pode ser trocada em /configuracoes/perfil.
Dica: comunique a senha por canal separado (WhatsApp, áudio). Não cole senha no mesmo e-mail (segurança).
Reenviar verificação
Se user não recebeu:
1.Lista → botão Reenviar verificação. 2.Sistema gera novo token (48h) + envia e-mail.
Bloqueio por tentativas falhas
Se user erra senha 10x:
-Conta bloqueada por 30 minutos. -Mensagem: "Conta bloqueada por segurança. Tente novamente em X minutos ou recupere a senha." -Após 30min, libera automaticamente.
Boas práticas
1. Princípio do menor privilégio
Dê role mínimo necessário:
-Vendedor júnior → viewer (até dominar). -Vendedor sênior → manager. -Sócio → admin.
2. Revise periodicamente
A cada 3-6 meses:
-Quem não loga há 60+ dias? Considerar excluir. -Roles atualizados com responsabilidades atuais? -Senhas fracas detectadas? Forçar reset.
3. Onboarding estruturado
Novo usuário → mande pra:
1.Verificar e-mail. 2.Trocar senha temporária. 3.Configurar perfil (foto, telefone). 4.Fazer tour interativo. 5.Ler artigos do help center relevantes.
4. Use departamentos mesmo se time pequeno
Mesmo com 5 users, departamentos ajudam a organizar pra futuro crescimento. Crie "Vendas" + "Suporte" desde o início.
5. Treinamento por role
-Admin: foco em config + integrações. -Manager: foco em leads + automações. -Viewer: foco em relatórios + conversas.
Auditoria
Sistema loga todas mudanças em audit_logs:
-Quem criou user X. -Quem mudou role do user Y. -Quem deletou user Z. -Quando, IP, user-agent.
Acesse /configuracoes/auditoria (admin).
Veja Audit Log.
Erros comuns
"Limite de usuários atingido"
Atingiu max_users do plano. Faça upgrade ou exclua user antigo.
"E-mail já cadastrado"
E-mail é único globalmente no sistema (não só no tenant). Pessoa já tem conta noutro tenant Syncro? Use e-mail diferente.
"Não posso editar meu próprio role"
Segurança. Peça pra outro admin.
"Não posso excluir esse usuário"
Possíveis razões:
-É você mesmo. -É último admin. -Pertence a outro tenant.
"User não recebeu e-mail de verificação"
-Cheque spam/lixo eletrônico. -Token expirou (48h)? Reenvie. -E-mail digitado errado? Edite e reenvie.
Próximos passos
-Pra criar departamentos, veja Criar departamento. -Pra entender visibilidade, veja Permissões de visibilidade. -Pra checklist completo de setup, veja Configuração inicial recomendada.
Artigos relacionados
-Gerenciar usuários -Criar departamento -Permissões de visibilidade -Audit Log -Configuração inicial recomendada