外観
メッセージを登録
POST
/messages
指定したキャンペーンに紐づくメッセージを登録します。
isDraft: trueの場合、ステータスはDRAFTになり配信対象は作成されません。isDraft: falseの場合、ステータスはSCHEDULEDになり、キャンペーンを購読中の顧客に対して配信対象(Delivery)が作成されます。
sendTiming: IMMEDIATEであればバッチ処理により即座に、SCHEDULEDであればsendsAtの日時に配信されます。- ただし次の場合、ステータスは
PENDING_APPROVAL(承認待ち)になり、運営が確認するまで配信されません。
許可されるとSCHEDULEDに戻り、却下されるとREJECTEDになります。- テナントの最初の配信(送信元のドメインや
methodを問わない) - 配信内容の確認でフィッシングなどが疑われた場合、または確認できなかった場合
- テナントの最初の配信(送信元のドメインや
method: EMAILの場合、subject・senderId・typeは必須です。sendTiming: SCHEDULEDかつisDraft: falseの場合、sendsAt(未来日時)は必須です。method: EMAILかつisPromotional: true(デフォルト)の場合、本文に配信停止URLのプレースホルダー
{{ 配信停止URL }}を含める必要があります(typeに応じてbodyText/bodyHtmlを検証します)。
含まれない場合は422を返します。- 送信元ドメインが公式ドメインの場合、本文に規定のフッター文言を含める必要があります(同様に
422)。 method: LINEの場合、bodyTextの内容がテキストメッセージとして送信されます。
Authorizations
bearerAuth
テナントに発行された個人アクセストークン(Laravel Sanctum)を
Authorization: Bearer {token} ヘッダーで送信してください。
Type
HTTP (bearer)
Request Body
application/json
JSON "campaignId": "string", "method": "string", "isDraft": true, "type": "string", "subject": "string", "bodyText": "string", "bodyHtml": "string", "senderId": "string", "lineChannelId": "string", "sendTiming": "IMMEDIATE", "sendsAt": "string", "urlTrackingEnabled": true, "isPromotional": true
{
}
Responses
登録したメッセージ
application/json
JSON "id": "string", "tenantId": "string", "campaignId": "string", "method": "string", "type": "string", "status": "string", "subject": "string", "bodyText": "string", "bodyHtml": "string", "senderId": "string", "domainId": "string", "lineChannelId": "string", "sendTiming": "string", "sendsAt": "string", "urlTrackingEnabled": true, "isPromotional": true, "createdAt": "string", "updatedAt": "string", "deletedAt": "string"
{
}
