n8n-nodes-biztalk

비즈톡 BGMS 발송(알림톡/문자/브랜드메시지/네이버/RCS/전송결과/수신차단)을 n8n 워크플로우에서 쓰기 위한 커뮤니티 노드.

직접 비즈톡 API 를 호출하지 않고 mcp-bridge(두 Java SDK 를 감싼 REST bridge)를 경유한다. 멀티계정 구조이므로 발송 계정 자격증명을 Credential 에 넣으면 매 요청 헤더로 전달된다.

구성

| 파일 | 역할 | |---|---| | credentials/BiztalkBgmsApi.credentials.ts | Base URL + X-API-Key + X-BGMS-BSID + X-BGMS-PASSWD (헤더 자동 주입) | | nodes/BiztalkBgms/BiztalkBgms.node.ts | 9개 리소스 / 22개 operation. 본문은 JSON 필드로 전달 |

리소스/오퍼레이션은 bridge 의 /bgms/** 와 1:1 (OpenAPI: mcp-bridge/docs/openapi/bgms-openapi.yaml).

인증 모델

n8n  ──(X-API-Key + X-BGMS-BSID + X-BGMS-PASSWD)──▶  mcp-bridge  ──▶  비즈톡 BGMS

• X-API-Key: bridge 출입 키 (운영자 발급)
• X-BGMS-BSID / X-BGMS-PASSWD: 발송 비즈톡 계정 — 사용자별로 각자 Credential 에 저장

빌드

npm install
npm run build      # dist/ 생성 (tsc)

로컬 n8n 에서 테스트

# 1) 이 패키지를 전역 링크
npm link

# 2) n8n 의 커스텀 노드 디렉토리에 링크
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom && npm link n8n-nodes-biztalk

# 3) n8n 재시작 후 노드 검색창에서 "Biztalk BGMS" 확인
n8n start

또는 package.json 의 community-node 설치(설정 > Community Nodes)에 n8n-nodes-biztalk 입력(npm 발행 후).

사용 예

1. Credential 등록: Biztalk BGMS API → Base URL(https://bridge.example.com), API Key, BSID, Password.
2. 노드 추가: Resource=알림톡, Operation=발송.
3. Body(JSON) 에 발송 payload 입력. 예(알림톡):

   {
     "senderKey": "...", "tmpltCode": "TC-001",
     "phoneNumber": "01012345678", "message": "주문이 접수되었습니다."
   }

   정확한 필드는 OpenAPI 스펙 / bridge Swagger UI(/swagger-ui/index.html) 참조.

Body 형태 힌트: 배치 {"msgList":[...]}, 전송결과 ack {"pk":"..."}, 수신차단 add/delete ["01012345678"], 이미지 업로드 {"imageUrl":"...","imageName":"..."}.

발행 (npm)

npm run build
npm publish        # n8n-nodes-* 규칙이라 커뮤니티 노드로 설치 가능

발행에는 npm 계정/권한 필요. 사내 레지스트리를 쓰면 publishConfig.registry 설정.

상태

• v0.1.0 — 코드 작성 완료. 실제 n8n 인스턴스 검증 / npm 발행 전.