API

대체발송

작성일 2026.03.01 | 수정일 2026.03.01

warning

친구톡 서비스 종료 안내

카카오 정책에 따라 친구톡 서비스는 2025.12.31부로 종료되었습니다.
2026.01.01 이후 모든 친구톡(CTA/CTI) 발송 요청은 브랜드 메시지 자유형으로 자동 전환되어 발송됩니다.

  • 친구톡(CTA) → 브랜드 메시지 자유형(TEXT)

  • 이미지 친구톡(CTI) → 브랜드 메시지 자유형(IMAGE)

브랜드 메시지로의 자동 대체 발송을 원치 않는 경우, 친구톡 발송을 시도하지 말고 문자 발송으로 직접 요청해야 합니다.

알림톡(ATA), RCS, 네이버 스마트 알림톡(NSA) 등의 경우 기본적으로 대체발송이 활성화되어 있습니다.

messages.kakaoOptions.disableSms (카카오), messages.rcsOptions.disableSms (RCS), messages.naverOptions.disableSms (네이버)를 true로 설정하지 않는 한, 발송에 실패하면 문자(SMS, LMS)로 대체 발송을 시도합니다.

대체발송 지원 여부

메시지 타입대체 발송 지원
SMS
LMS
MMS
카카오 알림톡✔️
카카오 친구톡 / 카카오 이미지 친구톡
(친구톡 서비스 종료로 항상 대체발송 됩니다)
✔️
카카오 브랜드 메시지 템플릿형
카카오 브랜드 메시지 자유형✔️
RCS SMS✔️
RCS LMS✔️
RCS MMS✔️
RCS 템플릿
RCS 이미지 템플릿
네이버 스마트 알림톡✔️
음성 메시지
FAX

대체발송 조건

대체발송이 정상적으로 동작하려면 요청 본문에 다음 조건을 모두 만족해야 합니다.

조건설명
disableSmsfalse로 설정 (기본값)
messages.from사전 등록된 발신번호 명시
chat

알림톡 발송 시 from 필드는 빈 값도 허용되지만, 대체발송을 원한다면 반드시 사전 등록된 발신번호를 명시해야 합니다.
조건을 만족하지 않으면 알림톡 발송 실패 시 그대로 실패로 종결됩니다.

발신번호 사전 등록하러 가기

실패 원인 타입별 대체발송 특성

원래 타입메시지 성격대체발송 설명
알림톡정보성 메시지기술적 전달 실패에 기반한 대체발송
친구톡광고성 메시지정책적 규칙을 포함한 대체발송 (2025.12.31 서비스 종료)
RCS리치 커뮤니케이션기술적 및 정책적 제약에 기반한 대체발송
BMS 자유형광고성 메시지채널 미추가, 수신 불가 등 발송 실패 시 LMS로 대체발송
RCS리치 커뮤니케이션기술적 및 정책적 제약에 기반한 대체발송

대체발송 시 원래 메시지 타입의 가격은 환불되고 각 문자 타입에 맞는 금액이 차감됩니다.

친구톡 대체발송 시 (광고) 문구 자동 추가
친구톡 발송이 실패하여 문자 메시지로 대체 발송될 때, 솔라피 시스템은 정보통신망법의 광고성 정보 전송 규제를 준수하기 위해 메시지 본문에 (광고) 문구를 자동으로 추가합니다.
자세한 내용은 해당 공지를 확인해주세요.

대체발송 시 메시지 콘텐츠 변환

카카오톡의 리치 미디어 환경에서 문자 메시지 환경으로 채널이 전환될 때, 솔라피 시스템은 정보 손실을 최소화하고 핵심 내용을 보존하는 방향으로 콘텐츠를 변환합니다.

콘텐츠 유형변환 방식
텍스트 콘텐츠알림톡/RCS 템플릿: 템플릿 내용이 전송됨
친구톡/RCS: messages.text 필드 내용이 전송됨
버튼 (웹/앱 링크)버튼의 이름과 연결된 URL이 문자 메시지 본문에 텍스트 형태로 포함됩니다
이미지이미지가 포함된 친구톡/BMS 자유형(IMAGE)은 MMS가 아닌 LMS로 전환됩니다
이미지는 URL 링크 형태로 LMS 본문에 포함됩니다
광고 표기BMS 자유형 대체발송 시 (광고) 문구가 필수 포함됩니다
LMS 기준 1건당 45원(부가세 별도)