> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Operador de Conversas

> Como configurar e utilizar o perfil de operador restrito, com acesso exclusivo à tela de conversas e carteira de clientes.

# 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`.

<Info>
  O preset "Operador" já seleciona automaticamente as permissões corretas. Se preferir configurar manualmente, marque apenas **Conversas** na lista de produtos.
</Info>

### 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:

1. O contato é automaticamente **atribuído ao operador** (`assigned_to`)
2. O contato entra na **carteira do operador** com prioridade absoluta
3. 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

```json theme={null}
{
  "instanceId": "SUA_INSTANCIA",
  "phone": "5511999999999",
  "messageType": "text",
  "message": "Olá! Você está sendo atendido pelo João.",
  "assignTo": "joao@empresa.com",
  "portfolio": true
}
```

<Info>
  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.
</Info>

### cURL

```bash theme={null}
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                    | ✅             | ❌                     |