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	✅	❌

Início

Minha Instância

Conta

Live Chat

Formulários

Link na Bio

Landing Pages

Agente de IA

Wiki

Dados

Suporte

Legal

Operador de Conversas

Operador de Conversas

O que o operador pode fazer

Configuração passo a passo

1. Convidar o membro

2. Ativar como operador do chat

3. Definir departamento (opcional)

Experiência do operador

Filtro forçado: “Minhas”

Campos somente leitura

Criação de contatos

Carteira de Clientes

Como funciona para o operador restrito

Modos de operação

Atribuição via API

Parâmetros relevantes

Exemplo completo

cURL

Comparativo de permissões

​Operador de Conversas

​O que o operador pode fazer

​Configuração passo a passo

​1. Convidar o membro

​2. Ativar como operador do chat

​3. Definir departamento (opcional)

​Experiência do operador

​Filtro forçado: “Minhas”

​Campos somente leitura

​Criação de contatos

​Carteira de Clientes

​Como funciona para o operador restrito

​Modos de operação

​Atribuição via API

​Parâmetros relevantes

​Exemplo completo

​cURL

​Comparativo de permissões

Operador de Conversas

O que o operador pode fazer

Configuração passo a passo

1. Convidar o membro

2. Ativar como operador do chat

3. Definir departamento (opcional)

Experiência do operador

Filtro forçado: “Minhas”

Campos somente leitura

Criação de contatos

Carteira de Clientes

Como funciona para o operador restrito

Modos de operação

Atribuição via API

Parâmetros relevantes

Exemplo completo

cURL

Comparativo de permissões