メインコンテンツへスキップ
POST /api/v1/forward/channel_pairings identity_resolution.mode=pairing の Channel にのみ適用されます。

Headers

Body parameters

Example request

Example response

HTTP 200 OK

Response fields

Error codes

Notes

  • サーバーは PAT から解決した user_id と正規化した code を使ってペンディング中のペアリングレコードを特定します。リクエストに channel_id は不要です。
  • ペアリングコードは単一ユーザースコープ内で一意です。レスポンスにはサーバーが解決した channel_id が返されます。
  • 同じコードを同じ Identity と Template で送信するとべき等で、既存の Pairing を返します。異なるバインディング値の場合はコンフリクトを返します。
  • Channel はトランスポート接続であり、Pairing はその direct/room スコープの実際の実行コンテキストバインディングです。
  • ペアリング成功後、Forward は元の会話に成功通知をベストエフォートで送信します。通知の失敗により Pairing がロールバックされることはありません。

Channel の作成

Channel のペアリング解除