Kakao i Connect Message::BizMessage(ENG)::BizMessage Agent::Multi-Channel Alternative Sending

페이지 이동경로

Multi-Channel Alternative Messaging

Multi-channel alternative messaging is a service that allows you to diversify and send alternative delivery channels, unlike the existing alternative delivery (subdelivery delivery) that only supported SMS and LMS. As it is a rule-based service, you need to set up the sequence of sending alternative messages on the web screen. Its rules are mapped 1:1 with department codes. Therefore, if the department code is attached at the time of sending messages, alternative messaging will be sent according to the mapped rule. (Department code can be created on the web screen.)

If an alternate message type is arbitrarily specified in the messaging data, the same alternative messaging as the existing method will be sent. (One alternative message for SMS and LMS)

NOTE

  • Multi-channel Alternative Messaging requires contract, so please inquire separately.
  • A web screen for sending multi-channel alternative messaging will be provided later.
  • For multi-channel alternative messaging, separate columns in the sending/result table are added.

If the use of multi-channel alternative messaging is reflected in the contract, the multiFallback value must be set to true. Also, new column are added as shown below. (If a table with the same name exists, a column will not be added.)

코드예제agent.ini

[AGENT]
client_id=TEST0001
agent_id=TEST0001001
agent_type=AT 
at_type=PUSH
multiFallback=true

New Result Column

The following columns are additionally created. 1-5 means columns that expand to 5.

Note
RESULT_MSG_TYPE1 is fixed as the type of message sent first.
New result column information
Agent Column Description
Common RESULT_MSG_TYPE(1~5) Result message type
RESULT_CD(1~5) Result code
SERVER_SEND_DATE(1~5) Messaging request time (KEP Mediator → Sender)
RESULT_DATE(1~5) Result Received Time (Sender → KEP Mediator)
DEPARTMENT_CD Department code
- To send by referring to multi-channel alternative messaging rules mapped to department codes
Alim Talk, Friend Talk TELECOM_CD(1~5) Telecom code
FALLBACK_YN Whether to use alternate sending
RCS ERROR_MESSAGE(1~5) Detailed result message
MNO_INFO(1~5) Telecom code
XMS TELECOM_CD(1~5) Telecom code
FALLBACK_YN Whether to send alternate messages
FALLBACK_SUBJECT Title of alternative message
FALLBACK_MESSAGE Alternate message
Naver Talk Talk ERROR_MESSAGE(1~5) Detailed messaging result
TELECOM_CD(1~5) Telecom code

Sending multi-channel messages

A multi-channel fallback service provides code examples for test sending messages based on different message types.

Sending Alim Talk

Send an alternative message to the Alim talk.

코드예제Sending Alim Talk

INSERT INTO K_MESSAGE (
   KKO_MSG,
   MSG_TYPE,
   MOBILE_NO,
   SENDER_NO,
   RESERVE_DATE,
   KKO_TEMPLATE_CD,
   KKO_TEMPLATE_TYPE,
   KKO_BTN_LINK1,
   KKO_BTN_LINK2,
   KKO_BTN_LINK3,
   KKO_BTN_LINK4,
   KKO_BTN_LINK5,
   KKO_QUICK_REPLY1,
   KKO_QUICK_REPLY2,
   KKO_QUICK_REPLY3,
   KKO_QUICK_REPLY4,
   KKO_QUICK_REPLY5,
   KKO_QUICK_REPLY6,
   KKO_QUICK_REPLY7,
   KKO_QUICK_REPLY8,
   KKO_QUICK_REPLY9,
   KKO_QUICK_REPLY10,
   PHONE_MSG,
   TITLE,
   REG_DATE,
   FALLBACK_YN,
   DEPARTMENT_CD
) VALUES (
            '[Kakao Music] Thanks to Join
            Dear, welcome to Kakao Music.
            ▶ Membership Subscription Benefits
            1 Month Free Streaming
            Free Kakao Talk emoticons',
            'KX',                                  # Message type. An alternative messaging type must not be specified.
            99999999,                      # Recipient’s number needs to be changed.
            '99999999',                      # Sender’s number needs to be changed.
            NOW(),                            # If future time is input, the message will be sent later.
            'alimtalktest_001',            # Template code
            'AT',                                 # Basic Template(Basic type and Text Emphasized type) - AT, Image template - AI   '{"name":"App Link Button","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}',
            '{"name":"Web Link Button","type":"WL","url_mobile":"http://kakao.com"}',
            NULL,
            NULL,
            NULL,
            '{"name":"Direct Link 1","type":"WL","url_mobile":"http://kakao.com"}',
            '{"name":"Direct Link 2","type":"WL","url_mobile":"http://kakao.com"}',
            NULL,
            NULL,
            NULL,
            NULL,
            NULL,
            NULL,
            NULL,
            NULL,
            'message',
            'title1',
            NOW(),
            1,                # New column. Whether or not to proceed with alternative shipments must be entered arbitrarily.
            'Downtown-001'    # New column. Department code must be entered. (Create on the web screen.)
);

Sending RCS

RCS is sent as an alternative message.

코드예제Sending RCS

# Basic RCSSMS + 1 BUTTONS

INSERT INTO RCS_MESSAGE (
   RESERVE_DATE,
   AGENCY_ID,
   PHONE_NO,
   CALLBACK,
   MESSAGE_BASE_ID,
   SERVICE_TYPE,
   HEADER,
   FOOTER,
   COPY_ALLOWED,
   BODY,
   BUTTONS,
   FALLBACK_YN,
   FALLBACK_CALLBACK,
   FALLBACK_MESSAGE,
   DEPARTMENT_CD
) VALUES (
           now(),
           kakaoenterprise,
          99999999,                   # Recipient’s number needs to be changed.
           99999999,                    # Sender’s number needs to be changed.
           'SS000000',                  # Message template code
           'RCSSMS',                    # [RCSSMS, RCSLMS, RCSMMS, RCSTMPL]
           '1',                         #  0 : for Info, 1 : for ad
           '080-0000-0000',             # Required in case of ‘1(for ad)’
           true,
           '{ "title": "","description":"일반 RCSSMS 테스트 메시지 입니다.\\n" }',
           '[{"suggestions":[{
                    "action":{
                       "urlAction": {
                           "openUrl": {
                               "url": "https://www.google.com"
                           }
                    },
            "displayText": "Open Url",
            "postback": {
                               "data": "set_by_open_url"
                       }
                   }
               }]
           }
           ]',
           1,      
           99999999,  # Sender’s number needs to be changed.
           'Alternate Sending Message',   # If no alternative sending type is specified, multi-channel alternative sending is performed.
           'Downtown-001'   # New column. Department code must be entered. (Create on the web screen.)
);

Sending XMS

XMS is sent as an alternative message

코드예제Sending XMS

INSERT INTO XMS_MESSAGE (
   PHONE_MSG,
   TITLE,
   MSG_TYPE,
   MOBILE_NO,
   SENDER_NO,
   IMG_ATTACH_CD,
   MMS_IMG1,
   MMS_IMG2,
   MMS_IMG3,
   REG_DATE,
   FALLBACK_YN,
   FALLBACK_MESSAGE,
   DEPARTMENT_CD
) VALUES (
        'This is a LMS message.',
        'This is a title of LMS.',
        'LM',                                 # Message type. See the table specification for Message type.
        '01000000000',                # Recipient’s number needs to be changed.
        '99999999999',                # Sender’s number needs to be changed.
        'N',                                   # IMG_ATTACH_CD :  To be ‘N’ in LMS
        NULL,                              # MMS_IMG1 : To be null in LMS
        NULL,                              # MMS_IMG2 : To be null in LMS
        NULL,                              # MMS_IMG3 : To be null in LMS
        NOW(),
        1,
        'Alternate Sending Message',            # If no alternative sending type is specified, multi-channel alternative sending is performed.
        'Downtown-001'             # New column. Department code must be entered. (Create on the web screen.)
);

Sending Naver Talk Talk

Naver Talk Talk is sent as an alternative message.

코드예제Sending Naver Talk Talk

INSERT INTO NAVER_MESSAGE (
   MESSAGE_TYPE,
   TEMPLATE_CODE,
   TEMPLATE_PARAMS,
   USER_NAME,
   SENDER_KEY,
   PHONE_NUMBER,
   ATTACHMENTS,
   FALLBACK_YN,
   FALLBACK_MESSAGE,
   FALLBACK_CALLBACK,
   FALLBACK_SUBJECT,
   DEPARTMENT_CD
) VALUES (
          'NT_TM',
          'NT-20221117174151',
          '{"Name": "Gildong Hong", "Recipient number": "821099999999"}',
          Gildong Hong,
          senderkey',
          8299999999,                 # Recipient’s number needs to be changed.
          '',
          1,
          'Alternate Sending message',
          '99999999',                 # Sender’s number needs to be changed.
          'Alternate subject',             # If no alternative sending type is specified, multi-channel alternative sending is performed.
          'Downtown-001'   # New column. Department code must be entered. (Create on the web screen.)
);

Result Type (RESULT_MSG_TYPE)

Result Type (RESULT_MSG_TYPE)
Category Value Description
RESULT_MSG_TYPE AT Alim Talk
AI Alim Talk image(Send with image)
FT Friend Talk
FI Friend Talk image(Send with image)
FW Friend Talk wide image (Send with image)
SM SMS
LM LMS
MM MMS
ISM International SMS
ILM International LMS
RCSSMS RCSSMS
RCSLMS RCSLMS
RCSMMS RCSMMS
RCSTMPL RCS template
NT_TM Naver Talk Talk only sends variable part
NT_FM Send Naver Talk Talk full text
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 contact.dkt@kakaocorp.com 으로 제보해주세요.