Convidar equipe

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