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:
Trial: 2.
Starter: 3.
Growth: 10.
Scale: 50+.
Acessar usuários
Configurações → Usuários (rota
/configuracoes/usuarios).Página mostra lista de users do tenant:
Nome, e-mail, role, departamentos.
Status (verificado / pendente).
Última atividade.
Botão Novo usuário no canto superior direito.
Convidar novo usuário
1. Clique em Novo usuário
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:
✅ 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.
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
Em /configuracoes/usuarios, clique no nome ou ícone editar.
Drawer abre com dados atuais.
Modifique:
Nome.
E-mail (cuidado — re-verificação).
Role.
Departamentos.
Pipelines.
can_see_all_conversations.
Salve.
⚠️ Atenção: você não pode editar seu próprio role (segurança). Pra mudar, peça pra outro admin.
Excluir usuário
Lista → ícone lixeira.
Confirma.
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 | 2 |
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:
Lista → botão Reenviar verificação.
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:
Verificar e-mail.
Trocar senha temporária.
Configurar perfil (foto, telefone).
Fazer tour interativo.
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.