solapi

This is a community node for easily using Solapi message/Kakao/commerce webhooks in n8n.

Package Information

Released: 9/12/2025
Downloads: 141 weekly / 225 monthly
Latest Version: 0.2.5
Author: SOLAPI

Available Nodes

Solapi icon
Solapi
No description available
Solapi Trigger icon
Solapi Trigger
No description available

Documentation

Solapi for n8n (Community Node)

솔라피(Solapi) 메시지/카카오/커머스 웹훅을 n8n에서 쉽게 사용하기 위한 커뮤니티 노드입니다.

설치

  • n8n Community Nodes에서 설치
    • n8n UI → Settings → Community Nodes → Install → n8n-nodes-solapi 입력
  • 또는 수동 설치
    • 프로젝트에 패키지 설치 후 n8n 재기동

인증 설정 (OAuth2)

  1. n8n → Credentials → New → Solapi OAuth2 API 선택
  2. Solapi 콘솔에서 발급받은 Client ID/Secret 입력
  3. Scope 기본값 유지(권장):
message:write message:read senderid:read storage:write storage:read webhook:read webhook:write kakao:write kakao:read users:read contacts:read contacts:write commerce:read commerce:write
  1. Save & Connect로 로그인 → 연결 성공 확인

인증 설정 (API Key)

  1. n8n → Credentials → New → Solapi API Key 선택
  2. Solapi 콘솔에서 발급받은 API Key / API Secret 입력
  3. 노드의 Authentication에서 API Key (HMAC-SHA256) 선택
  4. 사용 시 각 요청에는 문서에 따라 HMAC-SHA256 시그니처가 자동으로 포함됩니다. 상세: Solapi API Key 인증 방식

사용 가능한 노드/오퍼레이션

리소스 Message에서 아래 오퍼레이션을 제공합니다.

  • Send Text Message

    • SMS/LMS/MMS 발송
    • 필수: To, From, Text
    • 선택: Subject(LMS), Image ID(MMS), Country Code(기본 82)
    • 동적 옵션: From(발신번호), Image ID(MMS 스토리지)

  • Send Kakao AlimTalk (ATA)

    • 템플릿 기반 알림톡 발송
    • 필수: To, Kakao Channel, Kakao Template
    • 선택: Template Variables(JSON), From(문자 대체발신), Country Code
    • 동적 옵션: Kakao Channel, Kakao Template

  • Send Kakao FriendTalk (CTA)

    • 카카오 친구톡 발송(채널 친구 대상)
    • 필수: To, Kakao Channel, Text
    • 선택: AD Flag, CTA Image ID, Buttons(JSON Array), From(문자 대체발신), Country Code
    • 동적 옵션: Kakao Channel, Kakao Image

  • On Message Report (Single)

    • 단건 메시지 결과 웹훅 트리거(SINGLE-REPORT)
    • 워크플로우 활성화 시 Solapi Outgoing Webhook 자동 등록/해지

  • On Group Report

    • 메시지 그룹 결과 웹훅 트리거(GROUP-REPORT)
    • 워크플로우 활성화 시 Solapi Outgoing Webhook 자동 등록/해지

  • On Commerce Action

    • 커머스 액션 트리거(결제완료 등)
    • 필수: Commerce Hook (Solapi 콘솔에서 미리 생성)
    • 워크플로우 활성화 시 선택한 Hook에 웹훅 연결/해지

필드 설명 요약

  • To: 콤마/줄바꿈으로 여러 번호 입력 가능. 국가코드는 Country Code로 설정(기본 82)
  • From: Solapi에 등록된 발신번호만 사용 가능(동적 옵션)
  • Image ID: Solapi Storage에 업로드된 파일의 fileId(동적 옵션)
  • Kakao Channel: Solapi에 등록된 PFID(동적 옵션)
  • Kakao Template: 선택한 채널에서 발송 가능한 템플릿(동적 옵션)
  • Template Variables(JSON): 템플릿 변수 맵. 예) { "name": "홍길동" }
  • Buttons(JSON Array): 친구톡 버튼 배열. 예)
[
  { "buttonName": "홈", "buttonType": "WL", "linkMo": "https://example.com" }
]

권한(Scopes)

  • 기본 제공 스코프로 대부분의 기능 동작
  • 최소 필요 스코프 예시
    • 메시지 발송: message:write
    • 발신번호 조회: senderid:read
    • 스토리지 조회: storage:read
    • 카카오: kakao:read kakao:write
    • 웹훅: webhook:read webhook:write
    • 커머스: commerce:read commerce:write

트러블슈팅

  • 401/403 인증 오류
    • 크리덴셜 연결 상태 확인 및 재인증
    • Solapi 앱의 Redirect URI에 n8n 크리덴셜 리다이렉트 URL 등록 여부 확인
  • 템플릿/채널 목록 비어있음
    • Solapi 콘솔에서 채널/PFID 및 템플릿 등록 상태 확인
    • 해당 채널에 발송 가능한 템플릿인지 확인
  • 문자 대체발신 미동작
    • From(문자 대체발신)을 비워두면 대체발송 비활성화됨. 등록된 발신번호 선택 필요
  • 웹훅 미수신
    • 워크플로우 활성화 상태 확인
    • 방화벽/외부 접근 가능한 n8n 호스트인지 확인
    • Solapi 콘솔의 Outgoing Webhook 목록에 등록 여부 확인

라이선스

MIT

Discussion