Referência de engenharia · 14 de setembro de 2026
GoGenetic Agente Digital¶
Do primeiro contato no WhatsApp ao atendimento humano: entenda o fluxo, encontre os contratos e acompanhe cada decisão até sua implementação.
Escolha seu ponto de entrada¶
-
Começando
Prepare Python, configure os adapters e faça a primeira execução com dados fictícios.
-
Arquitetura
Siga uma mensagem pelas filas, guardas de concorrência, estados e persistência.
-
Agentes de IA
Veja prompts, histórico, enriquecimento contextual e o contrato
{JSON}Mensagem. -
Integrações
Consulte requests, respostas, autenticação, retries e substituição de providers.
-
Referência
Localize estados, códigos, serviços, variáveis, payloads e erros.
-
Testes
Diferencie testes unitários, replays, chamadas reais à IA e smokes controlados.
-
Operação
Use o dashboard, investigue incidentes e siga os runbooks de deploy e homologação.
-
Desenvolvimento
Encontre o ponto de extensão para serviços, integrações e alterações nos agentes.
A plataforma em um diagrama¶
flowchart LR
Cliente["Cliente no WhatsApp"] --> Webhook["Webhook Lambda"]
Webhook --> FIFO["SQS FIFO por telefone"]
FIFO --> Orq["Orchestrator Lambda"]
Orq <--> DB[("DynamoDB")]
Orq --> Agentes["Triagem · Qualificação · Coleta"]
Agentes --> IA["OpenAI Responses API"]
Agentes --> KB["Context Packages e overrides"]
Orq --> Confirm["Confirmação cadastral"]
Confirm --> Cadastro["Contato CRM + eGestor"]
Cron["Agendamento a cada minuto"] --> Sync["CRM sync assíncrono"]
Sync <--> DB
Sync --> CRM["Contato e deal no CRM"]
Orq --> Humano["Handoff e painel /atendimento"]
Orq --> Saida["WhatsApp outbound"]O core conduz pré-atendimento comercial: identifica segmento e intenção, qualifica um serviço do catálogo, coleta cadastro e prepara o atendimento humano. As decisões de estado e os efeitos externos pertencem ao código; a IA propõe ações em um contrato validado pelo parser.
O painel humano reúne a fila e as ações de assumir, responder e finalizar. O dashboard de desenvolvimento oferece chat, logs, cenários, conhecimento, prompts e smokes; são superfícies com propósitos e controles diferentes.
Como usar esta referência¶
Para entender um comportamento, comece pelo fluxo e abra a página do componente. Para corrigir um incidente, consulte troubleshooting e erros. Para evoluir o sistema, siga os tutoriais de integração, serviço e agentes.
Escopo verificado
Esta edição reflete o código da branch fix/ajustes, base 175a0bd986675a75ef760349b123595bf9fe714d. Nove estados, quinze serviços e quinze Context Packages foram identificados no código. Configurações remotas e homologação de produção não foram verificadas nesta tarefa. Veja auditoria, fontes e divergências.