Expediente (Work Queue)

A fila de trabalho do Dexter — chamada internamente de Expediente — centraliza todas as tarefas pendentes que o assistente detectou mas que ainda precisam de uma decisão humana antes de serem executadas.

O que é

O Expediente é um motor periódico que varre a carteira de contatos da instância em busca de situações que pedem ação: leads parados, mensagens sem resposta, contatos novos nunca abordados, WhatsApp desconectado e mais. Cada achado vira um item de trabalho na fila, contendo:

  • O tipo da situação detectada (lead parado, mensagem sem resposta, etc.)
  • Evidência: o motivo pelo qual o Dexter está sugerindo a ação
  • Rascunho da mensagem que seria enviada ao contato (gerado por IA)
  • Status: pending, executed, dismissed, failed ou expired

Quando o modo de operação requer aprovação (o padrão), nenhuma mensagem sai sem que um humano revise e aprove cada item.

Quando usar

  • Modo supervisionado de envio — a equipe revisa cada mensagem antes do disparo.
  • Controle de qualidade — um advogado, médico ou gestor valida respostas sensíveis.
  • Governança sobre IA — acompanhar o que o assistente quer fazer antes de permitir.
  • Visão consolidada — um painel único com tudo que precisa de atenção na carteira.

Como funciona

1
Varredura automática — O Dexter varre periodicamente a carteira de contatos da instância (leads, histórico de conversa, campanhas) em busca de situações que precisam de ação.
2
Criação do item — Cada achado gera um item na fila com evidência e, quando aplicável, um rascunho de mensagem gerado pela IA.
3
Revisão humana — O operador visualiza os itens pendentes no dashboard ou via MCP e decide o que fazer com cada um.
4
Aprovar ou dispensar — Ao aprovar, o rascunho é enviado ao contato (respeitando todos os limites de envio). Ao dispensar, o item sai da fila e não volta a ser sugerido por alguns dias.
Importante: Mesmo quando um item é aprovado, todas as proteções anti-duplicidade e limites de envio do Dexter continuam ativas. O Expediente nunca ignora as regras de segurança.

Tipos de itens detectados

Tipo Descrição
unanswered_inbound Lead enviou mensagem e ainda não recebeu resposta
hot_lead_cooling Lead com score alto sem interação recente — esfriando
stale_lead Lead parado há vários dias sem contato
new_lead_untouched Contato cadastrado como lead e nunca abordado
campaign_leftover Campanha encerrada com contatos que nunca receberam mensagem
instance_disconnected A instância WhatsApp está desconectada
wallet_reactivation Conversas no WhatsApp que não estão cadastradas como contatos

Dashboard: Fila de Expediente

1
Acesse a seção Dexter Worker no dashboard. Se o Worker ainda não estiver ativo, configure-o primeiro.
2
Clique em "O que o Dexter fez" para abrir o feed de atividade. Cada item mostra: contato, tipo de situação, evidência, rascunho da mensagem proposta e timestamp.
3
Para itens pendentes, você pode:
  • Aprovar — envia a mensagem rascunhada ao contato
  • Editar e aprovar — altere o rascunho antes de enviar
  • Dispensar — descarta o item (não será sugerido novamente por 7 dias)
4
O feed mostra também itens já executados e dispensados, com o modo de execução (dashboard, mcp, manual ou auto) e o resultado.
Dica: Use o botão "Olhar meus leads agora" na configuração do Worker para forçar uma varredura imediata, sem precisar esperar o ciclo automático.

Níveis de autonomia

O Expediente opera em quatro níveis de autonomia, configuráveis por instância:

Nível Nome Comportamento
L0 Observador Apenas envia o resumo diário, sem rascunhar mensagens.
L1 Rascunho (padrão) Detecta, rascunha e aguarda aprovação do responsável.
L2 Co-piloto Envia automaticamente apenas follow-ups para leads que já responderam antes.
L3 Autopiloto Envia todos os follow-ups rascunhados dentro da janela de horário e limites diários.
Atenção: O nível L3 (Autopiloto) envia mensagens automaticamente. Recomendamos começar no L1 (Rascunho) e subir gradualmente conforme a confiança no assistente aumentar.

Configurar o Worker

1
No dashboard, localize o card Dexter Worker e clique em Configurar.
2
Informe o(s) número(s) de WhatsApp do responsável. O resumo diário e as solicitações de aprovação serão enviados para esses números.
3
Escolha o nível de autonomia e o horário de funcionamento (padrão: segunda a sexta, 8h às 18h30).
4
Ative o toggle do Worker e clique em Salvar. O Dexter começará a varrer a carteira no próximo ciclo.

Via MCP

A fila do Expediente também pode ser consultada e operada via MCP (Model Context Protocol), permitindo que outra IA ou automação gerencie os itens programaticamente.

Tool Permissão Descrição
dexter_work_queue_list read Lista itens da fila. Aceita filtro por status e limite.
dexter_work_queue_approve send Aprova e executa um item pendente (envia a mensagem ao lead).
dexter_work_queue_dismiss write Dispensa um item pendente da fila.

Listar itens pendentes

dexter_work_queue_list()

// Filtrar por status
dexter_work_queue_list({ "status": "executed", "limit": 10 })

Aprovar um item

dexter_work_queue_approve({ "item_id": 42 })

// Aprovar com mensagem customizada (substitui o rascunho)
dexter_work_queue_approve({ "item_id": 42, "message": "Oi! Vi que faz tempo..." })

Dispensar um item

dexter_work_queue_dismiss({ "item_id": 42 })
Permissões necessárias: Para aprovar itens via MCP, a API key precisa ter a permissão "Permitir envio de mensagens" habilitada em Configurações → Integrações. Dispensar requer apenas a permissão de escrita.

Caso de uso: Escritório de advocacia

1
O Dexter detecta que um cliente enviou uma pergunta jurídica há 4 horas e ainda não recebeu resposta.
2
Um item do tipo unanswered_inbound é criado na fila com a evidência e um rascunho de resposta gerado pela IA.
3
O advogado abre o dashboard, revisa o rascunho no feed "O que o Dexter fez" e edita o texto para garantir precisão técnica.
4
Ao aprovar, a mensagem revisada é enviada ao cliente pelo WhatsApp, com todos os limites de envio respeitados.

Resumo por WhatsApp

Além do dashboard, o Dexter pode enviar um resumo diário diretamente no WhatsApp do responsável, listando os itens pendentes com números. O responsável pode aprovar ou dispensar respondendo diretamente à mensagem:

  • Responder 1 ou aprovar 1 — aprova o item 1
  • Responder aprovar tudo — aprova todos os itens com rascunho
  • Responder ignorar 1 — dispensa o item 1
  • Responder ver 1 — exibe o rascunho completo do item 1

Erros comuns

Erro Causa Solução
Item não encontrado ou não está pendente O item já foi aprovado, dispensado ou expirou. Use dexter_work_queue_list para ver os itens atuais.
Permissão negada A API key não tem permissão de escrita ou envio. Habilite as permissões em Configurações → Integrações.
Worker desativado O Expediente não está ativo para esta instância. Configure e ative o Worker no dashboard.
Faltam itens essenciais Etapas obrigatórias do setup não foram concluídas. Complete o passo a passo de configuração antes de ativar.

Links relacionados