# Canal ChatGPT

O ChatGPT usa as rotas `/api/chatgpt` protegidas por `Authorization: Bearer SERVICEGPT_CHATGPT_API_KEY` e limitadas a 60 requisições por minuto. Produção exige HTTPS. Para preparar uma solicitação, envie um `Idempotency-Key` único; a repetição da mesma chave devolve o mesmo `request_id`, enquanto uma chave diferente cria uma nova solicitação. A chave externa é transformada em hash antes de persistência; o valor original nunca é armazenado ou registrado.

Fluxo: buscar cliente → preparar com `prepareServiceOrder` → mostrar cliente, equipamento, problema, serviço, técnico, valor e campos faltantes → aguardar confirmação explícita no turno atual → confirmar. "Ok", "beleza" e silêncio não são confirmação. Com cliente ambíguo, apresente os candidatos; se não encontrar, informe sem criar cadastro. Nunca invente IDs, use Bling diretamente, exponha segredos ou confirme automaticamente.

Use `service_order_request_id` retornado pelo backend como estado da conversa. Enquanto não estiver pronta, complemente com PATCH e apresente o resumo atualizado. Para cancelar, use a ferramenta correspondente somente antes da confirmação.

O contrato das sete ferramentas está em `chatgpt-openapi.yaml`: busca, interpretação, preparação, consulta, atualização, confirmação e cancelamento. Todas passam pelas rotas autenticadas `/api/chatgpt`; as rotas operacionais equivalentes também exigem a mesma chave e não formam bypass público. A opção de implantação recomendada pela documentação oficial é um plugin ChatGPT com servidor MCP remoto sobre HTTPS; esta fase mantém o Laravel como fonte de verdade e fornece o contrato HTTP para um adaptador MCP fino futuro, sem adicionar uma stack Node/Python.
