시행일: 2026년 6월 23일무효한 발신번호 차단 정책 시행 안내더 알아보기
도입문의

문자 API 연동, 자사 서비스에 붙이기 전에 확인할 것

문자 API 연동, 자사 서비스에 붙이기 전에 확인할 것

문자 API 연동은 공급사를 고르는 순간 연동 방식, 발신번호, 결과 처리, 장애 대비가 함께 정해집니다. 자사 서비스에 문자 기능을 붙이기 전에 공급사에게 확인할 여덟 가지를 정리했습니다.

회원가입 인증번호, 주문·예약 알림처럼 서비스 안에서 문자가 나가야 할 때, 보통 공급사의 API 문서부터 열어 봅니다. 발송 요청을 보내는 코드는 금방 붙습니다.

문제는 붙인 다음에 드러납니다.

"고객사 이름으로 보내야 하는데 발신번호는 어떻게 등록하죠?"

"발송 요청은 성공했다는데 고객은 못 받았다고 합니다."

이런 질문의 답은 연동 코드보다 공급사가 어떤 구조를 갖췄는지에 달려 있습니다. 공급사를 바꾸려면 연동을 다시 해야 하니, 고르기 전에 확인하는 편이 비용이 적게 듭니다.

이번 글에서는 자사 서비스에 문자 기능을 넣으려는 기획·PM과 개발 담당이 공급사를 고를 때 확인할 것을 정리했습니다. 연동 방식, 연동 지원, 발신번호, 발송 결과, 인증번호, 장애 대비, 전송자격인증, 테스트와 전환입니다.

💡 Agent·DB 방식과 API 방식의 기본 차이가 궁금하시다면 이전 글 개발자 없이 이해하는 기업 문자 발송 시스템, Agent·DB vs API 방식 완벽 비교 가이드를 먼저 확인해 주세요.

1. 문자 API, Agent, 소켓 중 무엇으로 붙일까?

연동 방식은 공급사가 정하는 것이 아니라 우리 시스템이 정합니다. 발송 요청이 어디에서 생기는지부터 보면 고르기 쉽습니다.

우리 시스템 상황

맞는 방식

공급사에게 확인할 것

웹·앱 서버가 이벤트마다 바로 보냄

문자 API(HTTP 호출)

호출 규격 문서, 테스트 환경, 결과 받는 방법

업무 DB에 발송할 내용이 쌓임

문자 Agent 연동(DB)

기존 테이블을 그대로 쓸 수 있는지, 결과를 어디에 돌려주는지

은행·기간계처럼 고정 양식 통신을 씀

소켓(전문) 연동

전문 양식, 연동 모듈 제공 여부

담당자가 목록을 올려 보냄

파일·웹

엑셀·CSV 양식

문자 API, Agent, 소켓, 파일 연동 방식을 우리 시스템 상황별로 비교한 그림

한 회사 안에서도 방식이 하나로 끝나지 않는 경우가 있습니다. 앱 인증번호는 API로, 정기 안내는 업무 DB에서 Agent로 보내는 식입니다.

그래서 공급사가 여러 방식을 함께 지원하는지가 첫 번째 확인 항목입니다. KP(케이피모바일) 통합메시징시스템(UMS)은 DB Agent, REST API, 전문(소켓), 파일·웹 방식으로 연동합니다.

💡 연동 방식별 구성: 연동 솔루션 구성 보기 · 통합메시징시스템(UMS) 구성 보기

2. 문자 연동, 공급사가 무엇을 준비해 주는지 확인합니다

API 문서만 받고 나머지를 직접 만드는 연동과, 공급사가 모듈과 문서를 함께 주는 연동은 개발 범위가 다릅니다. 견적 전에 물어볼 것은 네 가지입니다.

✅ 연동 모듈이나 예제 코드를 주는지

✅ 개발자용 문서(매뉴얼)가 있는지

✅ 기존 DB를 그대로 쓸 수 있는지, 새 테이블을 만들어야 하는지

✅ 발송 결과를 받는 프로그램을 우리가 따로 만들어야 하는지

놓치기 쉬운 것은 마지막 항목입니다. 발송 요청을 보내는 쪽만 만들고 결과를 받는 쪽을 빠뜨리면, 실패한 문자를 알 길이 없습니다.

소켓(전문) 연동이라면 공급사가 준 발송 모듈로 인터페이스를 구현하고, 메시지는 공급사 게이트웨이 서버를 거쳐 고객에게 갑니다. 이 모듈에 결과 수신까지 들어 있는지에 따라 우리 쪽에서 만들 프로그램이 달라집니다.

3. 발신번호는 누구 이름으로 등록할까?

문자 발송 API를 붙일 때 발신번호는 기획 단계에서 놓치기 쉬운 항목입니다. 특히 여러 고객사가 쓰는 플랫폼이라면 "어느 회사 번호로 보내는가"를 먼저 정해야 합니다.

📌 전송자격인증기준 등에 관한 고시 별표 2.1·2.3

✔️ 내용: 고시는 전송자격인증을 받는 문자 발송 사업자가 이용자 계정을 1인당 1개로 제한하고, 계정당 등록할 수 있는 발신번호를 무선은 법인 4회선, 유선(인터넷전화 등)은 법인 종사자 수까지로 제한하도록 정합니다. 또 발신번호 명의자(이용자)와 이용료 납부자가 같은지 확인해 부정사용을 차단하도록 정합니다.

고시가 정한 것은 계정 수와 계정당 번호 수, 그리고 번호 명의자와 이용료 납부자가 같은지 확인하는 기준입니다. 자사 플랫폼에서 고객사 번호로 보내려면 공급사에게 아래를 물어야 합니다.

1️⃣ 고객사별로 계정을 나누는지, 한 계정에 번호를 모아 두는지

2️⃣ 고객사 명의 번호를 등록할 때 명의자와 이용료 납부자 확인을 어떻게 하는지

3️⃣ 등록되지 않은 번호로 발송을 요청하면 API가 어떤 결과를 돌려주는지

개발 담당이 가장 먼저 알아야 할 것은 세 번째 답입니다. 등록 안 된 번호로 보낸 요청이 바로 오류로 돌아오는지, 아무 표시 없이 사라지는지에 따라 오류 처리 설계가 달라집니다.

4. 문자 연동 후 발송 결과는 어떻게 받아 올까?

"발송 요청 성공"과 "고객 휴대전화 도착"은 다른 결과입니다. 요청을 받았다는 응답만 보고 끝내면, 실제로 실패한 문자를 놓칩니다.

👉 발송 요청 결과: 공급사가 요청을 접수했는지

👉 최종 전송 결과: 고객에게 전달됐는지, 실패했다면 이유가 무엇인지

👉 결과 받는 곳: 우리 DB에 쌓이는지, 우리 서버로 알려 주는지, 우리가 조회해야 하는지

문자 발송 API에서 발송 요청 응답과 최종 전송 결과를 받는 흐름도

결과를 받는 곳은 우리 시스템의 연동 방식과 맞춰야 합니다. 업무 DB로 보내는 DB Agent 방식이라면, 업무 시스템이 메시지 테이블에 데이터를 넣으면 Agent가 수집해 발송하고 결과도 같은 DB로 돌려주는 구조가 관리하기 쉽습니다. 이 구조에서는 기존 시스템 코드를 크게 고치지 않아도 됩니다.

5. 인증번호는 대량 발송과 같은 줄에 세우지 않습니다

자사 서비스에서 문자 API로 보내는 대표적인 메시지가 인증번호입니다. 같은 공급사 계정으로 이벤트 안내 같은 대량 발송도 한다면, 인증번호가 대량 발송 뒤에 줄을 서지 않는지 확인해야 합니다.

✅ 발송 요청에 메시지 유형(실시간·대량)을 구분해 넣는 값이 있는지

✅ 공급사가 대량 발송과 실시간 알림을 나눠 처리하는지

✅ 인증번호·결제 알림처럼 늦으면 고객 행동이 막히는 메시지를 어느 유형으로 보낼지

6. 문자 발송 API, 장애가 나면 어떻게 될까?

공급사가 발송 라인을 하나만 쓰면, 그 라인에 장애가 났을 때 우리 서비스의 인증번호도 함께 멈춥니다. 고객은 공급사가 아니라 우리 서비스에 "문자가 안 와요"라고 묻습니다.

점검 항목

확인할 것

발송 라인

발송 라인을 여러 개 두는지, 한 라인에 장애가 나면 남은 라인으로 옮기는지

장애 중 응답

장애나 지연 중에 보낸 요청에 API가 어떤 결과를 돌려주는지

장애 알림

장애 때 우리 쪽에 어떻게 알리는지

7. 전송자격인증, 공급사에게 무엇을 물어볼까?

전기통신사업법 제22조의11은 특수한 유형의 부가통신역무(문자메시지 발송시스템을 전기통신사업자의 설비에 연결해 문자메시지를 발송하는 역무, 제2조 제14호 나목)를 제공하는 사업을 경영하려는 자가 방송미디어통신위원회의 전송자격인증을 받아야 한다고 정합니다. 인증기준은 방송미디어통신위원회 고시 제2026-1호 「전송자격인증기준 등에 관한 고시」 별표에 있습니다.

인증기준 전체를 독자가 볼 필요는 없습니다. 아래 표는 문자 API를 붙이는 쪽에서 직접 부딪히는 항목만 골라, 공급사에게 물어볼 질문으로 바꾼 것입니다.

고시 별표 항목

기준

연동할 때 확인할 것

2.2 국외 이용자

국외 IP는 문자발송 시스템 접근을 차단합니다. 해외거주자·해외법인 등은 필요서류를 받아 관리자 확인 후 허용합니다

해외 리전 서버를 쓸 계획이라면 발송 호출을 보낼 IP

4.1 이용자 로그 관리

문자발송 이력 등은 관련 법령에서 정한 최소 보관 기간 이상(별도 기간이 없으면 1년) 보관합니다

발송 이력을 어디서, 얼마 동안 조회할 수 있는지

5.2 금칙어 등 차단 체계

금칙어·악성 URL 차단 체계를 운영합니다

문구나 링크가 차단되면 API가 어떤 결과를 돌려주는지

공급사가 전송자격인증을 받았다면 방송미디어통신위원회가 발급한 인증서가 있습니다(고시 제5조). 계약 전에 확인해 두시기 바랍니다.

8. 테스트에서 운영 전환까지, 순서를 정해 둡니다

연동은 개발 서버에서 끝나지 않습니다. 운영 전환 순서를 미리 정해 두면, 오픈 직후 발신번호나 결과 수신 문제로 되돌아가는 일이 줄어듭니다.

1️⃣ 도입 상담: 발송 채널, 발송량, 연동 환경을 공급사와 맞춥니다

2️⃣ 요구사항 정리: 연동 방식, 메시지 유형(실시간·대량), 발신번호 등록 대상을 정합니다

3️⃣ 연동 개발: 발송 요청과 결과 수신 경로를 함께 정합니다

4️⃣ 테스트: 성공뿐 아니라 실패 결과(미등록 발신번호, 차단 문구 등)가 어떻게 돌아오는지 확인합니다

5️⃣ 운영 전환: 오픈 뒤 첫 며칠은 결과와 실패 건을 매일 확인합니다

공급사에게 확인할 여덟 가지

자주 묻는 질문

Q. 문자 API와 Agent 연동은 무엇이 다른가요?

문자 API는 웹·앱 서버가 발송할 때마다 공급사에 바로 요청을 보내는 방식이고, Agent 연동은 업무 DB에 쌓인 발송 내용을 Agent가 가져가 보내는 방식입니다. 발송 요청이 어디에서 생기는지에 따라 고르면 됩니다. 한 회사에서 두 방식을 함께 쓰기도 합니다.

Q. 해외 클라우드 서버에서 문자 발송 API를 호출할 수 있나요?

전송자격인증기준 등에 관한 고시 별표 2.2는 국외 IP의 문자발송 시스템 접근을 차단하도록 정하고 있습니다. 예외는 해외거주자·해외법인 등이 필요서류를 내고 관리자 확인을 받은 경우입니다. 해외 리전 서버를 쓸 계획이라면 발송 호출을 어느 IP에서 보낼지 공급사와 먼저 맞추시기 바랍니다.

Q. 기존에 쓰던 문자 발송 테이블을 그대로 쓸 수 있나요?

공급사가 기존 테이블을 그대로 쓰게 해 주는지에 달려 있습니다. 새 테이블을 만들어야 한다면 업무 시스템 쪽 수정이 늘어나므로, 견적 전에 확인해 두는 편이 좋습니다.

Q. 문자 연동 구축 기간은 얼마나 걸리나요?

연동 방식과 맞춤 개발 범위에 따라 달라집니다. 연동 모듈과 개발자 문서를 받는지, 결과를 받는 프로그램을 직접 만들어야 하는지도 개발 범위를 바꿉니다.

Q. SaaS로 시작했다가 구축형으로 바꾸면 연동을 다시 해야 하나요?

도입 형태마다 연동 규격이 같은지에 달려 있습니다. 케이피모바일 UMS는 SaaS형·구축형·하이브리드형이 같은 엔진과 연동 규격을 써서, 연동한 시스템은 그대로 두고 구축 형태만 바꿉니다.


지금까지 문자 API 연동 전에 공급사에게 확인할 것을 살펴보았습니다. 연동 방식은 우리 시스템에 맞춰 고르고, 발신번호 등록과 결과 수신은 개발 전에 정하며, 인증번호와 장애 대비는 공급사의 발송 구조에서 확인하는 것이 핵심입니다.

오늘 한 가지만 해 보신다면, 지금 검토 중인 공급사에 "등록되지 않은 발신번호로 보내면 어떤 결과가 돌아오나요?"라고 물어보시기 바랍니다.

연동 방식을 아직 정하지 못했다면 도입 상담에서 지금 쓰는 DB와 앱 서버 구성부터 알려 주세요. 케이피모바일이 환경을 확인한 뒤 일정과 견적을 함께 안내합니다.

💡 도입 상담: 도입문의

※ 본 글은 전기통신사업법(2026년 10월 1일 시행), 방송미디어통신위원회 고시 제2026-1호 「전송자격인증기준 등에 관한 고시」(2026년 4월 28일 시행)를 기준으로 작성했습니다. 세부 사항은 관계 기관 안내를 확인하시기 바랍니다.

추천 게시물

인기글 TOP 5

  1. 1마케팅 수신동의, 문자·알림톡·이메일별로 따로 받아야 할까?
  2. 2광고성 정보 구분, 포인트 소멸 안내는 광고일까? 사례별 정리
  3. 32026년 최신(7차개정) 정보통신망법 스팸 가이드 총정리
  4. 4"인증서 없으면 문 닫는다?" 특수한 유형의 부가통신사업자 재등록, 법령 원문으로 총정리
  5. 5수신거부 회피로 보일 수 있는 광고 문자 발송 실수 4가지
문자·알림톡·RCS 서비스 소개서 도입 검토 자료 받기

읽은 내용을 우리 서비스에 적용하고 싶다면,
KP와 구성을 함께 검토해 보세요

도입문의