Notification > KakaoTalk Bizmessage > お知らせトーク > API v1.5 Guide

お知らせトーク

[APIドメイン]

ドメイン
https://api-alimtalk.cloud.toast.com

v1.5 API紹介

  1. テンプレート登録APIにハイライトテンプレートを使用できるように変更されました。(全文送信時、title値を設定できます)
  2. テンプレートタイプが拡張されました。広告・付加情報などの内容を追加することができます(後日提供予定)。
  3. 通知トーク/友達トークメッセージ送信時にcreateUserフィールドが追加されました。
  4. 通知トーク/友達トークのメッセージ照会時に登録時間と登録者で照会できるようフィールドが追加されました。
  5. ファイルを添付してテンプレート問い合わせAPIを追加しました。

一般メッセージ

メッセージ置換送信リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。
X-NC-API-IDEMPOTENCY-KEY String X 重複メッセージ送信要求基準key
10分間同じkeyで要求すると、その要求を失敗処理します。

[Request body]

{
    "plusFriendId": String,
    "templateCode": String,
    "requestDate": String,
    "senderGroupingKey": String,
    "createUser": String,
    "recipientList": [{
        "recipientNo": String,
        "templateParameter": {
            String: String
        },
        "resendParameter": {
          "isResend":boolean,
          "resendType":String,
          "resendTitle":String,
          "resendContent":String,
          "resendSendNo":String
        },
        "recipientGroupingKey": String
    }]
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
templateCode String O 登録した送信テンプレートコード(最大20桁)
requestDate String X リクエスト日時(yyyy-MM-dd HH:mm)
(入力しない場合は即時送信)
senderGroupingKey String X 発信グルーピングキー(最大100文字)
createUser String X 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
recipientList List O 受信者リスト(最大1000人)
- recipientNo String O 受信番号(最大15桁)
- templateParameter Object X テンプレートパラメータ
(テンプレートに置換する変数が含まれる時は必須)
-- key String X 置換キー(#{key})
-- value String X 置換キーにマッピングされるvalue値
- resendParameter Object X 代替発送情報
-- isResend boolean X 送信失敗時、代替送信するかどうか
コンソールで送信失敗設定をした時、デフォルト設定は再送信になっています。
-- resendType String X 代替送信タイプ(SMS、LMS)
値がない場合は、テンプレート本文の長さに応じてタイプが決まります。
-- resendTitle String X LMS代替送信タイトル(最大20文字)
(値がない場合は、プラスフレンドIDで再送信されます。)
-- resendContent String X 代替送信内容(最大1000文字)
(値がない場合は、テンプレートの内容で再送信されます。)
-- resendSendNo String X 代替送信発信番号(最大13桁)
(SMSサービスに登録された発信番号ではない場合、代替送信が失敗することがあります。)
- recipientGroupingKey String X 受信者グルーピングキー(最大100文字)
  • リクエスト日時は呼び出す時点から30日後まで設定可能です。
  • SMSサービスで代替送信されるため、SMSサービスの送信APIの仕様に応じてフィールドを入力する必要があります。(SMSサービスに登録された発信番号、各種フィールドの長さ制限など)
  • SMSサービスは、国際SMSのみサポートします。国際受信者番号の場合、 resendType(代替送信タイプ)をSMSに変更すると正常に代替送信できます。
  • 指定した代替送信タイプのバイト制限を超える代替送信のタイトルや内容は、途中で切れて代替送信されることがあります。([SMS注意事項]参考)
  • templateTitleとtemplateItemHighlight.titleフィールドの一番後ろに日本語識別子とtemplateParameterを利用して\s文字を追加する場合、取り消し線スタイルを適用できます。
    • ただし、テンプレート登録時にあらかじめ\sをフィールドに追加しておいた場合は適用されません。

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/messages -d '{"plusFriendId":"{プラスフレンドID}","templateCode":"{テンプレートコード}","requestDate":"2018-10-01 00:00","recipientList":[{"recipientNo":"{受信番号}","templateParameter":{"{日本語識別子フィールド}":"{置換データ}"}}]}'

レスポンス

{
  "header": {
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  },
  "message": {
    "requestId": String,
    "senderGroupingKey": String,
    "sendResults": [
      {
        "recipientSeq": Integer,
        "recipientNo": String,
        "resultCode": Integer,
        "resultMessage": String,
        "recipientGroupingKey": String
      }
    ]
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object 本文領域
- requestId String リクエストID
- senderGroupingKey String 発信グルーピングキー
- sendResults Object 送信リクエスト結果
-- recipientSeq Integer 受信者シーケンス番号
-- recipientNo String 受信番号
-- resultCode Integer 送信リクエスト結果コード
-- resultMessage String 送信リクエスト結果メッセージ
-- recipientGroupingKey String 受信者グルーピングキー

メッセージ全文送信リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/raw-messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。
X-NC-API-IDEMPOTENCY-KEY String X 重複メッセージ送信要求基準key
10分間同じkeyで要求すると、その要求を失敗処理します。

[Request body]

{
    "plusFriendId": String,
    "templateCode": String,
    "requestDate": String,
    "senderGroupingKey": String,
    "recipientList": [
        {
            "recipientNo": String,
            "content": String,
            "templateTitle":String,
            "buttons": [
                {
                    "ordering": Integer,
                    "type": String,
                    "name": String,
                    "linkMo": String,
                    "linkPc": String,
                    "schemeIos": String,
                    "schemeAndroid": String
                }
            ],
            "resendParameter": {
              "isResend":boolean,
              "resendType":String,
              "resendTitle":String,
              "resendContent":String,
              "resendSendNo":String
            },
            "recipientGroupingKey": String
        }
    ]
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
templateCode String O 登録した送信テンプレートコード(最大20桁)
requestDate String X リクエスト日時(yyyy-MM-dd HH:mm)
(入力しない場合は即時送信)
senderGroupingKey String X 発信グルーピングキー(最大100文字)
recipientList List O 受信者リスト(最大1,000人)
- recipientNo String O 受信番号(最大15桁)
- content String O 内容(最大1000文字)
- templateTitle String X テンプレートハイライトタイトル(最大50桁)
- buttons List X ボタンリスト(最大5個)
-- ordering Integer X ボタン順序(ボタンがある場合は必須)
-- type String X ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-- name String X ボタン名(ボタンがある場合は必須、最大14文字)
-- linkMo String X モバイルWebリンク(WLタイプの場合は必須フィールド、最大500文字)
-- linkPc String X PC Webリンク(WLタイプの場合は任意フィールド、最大500文字)
-- schemeIos String X iOSアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
-- schemeAndroid String X Androidアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
- resendParameter Object X 代替発送情報
-- isResend boolean X 送信失敗時、代替送信するかどうか
コンソールで送信失敗設定をした時、デフォルト設定は再送信になっています。
-- resendType String X 代替送信タイプ(SMS、LMS)
値がない場合は、テンプレート本文の長さに応じてタイプが決まります。
-- resendTitle String X LMS代替送信タイトル(最大20文字)
(値がない場合は、プラスフレンドIDで再送信されます。)
-- resendContent String X 代替送信内容(最大1000文字)
(値がない場合は、テンプレートの内容で再送信されます。)
-- resendSendNo String X 代替送信発信番号(最大13桁)
(SMSサービスに登録された発信番号ではない場合、代替送信が失敗することがあります。)
- recipientGroupingKey String X 受信者グルーピングキー(最大100文字)
  • 本文とボタンに置換が完了したデータを入れてください。
  • リクエスト日時は呼び出す時点から30日後まで設定可能です。
  • SMSサービスで代替送信されるため、SMSサービスの送信APIの仕様に応じてフィールドを入力する必要があります。(SMSサービスに登録された発信番号、各種フィールドの長さ制限など)
  • SMSサービスは、国際SMSのみサポートします。国際受信者番号の場合、 resendType(代替送信タイプ)をSMSに変更すると正常に代替送信できます。
  • 指定した代替送信タイプのバイト制限を超える代替送信のタイトルや内容は、途中で切れて代替送信されることがあります。([SMS注意事項]参考)<
  • 送信時にtemplateTitleとtemplateItemHighlight.titleフィールドの一番後ろに\s文字を追加すると、取り消し線スタイルを適用できます。
    • ただし、テンプレート登録時にあらかじめ\sをフィールドに追加しておいた場合は適用されません。

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/raw-messages -d '{"plusFriendId":"{プラスフレンドID}","templateCode":"{テンプレートコード}","requestDate":"2018-10-01 00:00","recipientList":[{"recipientNo":"{受信番号}","content":"{内容}","buttons":[{"ordering":"{ボタン順序}","type":"{ボタンタイプ}","name":"{ボタン名}","linkMo":"{モバイルWebリンク}"}]}]}'

レスポンス

{
  "header": {
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  },
  "message": {
    "requestId": String,
    "senderGroupingKey": String,
    "sendResults": [
      {
        "recipientSeq": Integer,
        "recipientNo": String,
        "resultCode": Integer,
        "resultMessage": String,
        "recipientGroupingKey": String
      }
    ]
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object 本文領域
- requestId String リクエストID
- senderGroupingKey String 発信グルーピングキー
- sendResults Object 送信リクエスト結果
-- recipientSeq Integer 受信者シーケンス番号
-- recipientNo String 受信番号
-- resultCode Integer 送信リクエスト結果コード
-- resultMessage String 送信リクエスト結果メッセージ
-- recipientGroupingKey String 受信者グルーピングキー

メッセージリストの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter] 1番or(2番、 3番)の条件は必須

タイプ 必須 説明
requestId String 条件必須(1番) リクエストID
startRequestDate String 条件必須(2番) 送信リクエスト日の開始値(yyyy-MM-dd HH:mm)
endRequestDate String 条件必須(2番) 送信リクエスト日の終了値(yyyy-MM-dd HH:mm)
startCreateDate String 条件必須(3番) 登録日開始値(yyy-MM-dd HH:mm)
endCreateDate String 条件必須(3番) 登録日終値(yyy-MM-dd HH:mm)
recipientNo String X 受信番号
plusFriendId String X プラスフレンドID
templateCode String X テンプレートコード
senderGroupingKey String X 発信グルーピングキー
recipientGroupingKey String X 受信者グルーピングキー
messageStatus String X リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
resultCode String X 送信結果(MRC01 -> 成功、MRC02 -> 失敗)
createUser String X 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
pageNum Integer X ページ番号(基本:1)
pageSize Integer X 照会件数(基本:15、最大: 1000)
  • 90日以上前の送信リクエストデータは照会されません。
  • 送信リクエスト日時の範囲は最大30日です。

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "messageSearchResultResponse":{
    "messages":[
    {
      "requestId": String,
      "recipientSeq":Integer,
      "plusFriendId": String,
      "templateCode": String,
      "recipientNo": String,
      "content": String,
      "requestDate": String,
      "createDate":String,
      "receiveDate":String,
      "resendStatus": String,
      "resendStatusName": String,
      "messageStatus": String,
      "resultCode": String,
      "resultCodeName":String,
      "createUser":String,
      "buttons":[
        {
          "ordering": Integer,
          "type": String,
          "name": String,
          "linkMo": String,
          "linkPc": String,
          "schemeIos": String,
          "schemeAndroid": String
        }
      ],
      "senderGroupingKey": String,
      "recipientGroupingKey": String
    }
    ],
    "totalCount": Integer
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
messageSearchResultResponse Object 本文領域
- messages List メッセージリスト
-- requestId String リクエストID
-- recipientSeq Integer 受信者シーケンス番号
-- plusFriendId String プラスフレンドID
-- templateCode String テンプレートコード
-- recipientNo String 受信番号
-- content String 本文
-- requestDate String リクエスト日
-- createDate String 登録日時
-- receiveDate String 受信日時
-- resendStatus String 再送信ステータスコード
-- resendStatusName String 再送信ステータスコード名
-- messageStatus String リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
-- createUser String 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
-- resultCode String 受信結果コード
-- resultCodeName String 受信結果コード名
-- buttons List ボタンリスト
--- ordering Integer ボタン順序
--- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
--- name String ボタン名
--- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
--- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
--- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
--- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
-- senderGroupingKey String 発信グルーピングキー
-- recipientGroupingKey String 受信者グルーピングキー
- totalCount Integer 総個数

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/messages?startRequestDate=2018-05-01%20:00&endRequestDate=2018-05-30%20:59"

SMS/LMS再送信ステータス

説明
RSC01 再送信の対象ではない
RSC02 再送信の対象(送信結果が失敗の時、再送信が行われます。)
RSC03 再送信中
RSC04 再送信成功
RSC05 再送信失敗

メッセージ単件照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/messages/{requestId}/{recipientSeq}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
requestId String リクエストID
recipientSeq Integer 受信者シーケンス番号

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/messages/{requestId}/{recipientSeq}"

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "message":{
      "requestId": String,
      "recipientSeq":Integer,
      "plusFriendId": String,
      "templateCode": String,
      "recipientNo": String,
      "content": String,
      "templateTitle":String,
      "templateSubtitle":String,
      "templateExtra":String,
      "templateAd":String,
      "requestDate": String,
      "receiveDate":String,
      "createDate":String,
      "resendStatus": String,
      "resendStatusName": String,
      "resendResultCode":String,
      "resendRequestId":String,
      "messageStatus": String,
      "resultCode": String,
      "resultCodeName":String,
      "createUser":String,
      "buttons":[
        {
          "ordering": Integer,
          "type": String,
          "name": String,
          "linkMo": String,
          "linkPc": String,
          "schemeIos": String,
          "schemeAndroid": String
        }
      ],
      "senderGroupingKey": String,
      "recipientGroupingKey": String
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object メッセージ
- requestId String リクエストID
- recipientSeq Integer 受信者シーケンス番号
- plusFriendId String プラスフレンドID
- templateCode String テンプレートコード
- recipientNo String 受信番号
- content String 本文
- templateTitle String テンプレートハイライトタイトル
- templateSubtitle String テンプレートハイライトサブタイトル
- templateExtra String テンプレート付加情報
- templateAd String テンプレート内の受信同意または簡単な広告文句
- requestDate String リクエスト日時
- receiveDate String 受信日時
- createDate String 登録日時
- resendStatus String 再送信ステータスコード
- resendStatusName String 再送信ステータスコード名
- messageStatus String リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
- resultCode String 受信結果コード
- resultCodeName String 受信結果コード名
- buttons List ボタンリスト
-- ordering Integer ボタン順序
-- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-- name String ボタン名
-- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
-- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
-- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
-- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
- senderGroupingKey String 発信グルーピングキー
- recipientGroupingKey String 受信者グルーピングキー

認証メッセージ

1. 認証メッセージの送信時、含まれる必要がある認証文言案内

区分 認証文言
認証メッセージ auth、password、verif、にんしょう、認証、パスワード、認証
  • 例1)認証メッセージAPI送信リクエストした時、全文(テンプレート日本語識別子含む)に認証文言が含まれていない場合は、送信に失敗します。
  • 例2)認証文言が英文の場合、大文字/小文字の区別なしで有効性チェックが行われます。

メッセージ置換送信リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/auth/messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。
X-NC-API-IDEMPOTENCY-KEY String X 重複メッセージ送信要求基準key
10分間同じkeyで要求すると、その要求を失敗処理します。

[Request body]

{
    "plusFriendId": String,
    "templateCode": String,
    "requestDate": String,
    "senderGroupingKey": String,
    "createUser":String,
    "recipientList": [{
        "recipientNo": String,
        "templateParameter": {
            String: String
        },
        "resendParameter": {
          "isResend":boolean,
          "resendType":String,
          "resendTitle":String,
          "resendContent":String,
          "resendSendNo":String
        },
        "recipientGroupingKey": String
    }]
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
templateCode String O 登録した送信テンプレートコード(最大20桁)
requestDate String X リクエスト日時(yyyy-MM-dd HH:mm)
(入力しない場合は即時送信)
createUser String X 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
senderGroupingKey String X 発信グルーピングキー(最大100文字)
recipientList List O 受信者リスト(最大1000人)
- recipientNo String O 受信番号(最大15桁)
- templateParameter Object X テンプレートパラメータ
(テンプレートに置換する変数が含まれる時は必須)
-- key String X 置換キー(#{key})
-- value String X 置換キーにマッピングされるvalue値
- resendParameter Object X 代替発送情報
-- isResend boolean X 送信失敗時、代替送信するかどうか
コンソールで送信失敗設定をした時、デフォルト設定は再送信になっています。
-- resendType String X 代替送信タイプ(SMS、LMS)
値がない場合は、テンプレート本文の長さに応じてタイプが決まります。
-- resendTitle String X LMS代替送信タイトル(最大20文字)
(値がない場合は、プラスフレンドIDで再送信されます。)
-- resendContent String X 代替送信内容(最大1000文字)
(値がない場合は、テンプレートの内容で再送信されます。)
-- resendSendNo String X 代替送信発信番号(最大13桁)
(SMSサービスに登録された発信番号ではない場合、代替送信が失敗することがあります。)
- recipientGroupingKey String X 受信者グルーピングキー(最大100文字)
  • リクエスト日時は呼び出す時点から30日後まで設定可能です。
  • SMSサービスで代替送信されるため、SMSサービスの送信APIの仕様に応じてフィールドを入力する必要があります。(SMSサービスに登録された発信番号、各種フィールドの長さ制限など)
  • 指定した代替送信タイプのバイト制限を超える代替送信のタイトルや内容は、途中で切れて代替送信されることがあります。([SMS注意事項]参考)

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/auth/messages -d '{"plusFriendId":"{プラスフレンドID}","templateCode":"{テンプレートコード}","requestDate":"2018-10-01 00:00","recipientList":[{"recipientNo":"{受信番号}","templateParameter":{"{日本語識別子フィールド}":"{置換データ}"}}]}'

レスポンス

{
  "header": {
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  },
  "message": {
    "requestId": String,
    "senderGroupingKey": String,
    "sendResults": [
      {
        "recipientSeq": Integer,
        "recipientNo": String,
        "resultCode": Integer,
        "resultMessage": String,
        "recipientGroupingKey": String
      }
    ]
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object 本文領域
- requestId String リクエストID
- senderGroupingKey String 発信グルーピングキー
- sendResults Object 送信リクエスト結果
-- recipientSeq Integer 受信者シーケンス番号
-- recipientNo String 受信番号
-- resultCode Integer 送信リクエスト結果コード
-- resultMessage String 送信リクエスト結果メッセージ
-- recipientGroupingKey String 受信者グルーピングキー

メッセージ全文送信リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/auth/raw-messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。
X-NC-API-IDEMPOTENCY-KEY String X 重複メッセージ送信要求基準key
10分間同じkeyで要求すると、その要求を失敗処理します。

[Request body]

{
    "plusFriendId": String,
    "templateCode": String,
    "requestDate": String,
    "senderGroupingKey": String,
    "createUser": String,
    "recipientList": [
        {
            "recipientNo": String,
            "content": String,
            "templateTitle":String,
            "buttons": [
                {
                    "ordering": Integer,
                    "type": String,
                    "name": String,
                    "linkMo": String,
                    "linkPc": String,
                    "schemeIos": String,
                    "schemeAndroid": String
                }
            ],
            "resendParameter": {
              "isResend":boolean,
              "resendType":String,
              "resendTitle":String,
              "resendContent":String,
              "resendSendNo":String
            },
            "recipientGroupingKey": String
        }
    ]
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
templateCode String O 登録した送信テンプレートコード(最大20桁)
requestDate String X リクエスト日時(yyyy-MM-dd HH:mm)
(入力しない場合は即時送信)
senderGroupingKey String X 発信グルーピングキー(最大100文字)
createUser String X 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
recipientList List O 受信者リスト(最大1,000人)
- recipientNo String O 受信番号(最大15桁)
- content String O 内容(最大1000文字)
- templateTitle String X タイトル(最大50桁)
- buttons List X ボタンリスト(最大5個)
-- ordering Integer X ボタン順序(ボタンがある場合は必須)
-- type String X ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-- name String X ボタン名(ボタンがある場合は必須、最大14文字)
-- linkMo String X モバイルWebリンク(WLタイプの場合は必須フィールド、最大500文字)
-- linkPc String X PC Webリンク(WLタイプの場合は任意フィールド、最大500文字)
-- schemeIos String X iOSアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
-- schemeAndroid String X Androidアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
- resendParameter Object X 代替発送情報
-- isResend boolean X 送信失敗時、代替送信するかどうか
コンソールで送信失敗設定をした時、デフォルト設定は再送信になっています。
-- resendType String X 代替送信タイプ(SMS、LMS)
値がない場合は、テンプレート本文の長さに応じてタイプが決まります。
-- resendTitle String X LMS代替送信タイトル(最大20文字)
(値がない場合は、プラスフレンドIDで再送信されます。)
-- resendContent String X 代替送信内容(最大1000文字)
(値がない場合は、テンプレートの内容で再送信されます。)
-- resendSendNo String X 代替送信発信番号(最大13桁)
(SMSサービスに登録された発信番号ではない場合、代替送信が失敗することがあります。)
- recipientGroupingKey String X 受信者グルーピングキー(最大100文字)
  • 本文とボタンに置換が完了したデータを入れてください。
  • リクエスト日時は呼び出す時点から30日後まで設定可能です。

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/auth/raw-messages -d '{"plusFriendId":"{プラスフレンドID}","templateCode":"{テンプレートコード}","requestDate":"2018-10-01 00:00","recipientList":[{"recipientNo":"{受信番号}","content":"{内容}","buttons":[{"ordering":"{ボタン順序}","type":"{ボタンタイプ}","name":"{ボタン名}","linkMo":"{モバイルWebリンク}"}]}]}'

レスポンス

{
  "header": {
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  },
  "message": {
    "requestId": String,
    "senderGroupingKey": String,
    "sendResults": [
      {
        "recipientSeq": Integer,
        "recipientNo": String,
        "resultCode": Integer,
        "resultMessage": String,
        "recipientGroupingKey": String
      }
    ]
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object 本文領域
- requestId String リクエストID
- senderGroupingKey String 発信グルーピングキー
- sendResults Object 送信リクエスト結果
-- recipientSeq Integer 受信者シーケンス番号
-- recipientNo String 受信番号
-- resultCode Integer 送信リクエスト結果コード
-- resultMessage String 送信リクエスト結果メッセージ
-- recipientGroupingKey String 受信者グルーピングキー

メッセージリストの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/auth/messages
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter] 1番or(2番、 3番)の条件は必須

タイプ 必須 説明
requestId String 条件必須(1番) リクエストID
startRequestDate String 条件必須(2番) 送信リクエスト日の開始値(yyyy-MM-dd HH:mm)
endRequestDate String 条件必須(2番) 送信リクエスト日の終了値(yyyy-MM-dd HH:mm)
startCreateDate String 条件必須(3番) 登録日開始値(yyy-MM-dd HH:mm)
endCreateDate String 条件必須(3番) 登録日終値(yyy-MM-dd HH:mm)
recipientNo String X 受信番号
plusFriendId String X プラスフレンドID
templateCode String X テンプレートコード
senderGroupingKey String X 発信グルーピングキー
recipientGroupingKey String X 受信者グルーピングキー
messageStatus String X リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
createUser String X 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
resultCode String X 送信結果(MRC01 -> 成功、MRC02 -> 失敗)
pageNum Integer X ページ番号(基本:1)
pageSize Integer X 照会件数(基本:15、最大: 1000)
  • 90日以上前の送信リクエストデータは照会されません。
  • 送信リクエスト日時の範囲は最大30日です。

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "messageSearchResultResponse":{
    "messages":[
    {
      "requestId": String,
      "recipientSeq":Integer,
      "plusFriendId": String,
      "templateCode": String,
      "recipientNo": String,
      "content": String,
      "requestDate": String,
      "createDate":String,
      "receiveDate":String,
      "resendStatus": String,
      "resendStatusName": String,
      "messageStatus": String,
      "resultCode": String,
      "resultCodeName":String,
      "createUser":String,
      "buttons":[
        {
          "ordering": Integer,
          "type": String,
          "name": String,
          "linkMo": String,
          "linkPc": String,
          "schemeIos": String,
          "schemeAndroid": String
        }
      ],
      "senderGroupingKey": String,
      "recipientGroupingKey": String
    }
    ],
    "totalCount": Integer
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
messageSearchResultResponse Object 本文領域
- messages List メッセージリスト
-- requestId String リクエストID
-- recipientSeq Integer 受信者シーケンス番号
-- plusFriendId String プラスフレンドID
-- templateCode String テンプレートコード
-- recipientNo String 受信番号
-- content String 本文
-- requestDate String リクエスト日時
-- createDate String 登録日時
-- receiveDate String 受信日時
-- resendStatus String 再送信ステータスコード
-- resendStatusName String 再送信ステータスコード名
-- messageStatus String リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
-- resultCode String 受信結果コード
-- resultCodeName String 受信結果コード名
-- createUser String 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
-- buttons List ボタンリスト
--- ordering Integer ボタン順序
--- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
--- name String ボタン名
--- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
--- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
--- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
--- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
-- senderGroupingKey String 発信グルーピングキー
-- recipientGroupingKey String 受信者グルーピングキー
- totalCount Integer 総個数

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/auth/messages?startRequestDate=2018-05-01%20:00&endRequestDate=2018-05-30%20:59"

SMS/LMS再送信ステータス

説明
RSC01 再送信の対象ではない
RSC02 再送信の対象(送信結果が失敗の時、再送信が行われます。)
RSC03 再送信中
RSC04 再送信成功
RSC05 再送信失敗

メッセージ単件照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/auth/messages/{requestId}/{recipientSeq}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
requestId String リクエストID
recipientSeq Integer 受信者シーケンス番号

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/auth/messages/{requestId}/{recipientSeq}"

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "message":{
      "requestId": String,
      "recipientSeq":Integer,
      "plusFriendId": String,
      "templateCode": String,
      "recipientNo": String,
      "content": String,
      "templateTitle":String,
      "templateSubtitle":String,
      "templateExtra":String,
      "templateAd":String,
      "requestDate": String,
      "createDate":String,
      "receiveDate":String,
      "resendStatus": String,
      "resendStatusName": String,
      "resendResultCode":String,
      "resendRequestId":String,
      "messageStatus": String,
      "resultCode": String,
      "resultCodeName":String,
      "createUser":String,
      "buttons":[
        {
          "ordering": Integer,
          "type": String,
          "name": String,
          "linkMo": String,
          "linkPc": String,
          "schemeIos": String,
          "schemeAndroid": String
        }
      ],
      "senderGroupingKey": String,
      "recipientGroupingKey": String
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
message Object メッセージ
- requestId String リクエストID
- recipientSeq Integer 受信者シーケンス番号
- plusFriendId String プラスフレンドID
- templateCode String テンプレートコード
- recipientNo String 受信番号
- content String 本文
- templateTitle String テンプレートハイライトタイトル
- templateSubtitle String テンプレートハイライトサブタイトル
- templateExtra String テンプレート付加情報
- templateAd String テンプレート内の受信同意または簡単な広告文句
- requestDate String リクエスト日時
- createDate String 登録日時
- receiveDate String 受信日時
- resendStatus String 再送信ステータスコード
- resendStatusName String 再送信ステータスコード名
- resendResultCode String 再送結果コードSMS結果コード
- resendRequestId String 再送SMSリクエストID
- messageStatus String リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
- resultCode String 受信結果コード
- resultCodeName String 受信結果コード名
- createUser String 登録者(コンソールから送信する場合、ユーザーUUIDとして保存)
- buttons List ボタンリスト
-- ordering Integer ボタン順序
-- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-- name String ボタン名
-- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
-- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
-- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
-- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
- senderGroupingKey String 発信グルーピングキー
- recipientGroupingKey String 受信者グルーピングキー

メッセージ

メッセージ送信取消

リクエスト

[URL]

DELETE  /alimtalk/v1.5/appkeys/{appkey}/messages/{requestId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
requestId String リクエストID

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter]

タイプ 必須 説明
recipientSeq String X 受信者シーケンス番号
(入力しない場合、リクエストIDのすべての送信件をキャンセル)
  • 一般/認証メッセージは同じAPIでキャンセルできます。

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

[例]

curl -X DELETE -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/messages/{requestId}?recipientSeq=1,2,3"

メッセージ結果アップデートの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/message-results
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter]

タイプ 必須 説明
startUpdateDate String O 結果アップデート照会開始時間(yyyy-MM-dd HH:mm)
endUpdateDate String O 結果アップデート照会終了時間(yyyy-MM-dd HH:mm)
alimtalkMessageType String X お知らせトークメッセージタイプ(NORMAL、AUTH)
pageNum Integer X ページ番号(基本:1)
pageSize Integer X 照会件数(基本:15、最大: 1000)

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "messageSearchResultResponse":{
    "messages":[
    {
      "requestId": String,
      "recipientSeq":Integer,
      "plusFriendId": String,
      "templateCode": String,
      "recipientNo": String,
      "content": String,
      "requestDate": String,
      "receiveDate":String,
      "resendStatus": String,
      "resendStatusName": String,
      "messageStatus": String,
      "resultCode": String,
      "resultCodeName":String,
      "buttons":[
        {
          "ordering": Integer,
          "type": String,
          "name": String,
          "linkMo": String,
          "linkPc": String,
          "schemeIos": String,
          "schemeAndroid": String
        }
      ],
      "senderGroupingKey": String,
      "recipientGroupingKey": String
    }
    ],
    "totalCount": Integer
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
messageSearchResultResponse Object 本文領域
- messages List メッセージリスト
-- requestId String リクエストID
-- recipientSeq Integer 受信者シーケンス番号
-- plusFriendId String プラスフレンドID
-- templateCode String テンプレートコード
-- recipientNo String 受信番号
-- content String 本文
-- requestDate String リクエスト日時
-- receiveDate String 受信日時
-- resendStatus String 再送信ステータスコード
-- resendStatusName String 再送信ステータスコード名
-- messageStatus String リクエストステータス(COMPLETED -> 成功、FAILED -> 失敗、CANCEL -> キャンセル)
-- resultCode String 受信結果コード
-- resultCodeName String 受信結果コード名
-- buttons List ボタンリスト
--- ordering Integer ボタン順序
--- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
--- name String ボタン名
--- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
--- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
--- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
--- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
-- senderGroupingKey String 発信グルーピングキー
-- recipientGroupingKey String 受信者グルーピングキー
- totalCount Integer 総個数

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/message-results?startUpdateDate=2018-05-01%20:00&endUpdateDate=2018-05-30%20:59"

プラスフレンド

プラスフレンドカテゴリーの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/categories
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

レスポンス

{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "categories":[
  {
      "parentCode":String,
      "depth":Integer,
      "code":String,
      "name":String,
      "subCategories":[
        {
        "parentCode":String,
        "depth":Integer,
        "code":String,
        "name":String,
        "subCategories":[
          {
            "parentCode":String,
            "depth":Integer,
            "code":String,
            "name":String
          }
          ]
        }
      ]
    }
  ]
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
categories Object カテゴリー
- parentCode String 親コード
- depth Integer カテゴリーの深さ
- code String カテゴリーコード
- name String カテゴリー名
- subCategories Object サブカテゴリー
-- parentCode String 親コード
-- depth Integer カテゴリーの深さ
-- code String カテゴリーコード
-- name String カテゴリー名
-- subCategories Object サブカテゴリー
--- parentCode String 親コード
--- depth Integer カテゴリーの深さ
--- code String カテゴリーコード
--- name String カテゴリー名

プラスフレンドの登録

リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/plus-friends
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
  "plusFriendId":String,
  "phoneNo":String,
  "categoryCode":String
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
phoneNo String O 管理者の携帯電話番号(最大15桁)
categoryCode String O カテゴリーコード(11文字)
カテゴリー照会APIのレスポンス参考
ex) 00100010001健康(001) - 病院(0001) - 総合病院(0001)

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

プラスフレンドトークン認証

リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/tokens
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
  "token":"Integer"
}
タイプ 必須 説明
token Integer O 認証トークン(プラスフレンド登録API呼び出し後、カカオトークアプリで受け取った認証トークン)

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

プラスフレンド単件照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

レスポンス

{  
   "header":{  
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
   },
   "plusFriend":{  
         "plusFriendId":String,
         "plusFriendType":String,
         "senderKey":String,
         "categoryCode":String,
         "status":String,
         "statusName":String,
         "kakaoStatus":String,
         "kakaoStatusName":String,
         "kakaoProfileStatus":String,
         "kakaoProfileStatusName":String,
         "alimtalk": {  
                "isResend": Boolean,
                "resendSendNo": String,
                "dailyMaxCount":Integer,
                "sentCount":Integer
          },
         "friendtalk": {  
                "isResend": Boolean,
                "resendSendNo": String,
                "resendUnsubscribeNo": String,
                "dailyMaxCount":Integer,
                "sentCount":Integer
         },
         "createDate": String
    }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
plusFriend Object プラスフレンド
- plusFriendId String プラスフレンドID
- plusFriendType String プラスフレンドタイプ(NORMAL、GROUP)
- senderKey String 発信キー
- categoryCode String カテゴリーコード
- status String NHN Cloudプラスフレンドステータスコード
(YSC02:登録待機中、YSC03:正常登録)
- statusName String NHN Cloudプラスフレンドステータス名(登録待機中、正常登録)
- kakaoStatus String カカオプラスフレンドステータスコード
(A:正常、S:遮断、D:削除)
statusがYSC02の場合、kakaoStatus null値を持ちます。
- kakaoStatusName String カカオプラスフレンドステータス名(正常、遮断、削除)
statusがYSC02の場合、kakaoStatusName null値を持ちます。
- kakaoProfileStatus String カカオプラスフレンドプロフィールステータスコード
(A:有効化、B:遮断、C:無効化、D:削除E:削除処理中)
statusがYSC02の場合、kakaoProfileStatus null値を持ちます。
- kakaoProfileStatusName String カカオプラスフレンドプロフィールステータス名(有効化、無効化、遮断、削除処理中、削除)
statusがYSC02の場合、kakaoProfileStatusName null値を持ちます。
- alimtalk Object お知らせトーク設定情報
-- isResend String 送信失敗設定(再送信)するかどうか
-- resendSendNo String 再送信時、tc-sms発信番号
-- dailyMaxCount Integer お知らせトークの一日最大送信件数
(値が0の場合、件数制限なし)
-- sentCount Integer お知らせトークの一日送信件数
(値が0の場合、件数制限なし)
- friendtalk Object 友人トーク設定情報
-- isResend String 送信失敗設定(再送信)するかどうか
-- resendSendNo String 再送信時、tc-sms発信番号
-- resendUnsubscribeNo String 再送信時、tc-sms 080受信拒否番号
-- dailyMaxCount Integer カカともへのメッセージの一日最大送信件数
(値が0の場合、件数制限なし)
-- sentCount Integer カカともへのメッセージの一日送信件数
(値が0の場合、件数制限なし)
- createDate String 登録日時

プラスフレンドリストの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/plus-friends
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter] 1番or 2番の条件は必須

タイプ 必須 説明
plusFriendId String X プラスフレンドID
status String X プラスフレンドステータスコード
(YSC02:トークン認証待機中、YSC03:正常登録)
pageNum Integer X ページ番号(基本:1)
pageSize Integer X 照会件数(基本:15、最大: 1000)

レスポンス

{  
   "header":{  
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
   },
   "plusFriends":[  
      {  
         "plusFriendId":String,
         "plusFriendType":String,
         "senderKey":String,
         "categoryCode":String,
         "status":String,
         "statusName":String,
         "kakaoStatus":String,
         "kakaoStatusName":String,
         "kakaoProfileStatus":String,
         "kakaoProfileStatusName":String,
         "createDate": String,
         "alimtalk": {  
                "isResend": Boolean,
                "resendSendNo": String,
                "dailyMaxCount":Integer,
                "sentCount":Integer
          },
         "friendtalk": {  
                "isResend": Boolean,
                "resendSendNo": String,
                "resendUnsubscribeNo": String,
                "dailyMaxCount":Integer,
                "sentCount":Integer
         }
      }
   ],
   "totalCount": Integer
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
plusFriends Object プラスフレンド
- plusFriendId String プラスフレンドID
- plusFriendType String プラスフレンドタイプ(NORMAL、GROUP)
- senderKey String 発信キー
- categoryCode String カテゴリーコード
- status String NHN Cloudプラスフレンドステータスコード
(YSC02:登録待機中、YSC03:正常登録)
- statusName String NHN Cloudプラスフレンドステータス名(登録待機中、正常登録)
- kakaoStatus String カカオプラスフレンドステータスコード
(A:正常、S:遮断、D:削除)
statusがYSC02の場合、kakaoStatus null値を持ちます。
- kakaoStatusName String カカオプラスフレンドステータス名(正常、遮断、削除)
statusがYSC02の場合、kakaoStatusName null値を持ちます。
- kakaoProfileStatus String カカオプラスフレンドプロフィールステータスコード
(A:有効化、B:遮断、C:無効化、D:削除E:削除処理中)
statusがYSC02の場合、kakaoProfileStatus null値を持ちます。
- kakaoProfileStatusName String カカオプラスフレンドプロフィールステータス名(有効化、無効化、遮断、削除処理中、削除)
statusがYSC02の場合、kakaoProfileStatusName null値を持ちます。
- alimtalk Object お知らせトーク設定情報
-- isResend String 送信失敗設定(再送信)するかどうか
-- resendSendNo String 再送信時、tc-sms発信番号
-- dailyMaxCount Integer お知らせトークの一日最大送信件数
(値が0の場合、件数制限なし)
-- sentCount Integer お知らせトークの一日送信件数
(値が0の場合、件数制限なし)
- friendtalk Object 友人トーク設定情報
-- isResend String 送信失敗設定(再送信)するかどうか
-- resendSendNo String 再送信時、tc-sms発信番号
-- resendUnsubscribeNo String 再送信時、tc-sms 080受信拒否番号
-- dailyMaxCount Integer カカともへのメッセージの一日最大送信件数
(値が0の場合、件数制限なし)
-- sentCount Integer カカともへのメッセージの一日送信件数
(値が0の場合、件数制限なし)
- createDate String 登録日時
totalCount Integer 総個数

テンプレート

テンプレートカテゴリー照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/template/categories
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

レスポンス


{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "categories": [
    {
      "name": String,
      "subCategories": [
        {
          "code": String,
          "name": String,
          "groupName": String,
          "inclusion": String,
          "exclusion": String
        }
      ]
    }
  ]
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
categories List カテゴリー一覧
- name String カテゴリー名
- subCategories List サブカテゴリーのリスト
-- code String カテゴリーコード(テンプレートの登録/変更する際、使用)
-- name String カテゴリー名
-- groupName String カテゴリーグループ名
-- inclusion String カテゴリー対象テンプレートの説明
-- exclusion String カテゴリの除外対象のテンプレートの説明

テンプレートの登録

リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
  "templateCode":String,
  "templateName":String,
  "templateContent":String,
  "templateMessageType": String,
  "templateEmphasizeType":String,
  "templateExtra": String,
  "templateTitle":String,
  "templateSubtitle":String,
  "securityFlag": Boolean,
  "categoryCode": String,
  "buttons":[
    {
      "ordering":Integer,
      "type":String,
      "name":String,
      "linkMo":String,
      "linkPc":String,
      "schemeIos":String,
      "schemeAndroid":String
    }
  ]
}
タイプ 必須 説明
templateCode String O テンプレートコード(最大20文字)
templateName String O テンプレート名(最大150文字)
templateContent String O テンプレート本文(最大1000文字)
templateMessageType String X テンプレートメッセージタイプ(BA:基本型、EX:付加情報型、AD:広告追加型、MI:複合型)
EX:templateExtraフィールド必須
MI:templateExtra フィールド必須」
templateEmphasizeType String X テンプレートハイライトタイプ(NONE:基本、TEXT:ハイライト、default:NONE)
TEXT:templateTitle、templateSubtitleフィールド必須
templateExtra String X テンプレート付加情報
tempalteTitle String X テンプレートのタイトル(最大50字、Android:2行、23字以上のコマ処理、iOS:2行、27字以上のコマ処理)
templateSubtitle String X テンプレートの補助フレーズ(最大50文字、Android:18字以上のコマを省く、iOS:21字以上のコマを省く)
securityFlag Boolean X セキュリティテンプレートかどうか
OTPなどのセキュリティメッセージの場合、設定
発信当時のメインデバイスを除くすべてのデバイスにメッセージテキストミノチュル(default: false)
categoryCode String X テンプレートのカテゴリコード(テンプレートカテゴリー照会API参考, default: 999999)
カテゴリーを入力し、テンプレートを優先審査
buttons List X ボタンリスト(最大5個)
-ordering Integer X ボタン順序(1~5)
-type String X ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-name String X ボタン名(ボタンがある場合は必須、最大14文字)
-linkMo String X モバイルWebリンク(WLタイプの場合は必須フィールド、最大500文字)
-linkPc String X PC Webリンク(WLタイプの場合は任意フィールド、最大500文字)
-schemeIos String X iOSアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
-schemeAndroid String X Androidアプリリンク(ALタイプの場合は必須フィールド、最大500文字)

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

テンプレートの修正

リクエスト

[URL]

PUT  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID
templateCode String テンプレートコード

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
  "templateName":String,
  "templateContent":String,
  "templateMessageType": String,
  "templateEmphasizeType":String,
  "templateExtra": String,
  "templateAd": String,
  "templateTitle":String,
  "templateSubtitle":String,
  "securityFlag": Boolean,
  "categoryCode": String,
  "buttons":[
    {
      "ordering":Integer,
      "type":String,
      "name":String,
      "linkMo":String,
      "linkPc":String,
      "schemeIos":String,
      "schemeAndroid":String
    }
  ]
}
タイプ 必須 説明
templateName String O テンプレート名(最大150文字)
templateContent String O テンプレート本文(最大1000文字)
templateMessageType String X テンプレートメッセージタイプ(BA:基本型、EX:付加情報型、AD:広告追加型、MI:複合型)
EX:templateExtraフィールド必須
MI:templateExtraフィールド必須」
templateEmphasizeType String X テンプレートハイライトタイプ(NONE:基本、TEXT:ハイライト、default:NONE)
TEXT:templateTitle、templateSubtitleフィールド必須
templateExtra String X テンプレート付加情報
tempalteTitle String X テンプレートのタイトル(最大50字、Android:2行、23字以上のコマ処理、iOS:2行、27字以上のコマ処理)
templateSubtitle String X テンプレートの補助フレーズ(最大50文字、Android:18字以上のコマを省く、iOS:21字以上のコマを省く)
securityFlag Boolean X セキュリティテンプレートかどうか
OTPなどのセキュリティメッセージの場合、設定
発信当時のメインデバイスを除くすべてのデバイスにメッセージテキストミノチュル(default: false)
categoryCode String X テンプレートのカテゴリコード(テンプレートカテゴリー照会API参考, default: 999999)
カテゴリーを入力し、テンプレートを優先審査
buttons List X ボタンリスト(最大5個)
-ordering Integer X ボタン順序(1~5)
-type String X ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
-name String X ボタン名(ボタンがある場合は必須、最大14文字)
-linkMo String X モバイルWebリンク(WLタイプの場合は必須フィールド、最大500文字)
-linkPc String X PC Webリンク(WLタイプの場合は任意フィールド、最大500文字)
-schemeIos String X iOSアプリリンク(ALタイプの場合は必須フィールド、最大500文字)
-schemeAndroid String X Androidアプリリンク(ALタイプの場合は必須フィールド、最大500文字)

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

テンプレートの削除

リクエスト

[URL]

DELETE  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID
templateCode String テンプレートコード

[Header]

{
  "X-Secret-Key": String
}

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

テンプレートの問い合わせをする

リクエスト

[URL]

PUT  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}/comments
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID
templateCode String テンプレートコード

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
  "comment":String
}
タイプ 必須 説明
comment String O お問い合わせ内容

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

ファイルを添付してテンプレートお問い合わせ

リクエスト

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}/comments_file
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のAppkey
plusFriendId String プラスフレンドID
templateCode String テンプレートコード

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request Body]

{
  "comment":String,
  "attachments":File
}
タイプ 必須 説明
comment String O お問い合わせ内容
attachments List X 添付ファイルリスト(最大10個)

レスポンス

{
  "header":{
    "resultCode": Integer,
    "resultMessage": String,
    "isSuccessful": boolean
  }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否

テンプレートリストの照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/templates
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Query parameter]

タイプ 必須 説明
plusFriendId String X プラスフレンドID
templateCode String X テンプレートコード
templateName String X テンプレート名
templateStatus String X テンプレートステータスコード
pageNum Integer X ページ番号(基本:1)
pageSize Integer X 照会件数(基本:15、最大: 1000)
テンプレートステータスコード 説明
TSC01 リクエスト
TSC02 検収中
TSC03 承認
TSC04 差し戻し

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/templates?plusFriendId={プラスフレンドID}&templateStatus={テンプレートステータスコード}"

レスポンス


{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "templateListResponse": {
      "templates": [
          {
              "plusFriendId": String,
              "plusFriendType": String,
              "templateCode": String,
              "templateName": String,
              "templateContent": String,
              "templateEmphasizeType": String,
              "templateTitle":String,
              "templateSubtitle":String,
              "templateMessageType":String,
              "templateExtra":String,
              "templateAd":String,
              "buttons": [
                {
                    "ordering":Integer,
                    "type": String,
                    "name": String,
                    "linkMo": String,
                    "linkPc": String,
                    "schemeIos": String,
                    "schemeAndroid": String
                }
                ],
                "comments": [
                  {
                      "id": Integer,
                      "content": String,
                      "userName": String,
                      "createdAt": String,
                      "status": String
                    }  
                ],
                "status": String,
                "statusName": String,
                "createDate": String
            }
        ],
        "totalCount": Integer
    }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
templateListResponse Object 本文領域
- templates List テンプレートリスト
-- plusFriendId String プラスフレンドID
-- plusFriendType String プラスフレンドタイプ(NORMAL、GROUP)
-- templateCode String テンプレートコード
-- templateName String テンプレート名
-- templateContent String テンプレート本文
-- templateEmphasizeType String テンプレートハイライトタイプ(NONE:基本、TEXT:ハイライト、default:NONE)
TEXT:templateTitle、templateSubtitleフィールド必須
-- tempalteTitle String テンプレートのタイトル(最大50字、Android:2行、23字以上のコマ処理、iOS:2行、27字以上のコマ処理)
-- templateSubtitle String テンプレートの補助フレーズ(最大50文字、Android:18字以上のコマを省く、iOS:21字以上のコマを省く)
-- templateMessageType String テンプレートメッセージタイプ(BA:基本型、EX:付加情報型、AD:広告追加型、MI:複合型)
EX:templateExtraフィールド必須
MI:templateExtraフィールド必須」
-- templateExtra String テンプレート付加情報
-- templateAd String テンプレート内の受信同意または簡単な広告文句
-- buttons List ボタンリスト
--- ordering Integer ボタン順序(1~5)
--- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
--- name String ボタン名
--- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
--- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
--- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
--- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
-- comments List 検収結果
--- id Integer お問い合わせID
--- content String お問い合わせ内容
---userName String 作成者
---createAt String 登録日
---status String 応答状態(INQ:お問い合わせ、APR:承認、REJ:差し戻し、REP:返信, REQ:検査中)
-- status String テンプレートのステータス
-- statusName String テンプレートのステータス名
-- createDate String 作成日時
- totalCount Integer 総個数

テンプレートの修正リスト照会

リクエスト

[URL]

GET  /alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}/modifications
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー
plusFriendId String プラスフレンドID
templateCode String テンプレートコード

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[例]

curl -X GET -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" "https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/plus-friends/{plusFriendId}/templates/{templateCode}/modifications"

レスポンス


{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  },
  "templateModificationsResponse": {
      "templates": [
          {
              "plusFriendId": String,
              "plusFriendType": String,
              "templateCode": String,
              "templateName": String,
              "templateContent": String,
              "templateEmphasizeType": String,
              "templateTitle":String,
              "templateSubtitle":String,
              "templateMessageType":String,
              "templateExtra":String,
              "templateAd":String,
              "buttons": [
                {
                    "ordering":Integer,
                    "type": String,
                    "name": String,
                    "linkMo": String,
                    "linkPc": String,
                    "schemeIos": String,
                    "schemeAndroid": String
                }
                ],
                "comments": [
                  {
                      "id": Integer,
                      "content": String,
                      "userName": String,
                      "createdAt": String,
                      "status": String
                    }  
                ],
                "status": String,
                "statusName": String,
                "activated": boolean,
                "createDate": String
            }
        ],
        "totalCount": Integer
    }
}
タイプ 説明
header Object ヘッダ領域
- resultCode Integer 結果コード
- resultMessage String 結果メッセージ
- isSuccessful Boolean 成否
templateModificationsResponse Object 本文領域
- templates List テンプレートリスト
-- plusFriendId String プラスフレンドID
-- plusFriendType String プラスフレンドタイプ(NORMAL、GROUP)
-- templateCode String テンプレートコード
-- templateName String テンプレート名
-- templateContent String テンプレート本文
-- templateEmphasizeType String テンプレートハイライトタイプ(NONE:基本、TEXT:ハイライト、default:NONE)
TEXT:templateTitle、templateSubtitleフィールド必須
-- tempalteTitle String テンプレートのタイトル(最大50字、Android:2行、23字以上のコマ処理、iOS:2行、27字以上のコマ処理)
-- templateSubtitle String テンプレートの補助フレーズ(最大50文字、Android:18字以上のコマを省く、iOS:21字以上のコマを省く)
-- templateMessageType String テンプレートメッセージタイプ(BA:基本型、EX:付加情報型、AD:広告追加型、MI:複合型)
EX:templateExtraフィールド必須
MI:templateExtraフィールド必須」
-- templateExtra String テンプレート付加情報
-- templateAd String テンプレート内の受信同意または簡単な広告文句
-- buttons List ボタンリスト
--- ordering Integer ボタン順序(1~5)
--- type String ボタンタイプ(WL:Webリンク、AL:アプリリンク、DS:配送照会、BK:Botキーワード、MD:メッセージ伝達、BC:相談トーク転換、BT:Bot転換、AC:チャンネル追加)
--- name String ボタン名
--- linkMo String モバイルWebリンク(WLタイプの場合は必須フィールド)
--- linkPc String PC Webリンク(WLタイプの場合は任意フィールド)
--- schemeIos String iOSアプリリンク(ALタイプの場合は必須フィールド)
--- schemeAndroid String Androidアプリリンク(ALタイプの場合は必須フィールド)
-- comments List 検収結果
--- id Integer お問い合わせID
--- content String お問い合わせ内容
---userName String 作成者
---createAt String 登録日
---status String 応答状態(INQ:お問い合わせ、APR:承認、REJ:差し戻し、REP:返信, REQ:検査中)
-- status String テンプレートのステータス
-- statusName String テンプレートのステータス名
-- activated Boolean 有効かどうか
-- createDate String 作成日時
- totalCount Integer 総個数

代替送信管理

SMS AppKey登録

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/failback/appkey
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{
    "resendAppKey": String
}
タイプ 必須 説明
resendAppKey String O 代替発送に設定するSMS AppKey

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/failback/appkey -d '{"resendAppKey": "smsAppKey"}

レスポンス


{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  }
}

代替送信設定登録

[URL]

POST  /alimtalk/v1.5/appkeys/{appkey}/failback
Content-Type: application/json;charset=UTF-8

[Path parameter]

タイプ 説明
appkey String 固有のアプリケーションキー

[Header]

{
  "X-Secret-Key": String
}
タイプ 必須 説明
X-Secret-Key String O コンソールで作成できます。

[Request body]

{  
   "plusFriendId": String,
   "isResend": Boolean,
   "resendSendNo": String
}
タイプ 必須 説明
plusFriendId String O プラスフレンドID(最大30文字)
isResend boolean O 送信失敗時、代替送信するかどうか
コンソールで送信失敗設定をした時、デフォルト設定は再送信になっています。
resendSendNo String O 代替送信発信番号(最大13桁)
(SMSサービスに登録された発信番号ではない場合、代替送信が失敗することがあります。)

[例]

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v1.5/appkeys/{appkey}/failback/appkey -d '{"plusFriendId": "@プラスフレンド","isResend": true,"resendSendNo": "01012341234" }

レスポンス


{
  "header":{
      "resultCode": Integer,
      "resultMessage": String,
      "isSuccessful": boolean
  }
}