Maria Clara / Overview
Overview
Visão geral do sistema Maria Clara em tempo real
Máquinas (VPS)
Unidades MC Ativa
Unidades Dash Ativa
Unidades MC + Dash
Com Operador
Follow Ups Ativos
Lembretes Ativos
Confirmações Ativas
Quick Access
ENTRADA
Pré-processamento
TRANSCRIÇÃO
Transcritor
ORQUESTRADOR
ORC
AGENTE
Maria Clara
ROTEADOR
MCP Router
EXECUTOR
MCP
EXECUTOR
DTF
Saúde dos Fluxos
carregando…
Check Sistema
Clique para testar os sistemas de cada unidade.
Check OpenRouter
Clique para consultar o saldo OpenRouter das unidades.
OpenRouter
Consumo e saldo por unidade · gasto do mês, semana e dia
Relatório por unidade
carregando…
Unidade Saldo Atual Gasto mês Semana Dia
  consultando OpenRouter…
unitConfig
Configurações por unidade · unitConfigs
● Modo Edição Ativo
  Carregando unidades...
Fluxos Auxiliares
Controle de ativação de fluxos · apenas unidades com Maria Clara (MC)
UnidadeStart Date FollowUpsLembretes ConfirmaçõeshasOperator
Versionamento
Replique um fluxo da homologação para as máquinas de produção · credenciais preservadas
Origem · o que replicar
Alvos · máquinas de produção
Motor · versionador (n8n)
A replicação é executada por um workflow no n8n de homologação (server-side, com as API keys guardadas lá). O painel só dispara — nunca guarda chave nem altera credencial.
Farol de Saúde
Falhas nas execuções dos fluxos n8n, em todas as máquinas
Instâncias Online
Instâncias Offline
Falhas na Janela
Última Coleta
Instâncias (VPS n8n)
Atividade do Coletor
QuandoStatusInstânciasFalhas achadasDuração
Logs de Execuções
Buscador de execuções da Maria Clara · orc_logs
— execuções
aguardando busca
TelefoneExecuçãoUnidadeLink
Digite um número para buscar as execuções.
Suporte · POP
Base de conhecimento — onde verificar cada coisa, como corrigir e para onde ir em cada situação
Buscas comuns:
Roteador de diagnóstico

Recebeu um chamado? Comece por aqui.

Identifique o tipo do problema na coluna da esquerda e vá direto ao fluxo responsável. Depois, veja o artigo “Como resolver” correspondente.

Tipo de questão / sintomaOnde verificarObservação
Resposta ou tomada de decisão Fluxo Maria Clara É o “cérebro”: o que ela entende e decide responder.
Realização de ações Fluxo MCP Executa integrações (agendar, confirmar, registrar no Ecuro).
FUP realizado de forma incorreta Fluxo DTF Decide quando/como é o próximo follow-up.
FUP não realizado Auxiliar · Follow Up O gatilho por horário não disparou o EXECUTE_FUP.
Não registrou no Ecuro Fluxo MCP A ação de gravar no Ecuro falhou.
Não encaminha para a FILA no fim dos FUPs DTF Follow Up Maria Clara Cadência no DTF + acionamento no Follow Up. O gatilho fica na sticky ## ENCAMINHA FILA (fluxo Maria Clara).
FILA — ortodontia ou fichas múltiplas Maria Clara · pré-processamento Vão para a fila já na entrada. Switch Status do Cadastro (Duplicado → fila) + IF Orto? (ficha única de orto → fila).
Como resolver

Artigos de suporte

Passo a passo por sintoma. Use a busca lá em cima para filtrar.

Maria Clara parou de responder

Sintomas: não responde o paciente, ficou muda, conversa parada.

  • Verifique o saldo do OpenRouter. É o “combustível” do modelo de IA. Se zerou ou está baixo, ela para de responder. (Botão “Check OpenRouter” no painel.)
  • Verifique a atribuição do agente na conversa. No Chatwoot, a conversa precisa estar atribuída à Maria Clara. Se está com um humano ou sem atribuição, ela não responde.
Fluxo responsável: Maria Clara — mas na maioria dos casos é saldo ou atribuição, não o fluxo em si.

Respondeu errado ou tomou decisão errada

Sintomas: entendeu errado, respondeu fora do contexto, decidiu algo indevido.

  • Vá na arquitetura principal, fluxo Maria Clara. É onde a IA interpreta e decide o que responder. Analise a execução da conversa nesse fluxo.

Não realizou uma ação (agendar, confirmar, registrar)

Sintomas: disse que fez, mas a ação não aconteceu no sistema.

  • Vá no fluxo MCP. É a camada que executa as ações e integrações (inclusive gravar no Ecuro). Verifique a execução da ferramenta correspondente.

Não registrou / sincronizou no Ecuro

Sintomas: agendou/confirmou na conversa, mas não aparece no Ecuro.

  • Vá no fluxo MCP. É quem grava no Ecuro. Verifique a chamada da ação e o retorno de erro do Ecuro nessa execução.

FUP saiu incorreto (horário/cadência errada)

Sintomas: follow-up no horário errado, repetido, ou fora da ordem.

  • Vá no fluxo DTF. É o cérebro que decide a cadência dos follow-ups (quando e como é o próximo). Verifique a decisão e o horário programado nesse fluxo.

Não fez o follow-up (FUP não realizado)

Sintomas: chegou a hora do FUP e nada foi enviado.

  • Vá no fluxo auxiliar Follow Up. É o gatilho por horário que lê o horário programado (gravado pelo DTF no Supabase) e dispara o EXECUTE_FUP na Maria Clara. Se o disparo não ocorreu, o problema está aqui.

Não encaminhou para a FILA ao fim dos FUPs

Sintomas: acabaram os follow-ups e a conversa não foi para a fila (não atribuídas).

  • Verifique a sequência da cadência no DTF. Confirme se, no último follow-up, a decisão realmente encaminha para a fila (fim da cadência).
  • Verifique o acionamento no Follow Up (auxiliar). Confirme se o gatilho executou o passo final que joga a conversa para a fila.
  • O gatilho de encaminhamento está na Maria Clara. Localize a sticky note azul-escuro ## ENCAMINHA FILA e verifique a execução dos nós: Envia Fila Chatwoot3 → Nota Fichas Chatwoot2 → reset FUP + need fup false.
É essa sequência, dentro do fluxo Maria Clara, que efetivamente joga a conversa na fila ao fim da cadência dos FUPs. Se os passos 1 e 2 estão ok mas a conversa não foi, é aqui que a execução falhou.

Fila no pré-processamento — ortodontia e fichas múltiplas

Nem toda ida para a fila é ao fim dos FUPs: alguns casos vão logo na entrada.

Além do fim dos FUPs, a Maria Clara também encaminha para a fila já no pré-processamento. A decisão passa por duas peças: o switch Status do Cadastro e o IF Orto?.

SWITCH Status do Cadastro · por totalFichas
== 0→Paciente Novo→Atendimento
== 1→Único→IF · Orto?→sim→ Filanão→ Atendimento
≥ 2→Duplicado→Fila

1. Switch Status do Cadastro — roteia por totalFichas

totalFichasSaídaO que acontece
== 0Paciente NovoRegistra tudo e segue para o atendimento.
== 1ÚnicoFicha única — segue, mas passa pelo IF Orto? (ver abaixo).
≥ 2Duplicado→ Fila — paciente com mais de uma ficha.

2. IF Orto? — só no caminho “Único”

  • Ficha única + especialidade Ortodontia → fila. Mesmo com ficha única (saída “Único”), se a especialidade das fichas do paciente for Ortodontia, o IF Orto? direciona para a fila. Caso contrário, segue para o atendimento.
Onde verificar: fluxo Maria Clara, etapa de pré-processamento. Se um paciente de orto ou com ficha duplicada tomou um caminho diferente do esperado, confira qual saída o switch Status do Cadastro tomou e, no caso de ficha única, o resultado do IF Orto?.

Paciente não recebeu a mensagem de confirmação

Antes de tratar como erro, confira os casos em que é esperado não enviar.

  • Unidade com o agente desligado (bot/confirmações off) — não envia.
  • Agendamento fora do status “à confirmar” — só dispara para o status “à confirmar”.
  • Fora da janela de antecedência — cada especialidade/dia tem sua janela; fora dela, não sai naquele momento.
  • Paciente sem WhatsApp/contato válido — não há para onde enviar.
  • Se nenhum desses se aplica → verifique o erro no Chatwoot (abaixo do balão) e o fluxo Confirmações.
Existe um POP dedicado “Chamados Indevidos” (Confirmações) com o passo a passo completo e a lista de códigos de erro.

Informações incorretas sobre a clínica

Ex.: endereço, telefone, valores ou nome errados.

  • Corrija no unitConfig da unidade. Campos: Nome da empresa, Endereço, Link do endereço, Telefone e os campos de valores.

Alterar a imagem da fachada

A clínica pediu para atualizar a foto da fachada.

  • Suba a nova imagem no Storage "mc". É o bucket que armazena as imagens das fachadas.
  • Insira a URL da foto no unitConfig. O agente passa a usar a nova imagem a partir daí.

Cadastro de novos templates

Pediram um novo template de mensagem.

  • Encaminhe a solicitação à Thauany. Ela direciona ao time de marketing, responsável por criar e aprovar os templates.

Template não foi enviado

A mensagem/template aparece com falha.

  • Olhe no próprio Chatwoot. O motivo aparece no erro logo abaixo do balão da mensagem enviada.
  • Cruze com a lista de códigos de erro. Ex.: 131042 = problema de pagamento no Meta. Consulte a tabela de códigos (POP “Chamados Indevidos”).
Esses códigos vêm da Meta (WhatsApp) — o Chatwoot só repassa. A causa está na conta/template/janela, não necessariamente na Maria Clara.
Glossário

Termos que você vai encontrar

O básico para quem nunca mexeu na Maria Clara.

ORC / Pré-ORC
Porta de entrada: recebe a mensagem do paciente e a encaminha (roteia) para o restante do fluxo. O “Pré-ORC” é a etapa de pré-processamento mais nova.
Maria Clara (fluxo)
O “cérebro” conversacional: interpreta a mensagem e decide o que responder.
MCP
A camada de ações/ferramentas. É quem executa de fato: agenda, confirma, registra no Ecuro, etc.
DTF
Decide a cadência dos follow-ups: quando e como será o próximo FUP. Grava o horário no Supabase.
FUP (Follow Up)
Mensagem de acompanhamento enviada a quem não respondeu, para retomar o contato.
Confirmações / Lembretes
Gatilhos por horário que enviam templates: confirmação da consulta e lembrete (2h antes).
unitConfig
A configuração de cada unidade/clínica: nome, endereço, telefone, valores, imagem da fachada, chaves e flags (ligado/desligado).
Ecuro
O sistema/agenda da clínica onde a Maria Clara registra agendamentos e confirmações.
Chatwoot
A plataforma de atendimento onde as conversas de WhatsApp acontecem e onde aparecem os erros de envio.
Template
Mensagem pré-aprovada pela Meta, usada para falar com o paciente fora da janela de 24h.
OpenRouter
Provedor do modelo de IA. O “saldo” que a Maria Clara consome para responder — se acaba, ela para.
Supabase
Banco de dados. Guarda estados como o horário programado do próximo follow-up.
Storage “mc”
Bucket de arquivos onde ficam as imagens das fachadas das clínicas.
Fila
Encaminhamento da conversa para atendimento humano (as “não atribuídas”).
n8n
A ferramenta onde os fluxos da Maria Clara são montados e executados.
🔍

Nenhum resultado. Tente outro termo — ex.: confirmação, fila, Ecuro, fachada.

Manual do Suporte da Maria Clara — POP / base de conhecimento. Visão geral → arquitetura → roteador de diagnóstico → artigos → glossário.