Joined Event

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

  • Bot がトークルームを生成した場合
  • トークルームにいるメンバーが他のメンバーを招待した場合

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

Request {#joined-event-request}

パラメータタイプ説明
typestring"joined"
required
sourceobjectcallback メッセージの内容
required
source.channelIdstringメンバーが招待されたトークルーム ID
required
source.domainIdstringメンバーが招待されたドメイン ID
required
issuedTimestringcallback メッセージが作成された日時 (YYYY-MM-DDThh:mm:ss.SSSZ)
required
membersarray<string>招待されたメンバーリスト
required

Request Example {#joined-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": "joined",  "source": {    "channelId": "12345",    "domainId": 40029600  },  "issuedTime": "2022-01-04T05:16:05.716Z",  "members":["userf7da-f82c-4284-13e7-030f3b4c756x"]}

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

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

Response {#joined-event-response-example}

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