# Identificar Texto em Imagem — Orçamento Automático de Exames

Projeto baseado em um workflow [n8n](https://n8n.io/) que recebe, via WhatsApp
(canal Z-PRO), a foto/PDF/áudio de um pedido médico de exames, identifica os
exames solicitados e responde automaticamente ao cliente com um orçamento
formatado (itens + valores + total), usando um agente de IA.

## Arquivos principais

- `n8n/orcamento-exames-imagem.workflow.json` — export do workflow n8n com todo
  o fluxo (webhook de entrada, tratamento de imagem/PDF/áudio, agente de IA,
  envio da resposta via API do Z-PRO).
- `Z-PRO v4.x.x.x.postman_collection.json` — collection Postman com a API
  externa do Z-PRO (criação de ticket, envio de mensagem, listagem de
  contatos, entre outros endpoints).
- `docs/superpowers/specs/2026-08-20-orcamento-exames-imagem-design.md` —
  spec/design do fluxo.
- `docs/superpowers/plans/2026-08-20-orcamento-exames-imagem.md` — plano de
  implementação.

## Dependências externas

- **n8n** — plataforma de automação onde o workflow é executado.
- **Z-PRO** — canal/API de WhatsApp usada para receber mensagens do cliente e
  enviar o orçamento de volta.
- **OpenAI** — modelo de IA usado para leitura da imagem/PDF do pedido médico,
  transcrição de áudio (Whisper) e montagem do orçamento.

## Como importar o workflow no n8n

1. Na instância n8n de destino, use **Import from File** (ou **Import from
   URL**) e selecione `n8n/orcamento-exames-imagem.workflow.json`.
2. Após a importação, o n8n vai pedir para associar cada nó que usa credencial
   a uma credencial existente na sua instância (ver seção abaixo).
3. Revise o node de webhook e a URL de envio ao Z-PRO — ambos contêm
   identificadores específicos da instância de origem (ver "Credenciais e
   portabilidade").

## Credenciais e portabilidade

- **As credenciais NÃO são armazenadas neste repositório.** O JSON do
  workflow referencia credenciais apenas por `id` e `name` (ex.:
  `"openAiApi": { "id": "h16jFm10cTU15k6M", "name": "OpenAI - Orçamento de
  Exames" }`), que são identificadores da instância n8n de origem — não são as
  chaves/segredos em si.
- Após importar o workflow, é necessário **configurar/reassociar as
  credenciais correspondentes** (OpenAI e API do Z-PRO/`httpHeaderAuth`) na
  instância n8n de destino.
- O workflow também contém identificadores específicos da instância de
  origem que não são segredos, mas reduzem a portabilidade direta: o `id` do
  workflow, o `webhookId` do nó de entrada, e a URL de envio ao Z-PRO
  (`https://apigchat.gtigrupo.com.br/...`), que inclui um identificador de
  integração usado por essa instância.