Sending Alternative Messages in Multi-channel

Multi-channel alternative message is a service that allows you to send alternative messages through various channels, unlike the existing alternative message that only supported SMS and LMS. Multi-channel alternative message is rule-based, and you must set the order of alternative message types on the web. Multi-channel alternative message is mapped one-to-one with department codes. When department codes are attached, alternative message will be sent accordingly. (Department code can be created on the web.)

If an alternate message type is specified in the data, alternative messages of SMS or LMS will be sent just once.

Note

• A separate contract is required to use the multi-channel alternative message.
  
• Web screens required to send a multi-channel alternative message will be provided later.
  
• For multi-channel alternative message, a separate column must be added to the existing table.

Request Information

Note

• Before calling every BizMessage API, you must call OAuth 2.0 API in advance.
  
• Please refer to the Sample Code document for API-specific codes.

Warning
As the staging server is linked to the Kakao operation server and actually sends messages, please be careful to avoid sending messages incorrectly.

Retrieveing Message Delivery Result

With the Push method, it is not possible to check the message delivery result at the same time as sending. In this case, you can use this API to check the message delivery result of each message.

Note
After calling this API, be sure to call the Closing Message Delivery Result Retrieval Request API not to retrieve the processed results again.

Request

Request Syntax

코드예제Request Syntax of Retrieveing Message Delivery Result

curl -X 'GET' \
  'https://{base_url}/v2/info/report/results' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {oauthToken}'

Request Header

Response

Response Syntax

코드예제Response Syntax of Retrieveing Message Delivery Result

{
  "code": "200",
  "code_detail": {
    "detail_code": "",
    "detail_message": "success"
  },
  "report_group_no": "8493608862033069978",
  "results": [
    {
      "cid": "77613652af2d464580796c41cf0d39a3",
      "uid": "220918080309405KFXrvK8CR9e+k8s",
      "message_type": "AT",
      "final_message_type": "RCSSMS",
      "status_code": "API_200",
      "broker_status_code": "0000",
      "error_message": "success",
      "req_date": "2022-12-07T04:58:36.656Z",
      "res_date": "2022-12-07T04:58:36.656Z"
    }
  ]
}

Response Elements

Closing Message Delivery Result Retrieval Request

This API is used to close the request of retrieving the message delivery result.

Request

Request Syntax

코드예제Request Syntax of Closing Message Delivery Result Retrieval Request

curl -X 'PUT' \
  'https://{base_url}/v2/info/report/results/complete/{report_group_no}' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {oauthToken}'

Request Header

Response

Response Syntax

코드예제Response Syntax of Closing Message Delivery Result Retrieval Request

{
  "code": "200",
  "code_detail": {
    "detail_code": "",
    "detail_message": "success"
  }
}

Response Elements

Retrieving Detailed Message Delivery Result

This API is used to retrieve the detailed delivery result of every type of message.

Request

Request Syntax

코드예제Request Syntax of Retrieving Detailed Message Delivery Result

curl -X 'GET' \
  'https://{base_url}/v2/info/report/search/detail/{uid}' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {oauthToken}'

Request Header

Response

Response Syntax

코드예제Response Syntax of Retrieving Detailed Message Delivery Result

{
  "code": "200",
  "code_detail": {
    "detail_code": "",
    "detail_message": "success"
  },
  "report_group_no": "8493608862033069978",
  "results": [
    {
      "cid": "77613652af2d464580796c41cf0d39a3",
      "uid": "220918080309405KFXrvK8CR9e+k8s",
      "message_type": "AT",
      "final_message_type": "RCSSMS",
      "status_code": "API_200",
      "broker_status_code": "0000",
      "error_message": "success",
      "req_date": "2022-12-07T04:58:36.656Z",
      "res_date": "2022-12-07T04:58:36.656Z"
    }
  ]
}

Response Elements