- 인포뱅크에서 제공하는 HTTPS방식을 이용해 RCS메시지를 전송하는 REST API입니다.
본 규격을 이용하여 국내 RCS메시징 서비스를 이용할 수 있습니다.
- 본 서비스를 이용하기 위해서 영업 담당자로부터 접속 정보를 제공받아야 합니다.
기술정보센터
접속 계정
영업 담당자로부터 RCS REST-API 접속 계정 정보를 제공받아야 합니다.
RCS Biz Center 가입 및 정보 등록
- RCS 발송을 위해 RCS Biz Center 사이트(https://www.rcsbizcenter.com)에 접속하여 가입한 후, 기업, Brand정보, 발신번호, 대행사(인포뱅크) 등의 정보를 등록해야 합니다.
- 가입 시 영업 담당자에 문의하여 주시기 바랍니다.
- RCS 템플릿 발송을 위해서는 템플릿 등록 요청 후 승인이 필요합니다.
네트워크 방화벽 허용
- 인포뱅크 RCS REST-API 서버 에 대해 방화벽 허용(Outbound)이 필요합니다.
- 인포뱅크 G/W는 Any로 열려 있습니다.
HTTPS METHOD
전송 요청을 위해 HTTPS GET/POST 방식을 제공하며 전송 응답은 JSON 방식을 사용합니다.
ENCODING
UTF-8 인코딩을 기본으로 제공합니다.
TIMEZONE
본 API에 대한 기준 시간은 한국 표준 시 KST(UTC+9)를 사용합니다.
API 설명
인증(토큰 발급) API
- 서비스 이용 시 인증에 사용할 토큰을 발급 받기 위한 API입니다.
- 발급 시 만료 시간이 있으며 만료 시간(24시간) 후에는 사용이 불가하고 재발급이 필요합니다.
- 토큰이 외부로 노출될 경우 악용의 소지가 있으므로 유의 바랍니다.
파일 업로드 API
- RCS MMS발송에 사용될 이미지 파일 업로드 API입니다.
- 파일 업로드 후 발급되는 파일 키 값을 사용 합니다.
- 파일 키 발급 시 만료 시간이 있으며 만료 시간 후에는 파일이 삭제됩니다.
메시지 전송 API
- 메시지 발송을 요청하는 API입니다.
리포트 API
- 메시지 전송 결과를 확인할 수 있는 API입니다.
* 리포트를 수신 하기 위해서는 인포뱅크에서 제공하는 서버 IP에 대한 접근을 허용해야 합니다.
결과 송신 서버 IP 정보 : 211.115.98.168, 211.115.98.169
API URL 정보
인증(토큰 발급) API | https://rcs-auth.ibizplus.co.kr:7000/v1/auth/token |
파일 업로드 API | https://rcs-file.ibizplus.co.kr:7010/v1/rcs/file |
메시지 전송 API | https://rcs-msg.ibizplus.co.kr:7020/v1/rcs/destination |
리포트 API (PUSH) | 인포뱅크에 등록한 URL 정보 |
API에 대한 자세한 내용은 메뉴얼을 다운로드 받아 확인해 주세요.
RCS 메시지 종류
RCS SMS (Rich Communication Services Short Message Service)
- 100자 이하, 최대 버튼 1개의 RCS메시지를 전송하는 서비스
RCS LMS (Rich Communication Services Long Message Service)
- 1,300자 이하, 최대 버튼 3개의 RCS메시지를 전송하는 서비스
RCS MMS (Rich Communication Services Multimedia Message Service)
- 1,300자 이하, 최대 버튼 2개, 이미지가 포함된 RCS메시지를 전송하는 서비스
RCS MMS (Carousel)
- 1,300자 이하, 최대 카드 6개, 카드 별 최대 버튼 2개의 다중 카드의 RCS 메시지를 전송 하는 서비스
RCS 템플릿(Template)
- 90자 이하, 사전 등록된 지정된 형태의 RCS 메시지를 전송하는 서비스
- Free 템플릿: RCS Biz Center를 통한 계정 생성 시 바로 사용 가능한 템플릿
- Description 템플릿: 등록된 형태에 맞게 전체 메시지내용을 기술하여 요청하는 템플릿
- Cell 템플릿: 등록된 블럭 구조에 맞게 key, value를 JSON형태로 요청하는 템플릿
FAILOVER
- RCS 발송 요청 시 FAILOVER 메시지 설정을 할 수 있습니다.- RCS 발송이 실패 할 경우 지정된 FAILOVER 메시지 데이터로 인포뱅크 G/W에서 발송 시도합니다.
- RCS 발송이 성공 한 경우 FAILOVER 메시지는 발송 되지 않습니다.
- FAILOVER 설정 상관 없이 발송 결과(REPORT)는 발송 요청 1건당 결과 1건이 전달됩니다.
- FAILOVER 처리 여부는 발송 결과(REPORT)로 전달된 CARRIER(이통사코드) 값으로 구별하여 확인 할 수 있습니다. (최종 이통사코드 값이 FAILOVER일 경우는 RCS실패 후 FAILOVER 발송 처리)
기술지원 상담
Email support@infobank.net