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

# Atendimento humano com Jelou

> Transfira a conversa do workflow para o Inbox do Jelou, com atribuição direta ou por fila.

O nó **Jelou** é a opção nativa de atendimento humano: entrega a conversa a um operador dentro do **Inbox** do Jelou. Use-o quando sua equipe atende diretamente pelo Jelou e você quer que o workflow decida quando escalar e para quem.

Ao ser executado, o nó move a sessão do usuário para o Inbox e encerra a execução do workflow. A partir daí, o operador atende diretamente. Se o usuário precisar voltar a um fluxo automatizado, isso acontece encaminhando a conversa para outro workflow a partir do Inbox — não acontece automaticamente ao fechar o caso.

<Note>
  Este nó aparece na barra inferior em **Atendimento humano > Jelou**. É a mesma capacidade que antes era conhecida como nó **Transferir para operador**, agora empacotada dentro do menu de handoff junto com HubSpot e Genesys.
</Note>

***

## Pré-requisitos

* Pelo menos um **operador ativo** no Inbox.
* Se for atribuir por equipe, a equipe deve existir em **Configurações > Equipes**.
* O canal do workflow precisa estar conectado a um canal suportado pelo painel (por exemplo, WhatsApp ou Web Widget). Os canais **Slack**, **Teams** e **Custom** não suportam este nó.

***

## Configuração

O painel do nó é organizado em três abas:

* **Configuração** — define como a conversa é atribuída ao operador.
* **Avançado** — controla o que acontece quando a atribuição falha e o tratamento de erros padrão.
* **Eventos** — registra eventos de rastreamento para suas métricas.

### Tipo de atribuição

Define como a conversa chega ao operador:

| Tipo       | Comportamento                                                                                          |
| :--------- | :----------------------------------------------------------------------------------------------------- |
| **Direta** | A conversa é entregue diretamente ao operador selecionado no Inbox.                                    |
| **Fila**   | A conversa entra em uma fila de espera; o operador a assume manualmente pelo Inbox geral ou de equipe. |

### Atribuir por

Determina o destinatário conforme o tipo escolhido.

**Quando o tipo é Direta:**

| Opção         | Descrição                                                                                     |
| :------------ | :-------------------------------------------------------------------------------------------- |
| **Equipe**    | Atribuída a um membro da equipe escolhida. Operadores com menos chats abertos têm prioridade. |
| **Operador**  | Atribuída a um operador específico.                                                           |
| **Aleatório** | Escolhido ao acaso entre operadores ativos, priorizando os de menor carga.                    |

**Quando o tipo é Fila:**

| Opção      | Descrição                                                                       |
| :--------- | :------------------------------------------------------------------------------ |
| **Geral**  | Cai na fila geral; qualquer operador pode assumi-la.                            |
| **Equipe** | Cai na fila de uma equipe específica; somente membros dessa equipe podem vê-la. |

### Prioridade (apenas em Fila)

Um slider de **0 a 10** que define a urgência dentro da fila:

* **0** — Urgente. Atendida primeiro.
* **10** — Prioridade mais baixa.

Use-a para que casos sensíveis (pagamentos, reclamações, VIP) apareçam no topo do Inbox da equipe.

***

## Saídas do nó

O nó Jelou expõe uma saída de sucesso e várias saídas de erro, cada uma conectável a um fluxo distinto de recuperação:

| Saída                       | Quando dispara                                                          |
| :-------------------------- | :---------------------------------------------------------------------- |
| **Atribuição bem-sucedida** | A conversa entrou corretamente no painel e ficou atribuída ou em fila.  |
| **Operador não encontrado** | O operador ou equipe configurado não existe ou está inativo.            |
| **Fora do horário**         | Não há operadores dentro do horário definido para a equipe.             |
| **Erro geral**              | Qualquer outra falha de atribuição não coberta pelas saídas anteriores. |

<Tip>
  Conecte cada saída de erro a uma mensagem distinta: por exemplo, "estamos fora do horário, escreva-nos entre 9:00 e 18:00" para **Fora do horário**, e uma mensagem genérica de retentativa para **Erro geral**.
</Tip>

***

## Aba Avançado

### Criar conversa quando não for possível atribuir

Toggle que controla o que acontece quando a atribuição falha:

* **Ativado (padrão)** — Cria um registro no Inbox **"Para recuperar"** de Monitoramento. Um supervisor pode retomar o caso manualmente.
* **Desativado** — Conversas não atribuídas não ficam registradas em Monitoramento.

<Warning>
  Desativar este toggle faz com que as conversas não atribuídas se percam do painel de Monitoramento. Só o desative se tiver um mecanismo alternativo de acompanhamento (por exemplo, um webhook ou uma base de dados).
</Warning>

### Tratamento de erros padrão

Define o nó ao qual o workflow deve saltar quando ocorre um erro que não tem uma saída específica conectada. Serve como rede de segurança para não deixar a conversa sem resposta.

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Um fluxo com várias equipes: use um Condicional antes do handoff">
    Um workflow que atende vendas, suporte e reclamações com **um único nó Jelou** em vez de três workflows separados.

    Antes do handoff, um nó **Condicional** avalia uma variável como `{{$memory.motivo_contato}}` e guarda a equipe de destino em `{{$memory.equipe_destino}}`. Depois, no nó Jelou:

    * **Tipo de atribuição**: Direta
    * **Atribuir por**: Equipe
    * **Equipe**: `{{$memory.equipe_destino}}`

    | Caminho do Condicional | Regra                                             | Valor guardado em `{{$memory.equipe_destino}}` |
    | :--------------------- | :------------------------------------------------ | :--------------------------------------------- |
    | Vendas                 | `{{$memory.motivo_contato}}` igual a `venda`      | `Vendas`                                       |
    | Suporte                | `{{$memory.motivo_contato}}` igual a `suporte`    | `Suporte Técnico`                              |
    | Reclamações            | `{{$memory.motivo_contato}}` igual a `reclamacao` | `Pós-venda`                                    |
    | **Se nenhum**          | —                                                 | `Atendimento Geral`                            |

    O workflow roteia para as três equipes com um único nó de handoff. Manter a lógica em um Condicional evita duplicar o fluxo por equipe e facilita adicionar um quarto caminho depois.
  </Accordion>

  <Accordion title="Atribuir operador VIP a clientes premium">
    Um workflow que reserva um operador específico para clientes premium e usa a fila geral para o restante.

    O Condicional avalia `{{$user.plan}}`:

    | Caminho       | Regra                              | Ramo do handoff                                              |
    | :------------ | :--------------------------------- | :----------------------------------------------------------- |
    | Premium       | `{{$user.plan}}` igual a `premium` | Nó Jelou em modo **Direta > Operador > Ana (operadora VIP)** |
    | **Se nenhum** | —                                  | Nó Jelou em modo **Fila > Geral**, prioridade 5              |

    Dois nós Jelou distintos, cada um com sua configuração, alimentados por um único Condicional.
  </Accordion>

  <Accordion title="Escalar para supervisor quando a atribuição falha">
    Um workflow que primeiro tenta atribuir à equipe de suporte e, se falhar, escala automaticamente para um supervisor.

    * Primeiro nó Jelou: **Direta > Equipe > Suporte Técnico**.
    * A saída **Fora do horário** conecta a uma mensagem que informa o horário e encerra.
    * As saídas **Operador não encontrado** e **Erro geral** conectam a um segundo nó Jelou: **Direta > Operador > Supervisor de plantão**.

    Com essa cadeia, nenhum caso fica sem atendimento mesmo se a equipe principal não estiver disponível.
  </Accordion>

  <Accordion title="Fila priorizada pela urgência detectada">
    Um workflow de reclamações que ajusta a prioridade na fila conforme a urgência da mensagem.

    Um nó **AI Agent** analisa a mensagem do usuário e guarda uma pontuação em `{{$memory.urgencia}}` (`alta`, `media`, `baixa`). Depois um Condicional direciona a três nós Jelou distintos, todos em modo **Fila > Equipe > Reclamações**, mudando apenas a prioridade:

    | Caminho | `{{$memory.urgencia}}` | Prioridade |
    | :------ | :--------------------- | :--------- |
    | Urgente | `alta`                 | 0          |
    | Normal  | `media`                | 5          |
    | Baixa   | `baixa`                | 9          |

    Os operadores veem os casos urgentes no topo do Inbox da equipe sem intervenção manual.
  </Accordion>
</AccordionGroup>

***

## Boas práticas

<Tip>
  Quando precisar rotear para vários operadores ou equipes, prefira **um único nó Jelou** alimentado por um Condicional em vez de múltiplos workflows paralelos. O workflow fica mais simples de manter e as mudanças na lógica de roteamento acontecem em um só lugar.
</Tip>

<Tip>
  Conecte sempre a saída **Fora do horário** a uma mensagem explícita com o horário de atendimento. É o erro mais frequente em handoffs e o que mais frustra o usuário quando ele fica no silêncio.
</Tip>

<Note>
  Use variáveis de `{{$memory}}` ou `{{$user}}` para preencher o campo **Equipe** ou **Operador** em vez de valores estáticos. Assim você decide o destinatário dinamicamente sem tocar na configuração do nó.
</Note>

***

## Relacionados

<CardGroup cols={2}>
  <Card title="Nó Condicional" icon="code-branch" href="/pt/guias/nodos/condicional">
    Como definir caminhos e regras para rotear antes do handoff.
  </Card>

  <Card title="Integração com HubSpot" icon="plug" href="/pt/connect/painel-multi-agente/hubspot">
    Handoff para a Inbox do HubSpot em vez do painel do Jelou.
  </Card>

  <Card title="Integração com Genesys" icon="headset" href="/pt/connect/painel-multi-agente/genesys">
    Handoff para agentes do Genesys Cloud.
  </Card>

  <Card title="Inbox" icon="users" href="/pt/connect/painel-multi-agente/transferencia-de-casos">
    Como os operadores trabalham dentro do painel depois de receber a conversa.
  </Card>
</CardGroup>
