tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Chat
    문서
    Download PDF

    Callback After the Group Owner Changed

    마지막 업데이트 시간:2024-05-14 14:30:33
    PDF 다운로드

      Feature Overview

      The app backend can use this callback to view group owner change information in real-time. The app backend can perform operations such as data synchronization based on this callback.

      Notes

      To enable the callback, you must configure a callback URL and toggle on the corresponding protocol switch. For detailed configuration methods, see Third-party Callback Configuration document.
      During this callback, the Chat backend initiates an HTTP POST request to the app backend.
      After the callback request is received, the app backend must check whether the SDKAppID contained in the request URL is consistent with its own SDKAppID.
      For other security-related matters, please refer to the Webhook Overview - Security Considerations document.

      Scenarios That May Trigger This Callback

      An app user successfully transfers the group owner via the client.
      An app administrator successfully transfers the group owner via the REST API.

      Callback Trigger Time

      After you successfully transferring the group owner.

      API Description

      Sample Request URL

      In the subsequent example, the callback URL configured within the app is https://www.example.com. Example:
      https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform

      Request Parameters

      Parameter
      Description
      https
      The request protocol is HTTPS, and the request method is POST
      www.example.com
      Callback URL
      SdkAppid
      SDKAppID allocated by Chat console at the time of application creation
      CallbackCommand
      Fixed to Group.CallbackAfterChangeGroupOwner
      contenttype
      Fixed value: JSON
      ClientIP
      Client IP, for example: 127.0.0.1
      OptPlatform
      Client Platform, see the Webhook Overview - Callback Protocol for the meaning of the OptPlatform parameter

      Sample Request Packets

      {
          "CallbackCommand": "Group.CallbackAfterChangeGroupOwner",    // Callback after the group owner changes
          "GroupId": "@TGS#2TTV7VSII", // Group ID
          "Type": "Public", // Group Type
             "Operator_Account": "admin", // Operating User ID
             "OldOwner_Account": "user1", // Original group owner
             "NewOwner_Account": "user2", // New group owner
             "EventTime":"1670574414123"// Event trigger timestamp in milliseconds
      }

      Request Packet Fields

      Field
      Type
      Description
      CallbackCommand
      String
      Callback command
      GroupId
      String
      Operating Group ID
      Type
      String
      Group Type Group Type Introduction, e.g., Public
      Operator_Account
      String
      Operating User UserID
      OldOwner_Account
      String
      Original Group Owner UserID
      NewOwner_Account
      String
      New Group Owner UserID
      EventTime
      Integer
      Event trigger timestamp in milliseconds

      Response Packet Example

      Following data synchronization, the app backend dispatches a callback response packet.
      {
          "ActionStatus": "OK",
          "ErrorInfo": "",
          "ErrorCode": 0 // Ignore callback result
      }

      Response Packet Field Description

      Field
      Type
      Attribute
      Description
      ActionStatus
      String
      Required
      Processed Request Result:
      OK: Indicates successful processing
      FAIL: Indicates failure
      ErrorCode
      Integer
      Required
      Error Code, entering 0 here means to ignore the response result
      ErrorInfo
      String
      Required
      Error message

      Reference

      Overview of Third-Party Callbacks
      REST API: Transfer Group Owner
      문의하기

      고객의 업무에 전용 서비스를 제공해드립니다.

      문의하기
      기술 지원

      더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

      티켓 제출
      연중무휴 24시간 전화 지원
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      개인정보 처리방침서비스 약관쿠키 정책