After Official Account Profile Is Modified
Feature Overview
Through this webhook, the app backend can view changes to Official Account Information (such as Official Account Name, Official Account Description, Official Account Avatar, etc.) in real time, including realtime records of changes to Official Account Information (e.g., logging or syncing to other systems).
Notes
To enable the webhook, you must configure a webhook URL and toggle on the corresponding protocol. For more information on the configuration method, see Webhook Configuration.
During this webhook, the Chat backend initiates an HTTP POST request to the app backend.
After receiving the webhook request, the app backend must check whether the SDKAppID contained in the request URL is the
SDKAppID
of the app.For other security-related matters, please refer to the Webhook Introduction: Security Considerations.
Webhook Triggering Scenarios
App admins modify Official Account information through REST API
Webhook Triggering Timing
After Successfully Modifying Official Account Information
API Calling Description
Sample request URL
In the subsequent example, the webhook 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 | Webhook URL |
SdkAppid | SDKAppID allocated by the Instant Messaging console at the time of Application creation |
CallbackCommand | Set to: OfficialAccount.CallbackAfterOfficialAccountInfoChanged |
contenttype | Fixed value: JSON |
ClientIP | Client IP, such as 127.0.0.1 |
OptPlatform | Client platform, for values refer to webhook introduction: Webhook protocol with regards to the parameter meanings of OptPlatform |
Sample request
{"CallbackCommand": "OfficialAccount.CallbackAfterOfficialAccountInfoChanged", // Callback command"Official_Account" : "@TOA#_test_OA_for_penn","Operator_Account": "leckie", // Operator"Introduction": "NewNotification", // Updated official account introduction"Name": "NewName", // Updated official account name"FaceUrl": "http://this.is.newface.url" // Updated official account profile photo"Organization": "NewOrganization" // Updated official account organization"EventTime": 1670574414123// Event trigger timestamp in milliseconds}
Request fields
Object | Features | Feature |
CallbackCommand | String | Webhook command |
Operator_Account | String | Initiator's UserID |
Official_Account | String | Created Official Account ID |
Introduction | String | Updated official account introduction |
Name | String | Updated Official Account Name |
FaceUrl | String | Updated Official Account Avatar |
Organization | String | Updated Official Account Affiliated Organization |
EventTime | Integer | Event trigger timestamp in milliseconds |
Sample response
Following data synchronization, the app backend dispatches a webhook response packet.
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0}
Response fields
Field | Type | Attribute | Description |
ActionStatus | String | Mandatory | Results of the request processing OK: Indicates successful processing FAIL: Indicates failure |
ErrorCode | Integer | Mandatory | Error Code, entering 0 here means to ignore the response result |
ErrorInfo | String | Mandatory | Error message |
References