틀 연습(opic2) 화면에서 말하기 스크립트를 n8n 웹훅으로 보내고, OpenAI가 OPIc 기준으로 평가한 결과를 받아 화면에 보여 주기까지 만든 과정을 정리한 문서입니다.
[GitHub Pages 앱 (opic2)]
│ POST JSON { question, kind, transcript, seconds }
▼
[n8n Webhook 노드] ── CORS 허용: https://chrisna2.github.io
▼
[Code: 입력 검증 + 프롬프트 구성]
▼
[IF: ok 인가?] ── 아니면 ──────────────────────────┐
▼ 맞으면 │
[HTTP Request: OpenAI Chat Completions] │
▼ │
[Code: 응답 파싱 + 기록 형식 보정] │
▼ │
[Respond to Webhook: JSON 응답] ◀─────────────────┘
▼
[앱: 결과 표시 + localStorage 날짜별 저장]
opic2/config.js).| 개념 | 설명 | 이번 프로젝트에서 |
|---|---|---|
| Webhook 노드 | 외부에서 HTTP 요청을 받는 시작점 | POST, path opic-eval, Respond 모드 “Respond to Webhook node” |
| Test URL vs Production URL | 테스트: /webhook-test/..., 운영: /webhook/... |
테스트 주소는 Execute를 누른 뒤 한 번만 응답함. 운영은 Active면 계속 응답 |
| Execute workflow | 편집 화면에서 테스트 웹훅을 대기 상태로 만드는 버튼 | 운영 주소로 바꾸면 불필요 |
| Active 스위치 | 워크플로우를 운영 상태로 켜는 스위치 | 켜야 운영 주소가 동작함 |
| Allowed Origins (CORS) | 어느 웹 페이지가 이 웹훅을 호출해도 되는지 지정 | https://chrisna2.github.io (경로 없이 origin만) |
| Code 노드 | JavaScript로 데이터를 가공 | 입력 검증, 프롬프트 구성, 응답 파싱 |
| IF 노드 | 조건에 따라 분기 | ok가 true면 OpenAI 호출, 아니면 바로 응답 |
| HTTP Request 노드 | 임의의 API 호출 | OpenAI Chat Completions 호출 |
| Respond to Webhook | 웹훅 요청자에게 응답을 돌려줌 | 결과 또는 오류 JSON 반환 |
| Credentials (자격증명) | 키를 워크플로우 밖에 안전하게 보관 | OpenAI account(openAiApi) |
$input.first().json.body에 있습니다.json.headers, json.query에 있습니다.webhook-test 주소를 쓰고 있었음.webhook(운영)으로 변경.No 'Access-Control-Allow-Origin' headerhttps://YOUR-APP-ORIGIN)였음.curl -i -X OPTIONS "https://<인스턴스>/webhook/opic-eval" \
-H "Origin: https://chrisna2.github.io" \
-H "Access-Control-Request-Method: POST" \
-H "Access-Control-Request-Headers: content-type"
204 + Access-Control-Allow-Origin: https://chrisna2.github.io.CRYPT_E_NO_REVOCATION_CHECK 오류는 schannel의 취소 목록(CRL) 확인 실패입니다.--ssl-no-revoke 옵션을 쓰면 우회됩니다. 브라우저에서는 보통 문제가 없습니다.platform.openai.com에서 키를 발급받고, 결제 수단과 크레딧이 있어야 호출이 됩니다.gpt-4.1-mini (Code 노드 Validate and Build Prompt의 MODEL 값).opic2/config.js의 주소가 /webhook/opic-eval(운영)인가?https://chrisna2.github.io인가? (n8n 화면에서 저장했는가?)OpenAI Chat 노드에 자격증명이 연결되어 있는가?204와 Access-Control-Allow-Origin을 돌려주는가?curl -X POST "https://<인스턴스>/webhook/opic-eval" \
-H "Content-Type: application/json" \
-d '{"transcript":"","question":"test","kind":"survey"}'
→ {"ok":false,"error":"스크립트가 비어 있어요."}가 나오면 웹훅과 검증 로직은 정상입니다.
{"result":{"grade","summary","good","problems","actions"}} 형태입니다.