n8n 주문 자동화: Claude API 연동 튜토리얼

시나리오: 매일 수동으로 주문 메시지에 답장하다 보면 감당이 안 됨

요식업, 소매업, 커뮤니티 공동구매 같은 로컬 비즈니스를 하면 주문 메시지가 대부분 위챗, 폼, 또는 매장 백오피스에 쌓입니다. 패턴은 거의 고정적입니다. 새 주문이 들어오면 내용을 보고 일반 주문인지 고객 불만인지 판단한 뒤 확인 메시지를 보냅니다. 주문량이 적을 때는 괜찮지만 주문량이 늘어나면 대부분의 시간을 반복 응답에 쏟게 됩니다.

이 튜토리얼의 목표는 구체적입니다. n8n으로 자동화 파이프라인을 구축해서, 새 주문이 들어오면 AI가 자동으로 의도를 판단하고 답변을 생성하며, 일반 주문은 바로 자동 응답하고, 고객 불만 주문은 사람에게 전달하면서 동시에 알림을 보내는 것입니다. 전 과정에서 코드를 작성하지 않으며, 모델 연동에는 HiAPI API key 하나만 있으면 됩니다.

2026년 이후 n8n은 여러 자동화 도구 정리 글에서 중소 상인에게 반복적으로 추천되고 있습니다(예: Atlassian, techaigoz의 2026년 연간 정리). 이유는 명확합니다. 셀프 호스팅, 오픈소스, 성숙한 LLM 노드 체계. 2026년 10월, X에서 n8n으로 로컬 소상공인 주문을 자동화한 게시물 하나가 약 5.1만 조회수를 기록했는데, 이는 이 수요가 이미 보편화되었음을 보여줍니다.

준비: HiAPI key 하나 + n8n 하나

시작하기 전에 두 가지만 있으면 됩니다.

첫째, HiAPI의 API key. HiAPI 콘솔에서 생성하고 복사하세요. 형식은 sk-로 시작합니다. 이 key는 OpenAI 호환이며, 이후 n8n의 모든 모델이 이 key를 사용합니다.

둘째, n8n. 클라우드 버전이나 셀프 호스팅 모두 가능하며, 이 글은 배포 방식을 가리지 않습니다. 유일한 요구사항은 버전이 너무 오래되지 않은 것이며, 이유는 아래에서 설명합니다.

핵심 단계: OpenAI Chat Model 노드에 HiAPI 연동

전체 파이프라인의 핵심은 n8n을 모델에 연결하는 것입니다. 방법은 생각보다 간단합니다. n8n의 AI 노드 체계에는 OpenAI Chat Model 하위 노드가 있는데, 그 Credential에 Base URL 입력란이 있어 OpenAI 호환 엔드포인트와 API Key를 입력하면 사용할 수 있습니다(이 기능은 n8n 커뮤니티에서 이미 논의된 바 있으며, 커뮤니티 글 Override baseURL for OpenAI Node 참고).

구체적으로 세 가지를 입력합니다:

1. Base URL: https://api.hiapi.ai
2. API Key: 당신의 HiAPI key(sk-로 시작)
3. Model: 직접 입력 deepseek-v4.1-flash

두 가지에 주의하세요. 첫째, 사용해야 하는 것은 AI 노드 체계의 OpenAI Chat Model 하위 노드이지, 구형 OpenAI 노드가 아닙니다. 둘째, Base URL 필드는 비교적 최신 버전의 n8n에만 있으며 일부 구버전에는 이 필드가 없으므로, 먼저 n8n을 최신 버전으로 업그레이드한 뒤 구성하세요.

입력하고 나면 워크플로 전체의 모든 AI 노드가 이 Credential 하나를 공유합니다. 나중에 모델을 바꾸고 싶으면 Model 칸만 수정하면 됩니다. 예를 들어 고객 불만 시나리오에서 claude-opus-4-8로 바꾸면 되고 key는 건드릴 필요가 없습니다.

여기까지 하면 모델 연동이 끝납니다. 다음은 워크플로 자체입니다.

워크플로 4단계

전체 파이프라인은 네 개의 노드로 연결됩니다: Webhook 트리거, AI 분류 및 답변 초안 작성, IF 분기, 알림.

1. Webhook 트리거

Webhook 노드를 입구로 사용합니다. 주문 시스템(폼, 매장 백오피스, 중계 봇)에 새 주문이 들어오면 메시지 내용을 이 주소로 POST합니다. 트리거가 받은 주문 텍스트는 뒤의 AI 노드로 전달됩니다.

아직 시스템 연동이 없다면 n8n의 폼 트리거 노드로 새 주문을 수동 시뮬레이션하여 흐름을 먼저 검증한 뒤 실제 데이터 소스로 교체해도 됩니다.

2. AI 노드: 분류 + 답변 초안

AI Agent 노드(또는 간소화된 Chain 노드)를 연결하고 방금 구성한 OpenAI Chat Model Credential을 붙이고, 모델은 deepseek-v4.1-flash를 입력합니다. 시스템 prompt가 두 가지를 담당합니다. 이 메시지가 일반 주문인지 고객 불만인지 판단하고, 각각 상인 말투로 답변 초안을 작성합니다.

아래는 바로 사용할 수 있는 시스템 prompt이며, 매장 이름과 업종만 바꾸면 실행됩니다:

你是一个本地餐饮商家的接单助手。请按以下规则处理每条用户消息：

1. 先判断消息类型：
   - 常规订单：用户明确下单，包含商品、数量、地址或取餐方式
   - 客诉：用户对商品或服务表达不满、要求退款、投诉
   - 其他：询问营业时间、菜单等不需要立即回复的内容

2. 再按类型生成回复：
   - 常规订单：以商家口吻确认订单内容，复述商品和数量，说明预计出餐或送达时间，语气亲切自然
   - 客诉：先表达歉意和重视，说明会尽快人工处理，不要承诺具体赔偿方案
   - 其他：正常回答用户问题

3. 输出格式严格为 JSON，两个字段：
   - category：order / complaint / other
   - reply：拟好的回复文本

只输出 JSON，不要输出任何解释。

AI가 구조화된 JSON을 출력하도록 요구하는 것이 핵심입니다. 그래야 뒤의 IF 분기가 안정적으로 판단할 수 있습니다. 가끔 표준에 맞지 않게 출력된다면 AI 노드 뒤에 간단한 데이터 정리 단계를 추가해 보완하세요.

3. IF 분기: 일반 주문 자동 응답, 고객 불만 사람에게 에스컬레이션

IF 노드로 category 필드를 읽습니다:

• order 또는 other: 자동 응답으로 진행하여 reply 텍스트를 당신의 알림 채널(위챗 봇, 이메일, SMS 등 연동한 것)로 고객에게 전송
• complaint: 자동 응답하지 않고, 주문 원문과 분류 결과를 패키징하여 점주 또는 당직자에게 알림을 보내고, 권장 대응 화법을 첨부하여 사람이 인계받을 때까지 대기

이 분기가 전체 파이프라인의 가치입니다. AI가 대부분의 반복 확인 메시지를 처리하고, 사람은 판단력과 공감이 필요한 고객 불만만 처리합니다.

4. 알림 노드

마지막으로 알림 노드를 연결하여 처리 결과를 협업 도구(Feishu, 위챗, 이메일 모두 가능)로 보냅니다. 일반 주문은 자동 회신 완료 알림을, 고객 불만 주문은 전체 주문 정보와 함께 수동 처리 대기로 표시하여 알립니다. 이렇게 하면 파이프라인 실행 기록을 지켜보지 않아도 매장에서 무슨 일이 일어나는지 실시간으로 알 수 있습니다.

비용 제어: 일반은 flash, 복잡한 것은 opus

작업별로 모델을 선택하는 것이 이 흐름의 비용 제어 핵심이며, 모든 요청에 가장 비싼 모델을 쓸 필요는 없습니다.

• 일반 분류와 응답은 deepseek-v4.1-flash로, 입력 $0.44 / 백만 token, 출력 $1.32 / 백만 token(HiAPI 플랫폼 가격, 2026-10 기준). 주문 메시지는 보통 수백 token이므로 주문 한 건당 모델 비용이 매우 낮아 1센트 미만으로 추산됩니다
• 고객 불만 분석, 긴 문맥 요약 같은 복잡한 시나리오에서는 claude-opus-4-8로 전환, 입력 $2.29 / 백만 token, 출력 $11.47 / 백만 token(2026-10 기준). 고객 불만 비중이 작아 총비용 영향은 제한적입니다

가격은 이 정도로만 언급하고, 자세한 가격은 모델 상세 페이지를 참고하세요. 작업별 모델 선택이 왜 비용을 절감하는지 더 알고 싶다면 이전에 작성한 Notion AI 자동 라우팅 실천을 보세요. 작업별로 요청을 다른 모델로 분배하는 완전한 사고방식이 담겨 있으며, 이 글의 주문 시나리오와 같은 논리입니다.

FAQ

API key를 n8n에 두는 것이 안전한가요?

key는 n8n의 Credential(자격 증명)에 입력해야 하며, 노드 파라미터나 코드에 직접 작성하면 안 됩니다. Credential은 n8n에서 암호화되어 저장되며, 워크플로를 내보내 공유할 때 key가 포함되지 않습니다. 또한 HiAPI 콘솔에서 이 key에 사용량 상한을 설정하는 것을 권장합니다. 유출되더라도 손실을 통제할 수 있습니다.

429(요청이 너무 빈번함)가 발생하면 어떻게 하나요?

429는 속도 제한에 걸렸다는 뜻입니다. 먼저 짧은 시간에 대량 주문이 일괄 유입되었는지 확인하고, 트리거 간격을 늘리거나 AI 노드에 대기열을 추가할 수 있습니다. 지속적으로 발생하면 HiAPI 콘솔에서 현재 key의 동시성 및 할당량 설정을 확인하고 필요 시 요금제를 조정하세요. 워크플로에서 AI 노드에 재시도 정책을 설정하여 429 발생 시 자동으로 지연 후 재시도하도록 할 수도 있습니다.

다른 모델로 바꿀 수 있나요?

가능합니다. Model 칸을 HiAPI의 임의 모델 이름으로 바꾸면 됩니다. 예를 들어 일반 주문은 deepseek-v4.1-flash, 고객 불만은 claude-opus-4-8로 바꾸면 되고 key와 Base URL은 변경할 필요가 없습니다. key 하나로 모든 모델을 사용할 수 있다는 점이 각 공식 key를 따로 신청하는 대신 HiAPI를 쓰는 편리함입니다.

공식 API key를 직접 신청하는 것과 무슨 차이가 있나요?

핵심은 두 가지입니다. 첫째, HiAPI key 하나로 여러 모델을 커버하므로 각 공식 플랫폼에 따로 가입하고, 따로 충전하고, 따로 할당량을 관리할 필요가 없습니다. 둘째, 사용량 기반 과금이 통합 정산되어 호출량이 여러 모델에 분산된 시나리오에서 더 유리합니다. 중소 상인에게는 관리 비용이 단가 차이보다 더 중요합니다.

스트리밍(streaming) 출력을 지원하지 않아도 문제없나요?

문제없습니다. 이 파이프라인은 주문을 비동기로 처리하므로 AI가 답변 생성을 마치면 한 번에 반환하면 됩니다. 채팅 인터페이스처럼 글자 단위로 표시할 필요가 없습니다. 스트리밍 여부는 결과에 영향을 주지 않습니다.

n8n에 Base URL 필드가 없으면 어떻게 하나요?

사용 중인 n8n 버전이 너무 오래된 것입니다. Base URL은 AI 노드 체계의 OpenAI Chat Model 하위 노드 파라미터이며 비교적 최신 버전에만 있습니다. 먼저 n8n을 최신 버전으로 업그레이드한 뒤 위의 Credential 구성 단계를 따르세요.

핵심 결론

• 연동은 Credential 한 곳만 수정하면 됩니다. Base URL에 https://api.hiapi.ai, API Key에 HiAPI key, 모델명에 deepseek-v4.1-flash를 직접 입력하고 코드는 작성하지 않습니다.
• 분류와 답변 초안 작성을 한 번의 AI 호출로 완료하고, 엄격한 JSON 출력 형식을 사용해야 뒤의 IF 분기가 안정적으로 판단할 수 있습니다.
• 일반 주문은 자동 응답, 고객 불만은 매번 사람에게 에스컬레이션하며, 이 경계는 IF 분기가 강제로 실행합니다.
• 비용은 난이도에 따라 씁니다. 일반 주문은 flash, 처리하기 어려운 메시지는 claude-opus-4-8로 전환하며 같은 key에서 모델명만 바꿉니다.
• key는 n8n Credential에 통합 관리하고, 429 발생 시 지연 재시도를 하며, 모델 교체는 한 곳만 수정하면 됩니다.