가이드

메시지 (Solapi)

작성일 2026.03.20 | 수정일 2026.03.20

메시지 (Solapi)

Solapi API를 통해 문자 메시지(SMS/LMS/MMS)와 카카오톡 알림톡을 발송하는 노드입니다.

주요 기능

Operation

설명

문자 발송

SMS/LMS/MMS 문자 메시지 발송

알림톡 발송

카카오톡 알림톡 (템플릿 기반 정보성 메시지) 발송

설정 항목

문자 발송 (sendText)

항목

타입

기본값

설명

수신번호

string

-

수신자 전화번호 (쉼표로 여러 번호 구분) (필수)

발신번호

options

-

등록된 발신번호 목록에서 선택 (필수)

메시지 내용

string

-

발송할 메시지 내용 (필수)

제목

string

-

LMS/MMS 제목 (선택)

이미지 ID

options

-

MMS 이미지 (목록에서 선택 또는 직접 입력)

국가코드

string

82

수신자 국가 코드

알림톡 발송 (sendKakaoATA)

항목

타입

기본값

설명

수신번호

string

-

수신자 전화번호 (필수)

카카오톡 채널

options

-

카카오톡 채널 선택 (필수)

카카오톡 템플릿

options

-

사용할 알림톡 템플릿 선택 (필수)

템플릿 변수

fixedCollection

-

템플릿에 치환할 변수 이름/값 쌍

발신번호

options

-

문자 대체 발신번호 (선택, 미입력 시 SMS 대체 발송 비활성화)

국가코드

string

82

수신자 국가 코드

동적 목록 로드

다음 항목은 Solapi 계정에서 자동으로 목록을 불러옵니다.

  • 발신번호: 활성화된 발신번호 목록

  • 이미지 ID: 등록된 MMS 이미지 목록

  • 카카오톡 채널: 연결된 카카오톡 채널 목록

  • 카카오톡 템플릿: 선택한 채널의 발송 가능한 템플릿 목록

  • 템플릿 변수: 선택한 템플릿의 변수 목록

인증 정보

Solapi 계정의 API Key와 API Secret이 필요합니다. Solapi 콘솔에서 발급받을 수 있습니다.

사용 예시

워크플로우 결과 알림 발송

  1. 워크플로우의 마지막 단계에 Solapi 노드를 추가합니다.

  2. 문자 발송을 선택하고 수신번호와 메시지 내용을 설정합니다.

  3. 메시지 내용에 이전 노드의 결과를 {{ $json.result }} 등으로 매핑합니다.

카카오톡 알림톡으로 주문 알림

  1. 카카오톡 채널과 승인된 알림톡 템플릿을 선택합니다.

  2. 템플릿 변수에 주문 정보(주문번호, 상품명, 금액 등)를 매핑합니다.

  3. 수신번호에 고객 전화번호를 입력합니다.

대량 발송

  1. 수신번호에 쉼표로 구분된 여러 번호를 입력합니다.

  2. 각 번호에 동일한 메시지가 개별적으로 발송됩니다.

참고 사항

  • AI 도구(Tool)로 사용 가능합니다 (usableAsTool: true).

  • 수신번호는 쉼표(,) 또는 줄바꿈으로 구분하여 여러 번호를 입력할 수 있습니다.

  • SMS는 90바이트, LMS는 2,000바이트까지 발송 가능합니다. 내용 길이에 따라 자동으로 SMS/LMS가 결정됩니다.

  • 이미지 ID를 입력하면 MMS로 발송됩니다.

  • 알림톡 발송 시 발신번호를 설정하지 않으면 SMS 대체 발송이 비활성화됩니다.

  • Solapi 공식 문서에서 API 사양과 요금을 확인할 수 있습니다.