connection.info-list는 메시지 발송을 위한 중계사(Connection) 정보를 설정하는 항목입니다.
참고
- 여러 개의 발송 라인(Line)을 구성할 수 있습니다.
- 동일한
schema,channel,line-type조합에 대해 여러 개의 라인을 등록하면ratio값에 따라 발송 비율이 결정됩니다.- 사용하지 않는 Connection 정보는 삭제한 후 서비스를 기동하는 것을 권장합니다.
connection:
info-list:
- vendor: lgu
schema: rcs
channel: rcs
line-type: normal
host: https://api.msghub.uplus.co.kr
port: 443
id: API6xkSP
pwd: passxxxx
tps: 100
ratio: 1
| 항목 | 필수 | 설명 | 예시 |
|---|---|---|---|
vendor |
O | 연동할 중계사(Vendor) 코드 | lgu, kt |
schema |
O | 현재 ID가 사용할 발송 테이블 종류 | sms, mms, rcs |
channel |
O | 실제 발송할 메시지 채널 | sms, mms, rcs |
line-type |
O | 발송 라인의 성격 | normal, batch, real |
host |
O | 연동 서버 주소(IP 또는 URL) | https://api.msghub.uplus.co.kr |
port |
O | 연동 서버 포트 번호 | 443 |
id |
O | 중계사에서 발급한 SM/PM 계정(ID) | API6xkSP |
pwd |
O | SM/PM 계정 비밀번호 | uracle1234 |
tps |
△ | 초당 발송 가능 건수(Throttle) | 100 |
ratio |
O | 동일한 발송 라인 간 발송 비율 | 1 |
참고
tps항목은 환경에 따라 지원되지 않을 수 있으며, 지원하는 경우 초당 발송 건수를 제한하는 용도로 사용됩니다.
연동할 메시지 중계사를 지정합니다.
예시
vendor: lgu
지원 예시
lgukt현재 계정(ID)이 사용할 발송 테이블 종류를 지정합니다.
지원 값
smsmmsrcsschema: rcs
실제로 발송할 메시지 채널을 지정합니다.
지원 값
smsmmsrcschannel: rcs
발송 라인의 용도를 구분합니다.
| 값 | 설명 |
|---|---|
normal |
일반 발송 |
batch |
대량 예약 발송 |
real |
실시간 발송 |
line-type: normal
메시지 중계 서버 주소를 입력합니다.
host: https://api.msghub.uplus.co.kr
중계 서버의 포트 번호를 입력합니다.
port: 443
중계사에서 발급한 SM/PM 계정을 입력합니다.
id: API6xkSP
SM/PM 계정의 비밀번호를 입력합니다.
pwd: uracle1234
비밀번호 암호화를 사용하는 경우
agent.password-encryption.use-yn설정에 따라 암호화된 값을 입력합니다.
초당 발송 가능한 최대 건수를 지정합니다.
tps: 100
예를 들어,
100 → 초당 최대 100건 발송300 → 초당 최대 300건 발송동일한 schema + channel + line-type 조합의 여러 발송 라인이 존재할 경우, 발송 비율을 지정합니다.
ratio: 1
- id: LINE01
ratio: 1
- id: LINE02
ratio: 1
발송 비율
LINE01 : 50%
LINE02 : 50%
- id: LINE01
ratio: 3
- id: LINE02
ratio: 1
발송 비율
LINE01 : 75%
LINE02 : 25%
connection:
info-list:
- vendor: lgu
schema: rcs
channel: rcs
line-type: normal
host: https://server1.example.com
port: 443
id: RCS01
pwd: password1
tps: 200
ratio: 3
- vendor: lgu
schema: rcs
channel: rcs
line-type: normal
host: https://server2.example.com
port: 443
id: RCS02
pwd: password2
tps: 200
ratio: 1
위 설정에서는 동일한 발송 그룹으로 인식되며, 발송 비율은 다음과 같습니다.
| ID | Ratio | 발송 비율 |
|---|---|---|
| RCS01 | 3 | 75% |
| RCS02 | 1 | 25% |
vendor, schema, channel, line-type 값은 실제 운영 환경과 일치해야 합니다.host와 port는 중계사에서 제공한 정보를 사용해야 합니다.ratio 값의 합계를 기준으로 자동 분배됩니다.connection.info-list 항목은 삭제한 후 서비스를 기동하는 것을 권장합니다.