Operador de Conversas
O Operador de Conversas é um perfil restrito criado para membros da equipe que precisam apenas atender clientes via chat, sem acesso a configurações, métricas, formulários ou outros módulos do Brainchat.
O que o operador pode fazer
| Ação | Permitido |
|---|
| Visualizar conversas atribuídas a ele | ✅ |
| Enviar mensagens | ✅ |
| Criar novos contatos | ✅ |
| Ver contatos da sua carteira | ✅ |
| Acessar configurações do chat | ❌ |
| Ver métricas e relatórios | ❌ |
| Transferir contatos de carteira | ❌ |
| Alterar departamento ou atribuição | ❌ |
| Acessar Formulários, Landing Pages, Wiki, Agentes | ❌ |
Configuração passo a passo
1. Convidar o membro
No painel Equipe (/u/settings/team), convide o novo membro informando o e-mail. Na etapa de permissões, selecione apenas o produto Conversas.
O preset “Operador” já seleciona automaticamente as permissões corretas. Se preferir configurar manualmente, marque apenas Conversas na lista de produtos.
2. Ativar como operador do chat
O membro convidado precisa estar ativo na lista de operadores da instância. Isso acontece automaticamente ao conceder a permissão Conversas.
3. Definir departamento (opcional)
Se sua instância utiliza departamentos, atribua o operador ao departamento correto nas Configurações do Chat → Departamentos. Isso garante que as conversas sejam direcionadas corretamente via Round-robin.
Experiência do operador
Ao fazer login, o operador é redirecionado automaticamente para a interface isolada de chat (/c/chat). Ele não vê o dashboard, menu lateral ou qualquer outro módulo.
Filtro forçado: “Minhas”
O operador vê apenas as conversas atribuídas a ele. O filtro “Todas” e os filtros globais ficam ocultos. Os filtros disponíveis são:
- Minhas — conversas atribuídas diretamente ao operador
- Carteira — contatos fixos da carteira do operador
Campos somente leitura
No painel de detalhes do contato, os campos Departamento e Operador Responsável aparecem como somente leitura. Apenas administradores e owners podem alterar esses campos.
Criação de contatos
Quando o operador cria um novo contato:
- O contato é automaticamente atribuído ao operador (
assigned_to)
- O contato entra na carteira do operador com prioridade absoluta
- O contato aparece imediatamente na lista “Minhas” e “Carteira”
Carteira de Clientes
A carteira garante que determinados contatos sempre sejam atendidos pelo mesmo operador.
Como funciona para o operador restrito
- Contatos criados pelo operador entram automaticamente na sua carteira
- Contatos atribuídos via API com
portfolio: true entram na carteira
- O operador não pode remover contatos da sua carteira
- O operador não pode redistribuir contatos para outros operadores
- Apenas um administrador ou owner pode alterar a carteira
Modos de operação
O administrador define o modo da carteira nas configurações da instância:
| Modo | Comportamento |
|---|
| Absoluto | Sempre envia para o dono da carteira, mesmo se estiver offline |
| Fallback | Tenta o dono primeiro; se offline ou sem capacidade, usa Round-robin |
Atribuição via API
Você pode criar conversas já atribuídas a um operador usando a API send-message.
Parâmetros relevantes
| Parâmetro | Tipo | Descrição |
|---|
assignTo | string | E-mail ou UUID do operador que receberá a conversa |
portfolio | boolean | Se true, o contato é adicionado à carteira do operador com prioridade absoluta |
Exemplo completo
{
"instanceId": "SUA_INSTANCIA",
"phone": "5511999999999",
"messageType": "text",
"message": "Olá! Você está sendo atendido pelo João.",
"assignTo": "joao@empresa.com",
"portfolio": true
}
O parâmetro assignTo aceita tanto o e-mail quanto o UUID do operador. Se informado um e-mail, o sistema busca automaticamente o usuário correspondente.
cURL
curl -X POST "https://wapi.stegia.com.br/functions/v1/send-message" \
-H "Content-Type: application/json" \
-H "X-Client-Token: SEU_TOKEN_AQUI" \
-d '{
"instanceId": "SUA_INSTANCIA",
"phone": "5511999999999",
"messageType": "text",
"message": "Bem-vindo! Sou seu consultor dedicado.",
"assignTo": "consultor@empresa.com",
"portfolio": true
}'
Comparativo de permissões
| Recurso | Owner / Admin | Operador de Conversas |
|---|
| Dashboard | ✅ | ❌ |
| Configurações do Chat | ✅ | ❌ |
| Métricas e Relatórios | ✅ | ❌ |
| Ver todas as conversas | ✅ | ❌ (apenas suas) |
| Enviar mensagens | ✅ | ✅ |
| Criar contatos | ✅ | ✅ (auto-atribuído) |
| Transferir conversas | ✅ | ❌ |
| Alterar departamento | ✅ | ❌ |
| Alterar carteira | ✅ | ❌ |
| Formulários | ✅ | ❌ |
| Landing Pages | ✅ | ❌ |
| Agentes de IA | ✅ | ❌ |
| Wiki | ✅ | ❌ |
| API | ✅ | ❌ |
