Join Event

組織 / グループ / 1:N トークルームに Bot が招待された際に生じる Callback イベントオブジェクト。
Join Callback イベントが有効で、下記のいずれかのイベントが発生した場合に送信されます。

  • API を使って Bot がトークルームを生成した場合
  • メンバーが Bot を含むトークルームを作成した場合
  • Bot が複数人のトークルームに招待された場合

注意
Join イベントについては、1:1 トークルームでは発生しないよう将来の変更を予定しています。
今後は 開始イベント (begin) を利用してください。

Request {#join-event-request}

パラメータタイプ説明
typestring"join"
required
sourceobjectcallback メッセージの内容
required
source.channelIdstringBot が招待されたトークルーム ID
required
source.domainIdnumberBot が招待されたドメイン ID
required
issuedTimestringメッセージが作成された日時 (YYYY-MM-DDThh:mm:ss.SSSZ)
required

Request Example {#join-event-request-example}

POST /callback HTTP/1.1Host: YOUR_SERVER_HOST_NAMEContent-type: application/json; charset=UTF-8X-WORKS-Signature: 9crxWhZ9aQO/9ruUM4MH3dF/WRGYRhj0vSR4cRyJfHQ=X-WORKS-botId: 123
{  "type": "join",  "source": {    "channelId": "12345",    "domainId": 40029600  },  "issuedTime":"2022-01-04T05:16:05Z"}

Response (トーク Bot のメッセージ受信サーバー -> メッセージサーバー) {#join-event-response}

Callback を受け取ったボットサーバーから LINE WORKS のメッセージングサーバーへのレスポンスは、ステータスコード 200 で返してください。
Callback で送信された HTTP リクエストは、送信に失敗しても再送されません。

Response {#join-event-response-example}

HTTP/1.1 200 OKContent-Type: application/jsonServer: YOUR_SERVER_HOST_NAMEContent-Length: 0