# Planejamento do Hermes e dos agentes de apoio comercial ## Objetivo e status de confiança O objetivo é transformar o Hermes em uma central supervisionada para solicitar, criar, executar e avaliar agentes especializados em tarefas recorrentes da Hablachat: pesquisa, inteligência competitiva, prospecção, qualificação, conteúdo, roteiros, lives, promoções, QA/compliance e reporting. ### O que está confirmado - O projeto contém configuração de **Hermes Agent e Hermes WebUI**; isso não prova funcionamento atual do servidor. - A configuração prevê WebUI por HTTPS atrás do Traefik. - O gateway do agente permanece na rede Docker interna. - A configuração prevê workspace montado e proteção por senha. - No mesmo ambiente existem n8n, Ollama, Paperclip, Chatwoot e ERPNext, mas não há evidência neste escopo de que estejam integrados ao Hermes. - O AnyChat documenta webhook e API REST, mas a ligação Hermes ↔ AnyChat ainda precisa ser projetada e homologada. Fontes internas confirmadas: `deploy/hermes/README.md`, `deploy/hermes/docker-compose.yml` e `docs/relatorio-servidor-oracle-abizara.md`. ### Hipóteses que precisam de piloto - **Hipótese:** Hermes pode atuar como orquestrador de tarefas e fábrica de especificações/agentes especializados. - **Hipótese:** n8n pode disparar cadências e coletar resultados do Hermes. - **Hipótese:** Ollama pode atender tarefas locais compatíveis com os requisitos de qualidade. - **Hipótese:** Paperclip pode administrar carteira e estado de agentes. - **Hipótese:** Chatwoot, ERPNext e AnyChat podem fornecer ou receber eventos mediante APIs/webhooks e autorização. - **Hipótese:** parte dos relatórios pode ser gerada automaticamente sem comprometer precisão. Nenhuma dessas integrações deve entrar em produção sem autenticação, autorização, segregação de dados, logs, testes de falha e aprovação humana. ## Princípios de desenho 1. **Humano responsável:** agente prepara; pessoa autorizada decide e publica. 2. **Menor privilégio:** cada agente recebe somente fontes, ferramentas e destinos necessários. 3. **Dados mínimos:** não copiar bases completas quando uma amostra ou agregação for suficiente. 4. **Evidência antes de conclusão:** pesquisas e relatórios devem apontar fonte, data e confiança. 5. **Hipótese explícita:** inferências são rotuladas e nunca apresentadas como fatos. 6. **Saída estruturada:** toda execução entrega resultado, evidências, riscos, pendências e próximo passo. 7. **Canal controlado:** nenhuma mensagem externa, campanha, postagem ou alteração de sistema sem regra de aprovação. 8. **Reversibilidade:** começar em modo rascunho; ampliar autonomia apenas após métricas e auditoria. 9. **Separação entre produto e profissão:** agente não substitui advogado, contador, dentista, RT ou decisor do cliente. ## Arquitetura operacional proposta ```text Solicitação humana / evento aprovado | v Hermes Orquestrador - valida objetivo e escopo - classifica risco - escolhe agente/modelo - aplica política de dados | +-------+--------+ | | v v Agente especialista QA/Compliance - pesquisa - fontes - conteúdo - claims - prospecção - LGPD/setor - relatório - formato | | +-------+--------+ v Aprovação humana | +-------+--------+ | | v v Publicar/enviar Devolver/rejeitar | v Métricas, log e aprendizado aprovado ``` ### Componentes | Componente | Função | Estado | |---|---|---| | Hermes WebUI | Entrada humana, revisão e acompanhamento | Configuração presente no projeto; funcionamento atual a verificar | | Hermes gateway | Execução/orquestração interna | Confirmado no compose | | Catálogo de agentes | Versões, owners, permissões e templates | A criar | | Fila de trabalhos | Prioridade, SLA interno, status e reprocessamento | Hipótese; escolher mecanismo no piloto | | Cofre de credenciais | Segredos fora de prompts e arquivos de saída | Obrigatório; implementação a definir | | Repositório de evidências | Fontes, artefatos, logs e decisões | A criar | | Motor de políticas | Risco, aprovação e bloqueios por vertical/canal | A criar | | Integrações | n8n, Ollama, AnyChat, Chatwoot, ERPNext e outras | Disponíveis no ambiente ou documentadas, não confirmadas como conectadas | ## Contrato universal de trabalho Todo job enviado ao Hermes deve conter: ```yaml job_id: identificador_não_sensível objetivo: resultado específico vertical: odontologia|estetica|advocacia|imobiliaria|contabilidade|geral solicitante: papel_interno owner_humano: papel_responsável fontes_permitidas: lista dados_permitidos: categorias_mínimas dados_proibidos: categorias canal_destino: rascunho|email|whatsapp|social|relatorio|interno prazo: data_hora risco: baixo|medio|alto aprovacoes_exigidas: lista_de_papeis criterios_de_aceite: lista ``` Saída padrão: ```yaml status: concluido|parcial|bloqueado|rejeitado resumo: texto_curto artefatos: lista fontes: url_data_trecho fatos: lista hipoteses: lista riscos: lista dados_pessoais_encontrados: sim_nao_e_categorias aprovacoes_pendentes: lista acao_recomendada: texto metricas_execucao: duração_custo_erros ``` ## Catálogo de especializações para implantação progressiva ### Hermes Orquestrador **Missão:** receber pedido, verificar completude, classificar risco, decompor o trabalho, chamar agentes e impedir saída sem aprovação. **Entradas:** contrato de trabalho, catálogo de agentes, políticas, capacidade disponível. **Saídas:** plano de execução, tarefas-filhas, estado consolidado, pedido de aprovação ou bloqueio. **Ferramentas propostas:** Hermes; fila e armazenamento a definir; integrações apenas após homologação. **Limites de segurança:** não executar destino externo por padrão; não reduzir risco manualmente; encerrar quando fonte ou autorização estiver ausente. ### Agente de Pesquisa de Mercado **Missão:** produzir panoramas de mercado verificáveis por vertical, região e período. **Entradas:** pergunta, recorte, fontes permitidas, período e formato. **Saídas:** achados, fatos, hipóteses, tendências, limitações, fontes e perguntas para entrevistas. **Ferramentas:** navegador/fontes públicas; repositório interno aprovado; planilha ou documento de saída. **Limites de segurança:** priorizar fontes primárias; registrar data; não inventar TAM, preço ou participação; não coletar dados pessoais desnecessários. **Aprovação:** analista de mercado ou líder comercial. ### Agente de Inteligência Competitiva **Missão:** comparar posicionamento, oferta pública, mensagens, integrações declaradas e sinais de mercado. **Entradas:** concorrentes autorizados, dimensões, geografia e período. **Saídas:** matriz de evidências, lacunas, diferenças confirmadas e hipóteses de oportunidade. **Ferramentas:** sites públicos, documentação, bases contratadas quando licenciadas. **Limites de segurança:** nada de login indevido, scraping proibido, engenharia social ou acesso a segredo; preço e recurso precisam de data e URL. ### Agente de Prospecção **Missão:** pesquisar contas, identificar sinais públicos e criar rascunhos personalizados. **Entradas:** ICP, contas permitidas, sinais, canal, política de contato e opt-out. **Saídas:** ficha da conta, hipótese de dor, rascunho, motivo de contato e risco regulatório. **Ferramentas:** fontes públicas; CRM apenas se integração for homologada; nunca enviar diretamente na fase inicial. **Limites de segurança:** não obter lista clandestina; não inferir saúde, religião ou dado sensível; não usar WhatsApp frio; advocacia recebe política “inbound/conteúdo”, sem captação. ### Agente de Qualificação **Missão:** preparar perguntas e resumir respostas para encaminhamento humano. **Entradas:** conversa autorizada, score, critérios e vertical. **Saídas:** resumo, score explicável, campos faltantes, riscos e próxima ação. **Ferramentas:** AnyChat/CRM apenas após integração; formulário estruturado. **Limites de segurança:** não tomar decisão clínica, jurídica, tributária ou de crédito; não desqualificar com atributo protegido; score sempre explicável e revisável. ### Agente Social Content **Missão:** planejar e redigir conteúdo orgânico ou pago dentro das regras da vertical. **Entradas:** objetivo, persona, canal, identidade, fontes, claims permitidos e calendário. **Saídas:** pauta, copy, criativo sugerido, CTA, fontes, checklist regulatório e variações. **Ferramentas:** biblioteca de marca, fontes aprovadas e editor; publicação automática inicialmente bloqueada. **Limites de segurança:** sem depoimento/imagem sem autorização; sem promessa; sem captação indevida; toda peça regulada exige aprovador técnico. ### Agente de Roteiros de Vídeo **Missão:** criar roteiro, storyboard textual, lista de takes e legenda. **Entradas:** tema, duração, apresentador, público, plataforma, fontes e restrições. **Saídas:** gancho, roteiro por cena, textos na tela, CTA, disclaimer e checklist de gravação. **Limites de segurança:** sinalizar afirmações que exigem fonte; impedir diagnóstico, resultado garantido, conselho jurídico ou tributário individualizado; uso de imagem exige autorização. ### Agente de Lives e Webinars **Missão:** planejar evento ao vivo, pauta, convidados, perguntas, moderação e reaproveitamento. **Entradas:** tema, data, vertical, convidados, canal, política e objetivo. **Saídas:** run of show, briefing, perguntas aprovadas, regras de moderação, CTA e pacote pós-evento. **Limites de segurança:** moderador humano; perguntas individuais sensíveis não são respondidas ao vivo; registrar consentimento de convidados; não expor caso de cliente. ### Agente de Promoções e Campanhas **Missão:** criar plano e rascunhos de campanha, sem disparar autonomamente. **Entradas:** oferta aprovada, audiência, base legal, canal, janela, template e limites. **Saídas:** briefing, segmentos permitidos, mensagem, frequência, teste, opt-out e métricas. **Ferramentas:** campanha WABA do AnyChat somente após homologação; n8n/CRM como hipótese. **Limites de segurança:** WABA, template aprovado e Dry run; bloquear advocacia promocional/captação; revisar saúde/estética pelo RT; bloquear claims ou escassez não comprovados. ### Agente QA Compliance **Missão:** atuar como gate independente antes de saída externa. **Entradas:** artefato, vertical, fontes, audiência, canal, dados e política vigente. **Saídas:** aprovado, aprovado com correções, rejeitado; motivos, trechos e aprovadores necessários. **Ferramentas:** políticas versionadas, regras determinísticas, detectores de dados, fontes oficiais. **Limites de segurança:** não pode ser ignorado pelo agente autor; risco alto sempre sobe para humano; atualização normativa tem responsável e data. ### Agente de Reporting **Missão:** consolidar métricas e narrar resultados sem confundir correlação com causalidade. **Entradas:** métricas definidas, período, fonte, baseline, meta e qualidade dos dados. **Saídas:** dashboard/resumo, desvios, limitações, decisões e ações. **Ferramentas:** exportações, planilhas, CRM/AnyChat apenas após acesso aprovado. **Limites de segurança:** não preencher N/D com estimativa; mostrar denominador; separar observado de atribuído; ocultar/anonimizar dados pessoais. ## Fábrica de agentes ### Processo de criação 1. **Intake:** problema, frequência, responsável, risco, dados, destino e benefício esperado. 2. **Decisão build/no-build:** não criar agente para tarefa rara, sem responsável ou sem critério de aceite. 3. **Especificação:** missão, entradas, saídas, ferramentas, limites e exemplos. 4. **Threat model:** dados, prompt injection, exfiltração, abuso de canal, erro profissional e reputação. 5. **Protótipo offline:** arquivos sintéticos e sem ferramenta de escrita externa. 6. **Avaliação:** conjunto de casos feliz, ambíguo, adversarial e regulado. 7. **Shadow mode:** agente produz rascunho; humano executa a ação real. 8. **Piloto limitado:** pequena audiência, limites de volume e rollback. 9. **Produção supervisionada:** autonomia somente no risco baixo. 10. **Revisão:** métricas, incidentes, atualização de política e desativação quando necessário. ### Cartão de agente obrigatório | Campo | Conteúdo | |---|---| | Nome e versão | Identificação imutável da versão | | Responsável | Pessoa responsável pela operação | | Missão | Uma finalidade específica | | Fora de escopo | Ações proibidas | | Dados | Entradas permitidas, sensíveis e retenção | | Ferramentas | Leitura, escrita e destinos | | Aprovação | Quem aprova cada risco/canal | | Avaliações | Casos e limiar de aceite | | Métricas | Qualidade, segurança, custo e tempo | | Rollback | Como desligar e restaurar processo manual | ## Limites de segurança transversais ### LGPD e segurança - Definir controlador, operador e instruções contratuais para cada cliente. - Associar finalidade e hipótese legal por dado e processo; legítimo interesse exige finalidade, necessidade, balanceamento e salvaguardas e não se aplica a dados sensíveis. - Tratar saúde, biometria e outras categorias sensíveis com política específica; não usá-las para prospecção. - Coletar somente o necessário; separar tenants/clientes; mascarar logs; definir retenção e descarte. - Oferecer canal de direitos do titular e opt-out operacional. - Impedir segredos em prompt, output, log ou repositório comum. - Bloquear conteúdo externo que tente mudar instruções, pedir credenciais ou ampliar ferramentas. - Incidente ou vazamento interrompe o workflow e aciona o plano de resposta. Fontes: [LGPD](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709compilado.htm), [ANPD — agentes de tratamento](https://www.gov.br/anpd/pt-br/assuntos/noticias/nova-versao-do-guia-dos-agentes-de-tratamento) e [ANPD — legítimo interesse](https://www.gov.br/anpd/pt-br/centrais-de-conteudo/materiais-educativos-e-publicacoes/guia_orientativo_hipoteses_legais_tratamento_de_dados_pessoais_legitimo_interesse). ### Advocacia OAB - Conteúdo meramente informativo, discreto e sóbrio. - Bloquear honorários, descontos, gratuidade como captação, comparação, autoengrandecimento, promessa ou estímulo ao litígio. - Bloquear prospecção dirigida a potenciais partes/vítimas e campanhas de contratação. - Não usar decisões e resultados de casos como peça promocional. - Atendimento automatizado não dá parecer; contato é encaminhado a advogado. - Aprovação obrigatória do sócio/advogado responsável. Fonte: [Provimento 205/2021](https://www.oab.org.br/leisnormas/legislacao/provimentos/205-2021). ### Odontologia CFO CRO - Não produzir diagnóstico, prescrição ou promessa de resultado. - Imagem de paciente exige TCLE e regras de autoria/identificação. - Bloquear vídeo/imagem do transcurso do procedimento, salvo contexto científico permitido. - Não presumir que clínica pessoa jurídica possa publicar caso do profissional. - Conteúdo e campanha passam pelo RT/profissional responsável. Fontes: [Resolução CFO 196/2019](https://website.cfo.org.br/wp-content/uploads/2019/01/Resolu%C3%A7%C3%A3o-CFO-196-2019.pdf) e [orientação CFO 2025](https://website.cfo.org.br/redes-sociais-na-odontologia-fique-atento-as-normas-eticas-e-acerte-na-publicacao-dos-conteudos/). ### Estética - “Estética” pode envolver categorias e conselhos diferentes; identificar profissão, RT e norma antes de produzir peça. - Bloquear diagnóstico, indicação, contraindicação, prescrição e garantia. - Exigir autorização de imagem e revisão de claims. - Promoção, influenciador e antes/depois permanecem bloqueados até aprovação específica. ### Imobiliárias - Anúncios e respostas devem usar dados atualizados e verificáveis. - Escassez, preço, disponibilidade e condição dependem de fonte oficial. - Evitar critérios discriminatórios ou inferência de atributo protegido. - Corretor valida circunstâncias, riscos e informações antes de oferecer negócio. - Qualquer perfil financeiro ou crédito usa processo separado e legalmente revisado. Referência: [COFECI](https://www.cofeci.gov.br/post/corretor-de-im%C3%B3veis-profissional-qualificado). ### Contabilidade CFC - Não automatizar conclusão tributária individual, assinatura ou responsabilidade técnica. - Publicidade técnica e científica, moderada, discreta e não mercantilista. - Bloquear garantia de restituição/economia, afirmação desproporcional e comparação depreciativa. - Incluir identificação profissional/organizacional exigida nas peças. - Proposta e conteúdo técnico exigem revisão do contador responsável. Fontes: [NBC PG 01](https://cfc.org.br/tecnica/normas-brasileiras-de-contabilidade/nbc-pg-geral/), [publicidade contábil](https://cfc.org.br/noticias/codigo-de-etica-profissional-do-contador-e-atualizado-saiba-o-que-mudou/) e [identificação](https://cfc.org.br/fiscalizacao-etica-e-disciplina/perguntas-frequentes/assinatura-de-pecas-contabeis/). ## Níveis de risco e aprovação | Nível | Exemplo | Autonomia | Aprovação | |---|---|---|---| | Baixo | resumo interno de fontes públicas | Executar e registrar | Responsável revisa por amostragem | | Médio | rascunho de e-mail, post ou roteiro | Produzir, não enviar | Marketing/comercial | | Alto | saúde, jurídico, tributário, imagem, campanha, dado sensível | Somente rascunho e checagem | Responsável técnico/jurídico + dados quando aplicável | | Proibido | diagnóstico, parecer, prescrição, promessa, captação vedada, exfiltração | Bloquear | Não aprovável sem redesenho | ## Cadências operacionais ### Diário - 08h: pesquisa de sinais e fila de contas, sem envio. - 09h: revisão humana e priorização. - 11h: rascunhos de conteúdo/prospecção. - 14h: QA/compliance e devoluções. - 16h: publicação/envio aprovado por operador humano. - 18h: relatório de execução, erros e bloqueios. ### Semanal | Dia | Ciclo | |---|---| | Segunda | pauta, ICP, eventos gatilho e prioridades | | Terça | pesquisa competitiva e prospecção | | Quarta | conteúdo, vídeo e preparação de live | | Quinta | campanhas, demos e materiais de parceiros | | Sexta | reporting, QA, revisão de prompts e aprendizado aprovado | ### Mensal - revisão normativa e de fontes; - análise de ganhos e perdas e feedback humano; - auditoria de acesso, retenção e incidentes; - avaliação de agentes: precisão, aprovação, retrabalho, custo e valor; - promover, limitar ou desativar versões. ## Fluxo de aprovação humana 1. Agente autor produz artefato e evidências. 2. QA/compliance executa regras determinísticas e revisão contextual. 3. Responsável de negócio valida objetivo, público e claim. 4. Responsável setorial aprova conteúdo regulado. 5. Encarregado/jurídico valida dados ou campanha de risco. 6. Operador autorizado publica/envia. 7. Sistema registra versão, aprovadores, data, destino e métricas. **Regra:** silêncio não é aprovação. Alteração após aprovação invalida o aceite e reinicia o gate. ## Matriz RACI Papéis: **PAT** = patrocinador; **PO** = product responsável Hermes; **ENG** = engenharia/DevOps; **REV** = Gestão de operações comerciais/comercial; **MKT** = marketing; **COMP** = jurídico/LGPD/compliance; **RT** = responsável técnico/setorial; **OPS** = operador humano. | Atividade | PAT | PO | ENG | REV | MKT | COMP | RT | OPS | |---|---|---|---|---|---|---|---|---| | Priorizar casos de uso | A | R | C | C | C | C | C | I | | Definir arquitetura e acessos | I | A | R | C | I | C | I | I | | Criar agente | I | A/R | R | C | C | C | C | I | | Definir política LGPD | I | C | C | I | I | A/R | C | I | | Definir regra setorial | I | C | I | I | C | C | A/R | I | | Aprovar prospecção | I | C | I | A/R | C | C | C | I | | Aprovar conteúdo | I | C | I | C | A/R | C | R quando regulado | I | | Publicar/enviar | I | I | C | A | A | C | C | R | | Monitorar qualidade | I | A | C | R | R | C | C | R | | Responder incidente | I | C | R | I | I | A/R | C | I | | Desativar agente | I | A | R | C | C | C | C | I | Legenda: **R** executa; **A** responde pelo resultado; **C** consultado; **I** informado. ## KPIs e critérios de promoção de autonomia ### Qualidade - precisão factual e percentual de afirmações com fonte; - taxa de aprovação sem alteração; - severidade e volume de correções; - cobertura de checklist; - taxa de alucinação/claim sem evidência. ### Operação - tempo até rascunho; - tempo até aprovação; - jobs concluídos, bloqueados e reprocessados; - custo por job; - disponibilidade e falhas de ferramenta. ### Segurança e conformidade - dados pessoais indevidos por job; - tentativas bloqueadas; - conteúdo regulado sem aprovação; - opt-outs respeitados; - incidentes e tempo de contenção. ### Valor - horas poupadas validadas por amostragem; - pesquisa utilizada em decisão; - rascunhos publicados; - reuniões qualificadas aceitas; - melhoria de completude, resposta ou SLA, sem alegar causalidade automática. Autonomia só aumenta após quatro semanas sem incidente crítico, qualidade acima do limiar definido e aprovação formal do responsável e compliance. ## Cronograma de implantação 12 semanas | Semana | Entrega | Gate de saída | |---|---|---| | 1 | Inventário do Hermes, acessos, owners e dados | Ambiente validado; nenhuma credencial em documento | | 2 | Contrato de job, taxonomia de risco e catálogo inicial | PO e compliance aprovam | | 3 | Repositório de fontes/políticas e logs | Retenção e acesso definidos | | 4 | Atlas em pesquisa e reporting offline | Avaliações factuais aprovadas | | 5 | Atlas em inteligência competitiva | Fontes, datas e limites validados | | 6 | Luma em conteúdo com revisão humana | Nenhuma publicação automática | | 7 | Luma em roteiros de vídeo e lives | Gate setorial funcionando | | 8 | Prospecção e Qualificação em shadow mode | Nenhum envio; score explicável | | 9 | Promoções/Campanhas em sandbox | WABA/AnyChat ainda sem envio real, salvo homologação | | 10 | Integração piloto de uma ferramenta | Auth, logs, retry, rollback e teste de falha | | 11 | Piloto com um vertical e audiência controlada | Métricas e incidentes revisados | | 12 | Go/no-go, runbook, treinamento e backlog | Autonomia explicitamente aprovada | ## Backlog por prioridade ### P0 antes de qualquer automação externa - confirmar saúde do Hermes/WebUI e controle de acesso; - definir owners, tenants e segregação; - criar contratos de entrada/saída e logging; - implantar cofre de segredos; - cadastrar políticas LGPD e setoriais versionadas; - preparar botão de parada e rollback; - construir conjunto de avaliação. ### P1 produtividade interna - pesquisa de mercado; - inteligência competitiva; - reporting; - conteúdo, roteiro e live em modo rascunho; - QA/compliance independente. ### P2 receita supervisionada - prospecção e qualificação em shadow mode; - integração controlada com CRM/Inbox; - campanhas WABA com Dry run e aprovação; - experimentos por vertical. ### P3 autonomia limitada - agendamentos de jobs de baixo risco; - publicação interna automática; - ações externas reversíveis e com limites de volume; - nunca remover aprovação técnica de conteúdo regulado. ## Checklist de entrada em operação - [ ] Hermes e WebUI testados com autenticação e logs; - [ ] gateway continua não exposto diretamente; - [ ] owners e RACI assinados; - [ ] segredos fora de prompts e repositórios; - [ ] separação por cliente/tenant validada; - [ ] fontes oficiais e políticas versionadas; - [ ] conjunto de avaliações passou pelo limiar; - [ ] prompt injection e exfiltração testados; - [ ] níveis de risco aplicados; - [ ] aprovações humanas registradas; - [ ] opt-out e retenção implementados; - [ ] integrações testadas com falha, retry e rollback; - [ ] agente não publica ou envia além da autonomia concedida; - [ ] relatório distingue fato, hipótese e inferência; - [ ] runbook de incidente e desativação disponível; - [ ] revisão após 7, 14 e 30 dias agendada. ## Decisões ainda pendentes 1. Qual sistema será a fonte principal de contas, contatos e pipeline? 2. O Hermes terá fila própria ou será acionado pelo n8n/Paperclip? 3. Qual cofre armazenará credenciais? 4. Como será a separação por cliente e vertical? 5. Quais modelos podem processar quais categorias de dados? 6. Onde ficarão evidências, aprovações e retenção? 7. Quem exerce os papéis de compliance, encarregado e RT por vertical? 8. Qual vertical será o piloto e qual é o volume máximo? 9. Quais métricas autorizam ampliar autonomia? 10. Quais integrações AnyChat/Hermes são realmente necessárias no MVP? > Este documento descreve uma arquitetura proposta. O fato de um serviço existir no servidor não confirma integração, permissão, qualidade ou adequação regulatória. Cada conexão e cada autonomia devem ser aprovadas e testadas separadamente. # Conteúdo promocional e operação dos agentes de IA ## Dois agentes na primeira fase Atlas concentra pesquisa de mercado, concorrência, sinais de contas e qualidade das fontes. Luma concentra planejamento editorial, rascunhos de posts, roteiros de vídeos, lives e materiais de parceiros. Hermes organiza solicitações e revisões como arquitetura proposta. Os demais papéis do catálogo são especializações sob demanda desses dois agentes ou backlog futuro; não representam agentes adicionais já implantados. Nenhuma rotina abaixo foi agendada ou instalada neste material. A produção deve começar em modo rascunho, com publicação e mensagens por operador humano autorizado. Criar contas, chaves, campanhas e integrações requer homologação e os responsáveis definidos. | Agente | Produção diária sugerida | Produção semanal | Entrega mensal | |---|---|---|---| | Atlas | Até 24 fichas de contas com fonte e sinal público, priorizadas pelo time | Atualização de 3 concorrentes e uma síntese do nicho | Benchmark de 12 fornecedores e relatório de oportunidade | | Luma | Até 3 rascunhos, revisão de peças e reaproveitamento | 5 posts publicados após aprovação, 3 vídeos, 1 artigo e pauta de live | 20 posts, 12 vídeos, 4 artigos, 2 lives e kit de parceiro | São capacidades-alvo, não obrigação de volume sem qualidade. Atlas pode priorizar oito contas por vendedor, mas não deve preencher dado ausente com invenção. Luma deve produzir menos quando o responsável setorial não aprovar a pauta. O operador registra fonte, revisão, versão, publicação e link de atribuição. ## Calendário editorial de um mês | Semana | Tema | Conteúdos | Próximo passo comercial | |---|---|---|---| | 1 | Conversa sem responsável | Carrossel, vídeo geral e artigo odontologia | Diagnóstico administrativo | | 2 | Lead e próxima ação | Demo imobiliária, checklist e live de processo | Demonstração com dados sintéticos | | 3 | Informação e responsabilidade | Vídeo advocacia, post contábil e artigo de privacidade | Revisão de requisitos do escritório | | 4 | Implantação e prova | Vídeo estética, comparação de modalidades e live | Piloto com critério de aceite | Distribuição sugerida: 40% educação, 30% demonstração de produto, 15% implantação e bastidores, 10% parceiros e 5% oferta explícita. Ajustar pelos resultados e não transformar proporção em regra fixa. Todos os posts direcionam para uma página de nicho, artigo ou demonstração, com UTM de campanha e fonte no CRM. ## Identidade visual por ramo Manter logotipo Hablachat, hierarquia tipográfica e navegação comuns. Usar variação de cor, exemplos e fotografias reais autorizadas, preservando contraste mínimo legível e não usando cor como único sinal. Capturas do produto são evidência da operação, não decoração. | Ramo | Cor principal | Cor de apoio | Fotografia e linguagem | |---|---|---|---| | Marca Hablachat | Azul marinho #10233A | Ciano #21C2CC | Interface, equipe e processo | | Odontologia | Petróleo #087E92 | Verde suave #DDF4EE | Recepção e ambiente sem paciente identificável | | Estética | Ameixa #92538B | Areia #F4ECE4 | Diversidade, atendimento e avaliação responsável | | Advocacia | Bronze #73593B | Off white #F7F5EF | Escritório e informação sóbria | | Imobiliárias | Ocre #BE7126 | Terracota #C67A59 | Arquitetura real e mapa com fonte | | Contabilidade | Azul #326FA9 | Verde #237864 | Calendário, dados e organização | Usar fonte de interface legível como Inter ou Arial, corpo mínimo de 16 px no site e legendas visíveis no vídeo vertical. Evitar cifrões, selos de melhor, antes e depois corporal ou tribunal como atalho de confiança. A marca explica organização e apoio, não promete resultado profissional. ## Estrutura dos vídeos curtos Gancho nos primeiros dois segundos, uma situação reconhecível, prova visual, benefício operacional verificável e uma chamada para ação. Gravar em 9:16; legendar; mostrar a interface em close; preservar dados pessoais e credenciais. Testar duas aberturas com o mesmo corpo para comparar retenção e pedidos qualificados. Técnicas de edição e gancho são hipóteses de desempenho; não garantem viralização. Métricas: retenção em três segundos quando disponível, duração média assistida, conclusão, salvamentos, compartilhamentos, cliques, conversas qualificadas e demonstrações realizadas. Informar denominador e plataforma. Comparar somente campanhas com público e verba próximos; não declarar vencedor com poucas visualizações. ## Roteiro geral de 25 segundos 0 a 3 s: apresentador pergunta “Quem da sua equipe assumiu a última mensagem?” Texto na tela: conversa sem dono. 3 a 8 s: encenação identificada como exemplo de duas pessoas supondo que a outra respondeu. Fala: “Quando o responsável não está claro, o próximo passo depende da memória.” 8 a 17 s: gravação de Inbox e departamentos em homologação, sem dado real. Fala: “O Hablachat organiza os canais conectados, encaminhamento e acompanhamento. Primeiro configuramos, depois testamos com a equipe.” 17 a 25 s: apresentador e tela de processo. Fala: “Quer ver uma jornada do seu ramo? Peça uma demonstração.” CTA único: conhecer a demonstração. Não inserir percentual de vendas ou depoimento inexistente. ## Roteiro odontologia de 30 segundos Gancho A: “A recepção recebe pedidos de agenda ou perguntas clínicas?” Gancho B: “Nem toda pergunta de paciente deve ser respondida por um bot.” 0 a 6 s: mostrar três assuntos administrativos: horário, unidade e agenda. Fala: “O começo pode ser simples: separar o que é administrativo e encaminhar o que precisa de profissional.” 6 a 20 s: tela de widget com campos mínimos e transferência de homologação. Fala: “No Hablachat, a jornada pode pedir nome, retorno e preferência de período. Orientação clínica continua com a equipe habilitada.” 20 a 30 s: tela de tarefa e responsável. Fala: “Quer organizar a recepção sem prometer diagnóstico automático? Solicite o checklist da clínica.” CTA: checklist. Revisão pelo responsável técnico antes da publicação. ## Roteiro estética de 28 segundos Gancho A: “Lead interessado não é indicação de procedimento.” Gancho B: “Sua consultora recebe contexto ou só um oi?” 0 a 7 s: apresentador mostra perguntas sobre unidade e disponibilidade, sem imagem corporal. Fala: “O atendimento digital pode organizar interesse e horário sem decidir um procedimento.” 7 a 20 s: prova de fluxo com aviso, coleta administrativa e handoff. Fala: “Hablachat ajuda a encaminhar o contato com contexto e registrar a próxima ação. A avaliação individual permanece com o profissional.” 20 a 28 s: CTA: “Peça uma demonstração do atendimento responsável.” Não mostrar antes e depois, indicação, contraindicação ou resultado garantido. ## Roteiro advocacia de 30 segundos Gancho A: “Contato espontâneo precisa de acolhimento, não de parecer automático.” Gancho B: “Quem aprova o que o atendimento do escritório responde?” 0 a 8 s: apresentar assuntos administrativo, contato e informação geral. Fala: “Uma recepção digital deve ser informativa, discreta e encaminhar o que exige análise.” 8 a 22 s: mostrar departamento e tarefa com dados fictícios. Fala: “Hablachat organiza o contato recebido, responsável e acompanhamento. Não emite parecer, prognóstico ou promessa de êxito.” 22 a 30 s: CTA institucional B2B: “Conheça o desenho de organização do seu escritório.” Este vídeo vende software ao escritório; se adaptado para publicidade jurídica ao público, exige revisão própria do responsável. ## Roteiro imobiliárias de 26 segundos Gancho A: “Compra, locação e financeiro entram no mesmo número?” Gancho B: “O lead chega ao corretor com contexto?” 0 a 6 s: mostrar três destinos reais da referência Aura: Vendas, Locação e Financeiro. Fala: “Um contato precisa chegar à equipe certa.” 6 a 19 s: gravação da jornada sintética por intenção e região. Fala: “Hablachat registra o interesse declarado e encaminha. Estoque, preço e disponibilidade só vêm de uma fonte homologada ou do corretor.” 19 a 26 s: CTA: “Peça a demonstração de distribuição de leads.” Não inventar imóvel disponível ou escassez de unidades. ## Roteiro contabilidade de 28 segundos Gancho A: “É uma dúvida fiscal, de DP ou um novo cliente?” Gancho B: “Seu atendimento consegue mostrar quem ficou responsável?” 0 a 7 s: apresentar categorias de solicitação. Fala: “Misturar as demandas dificulta acompanhar prazo e responsável.” 7 a 21 s: mostrar triagem, ticket e tarefa em homologação. Fala: “O Hablachat organiza a entrada e encaminha por departamento. A decisão fiscal e a responsabilidade técnica continuam com o contador.” 21 a 28 s: CTA: “Conheça a demonstração de organização de demandas.” Evitar garantia de economia tributária ou declaração de conformidade automática. ## Roteiro de preço e anual de 30 segundos 0 a 3 s: “Compare o ano inteiro, não só a mensalidade.” 3 a 16 s: mostrar os preços do Completo em tela: 12 meses de lista R$ 9.564, anual à vista R$ 7.970, economia R$ 1.594. Fala: “O anual reduz a licença em 16,67%, com compromisso de 12 meses. Implantação e adaptação são serviços separados.” 16 a 24 s: mostrar a linha custos de terceiros. Fala: “Tarifas de canal e IA devem entrar na comparação; o preço publicado não elimina esses custos.” 24 a 30 s: CTA: “Solicite a proposta com escopo e custo total.” Publicar somente após aprovação financeira e contratual do preço de lançamento. ## Live de demonstração de 40 minutos | Tempo | Pauta | Responsável | |---|---|---| | 0 a 5 min | Problema operacional e escopo sem promessa | Apresentador comercial | | 5 a 12 min | Processo atual e campos mínimos | Especialista do nicho | | 12 a 25 min | Widget, triagem, handoff e acompanhamento | Consultor de solução | | 25 a 32 min | Falha, offline e limites de integração | Consultor de solução | | 32 a 37 min | Perguntas gerais moderadas | Moderador humano | | 37 a 40 min | Checklist e convite a diagnóstico | Apresentador | Não responder casos individuais de saúde, direito ou tributação. Ao surgir dado sensível, interromper e orientar contato privado com profissional. A gravação usa ambiente sintético e autorização dos participantes. Após o evento, Luma prepara três trechos, um artigo e resumo; Atlas verifica claims e fontes; humano aprova publicação. ## Promoções e experiências de crescimento Testar uma mudança por vez: gancho, CTA, formato ou página de destino. Registrar hipótese, orçamento, público, período, métrica primária e critério de encerramento. Limite inicial de mídia deve ser aprovado por financeiro e ter relação com capacidade de demos e implantação. Não criar promoção de anual abaixo da margem mínima para conseguir volume. Promoção honesta possível: lote de até três implantações por semana, se essa for a capacidade medida, com revisão adicional de processo no D30 dentro do orçamento. O operador registra capacidade livre antes de comunicar. Evitar contador regressivo fictício, cupom que nunca expira ou prova social inventada. ## Depoimentos demonstrativos para substituir Os textos abaixo são fictícios e não representam clientes ou resultados observados. Uso permitido apenas em layout identificado como exemplo ilustrativo. Substituir por depoimento real autorizado antes de usar como prova de venda. Exemplo ilustrativo odontologia: “O que buscamos foi uma recepção com próximos passos claros e uma forma de separar dúvidas administrativas das clínicas.” Persona fictícia: gestora de clínica. Exemplo ilustrativo imobiliárias: “Queríamos que compra, locação e financeiro chegassem ao responsável com contexto, sem depender de encaminhar mensagens manualmente.” Persona fictícia: diretor de imobiliária. Exemplo ilustrativo contabilidade: “Nossa prioridade era acompanhar categoria, prazo e responsável de cada solicitação.” Persona fictícia: sócia de escritório contábil. Modelo de autorização real: identificar cliente e porta voz, texto aprovado, uso de nome e imagem, canais, período, edição permitida e possibilidade de revogação conforme acordo. Validar fonte de cada número de resultado e não editar de forma que mude o sentido. ## Fontes de criação e produto - TikTok Creative Center https://ads.tiktok.com/business/creativecenter/ - Meta Reels https://www.facebook.com/business/ads/facebook-instagram-reels-ads - YouTube descoberta de Shorts https://support.google.com/youtube/answer/11914225 - YouTube métricas de Shorts https://support.google.com/youtube/answer/12942217 - Documentação AnyChat https://docs.anychat.one/ - Shared Inbox https://anychat.one/product/shared-inbox - ChatFlow webhook https://docs.anychat.one/chatflows-chatbot-builder/chat-flow-basics/send-a-webhook Essas fontes orientam a verificação de funcionalidades e práticas criativas. A hipótese de viralização deve ser testada no público da Hablachat; não existe promessa de alcance neste planejamento.