メッセージリアクション：絵文字の送受信

リアクションを送信する

type が reaction のメッセージで、リアクション対象のメッセージ ID と 1 つの絵文字を指定します。同じメッセージに 2 つ目のリアクションを送ると、追加ではなく 1 つ目が置き換わります。これは、送信者が 1 メッセージにつき 1 つしかリアクションを持てないためです。

メッセージ ID は、番号から確認できるものでなければなりません。その顧客から受信したメッセージ、または顧客に送信したメッセージが対象です。

リアクションを削除する

ここが意外に感じられる点です。削除用のリクエストはありません。emoji フィールドを空文字列に設定した同じリアクションメッセージを送信すると、リアクションが消去されます。

削除イベントを想定したハンドラーは、いつまでも待ち続けます。届くのは emoji が空のリアクションで、新しいリアクションと同じ形式です。フィールドを確認して、削除として読み取る必要があります。

リアクションを受信する

受信したリアクションは messages Webhook に届きます。type が reaction のメッセージとして、対象のメッセージ ID と絵文字が含まれます。

• messages フィールドを購読してください。リアクション専用のフィールドはありません。
• 空の絵文字は、顧客がリアクションを削除したことを示します。
• 参照されるメッセージ ID は、以前に送信または受信したものです。
• リアクションによって 24 時間のサービスウィンドウが再開することはありません。

サービスウィンドウは適用される

リアクションはメッセージのため、送信には 24 時間のカスタマーサービスウィンドウが開いている必要があります。3 日前の顧客メッセージにリアクションすると、テキストメッセージと同じく、エラー 131047 が返されます。

顧客からリアクションを受信すると、ウィンドウは再開します。受信したメッセージはすべて対象となるためです。自動化では、最後のメッセージへの親指を立てるリアクションが、自由に返信できる有効なシグナルになります。

よくある間違い

• 削除用のエンドポイントを探す。削除は絵文字を空にして同じリクエストを送ります。
• 空の絵文字を不正な形式として扱う。削除はこの形式で表されます。
• サービスウィンドウ外でリアクションを送信する。他のメッセージと同じように失敗します。

よくある質問

続きを読む