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

# Chat com Motoristas

> Troque mensagens em tempo real com seus motoristas direto do painel, sem precisar de WhatsApp.

O chat do BulkRoute permite que gestores e motoristas troquem mensagens em tempo real, sem sair do painel. Útil para orientações de última hora, mudanças de endereço ou dúvidas durante a rota.

<Note>
  Acesso: **Campo** > **Chat** (`/admin/chat`). Requer perfil Manager.
</Note>

## Como funciona

A tela é dividida em duas partes:

* **Lado esquerdo**: lista de motoristas com busca, indicador de disponibilidade (verde = disponível, cinza = pausado), última mensagem e contador de não lidas
* **Lado direito**: conversa com o motorista selecionado, com bolhas de mensagens, separadores de data e campo de digitação

## Enviando uma mensagem

1. Selecione o motorista na lista da esquerda
2. Digite a mensagem no campo inferior
3. Pressione **Enter** ou clique no botão **Enviar**

As mensagens aparecem em tempo real — o motorista vê no app do celular (PWA) e você vê no painel.

## Buscando um motorista

Use o campo de busca no topo da lista para encontrar um motorista pelo nome.

## Marcar como lida

Quando você abre uma conversa, as mensagens são marcadas como lidas automaticamente. O contador de não lidas some.

## Indicador de disponibilidade

| Cor      | Status     | Significado                           |
| :------- | :--------- | :------------------------------------ |
| 🟢 Verde | Disponível | Motorista pode receber novas entregas |
| ⚪ Cinza  | Pausado    | Motorista em pausa ou inativo         |

## Atualização automática

O chat atualiza sozinho de duas formas:

1. **Tempo real (SSE)** — quando chega uma mensagem nova, ela aparece na hora
2. **A cada 15 segundos** — verificação de segurança caso o tempo real falhe

<Tip>
  Use o chat para orientações rápidas durante a rota: "entregar nos fundos", "cliente pediu para ligar antes", "trocar para o endereço B". Evita ligações e mantém o histórico no shipment.
</Tip>

## No celular do motorista

O motorista recebe as mensagens no app PWA (`driver.bulkroute.com.br`). Ele vê a conversa na tela de Chat e pode responder direto do celular.

## Troubleshooting

| Problema                       | Causa                          | Solução                                               |
| :----------------------------- | :----------------------------- | :---------------------------------------------------- |
| Motorista não aparece na lista | Status inativo ou sem entregas | Ativar motorista em **Campo** > **Motoristas**        |
| Mensagem não chega no app      | Motorista sem internet         | Motorista precisa abrir o app com internet            |
| Mensagem demora para chegar    | SSE desconectou                | Aguarde 15s (polling automático) ou atualize a página |