PUT /im/chat/messages/{message_id}
Edit a message that was sent by your Chatbot app.
After sending a message using the Send Chatbot Message API, you must store the messageId returned in the response so that you can make edits to the associated message using this API.
Scope: imchat:bot
Rate Limit Label: Medium
Authorization Flow: Client Credentials Flow
To get authorized, make a POST request to /oauth/token endpoint with grant type as client_credentials.
Use https://api.zoom.us/oauth/token?grant_type=client_credentials as the endpoint for the request.
You will need to send your ClientID and Secret as a Basic base64 encoded AUthorization header. Ex. Basic base64Encode({client_id}:{client_sceret})
Next, use the token received (access_token) as a bearer token while making the PUT /im/chat/messages/{message_id} request to edit a chatbot message.
Learn more about how to authotize chatbots in the Chatbot Authorization guide.
Servers
- https://api.zoom.us/v2
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
message_id |
String | Yes |
Unique Identifier of the message that needs to be updated. This should be retrieved from the response of Send Chatbot Message API. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
robot_jid |
String | Yes |
Robot JID created when enabling chatbot features on your marketplace app. |
user_jid |
String | No |
Optional |
content |
Object | Yes |
JSON template describing how the edited message should be displayed for the user. For more information please see our "Send Message" templates. |
account_id |
String | Yes |
The AccountID of the Zoom account to which the message was sent. Retrieve this from the Chatbot request sent to your server as shown in the example here. |
is_markdown_support |
Boolean | No |
Optional |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.