メインコンテンツへスキップ
POST
プロジェクトのチャネル設定に応じて、アプリプッシュ、Webプッシュ、カカオアリムトーク、カカオフレンドトーク、カカオブランドメッセージ、テキストメッセージ(SMS、LMS、MMS)、メール、LINEのキャンペーンをAPIからトリガーできます。フレンドトークは旧チャネルです。
送信先の指定方法とパーソナライズ選択したチャネルで対応していない送信先の指定方法を使うと、400 Bad Requestが返ります。パーソナライズにユーザーデータを使う場合はuser-idで指定します。ほかの指定方法では、Notiflyはリクエストに含まれる情報を使います。たとえば本文が{{ user["name"] }} さん、こんにちはの場合、名前が空になり、受信者にはさん、こんにちはと表示されます。イベントパラメーターは、どの指定方法でも使えます。
重複した送信先の扱いアプリプッシュとWebプッシュは、同じデバイストークンに一度だけ送信します。カカオアリムトーク、カカオフレンドトーク、カカオブランドメッセージ、テキストメッセージは電話番号で重複を判定します。メールはメールアドレス、LINEはLINEユーザーIDで判定します。
400レスポンスに含まれる無効な送信先送信先の検証に失敗すると、400レスポンスにerrorDetailsが含まれます。
  • 400レスポンスにはcode、success、errorが含まれます。errorDetailsが含まれるのは、送信先の検証に失敗した場合だけです。パラメーターが不正な場合やキャンペーンが無効な場合は含まれません。
  • user-idで指定したユーザーがNotiflyに登録済みでも、チャネルに必要な連絡先の情報がなければ無効な送信先になります。存在しないユーザーIDはスキップします。
  • partialSendがfalseまたは省略されている場合、無効な送信先が1件でもあるとリクエスト全体が400で失敗し、メッセージは配信されません。
  • 再送する場合は、errorDetails.invalidRecipientsを確認し、無効な送信先をリクエストから削除します。
有効な送信先に限って配信するpartialSendをtrueにすると、一部の送信先に電話番号やメールアドレスがなくても、有効な送信先に配信します。
  • partialSend: false(デフォルト)の場合、無効な送信先が1件でもあるとリクエストは400で失敗し、どの送信先にも配信されません。
  • partialSend: trueの場合、有効な送信先に配信し、無効な送信先をレスポンスに含めます。すべての送信先が無効でも200が返ります。
以下は、partialSend: trueで無効な送信先が2件ある場合のレスポンス例です。
partialSendに対応するチャネルは、kakao-alimtalk、kakao-friendtalk、kakao-brand-message、text-message、emailです。
この連絡先の検証はuser-idで指定した送信先に適用されます。type: "phone-number"またはtype: "email"で直接指定した場合は対象外です。

承認

Authorization
string
header
必須

POST /authenticateで発行したトークンをBearer形式で送信します。

パスパラメータ

projectId
string
必須

プロジェクトIDです。

campaignId
string
必須

コンソールで確認できるキャンペーンIDです。

ボディ

application/json
recipients
object[]
必須

送信先のリストです。最大1,000件まで指定できます。

partialSend
boolean
デフォルト:false

trueの場合、一部の送信先に必須の電話番号やメールアドレスがなくても、有効な送信先に配信します。レスポンスには無効な送信先のリストが含まれます。falseまたは省略時は、無効な送信先が1件でもあるとリクエスト全体が失敗します。

レスポンス

キャンペーンをトリガーしました。partialSendがtrueで無効な送信先がある場合、レスポンスにerrorDetailsが含まれます。

code
integer
success
boolean
error
string | null
errorDetails
object

partialSendがtrueで無効な送信先がある場合に含まれます。