AlimTalk APIs
    • PDF

    AlimTalk APIs

    • PDF

    Article summary

    Basic information

    API URL

    https://sens.apigw.ntruss.com/alimtalk/v2
    

    Go to SENS AlimTalk API Swagger

    API Header

    ItemMandatoryDescription
    Content-TypeMandatorySpecifies the request Body Content Type as application/json (POST)
    x-ncp-apigw-timestampMandatory- This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 (UTC)
    - The request is considered invalid if the time difference compared to the API Gateway server is more than 5 minutes
    x-ncp-iam-access-keyMandatoryAccess Key ID issued by the portal or Sub Account
    x-ncp-apigw-signature-v2Mandatory- Signature of the body in the above example encrypted with a SecretKey mapped to Access Key ID
    - HmacSHA256 is used as the HMAC encryption algorithm.

    Go to NAVER Cloud Platform authentication key and signature creation guide

    Messages

    Send messages

    Sends a message.

    Request URL

    POST https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/messages
    
    Content-Type: application/json; charset=utf-8
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project

    Headers

    Go to API Header

    Request Body

    {
        "plusFriendId":"string",
        "templateCode":"string",
        "messages":[
            {
                "countryCode":"string",
                "to":"string",
                "title":"string",
                "content":"string",
                "headerContent":"string",
                "itemHighlight":{
                    "title":"string",
                    "description":"string"
                },
                "item":{
                    "list":[
                        {
                            "title":"string",
                            "description":"string"
                        }
                    ],
                    "summary":{
                        "title":"string",
                        "description":"string"
                    }
                },
                "buttons":[
                    {
                        "type":"string",
                        "name":"string",
                        "linkMobile":"string",
                        "linkPc":"string",
                        "schemeIos":"string",
                        "schemeAndroid":"string"
                    }
                ],
                "useSmsFailover": "boolean",
                "failoverConfig": {
                    "type": "string",
                    "from": "string",
                    "subject": "string",
                    "content": "string"
                }
            }
        ],
        "reserveTime": "yyyy-MM-dd HH:mm",
        "reserveTimeZone": "string"
    }
    
    ItemMandatoryTypeDescriptionRemarks
    plusFriendIdMandatoryStringName of KakaoTalk Channel ((formerly) Plus Friend ID)
    templateCodeMandatoryStringTemplate code
    messagesMandatoryObjectMessage information- See items below (messages.XXX)
    - Up to 100
    messages.countryCodeOptionalStringRecipient's country codedefault: 82
    messages.toMandatoryStringRecipient's number
    messages.titleOptionalStringAlimTalk highlighted contentOnly available in templates of highlighting type
    messages.contentMandatoryStringAlimTalk message content
    messages.headerContentOptionalStringAlimTalk header content- Only available in templates of item list type
    - Enter less than 16 bytes
    messages.itemHighlightOptionalObjectItem highlightOnly available in templates of item list type
    messages.itemHighlight.titleMandatoryStringItem highlight title- Only available in templates of item list type
    Without images
    - Up to 30 characters can be entered (2 lines)
    - Up to 15 characters can be entered in a line
    With images
    - Up to 21 characters can be entered (2 lines)
    - Up to 10 characters can be entered in a line
    - If the length goes over 2 lines, the excess is replaced by an ellipsis.
    messages.itemHighlight.descriptionMandatoryStringItem highlight description- Only available in templates of item list type
    Without images
    - Up to 19 characters can be entered (1 line)
    With images
    - Up to 13 characters can be entered (1 line)
    - If the length goes over 1 line, the excess is replaced by an ellipsis.
    messages.itemOptionalObjectItem listIt can only be used in a template with the item list type.
    messages.item.listMandatoryArray of ObjectItem list- It can only be used in a template with the item list type.
    - It must be between 2 and 10.
    messages.item.list.titleMandatoryStringItem list title- It can only be used in a template with the item list type.
    - Up to 6 characters can be entered
    messages.item.list.descriptionMandatoryStringItem list description- It can only be used in a template with the item list type.
    - Up to 23 characters can be entered
    messages.summaryOptionalObjectItem summary informationIt can only be used in a template with the item list type.
    messages.summary.titleMandatoryStringItem summary title- It can only be used in a template with the item list type.
    - Up to 6 characters can be entered
    messages.summary.descriptionMandatoryStringItem summary description- It can only be used in a template with the item list type.
    - Allowed characters: currency symbols (Unicode currency symbols, yuan, yen, won), currency codes (ISO 4217), number, commas, periods, spaces
    - Two decimal places allowed
    - Up to 23 characters can be entered
    messages.buttonsOptionalArray of ObjectAlimTalk message buttonSee the following template button information.
    messages.buttons.typeMandatoryStringButton typeSee the following template button information.
    messages.buttons.nameMandatoryStringButton nameSee the following template button information.
    messages.useSmsFailoverOptionalBooleanSMS Failover use status- Available only on KakaoTalk Channels where Failover is set.
    - Default: follows the Failover set status of KakaoTalk Channel.
    messages.failoverConfigOptionalObjectFailover settingsSee the items below
    messages.failoverConfig.typeOptionalStringFailover SMS message type- SMS or LMS
    - Default: automatically applied according to the content length. (SMS if 90 bytes or less, LMS if it exceeds 90 bytes)
    messages.failoverConfig.fromOptionalStringFailover SMS caller ID- Default: caller ID selected when setting up Failover
    - Failover does not work when using an unauthorized caller ID.
    messages.failoverConfig.subjectOptionalStringFailover SMS title- Used when operating in LMS type
    - Default: KakaoTalk Channel name
    messages.failoverConfig.contentOptionalStringFailover SMS contentDefault: AlimTalk message content (excluding button)
    reserveTimeOptionalStringReserved date and timeReserved date and time for message delivery (yyyy-MM-dd HH:mm)
    reserveTimeZoneOptionalStringTime zone of reserved date and time- Time zone of reserved date and time (default: Asia/Seoul)
    - List of supported time zones
    * Use the TZ database name value
    Caution
    • If you are using the Mandatory field in the request Body, blanks are not allowed. (Only in the case of addition)
    • The content and buttons must be entered according to the registered and approved template specifications.
    • If the message you want to send does not meet the template specifications, then your request to send the message will fail.
    Note
    • If an image is registered in the template, when sending a message separately, the registered image will be sent even if you do not insert the corresponding content in the request body.
    • SMS Failover operates when the AlimTalk reception result code shows not successful. For codes with the prefix "B," SMS replacement cannot be sent through the Failover function.

    You can check the Web console manual (formerly, user manual) for a guide on template registration and inspection. Go to template registration guide

    Template button information

    TypeNameMandatory item
    DSTrack package
    WLWeb linklinkMobile, linkPc (URL starting with http:// or https://)
    ALApp linkschemeIos, schemeAndroid
    BKBot keyword
    MDSend message
    ACAdd ChannelFix button names with 채널 추가

    List of supported couriers

    CourierCourier nameInvoice number
    ePOST KoreaKorea Post13-digit number, or 6-digit number + 7-digit number
    (separator is "-" or "_")
    LogenLogen11-digit number, or 3-digit number + 4-digit number + 4-digit number
    (separator is "-" or "_")
    ILYANG Logis- ILYANG Logis post
    - ILYANG post
    - ILYANG Logis
    9 to 11-digit number
    FedEX- FedEx
    - FedEx
    - fedex
    12-digit number
    HANJIN TRANSPORTATIONHANJIN TRANSPORTATION10-digit number or 12-digit number
    KYOUNGDONG EXPRESSKYOUNGDONG EXPRESS9 to 16-digit number, or 4-digit number + 3-digit number + 6-digit number
    (separator is "-")
    HAPDONG EXPRESSHAPDONG EXPRESS9 to 16-digit number
    LOTTE GLOBAL LOGISTICS- LOTTE GLOBAL LOGISTICS
    - LOTTE LOGISTICS
    - HYUNDAI EXPRESS
    - Hyundai Logistics
    12-digit number, or 4-digit number + 4-digit number + 4-digit number
    (separator is "-")
    Nonghyup LogisNonghyup Logis12-digit number
    Honam LogisticsHonam Logistics10-digit number
    Chunil ParcelChunil Parcel11-digit number
    Daesin parcel servicesDaesin parcel services13-digit number
    Kunyong expressKunyong express10-digit number
    CUpost- CUpost
    - CU post
    10-digit number, 12-digit number, or 4-digit number + 4-digit number + 4-digit number
    (separator is "-" or "_")
    CVSnet postbox- GS Postbox
    - GS postbox
    - CVSnet postbox
    10-digit number, 12-digit number, or 4-digit number + 4-digit number + 4-digit number
    (separator is "-" or "_")
    HandexHandex10-digit number or 14-digit number
    TNT Express- TNTExpress
    - TNT Express
    - TNT Express
    8 to 9-digit number
    USPSUSPS10-digit number, 22-digit number, or 2 uppercase English letters + 9-digit number + 2 uppercase English letters
    (no separator)
    EMSEMS2 uppercase English letters + 9-digit number + 2 uppercase English letters
    (no separator)
    DHLDHL10-digit number
    GOODSTOLUCKGOODSTOLUCK4-digit number + 4-digit number + 4-digit number
    (separator is "-")
    • Buttons are not automatically added for unsupported couriers.
      • You can use the tracking page with web link (WL) buttons.

    Response bodies

    {
        "requestId":"string",
        "requestTime":"string",
        "statusCode":"string",
        "statusName":"string",
        "messages":[
            {
                "messageId":"string",
                "countryCode":"string",
                "to":"string",
                "content":"string",
                "requestStatusCode":"string",
                "requestStatusName":"string",
                "requestStatusDesc":"string",
                "useSmsFailover":"boolean"
            }
        ]
    }
    
    ItemMandatoryTypeDescriptionRemarks
    requestIdMandatoryStringDelivery request ID
    requestTimeMandatoryDateTimeDelivery request timeyyyy-MM-dd'T'HH:mm:ss.SSS
    statusCodeMandatoryStringRequest status code- Success: 202
    - Failed: others
    - Follows the HTTP Status specifications.
    statusNameMandatoryStringRequest status name- Success: success
    - Being processed: processing
    - Being reserved: reserved
    - Failed: fail
    messages.messageIdMandatoryStringMessage ID
    messages.countryCodeOptionalStringRecipient's country codedefault: 82
    messages.toMandatoryStringRecipient number
    messages.contentMandatoryStringAlimTalk message content
    messages.requestStatusCodeMandatoryStringDelivery request status code- Success: A000
    - Failed: other codes (reason for failure specified in the Desc category)
    messages.requestStatusNameMandatoryStringDelivery request status name- Success: success
    - Failed: fail
    messages.requestStatusDescMandatoryStringDelivery request status content
    messages.useSmsFailoverMandatoryBooleanSMS Failover use status

    Response status

    HTTP StatusDesc
    202Accepted (delivery request completed)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal Server Error

    Search for message delivery request

    Search for the message delivery request.

    Request URL

    GET https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/messages?requestId=
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project

    Parameters

    ItemMandatoryTypeDescriptionRemarks
    requestIdMandatoryStringRequest IDDelivery request ID
    plusFriendIdMandatoryStringKakao ChannelRegistered Channel name
    requestStartTimeMandatoryStringStart time of searchyyyy-MM-dd'T'HH:mm:ss
    requestEndTimeMandatoryStringEnd time of searchyyyy-MM-dd'T'HH:mm:ss
    completeStartTimeMandatoryStringStart time to complete deliveryyyyy-MM-dd'T'HH:mm:ss
    completeEndTimeMandatoryStringEnd time to complete deliveryyyyy-MM-dd'T'HH:mm:ss
    messageIdOptionalStringMessage ID
    requestStatusNameOptionalStringRequest statussuccess, fail
    messageStatusNameOptionalStringRequest statussuccess, processing, fail
    templateCodeOptionalStringTemplate codeRegistered template code
    toOptionalStringMessage received numberNumbers without hyphens (-)
    pageIndexOptionalIntegerPage numberdefault: 0
    pageSizeOptionalIntegerPage sizedefault: 20, max: 100
    When viewing including requestId, default: 100
    Note
    • History of delivering messages can only be viewed within the last 30 days.
    • Either requestId or requestStartTime + requestEndTime or completeStartTime + completeEndTime is required.
    • requestStartTime + requestEndTime and completeStartTime + completeEndTime cannot be used simultaneously.
    • The query range from requestStartTime to requestEndTime is limited to a maximum of 31 days.
    • The query range from completeStartTime to completeEndTime is limited to a maximum of 24 hours.
    • If requestId is not included in the query conditions, plusFriendId is required.

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    {
        "requestId": "string", 
        "statusCode": "string",
        "statusName": "string",
        "messages": [
            {
                "requestTime": "string",
                "messageId": "string",
                "countryCode": "string",
                "to": "string",
                "content": "string",
                "plusFriendId": "string",
                "templateCode": "string",
                "completeTime": "string",
                "requestStatusCode": "string",
                "requestStatusName": "string",
                "requestStatusDesc": "string",
                "messageStatusCode": "string",
                "messageStatusName": "string",
                "messageStatusDesc": "string",
                "useSmsFailover": "boolean",
                "failover": {
                    "smsServiceId": "string",
                    "requestId": "string",
                    "messageId": "string",
                    "requestStatusCode": "string",
                    "requestStatusName": "string",
                    "requestStatusDesc": "string",
                    "messageStatus": "string",
                    "messageStatusCode": "string",
                    "messageStatusName": "string",
                    "messageStatusDesc": "string"
                }
            }
        ],
        "pageSize": "integer",
        "pageIndex": "integer",
        "itemCount": "integer",
        "hasMore": "boolean"
    }
    
    ItemMandatoryTypeDescriptionRemarks
    requestIdOptionalStringDelivery request IDOnly exposed when you query with requestId
    statusCodeMandatoryStringRequest status code202 - Success
    Others - Failed
    * Follows the HTTP Status specifications.
    statusNameMandatoryStringRequest status namesuccess - Success
    processing - Being delivered
    reserved - Being reserved
    fail - Failed
    messages.requestTimeMandatoryDateTimeDelivery request timeyyyy-MM-dd'T'HH:mm:ss.SSS
    messages.messageIdMandatoryStringMessage ID
    messages.countryCodeOptionalStringRecipient's country codedefault: 82
    messages.toMandatoryStringRecipient's number
    messages.contentMandatoryStringAlimTalk message content
    messages.plusFriendIdMandatoryStringName of KakaoTalk Channel ((formerly) Plus Friend ID)
    messages.templateCodeMandatoryStringTemplate code
    messages.completeTimeOptionalDateTimeDelivery reporting (processing completion) timeyyyy-MM-dd'T'HH:mm:ss
    messages.requestStatusCodeMandatoryStringDelivery request status codeA000 - Success
    Other codes - Failed (reason for failure specified in the Desc category)
    messages.requestStatusNameMandatoryStringDelivery request status namesuccess - Success
    fail - Failed
    messages.requestStatusDescMandatoryStringDelivery request status content
    messages.messageStatusCodeMandatoryStringDelivery result status code0000 - Success
    Other codes - Failed (reason for failure specified in the Desc category)
    messages.messageStatusNameMandatoryStringDelivery result status namesuccess - Success
    processing - Being processed
        * Being processed in the message delivery server after successful sending request
        * Fail to search messageCode, messageDesc
    fail - Failed
    messages.messageStatusDescMandatoryStringDelivery result status description
    messages.useSmsFailoverMandatoryBooleanSMS Failover use status
    messages.failoverOptionalObjectSMS Failover
    messages.failover.smsServiceIdOptionalStringSMS Failover service ID
    messages.failover.requestIdOptionalStringSMS Failover delivery request ID
    messages.failover.messageIdOptionalStringSMS Failover delivery message ID
    messages.failover.requestStatusCodeOptionalStringSMS Failover delivery request status codeSee the Errors table.
    messages.failover.requestStatusNameOptionalStringSMS Failover delivery request status namesuccess - Success
    fail - Failed
    messages.failover.requestStatusDescOptionalStringSMS Failover delivery request status content
    messages.failover.messageStatusOptionalStringSMS Failover delivery request statusREADY: ready
    PROCESSING: being processed
    COMPLETED: processing completed
    messages.failover.messageStatusCodeOptionalStringSMS Failover delivery device received status result codeSee the Errors table.
    messages.failover.messageStatusNameOptionalStringSMS Failover delivery device received result name
    messages.failover.messageStatusDescOptionalStringSMS Failover delivery device received content
    pageSizeMandatoryIntegerPage size
    pageIndexMandatoryIntegerPage index (starting from 0)
    itemCountMandatoryIntegerThe number of messages within the viewed page
    hasMoreMandatoryBooleanIndicates whether there is a next page
    Note
    • If requestId is not included in the query condition, requestId is not included.

    Response status

    HTTP StatusDesc
    200OK (successfully searched)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal Server Error

    Search for message delivery result

    Search for the message delivery result.

    Request URL

    GET https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/messages/{messageId}
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project
    messageIdMandatoryStringMessage IDMessage identifier that is returned when the message is sent

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    {
        "messageId":"string",
        "requestId":"string",
        "requestTime":"string",
        "completeTime":"string",
        "plusFriendId":"string",
        "templateCode":"string",
        "countryCode":"string",
        "to":"string",
        "content":"string",
        "requestStatusCode":"string",
        "requestStatusName":"string",
        "requestStatusDesc":"string",
        "messageStatusCode":"string",
        "messageStatusName":"string",
        "messageStatusDesc":"string",
        "useSmsFailover":"boolean",
        "failover": {
            "smsServiceId":"string",
            "requestId":"string",
            "requestStatusCode":"string",
            "requestStatusName":"string",
            "requestStatusDesc":"string",
            "messageId":"string",
            "messageStatus":"string",
            "messageStatusCode":"string",
            "messageStatusName":"string",
            "messageStatusDesc":"string"
        }
    }
    
    ItemMandatoryTypeDescriptionRemarks
    messageIdMandatoryStringMessage ID
    requestIdMandatoryStringDelivery request ID
    requestTimeMandatoryDateTimeDelivery request timeyyyy-MM-dd'T'HH:mm:ss.SSS
    completeTimeOptionalDateTimeDelivery reporting (processing completion) timeyyyy-MM-dd'T'HH:mm:ss
    plusFriendIdMandatoryStringName of KakaoTalk Channel ((formerly) Plus Friend ID)
    templateCodeMandatoryStringTemplate code
    countryCodeOptionalStringRecipient's country codedefault: 82
    toMandatoryStringRecipient's number
    contentMandatoryStringAlimTalk message content
    requestStatusCodeMandatoryStringDelivery request status codeA000 - Success
    Other codes - Failed (reason for failure specified in the Desc category)
    requestStatusNameMandatoryStringDelivery request status namesuccess - Success
    fail - Failed
    requestStatusDescMandatoryStringDelivery request status content
    messageStatusCodeMandatoryStringDelivery result status code0000 - Success
    Other codes - Failed (reason for failure specified in the Desc category)
    messageStatusNameMandatoryStringDelivery result status namesuccess - Success
    processing - Being processed
        * Being processed in the message delivery server after successful sending request
        * Fail to search messageCode, messageDesc
    fail - Failed
    messageStatusDescMandatoryStringDelivery result status description
    messages.useSmsFailoverMandatoryBooleanSMS Failover use status
    messages.failoverOptionalObjectSMS Failover use status
    messages.failover.smsServiceIdOptionalStringSMS Failover service ID
    messages.failover.requestIdOptionalStringSMS Failover delivery request ID
    messages.failover.requestStatusCodeOptionalStringSMS Failover delivery request status codeSee the Errors table.
    messages.failover.requestStatusNameOptionalStringSMS Failover delivery request status namesuccess - Success
    fail - Failed
    messages.failover.requestStatusDescOptionalStringSMS Failover delivery request status content
    messages.failover.messageIdOptionalStringSMS Failover delivery message ID
    messages.failover.messageStatusOptionalStringSMS Failover delivery request statusREADY: ready
    PROCESSING: being processed
    COMPLETED: processing completed
    messages.failover.messageStatusCodeOptionalStringSMS Failover delivery device received status result codeSee the Errors table.
    messages.failover.messageStatusNameOptionalStringSMS Failover delivery device received result name
    messages.failover.messageStatusDescOptionalStringSMS Failover delivery device received content

    Failover request status code

    requestStatusCodeDesc
    0Succeeded
    E4000Failover setting is not valid.
    E4001Failover settings information is omitted.
    E4002Failover SMS service is not configured.
    E4003Failover SMS type (SMS, LMS) is not configured.
    E4004Failover SMS caller ID is not configured.
    E4005Failover SMS title is not configured.
    E4006Failover SMS content is not set.
    E4007Failover SMS recipient number is not set.
    E4008Failover SMS service is not available.
    E4009Failover SMS caller ID is not authenticated.
    E4010Failover SMS free 080 unsubscribing service is not available.
    E4999Failover settings parsing error (need to contact Customer Support)
    E5000Internal error (need to contact Customer Support)

    Response status

    HTTP StatusDesc
    200OK (successfully searched)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal Server Error

    Reserved message

    Search for reserved message status

    Search for the reservation status of message delivery.

    GET https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/reservations/{reserveId}/reserve-status
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project
    reserveIdMandatoryStringReserved message IDMessage identifier that is returned when searching for the reserved delivery requests (requestId)

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    {
      "reserveId": "string",
      "reserveTimeZone": "string",
      "reserveTime": "string",
      "reserveStatus": "string"
    }
    
    ItemMandatoryTypeDescriptionRemarks
    reserveIdMandatoryStringReserved message IDMessage identifier that is returned when searching for the reserved delivery requests (requestId)
    reserveTimeMandatoryStringReserved date and timeReserved date and time for message delivery (yyyy-MM-dd HH:mm)
    reserveTimeZoneMandatoryStringTime zone of reserved date and time- Time zone of reserved date and time (default: Asia/Seoul)
    - List of supported time zones
    * Use the TZ database name value
    reserveStatusMandatoryStringReserved status- Waiting to be sent: READY
    - Requesting to send: PROCESSING
    - Delivery canceled: CANCELED
    - Delivery request Failed: FAIL
    - Successful delivery request: DONE
    - Delivery request Failed (timeout): STALE

    Response status

    HTTP StatusDesc
    200OK (successfully searched)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal Server Error

    Cancel reserved message

    Cancel the reserved message delivery.

    DELETE https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/reservations/{reserveId}
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project
    reserveIdMandatoryStringReserved message IDMessage identifier that is returned when searching for the reserved delivery requests (requestId)

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    N/A
    

    Response status

    HTTP StatusDesc
    204No Content (successfully deleted)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal Server Error

    KakaoTalk Channel

    Search Channel

    Search KakaoTalk Channels.

    GET https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/channels
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project

    Parameters

    ItemMandatoryTypeDescriptionRemarks
    pageSizeOptionalIntegerPage sizeDefault: 100 (Only numbers between 1 and 100 can be entered.)
    pageIndexOptionalIntegerPage indexdefault: 0

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    [
        {
            "createTime": "string",
            "updateTime": "string",
            "serviceId": "string",
            "channelId": "string",
            "channelName": "string",
            "channelStatus": "string",
            "useSmsFailover": "boolean",
            "failoverServiceId": "string",
            "failoverTelNo": "string",
            "isBlock": "boolean",
            "isDormant": "boolean"
        }
    ]
    
    ItemMandatoryTypeDescriptionRemarks
    createTimeMandatoryStringCreated timeformat: LocalDateTime
    updateTimeOptionalStringEdited timeformat: LocalDateTime
    serviceIdMandatoryStringService IDService ID issued when registering the project
    channelIdMandatoryStringKakaoTalk Channel ID
    channelNameMandatoryStringKakaoTalk Channel name
    channelStatusMandatoryStringKakaoTalk Channel status- Normal: ACTIVE
    - Deleted: DELETED
    - Being deleted permanently: DELETING_PERMANENTLY
    - Deleted permanently: PERMANENTLY_DELETED
    - Blocked: BLOCKED
    - Deletion pending: PENDING_DELETE
    useSmsFailoverMandatoryBooleanUse status of alternative SMS delivery
    failoverServiceIdOptionalStringFailover SMS service ID
    failoverTelNoOptionalStringFailover caller ID
    isBlockMandatoryBooleanChannel block status
    isDormantMandatoryBooleanWhether Channel is switched to dormant status

    Response status

    HTTP StatusDesc
    200OK
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    429Too Many Requests
    500Internal Server Error

    AlimTalk template

    Search template

    This searches AlimTalk templates registered in the KakaoTalk Channel.

    GET https://sens.apigw.ntruss.com/alimtalk/v2/services/{serviceId}/templates?channelId=
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Path Variables

    ItemMandatoryTypeDescriptionRemarks
    serviceIdMandatoryStringService IDService ID issued when registering the project

    Parameters

    • channelId is a required value, and it returns the detailed information of the template when using templateCode.
    • Additional information, including comments, is only exposed during detailed inquiry.
    ItemMandatoryTypeDescriptionRemarks
    channelIdMandatoryStringChannel IDChannel ID registered to KakaoTalk
    templateCodeMandatoryStringTemplate codetemplateCode를 사용하여 조회 시 상세 조회 결과 반환
    Registered template code
    templateNameOptionalStringTemplate namelike search results are returned.
    pageSizeOptionalIntegerPage sizeDefault: 100 (Only numbers between 1 and 100 can be entered.)
    pageIndexOptionalIntegerPage indexdefault: 0

    Headers

    Go to API Header

    Request Body

    N/A
    

    Response bodies

    [
        {
            "createTime": "string",
            "updateTime": "string",
            "channelId": "string",
            "templateCode": "string",
            "templateName": "string", 
            "categoryCode": "string", 
            "categoryName": "string", 
            "messageType" : "string", 
            "emphasizeType" : "string", 
            "content": "string",
            "adContent": "string", 
            "extraContent": "string", 
            "title": "string", 
            "additionalTitle": "string", 
            "comments": [
                {
                    "commentId": "string",
                    "content": "string",
                    "status": "string",
                    "createTime": "string",
                    "attachment": [ 
                        {
                            "fileName": "string",
                            "fileUrl": "string"
                        }
                    ]
                }
            ],
            "templateInspectionStatus": "string",
            "templateStatus": "string",
            "buttons":[
                    {
                        "order":"integer",
                        "type":"string",
                        "name":"string",
                        "linkMobile":"string",
                        "linkPc":"string",
                        "schemeIos":"string",
                        "schemeAndroid":"string"
                    }
                ],
            "imageName": "string",
            "imageUrl": "string",
            "headerContent": "string",
            "itemHighlight": {
                "title": "string",
                "description": "string",
                "imageUrl": "string"
            },
            "item": {
                "list": [
                    {
                        "title": "string",
                        "description": "string"
                    }
                ],
                "summary": {
                    "title": "string",
                    "description": "string"
                }
            },
            "securityFlag": "boolean",
            "isBlock": "boolean",
            "isDormant": "boolean"
        }
    ]
    
    ItemMandatoryTypeDescriptionRemarks
    createTimeMandatoryStringCreated timeformat: LocalDateTime
    updateTimeOptionalStringEdited timeformat: LocalDateTime
    channelIdMandatoryStringKakaoTalk Channel ID
    templateCodeMandatoryStringTemplate code
    templateNameMandatoryStringTemplate name
    categoryCodeMandatoryStringTemplate category code
    categoryNameMandatoryStringTemplate category name
    messageTypeMandatoryStringTemplate message type- BA: default type
    - EX: additional information type
    - AD: ad addition type
    - MI: hybrid type
    emphasizeTypeMandatoryStringTemplate highlighting type- NONE: default type
    - TEXT: highlighting type
    - IMAGE: image type
    - ITEM_LIST: item list type
    contentMandatoryStringTemplate content
    adContentOptionalStringAd message
    extraContentOptionalStringAdditional information
    titleOptionalStringHighlighting type title
    additionalTitleOptionalStringHighlighting type additional title
    comments.commentIdMandatoryStringInspection ID
    comments.contentMandatoryStringInspection content
    comments.statusMandatoryStringInspection status- Inspection completed: APR
    - Inspection rejected: REJ
    comments.createMandatoryStringInspection time
    comments.attachmentOptionalObjectInspection inquiry attachment
    comments.attachment.fileNameMandatoryStringFile name
    comments.attachment.fileUrlMandatoryStringFile URL
    templateInspectionStatusMandatoryStringTemplate inspection status- Accept: ACCEPT
    - Register: REGISTER
    - In inspection: INSPECT
    - Completed: COMPLETE
    - Rejected: REJECT
    templateStatusMandatoryStringTemplate status- Normal: ACTIVE
    - Ready: READY
    - Stopped: STOP
    buttonsOptionalArray of ObjectAlimTalk message buttonSee the parent template button information.
    buttons.orderMandatoryIntegerButton orderButton registration order
    buttons.typeMandatoryStringButton typeSee the parent template button information.
    buttons.nameMandatoryStringButton nameSee the parent template button information.
    buttons.linkMobileOptionalStringMobile link buttonSee the registered template button information.
    buttons.linkPcOptionalStringPC link buttonSee the registered template button information.
    buttons.schemeIosOptionalStringiOS scheme buttonSee the registered template button information.
    buttons.schemeAndroidOptionalStringAndroid scheme buttonSee the registered template button information.
    titleOptionalStringHighlighting type title
    additionalTitleOptionalStringHighlighting type additional title
    useImageMandatoryBooleanImage usage status
    imageNameOptionalStringImage name
    imageUrlOptionalStringImage URL
    useHeaderContentMandatoryBooleanHeader usage status
    headerContentOptionalStringHeader content
    useItemHighlightMandatoryBooleanItem highlight status
    useItemHighlightImageMandatoryBooleanItem highlight image usage status
    itemHighlightOptionalObjectItem highlightOnly exposed when item highlight is used
    itemHighlight.titleOptionalStringItem highlight title
    itemHighlight.descriptionOptionalStringItem highlight content
    itemHighlight.imageUrlOptionalStringItem highlight image URL
    itemOptionalObjectItemOnly exposed when item is used
    item.listOptionalStringItem listOnly exposed when item list is used
    item.list.titleOptionalStringItem name
    item.list.descriptionOptionalStringItem content
    item.summaryOptionalStringItem summary informationOnly exposed when item summary information is used
    item.summary.titleOptionalStringItem summary information name
    item.summary.descriptionOptionalStringItem summary information content
    securityFlagMandatoryBooleanSecurity setting status
    isBlockMandatoryBooleanTemplate block status
    isDormantMandatoryBooleanWhether template is switched to dormant status
    Note
    • channelId is a required value, and it returns the detailed information of the template when using templateCode.
    • Additional information, including comments, is only exposed during detailed inquiry.

    Response status

    HTTP StatusDesc
    200OK
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    429Too Many Requests
    500Internal Server Error

    Errors

    AlimTalk reception result code

    StatusError textDesc
    0000-Normal delivery
    1001NoJsonBodyRequest Body is not in JSON format.
    1002InvalidHubPartnerKeyInvalid partner key
    1003InvalidSenderKeyOutgoing profile key is invalid.
    1004NoValueJsonElementName not found in Request Body (JSON)
    1005SenderNotFoundOutgoing profile not found
    1006DeletedSenderDeleted outgoing profile
    1007StoppedSenderBlocked outgoing profile
    1011ContractNotFoundContract information not found
    1012InvalidUserKeyExceptionInvalid formatted user key request
    1013InvalidAppLinkInvalid app connection
    1014InvalidBizNumInvalid business registration number
    1015TalkUserIdNotFonudInvalid app user id request
    1016BizNumNotEqualMismatched business registration number
    1020InvalidReceiveUserExceptionNo valid user identifier value
    1021BlockedProfileBlocked KakaoTalk Channel (check in KakaoTalk Channel operation tool.)
    1022DeactivatedProfileClosed KakaoTalk Channel (check in KakaoTalk Channel operation tool.)
    1023DeletedProfileDeleted KakaoTalk Channel (check in KakaoTalk Channel operation tool.)
    1024DeletingProfileDeletion pending KakaoTalk Channel (check in KakaoTalk Channel operation tool.)
    1025SpammedProfileMessage blocked KakaoTalk Channel (check in KakaoTalk Channel operation tool.)
    1026UnableUseMessageTypeThe request was made with response_method unavailable for the msg_type. (Image AlimTalk (AI) cannot be sent in real time.)
    1030InvalidParameterExceptionInvalid parameter request
    1033-Template type and message type mismatched
    2003FailedToSendMessageByNoFriendshipExceptionMessage transmission Failed (if KakaoTalk Channel is not added in the test server)
    2004FailedToMatchTemplateExceptionError when checking template match (Kakao internal error)
    2006FailedToMatchSerialNumberPrefixPatternSerial number format mismatch
    3000UnexceptedExcetpionAn unexpected error occurred.
    3005AckTimeoutExceptionA message was sent but the read receipt was not confirmed. (success uncertain)
    3006FailedToSendMessageExceptionMessage transmission failed due to Kakao's internal system error.
    3008InvalidPhoneNumberExceptionPhone number error
    3010JsonParsseExcetpionJSON parsing error
    3011MessageNotFoundExceptionMessage does not exist.
    3012SerialNumberDuplicatedExceptionMessage serial number is duplicated. (A unique value must be assigned for the message serial number.)
    3013MessageEmptyExceptionBlank message
    3014MessageLengthOverLimitExceptionMessage length limit error (text type exceeds 1000 characters, image type exceeds 400 characters.)
    3015TemplateNotFoundExceptionTemplate not found
    3016NoMatchedTemplateExceptionMessage content does not match the template.
    3018NoSendAvailableExceptionMessage could not be sent.
    3020SeenInfoNotFoundExceptionMessage verification information not found
    3022NoSendAvailableTimeExceptionOutside the time available for sending messages (FriendTalk/marketing messages can be sent from 08:00 to 20:00.)
    3024MessageInvaildImageExceptionThe image contained in the message cannot be sent.
    3025ExceedMaxVariableLengthExceptionVariable character limit exceeded
    3026Button chat_extra(event)-InvalidExtra(EventName)Exception '([A-Za-z0-9_]{1,50})'Consultation/bot conversion button extra, event character limit exceeded
    3027NoMatchedTemplateButtonExceptionButton content does not match the template.
    3028NoMatchedTemplateTitleExceptionMessage highlighting title does not match the template.
    3029ExceedMaxTitleLengthExceptionMessage highlighting title length limit exceeded (50 characters)
    3031-Text type mismatch
    3030NoMatchedTemplateWithMessageTypeExceptionMessage type does not match the template highlight type.
    3031NoMatchedTemplateHeaderExceptionHeader does not match the template.
    3032ExceedMaxHeaderLengthExceptionHeader length limit exceeded (16 characters)
    3033NoMatchedTemplateItemHighlightExceptionItem highlight does not match the template.
    3034ExceedMaxItemHighlightTitleLengthExceptionItem highlight title length limit exceeded (30 characters in case of no images, 21 characters in case there are images)
    3035ExceedMaxItemHighlightDescriptionLengthExceptionItem highlight description length limit exceeded (19 characters without images, 14 characters with images)
    3036NoMatchedTemplateItemListExceptionItem list does not match the template.
    3037ExceedMaxItemDescriptionLengthExceptionItem's description length limit exceeded in the item list (23 characters)
    3038NoMatchedTemplateItemSummaryExceptionItem summary information does not match template
    3039ExceedMaxItemSummaryDescriptionLengthExceptionItem summary information's description length limit exceeded (14 characters)
    3040InvalidItemSummaryDescriptionExceptionItem summary information's description includes disallowed characters. (characters other than currency sign/code, number, comma, period, and space included.)
    4000ResponseHistoryNotFoundExceptionMessage delivery result not found
    4001UnKnownMessageStatusErrorUnknown message status
    7011-Serial number pattern error
    7014-Message valid timeout error
    8512-Recipient type not found
    8514-request_id not found
    8520-Merchandise type not supported error
    8521-Message type not supported error
    8522-Test type not supported error
    8523-Response method not supported error
    8530-Recipient list size error
    8999-Internal server error
    9998The service is not currently provided.Admin is checking a problem that occurred in the system.
    9999Admin is checking an unknown problem that occurred in the system.Admin is checking a problem that occurred in the system.
    B000Prepare to relay failedPreparation for transmission to relay company failed
    B001Request to relay failedTransmission to relay company failed
    B002Filtering for request to relay failedFiltered due to invalid request
    B003Invalid phone number formatInvalid calling number format
    B004Quota ExceedOver quota
    B005Message processing timeout exceedDifference between message request time and processing time exceeds acceptable range
    B400Invalid RequestMessage format error
    B999Unexpected server errorUnexpected error

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.