{"openapi":"3.0.0","info":{"title":"Chatbot Webhooks","description":"The chatbot webhooks allow developers to receive events for [chatbot](https://developers.zoom.us/docs/team-chat-apps/) features.  \r\n\r\nNote regarding JSON payloads for guest users:\r\nBe aware that guest users (users not signed in to Zoom or who are members of a different account) are assigned temporary IDs that are valid only for the duration of that meeting or chat channel. Data for guest users in JSON payloads is associated with these temporary IDs.\r\n\r\n","version":"1.0.0"},"paths":{"team_chat.link_shared":{"post":{"tags":["webhook"],"summary":"team_chat.link_shared","description":"The **Chat message link shared**  event triggers when a user sends a chat message to a contact or a chat channel, and when the app is installed for the user. This message must contain the link. The link's domain is registered by the app in Marketplace. A POST request with a mention message is sent to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) specified in the app's dashboard.\n## Prerequisites\n* A Pro or a higher [plan](https://zoom.us/pricing).\n","operationId":"Team_chat.link_sharedWebhook","requestBody":{"description":"Webhook payload for the `team_chat.link_shared` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Team_chat.link_sharedEvent"},"examples":{"default":{"summary":"Example team_chat.link_shared event","value":{"event":"team_chat.link_shared","event_ts":1696914490200,"response_url":"https://api.zoom.us/v2/im/chat/users/exampleUserId/unfurls/exampleTriggerId","payload":{"account_id":"exampleAccountId","operator_id":"exampleuserId","operator":"example@zoom.us","operator_member_id":"R4VM29Oj0fVM2hhEmSKVM2hhezJTezJTKVM2hezJT2hezJTSK","by_external_user":false,"object":{"message_id":"5DD614F4-DD19-4C39-8D03-93C4D0A0C839","reply_main_message_id":"5DD614F4-DD19-4C39-8D03-93C4D0A0C838","type":"to_channel","channel_id":"xxxxxxx","channel_name":"Team Chat","link":"https://sg.com/1234w","trigger_id":"exampleTriggerId","date_time":"2023-10-10T05:08:10Z","timestamp":1696914490157}}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"interactive_message_fields_editable":{"post":{"tags":["webhook"],"summary":"interactive_message_fields_editable","description":"\nAfter a user edits the text of a Chatbot [message with Editable Text](https://marketplace.zoom.us/docs/guides/chatbots/customizing-messages/message-with-editable-text), the `interactive_message_editable` event is invoked and a POST request with data about the event is sent to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) specified in the app's dashboard.\n\nThe `editItem` object displays the changes in edited text with `origin` and `target` values.\n\n","operationId":"Interactive_message_fields_editableWebhook","requestBody":{"description":"Webhook payload for the `interactive_message_fields_editable` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Interactive_message_fields_editableEvent"},"examples":{"default":{"summary":"Example interactive_message_fields_editable event","value":{"event":"interactive_message_fields_editable","event_ts":1560891222018,"callback_url":"https://api.zoom.us/v2/im/chat/callback/bKFS3ybORiWbJx6VM6Qe1A","callback_token":"eyJzdiI6IjAwMDAwMSIsInR5cCI6IkpXVCIsImFsZyI6IkVTMjU2In0.eyJhdWQiOiJib3QiLCJ1aWQiOiJWV2ZQa1NENVJvMk5xRWUyR1VMa2F3IiwiY2xpZW50SWQiOiJRQmZVaEFyUlNHVVFVclM2ZDFXVnciLCJpc3MiOiJ6b29tIiwiZXhwIjoxNzYwMzYzNzc5LCJpYXQiOjE3NjAzMzM3NzksImFpZCI6InQ4dURPZWtYUkx5b3ExR0M4UFBaTVEifQ.wBeNSNeYLQYJD1Lp0O0EnnfyCYNzF03tEwFin0-hRV7UfECLmHsW7NnQ9EEPGxOokDKnQb-pRPd_iBX4JKfg_Q","payload":{"accountId":"gVcjZnWWRLWvv_GtyGuaxg","channelName":"Jill Chill","fieldEditItem":{"currentValue":"","key":"Title","newValue":"Software Engineer"},"messageId":"20190618205323327_EZjIqCQ_aw1","original":{"head":{"sub_head":{"text":"I am a sub header"},"text":"I am a header"},"body":[{"type":"fields","items":[{"editable":true,"value":" ","key":"Name"},{"editable":true,"value":" ","key":"Title"},{"editable":false,"value":"Example Company","key":"Company"}]}]},"robotJid":"v1m0yn1imztuogsxjje8fdew@example.com","timestamp":1560891222018,"toJid":"kdykjnimt4kpd8kkdqt9fq@example.com/robot_v1m0yn1imztuogsxjje8fdew@example.com","userId":"KdYKjnimT4KPd8KKdQt9FQ","userJid":"kdykjnimt4kpd8kkdqt9fq@example.com","userName":"Jill Chill"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"bot_notification":{"post":{"tags":["webhook"],"summary":"bot_notification","description":"\nAfter a user enters a [User Command](https://marketplace.zoom.us/docs/guides/chatbots/sending-messages#user-commands), a slash command unique to the application, Chatbots send a POST request associated with the `bot_notification` event to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) with a JSON payload containing all text entered following the command. This payload contains information on the user and event including the account, channel, timestamp, and user name.\n\nThe `cmd` value reflects the text entered by the user after the slash command. The `userName` is the string value of the user's displayed name, and `channelName` is the string value of the channel in which the command was sent.\n\n","operationId":"Bot_notificationWebhook","requestBody":{"description":"Webhook payload for the `bot_notification` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot_notificationEvent"},"examples":{"default":{"summary":"Example bot_notification event","value":{"event":"bot_notification","event_ts":1560796234686,"payload":{"accountId":"asgVcjZnWWRLWvv_GtyGuaxg","channelName":"Photos","cmd":"island","name":"Unsplash","robotJid":"v10r4uxexurcasg-pwh8hyh7sg@example.com","timestamp":1560796234686,"toJid":"b1c841dc7b0b4as69287e6be05c7f93f25@conference.example.com","userId":"KdYKjnimT4asKPd8KKdQt9FQ","userJid":"kdykjnimtas4kpd8kkdqt9fq@example.com","userName":"Jill Chill"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"interactive_message_actions":{"post":{"tags":["webhook"],"summary":"interactive_message_actions","description":"\nAfter a user clicks a [button in a Chatbot message](https://marketplace.zoom.us/docs/guides/chatbots/customizing-messages/message-with-buttons), the `interactive_message_actions` event is invoked and a POST request with data on the selected option is sent to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) specified in the app's dashboard.\n\nThe `actionItem` object displays the value chosen by the user from the `items` array of the original message from the Chatbot.\n\n","operationId":"Interactive_message_actionsWebhook","requestBody":{"description":"Webhook payload for the `interactive_message_actions` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Interactive_message_actionsEvent"},"examples":{"default":{"summary":"Example interactive_message_actions event","value":{"event":"interactive_message_actions","event_ts":1560891332219,"callback_url":"https://api.zoom.us/v2/im/chat/callback/bKFS3ybORiWbJx6VM6Qe1A","callback_token":"eyJzdiI6IjAwMDAwMSIsInR5cCI6IkpXVCIsImFsZyI6IkVTMjU2In0.eyJhdWQiOiJib3QiLCJ1aWQiOiJWV2ZQa1NENVJvMk5xRWUyR1VMa2F3IiwiY2xpZW50SWQiOiJRQmZVaEFyUlNHVVFVclM2ZDFXVnciLCJpc3MiOiJ6b29tIiwiZXhwIjoxNzYwMzYzNzc5LCJpYXQiOjE3NjAzMzM3NzksImFpZCI6InQ4dURPZWtYUkx5b3ExR0M4UFBaTVEifQ.wBeNSNeYLQYJD1Lp0O0EnnfyCYNzF03tEwFin0-hRV7UfECLmHsW7NnQ9EEPGxOokDKnQb-pRPd_iBX4JKfg_Q","payload":{"accountId":"gVcjZnWWRLWvv_GtyGuaxg","actionItem":{"text":"Add","value":"add"},"channelName":"Jill Chill","messageId":"20190618205516496_ynICmz8_aw1","original":{"head":{"sub_head":{"text":"I am a sub header"},"text":"I am a header"},"body":[{"type":"actions","items":[{"style":"Primary","text":"Add","value":"add"},{"style":"Default","text":"Update","value":"update"},{"style":"Danger","text":"Delete","value":"delete"},{"style":"Disabled","text":"Disabled","value":"disable"}]}]},"robotJid":"v1m0yn1imztuogsxjje8fdew@example.com","timestamp":1560891332219,"toJid":"kdykjnimt4kpd8kkdqt9fq@example.com/robot_v1m0yn1imztuogsxjje8fdew@example.com","userId":"KdYKjnimT4KPd8KKdQt9FQ","userJid":"kdykjnimt4kpd8kkdqt9fq@example.com","userName":"Jill Chill"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"interactive_message_editable":{"post":{"tags":["webhook"],"summary":"interactive_message_editable","description":"\nAfter a user edits the text of a Chatbot [message with Editable Text](https://marketplace.zoom.us/docs/guides/chatbots/customizing-messages/message-with-editable-text), the `interactive_message_editable` event is invoked and a POST request with data about the event is sent to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) specfied in the app's dashboard. \n\nThe `editItem` object displays the changes in edited text with `origin` and `target` values.\n\n","operationId":"Interactive_message_editableWebhook","requestBody":{"description":"Webhook payload for the `interactive_message_editable` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Interactive_message_editableEvent"},"examples":{"default":{"summary":"Example interactive_message_editable event","value":{"event":"interactive_message_editable","event_ts":1560891135776,"callback_url":"https://api.zoom.us/v2/im/chat/callback/bKFS3ybORiWbJx6VM6Qe1A","callback_token":"eyJzdiI6IjAwMDAwMSIsInR5cCI6IkpXVCIsImFsZyI6IkVTMjU2In0.eyJhdWQiOiJib3QiLCJ1aWQiOiJWV2ZQa1NENVJvMk5xRWUyR1VMa2F3IiwiY2xpZW50SWQiOiJRQmZVaEFyUlNHVVFVclM2ZDFXVnciLCJpc3MiOiJ6b29tIiwiZXhwIjoxNzYwMzYzNzc5LCJpYXQiOjE3NjAzMzM3NzksImFpZCI6InQ4dURPZWtYUkx5b3ExR0M4UFBaTVEifQ.wBeNSNeYLQYJD1Lp0O0EnnfyCYNzF03tEwFin0-hRV7UfECLmHsW7NnQ9EEPGxOokDKnQb-pRPd_iBX4JKfg_Q","payload":{"accountId":"gVcjZnWWRLWvv_GtyGuaxg","channelName":"Jill Chill","editItem":{"origin":"I am a message with editable text","target":"I am a message with editable text that has been edited"},"messageId":"20190618205205291_tI1CUa6_aw1","original":{"head":{"sub_head":{"text":"I am a sub header"},"text":"I am a header"},"body":[{"editable":true,"text":"I am a message with editable text","type":"message"}]},"robotJid":"v1m0yn1imztuogsxjje8fdew@example.com","timestamp":1560891135776,"toJid":"kdykjnimt4kpd8kkdqt9fq@example.com/robot_v1m0yn1imztuogsxjje8fdew@example.com","userId":"KdYKjnimT4KPd8KKdQt9FQ","userJid":"kdykjnimt4kpd8kkdqt9fq@example.com","userName":"Jill Chill"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"bot_installed":{"post":{"tags":["webhook"],"summary":"bot_installed","description":"To configure a dynamic welcome message: \n1. Go to your Chatbot's settings and navigate to the **Features** page.  \n2. Check **Your App** for the welcome message.  \n3. Save your settings.\n\nAfter your Chatbot is authorized, Zoom sends an HTTP POST request to your respective Bot Endpoint URL with the following request body:","operationId":"Bot_installedWebhook","requestBody":{"description":"Webhook payload for the `bot_installed` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot_installedEvent"},"examples":{"default":{"summary":"Example bot_installed event","value":{"event":"bot_installed","payload":{"accountId":"CDSCdcsdv","robotJid":"csvfdvfd@xmpp.zoom.us","timestamp":1542796725586,"userId":"fvdfvfdvfd","userJid":"fvdfvfdvfd@xmpp.zoom.us","userName":"UserName"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"team_chat.app_mention":{"post":{"tags":["webhook"],"summary":"team_chat.app_mention","description":"This event triggers when a user mentions a specific app in a chat channel. A POST request with the mention message is sent to the [Bot Endpoint URL](https://developers.zoom.us/docs/team-chat-apps/team-chat-subscriptions/) specified in the app's dashboard.\n## Prerequisites\n* A Pro or a higher [plan](https://zoom.us/pricing).","operationId":"Team_chat.app_mentionWebhook","requestBody":{"description":"Webhook payload for the `team_chat.app_mention` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Team_chat.app_mentionEvent"},"examples":{"default":{"summary":"Example team_chat.app_mention event","value":{"event":"team_chat.app_mention","event_ts":1696914490200,"payload":{"account_id":"asgVcjZnWWRLWvv_GtyGuaxg","operator":"example@zoom.us","operator_member_id":"R4VM29Oj0fVM2hhEmSKVM2hhezJTezJTKVM2hezJT2hezJTSK","operator_id":"z8yCxjabcdEFGHfp8uQ","by_external_user":true,"object":{"message_id":"5DD614F4-DD19-4C39-8D03-93C4D0A0C839","type":"to_channel","channel_id":"8AmQ0WOoQ1O3a84yYFc2xQ","channel_name":"Team Chat","message":"hello","files":[{"file_id":"56bed9orRnOSEnBoX_HQvA","file_name":"Screenshot 2023-12-22 at 11.21.38 AM.png","file_size":23025,"OS_file_type":"PNG","file_message_type":"image"}],"rich_text":[{"start_position":0,"end_position":1,"format_type":"Bold"},{"start_position":1,"end_position":2,"format_type":"BulletedList"},{"start_position":2,"end_position":3,"format_type":"AddLink","format_attr":"https://www.example.com/templates/daily-stand-up"}],"reply_main_message_id":"5DD614F4-DD19-4C39-8D03-93C4D0A0C838","date_time":"2023-10-10T05:08:10Z","timestamp":1696914490157}}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}},"interactive_message_select":{"post":{"tags":["webhook"],"summary":"interactive_message_select","description":"\nAfter a user selects an option in a Chatbot [message with a Dropdown](https://marketplace.zoom.us/docs/guides/chatbots/customizing-messages/message-with-dropdown), the `interactive_message_select` event is invoked. The Chatbot sends a POST request associated with this event along with data on the selected option to the [Bot Endpoint URL](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app#set-features) specified in the app's dashboard.\n\nThe `selectedItems` array displays the value chosen by the user from the  `selected_items` array in the original message sent by the Chatbot.\n\n","operationId":"Interactive_message_selectWebhook","requestBody":{"description":"Webhook payload for the `interactive_message_select` event.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Interactive_message_selectEvent"},"examples":{"default":{"summary":"Example interactive_message_select event","value":{"event":"interactive_message_select","event_ts":1560891284464,"payload":{"accountId":"gVcjZnWWRLWvv_GtyGuaxg","channelName":"Jill Chill","messageId":"20190618205440879_sRHVqf4_aw1","original":{"head":{"sub_head":{"text":"I am a sub header"},"text":"I am a header"},"body":[{"select_items":[{"text":"Lions","value":"lions"},{"text":"Tigers","value":"tigers"},{"text":"Bears","value":"bears"}],"text":"Animals","type":"select"}]},"robotJid":"v1m0yn1imztuogsxjje8fdew@example.com","selectedItems":[{"value":"lions"}],"timestamp":1560891284464,"toJid":"kdykjnimt4kpd8kkdqt9fq@example.com/robot_v1m0yn1imztuogsxjje8fdew@example.com","userId":"KdYKjnimT4KPd8KKdQt9FQ","userJid":"kdykjnimt4kpd8kkdqt9fq@example.com","userName":"Jill Chill"}}}}}},"required":true},"responses":{"200":{"description":"Successfully received the webhook event."}},"deprecated":false}}},"components":{"schemas":{"Team_chat.link_sharedEvent":{"required":["event","event_ts","payload","response_url"],"type":"object","properties":{"event":{"type":"string","description":"The name of the event.","enum":["team_chat.link_shared"]},"event_ts":{"type":"integer","description":"A timestamp at which the event occurred.","format":"int64"},"response_url":{"type":"string","description":"A callback uri for app to response preview result."},"payload":{"required":["account_id","by_external_user","object","operator","operator_id","operator_member_id"],"type":"object","properties":{"account_id":{"type":"string","description":"The account ID of the user who sent the app mention message."},"operator_id":{"type":"string","description":"The user ID of the user who sent the app mention message."},"operator":{"type":"string","description":"The email address of the user who sent the app mention message.","format":"email"},"operator_member_id":{"type":"string","description":"The member ID of the user who sent the app mention message."},"by_external_user":{"type":"boolean","description":"Whether this action was performed by an external user."},"object":{"required":["date_time","link","timestamp","trigger_id","type"],"type":"object","properties":{"message_id":{"type":"string","description":"The message's ID. If the preview is provided in an unfurl for a posted message, rather than a link inside the message composer, we will simply ignore this property."},"type":{"type":"string","description":"The type of message: \n* `to_contact` — The message was sent to a contact. \n* `to_channel` — The message was sent to a chat channel.","enum":["to_contact","to_channel"]},"channel_id":{"type":"string","description":"The chat channel's ID."},"channel_name":{"type":"string","description":"The chat channel's name."},"contact_id":{"type":"string","description":"The message contact's user ID. If the user ID does not belong to the same account as the current user, this field will be empty."},"contact_member_id":{"type":"string","description":"The message contact's member ID."},"trigger_id":{"type":"string","description":"The unique identification of this webook event, app can use this trigger_id to invoke openAPI"},"link":{"type":"string","description":"The link content in message."},"reply_main_message_id":{"type":"string","description":"The ID of the parent message in the chat thread.It's only available if the message is a reply to a main message in a thread."},"date_time":{"type":"string","description":"The date and time at which the message was sent, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format.","format":"date-time"},"timestamp":{"type":"integer","description":"The timestamp for when the message was sent.","format":"int64"}},"additionalProperties":false,"description":"Information about the app mention message."}},"additionalProperties":false}},"additionalProperties":false},"Interactive_message_fields_editableEvent":{"type":"object","properties":{"event":{"type":"string","description":"The name of the event."},"event_ts":{"type":"integer","description":"The timestamp (in milliseconds since epcoch) at which the event occured. The value of this field is returned in long(int64) format.","format":"int64"},"callback_url":{"type":"string","description":"Use this endpoint to send a one-time asynchronous response within 30 minutes of receiving the event. <br> The response payload should follow the same structure as the [Send Chatbot Messages](https://developers.zoom.us/docs/api/chatbot/#tag/chatbot-messages/POST/im/chat/messages) API with required property **content** and optional properties *reply_to*, *visible_to_user* and *is_markdown_support*. <br> Include the **callback_token** value from the event as **Bearer token in the Authorization header** of your HTTP POST request."},"callback_token":{"type":"string","description":"Use the generated token value with the **callback_url** value to send a one-time asynchronous response. The token only lasts for 30 mins. Include the **callback_token** as a **Bearer token in the Authorization header** of your HTTP request. \n Example: \n\n ```\ncurl --request POST \\\n  --url '{callback_url}' \\\n  --header 'authorization: Bearer {callback_token}' \\\n  --header 'content-type: application/json'\\\n  --data-raw '{\"content\":{\"head\":{\"text\":\"Response Header\"},\"body\":[{\"type\":\"message\",\"text\":\"This is an asynchronous chatbot response.\"}]}}'"},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user sending the command."},"channelName":{"type":"string","description":"The channel in which the message was sent. "},"fieldEditItem":{"type":"object","properties":{"currentValue":{"type":"string"},"key":{"type":"string"},"newValue":{"type":"string"}},"description":"The item that the user edits."},"messageId":{"type":"string","description":"The unique ID of the message."},"original":{"type":"object","properties":{"head":{"type":"object","properties":{"sub_head":{"type":"object","properties":{"text":{"type":"string"}}},"text":{"type":"string"}}},"body":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"editable":{"type":"string"},"value":{"type":"string"},"key":{"type":"string"}}}}}}}},"description":"The original message sent to the user."},"robotJid":{"type":"string","description":"The unique credential of the Chatbot."},"timestamp":{"type":"string","description":"The time command message was sent."},"toJid":{"type":"string","description":"The JID of the channel or user the message was sent to."},"userId":{"type":"string","description":"The user who sends the command."},"userJid":{"type":"string","description":"The JID of user who is sending the command."},"userName":{"type":"string","description":"The user's display name."}}}}},"Bot_notificationEvent":{"type":"object","properties":{"event":{"type":"string","description":"Name of the event."},"event_ts":{"type":"integer","description":"Timestamp (in milliseconds since epcoch) at which the event occured. The value of this field is returned in long(int64) format.","format":"int64"},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user sending the command."},"channelName":{"type":"string","description":"Channel in which the message was sent. "},"cmd":{"type":"string","description":"Slash command entered by the user."},"name":{"type":"string","description":"Chatbot Name."},"robotJid":{"type":"string","description":"Unique credential of the Chatbot."},"timestamp":{"type":"integer","description":"Time command message was sent.","format":"date-time"},"toJid":{"type":"string","description":"JID of the channel or user the message was sent to."},"userId":{"type":"string","description":"User sending the command."},"userJid":{"type":"string","description":"JID of user who is sending the command."},"userName":{"type":"string","description":"User's display name."}}}}},"Interactive_message_actionsEvent":{"type":"object","properties":{"event":{"type":"string","description":"The name of the event."},"event_ts":{"type":"integer","description":"The timestamp (in milliseconds since epcoch) at which the event occured. The value of this field is returned in long(int64) format.","format":"int64"},"callback_url":{"type":"string","description":"Use this endpoint to send a one-time asynchronous response within 30 minutes of receiving the event. <br> The response payload should follow the same structure as the [Send Chatbot Messages](https://developers.zoom.us/docs/api/chatbot/#tag/chatbot-messages/POST/im/chat/messages) API with required property **content** and optional properties *reply_to*, *visible_to_user* and *is_markdown_support*. <br> Include the **callback_token** value from the event as **Bearer token in the Authorization header** of your HTTP POST request."},"callback_token":{"type":"string","description":"Use the generated token value with the **callback_url** value to send a one-time asynchronous response. The token only lasts for 30 mins. Include the **callback_token** as a **Bearer token in the Authorization header** of your HTTP request. \n Example: \n\n ```\ncurl --request POST \\\n  --url '{callback_url}' \\\n  --header 'authorization: Bearer {callback_token}' \\\n  --header 'content-type: application/json'\\\n  --data-raw '{\"content\":{\"head\":{\"text\":\"Response Header\"},\"body\":[{\"type\":\"message\",\"text\":\"This is an asynchronous chatbot response.\"}]}}'"},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user sending the command."},"actionItem":{"type":"object","properties":{"text":{"type":"string"},"value":{"type":"string"}},"description":"Action taken by the user."},"channelName":{"type":"string","description":"Channel in which the message was sent."},"messageId":{"type":"string","description":"Unique ID of the message."},"original":{"type":"object","properties":{"head":{"type":"object","properties":{"sub_head":{"type":"object","properties":{"text":{"type":"string"}}},"text":{"type":"string"}}},"body":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"style":{"type":"string"},"text":{"type":"string"},"value":{"type":"string"}}}}}}}},"description":"Original message sent to the user."},"robotJid":{"type":"string","description":"Unique credential of the Chatbot."},"timestamp":{"type":"integer","description":"Time command message was sent."},"toJid":{"type":"string","description":"JID of the channel or user the message was sent to."},"userId":{"type":"string","description":"User sending the command."},"userJid":{"type":"string","description":"JID of user who is sending the command."},"userName":{"type":"string","description":"User's display name."}}}}},"Interactive_message_editableEvent":{"type":"object","properties":{"event":{"type":"string","description":"The name of the event."},"event_ts":{"type":"integer","description":"The timestamp (in milliseconds since epcoch) at which the event occured. The value of this field is returned in long(int64) format.","format":"int64"},"callback_url":{"type":"string","description":"Use this endpoint to send a one-time asynchronous response within 30 minutes of receiving the event. <br> The response payload should follow the same structure as the [Send Chatbot Messages](https://developers.zoom.us/docs/api/chatbot/#tag/chatbot-messages/POST/im/chat/messages) API with required property **content** and optional properties *reply_to*, *visible_to_user* and *is_markdown_support*. <br> Include the **callback_token** value from the event as **Bearer token in the Authorization header** of your HTTP POST request."},"callback_token":{"type":"string","description":"Use the generated token value with the **callback_url** value to send a one-time asynchronous response. The token only lasts for 30 mins. Include the **callback_token** as a **Bearer token in the Authorization header** of your HTTP request. \n Example: \n\n ```\ncurl --request POST \\\n  --url '{callback_url}' \\\n  --header 'authorization: Bearer {callback_token}' \\\n  --header 'content-type: application/json'\\\n  --data-raw '{\"content\":{\"head\":{\"text\":\"Response Header\"},\"body\":[{\"type\":\"message\",\"text\":\"This is an asynchronous chatbot response.\"}]}}'"},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user editing the message."},"channelName":{"type":"string","description":"The channel in which the message was edited."},"editItem":{"type":"object","properties":{"origin":{"type":"string"},"target":{"type":"string"}},"description":"The object containing original and edited value."},"messageId":{"type":"string","description":"The unique ID of the message."},"original":{"type":"object","properties":{"head":{"type":"object","properties":{"sub_head":{"type":"object","properties":{"text":{"type":"string"}}},"text":{"type":"string"}}},"body":{"type":"array","items":{"type":"object","properties":{"":{"type":"object","properties":{"editable":{"type":"boolean"},"text":{"type":"string"},"type":{"type":"string"}}}}}}},"description":"The original message sent to the user."},"robotJid":{"type":"string","description":"The unique credential of the Chatbot."},"timestamp":{"type":"integer","description":"The time command message was sent.","format":"date-time"},"toJid":{"type":"string","description":"The JID of the channel or user the message was sent to."},"userId":{"type":"string","description":"The user who sends the command."},"userJid":{"type":"string","description":"The JID of user who is sending the command."},"userName":{"type":"string","description":"The user's display name."}}}}},"Bot_installedEvent":{"type":"object","properties":{"event":{"type":"string","description":"Name of the event."},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user sending the command."},"robotJid":{"type":"string","description":"Unique credential of the Chatbot."},"timestamp":{"type":"integer","description":"Time command message was sent.","format":"date-time"},"userId":{"type":"string","description":"User sending the command."},"userJid":{"type":"string","description":"JID of user who is sending the command."},"userName":{"type":"string","description":"User's display name."}}}}},"Team_chat.app_mentionEvent":{"required":["event","event_ts","payload"],"type":"object","properties":{"event":{"type":"string","description":"The name of the event.","enum":["team_chat.app_mention"]},"event_ts":{"type":"integer","description":"A timestamp at which the event occurred.","format":"int64"},"payload":{"required":["account_id","by_external_user","object","operator","operator_id","operator_member_id"],"type":"object","properties":{"account_id":{"type":"string","description":"The account ID of the user who sent the app mention message. Will be empty when by_external_user is true"},"operator_id":{"type":"string","description":"The user ID of the user who sent the app mention message. Will be empty when by_external_user is true"},"operator":{"type":"string","description":"The email address of the user who sent the app mention message. Will be empty when by_external_user is true","format":"email"},"operator_member_id":{"type":"string","description":"The member ID of the user who sent the app mention message."},"by_external_user":{"type":"boolean","description":"Whether this action was performed by an external user."},"object":{"required":["date_time","message","message_id","timestamp","type"],"type":"object","properties":{"message_id":{"type":"string","description":"The message's ID."},"type":{"type":"string","description":"The type of message: \n* `to_channel` — The message was sent to a chat channel.","enum":["to_channel"]},"channel_id":{"type":"string","description":"The chat channel's ID."},"channel_name":{"type":"string","description":"The chat channel's name."},"message":{"type":"string","description":"The sent message's content."},"files":{"type":"array","description":"The attachments file info in sent message's content.","items":{"required":["OS_file_type","file_id","file_message_type","file_name","file_size"],"type":"object","properties":{"OS_file_type":{"type":"string","description":"The attachments file extension type"},"file_id":{"type":"string","description":"The attachments file's universally unique identifier (UUID), in base64-encoded format."},"file_message_type":{"type":"string","description":"The attachments file message type","enum":["file","image","audio","audio v2","code snippet","screen shot"]},"file_name":{"type":"string","description":"The attachments file's name."},"file_size":{"type":"integer","description":"The attachments file's size, in bytes."}},"additionalProperties":false}},"rich_text":{"type":"array","description":"The [rich text formatting](https://support.zoom.us/hc/en-us/articles/115004789183-Replying-to-and-managing-chat-messages)object. Use this object to include rich text info in sent message's content.","items":{"required":["end_position","format_type","start_position"],"type":"object","properties":{"start_position":{"type":"integer","description":"The start position of the rich text in the message string. \n\nFor example if the first character at the beginning of the message is bold, the value for this field will be 0."},"end_position":{"type":"integer","description":"The end position of the rich text."},"format_type":{"type":"string","description":"The type of rich text.","enum":["Bold","Italic","Strikethrough","BulletedList","NumberedList","Underline","FontSize","FontColor","BackgroundColor","LeftIndent","Paragraph","Quote","AddLink"]},"format_attr":{"type":"string","description":"This field is non-null if the value of the `format_type` field is listed below:\n\n1.`FontSize` value: `s` for small, `m` for medium, or `l` for large font size. \n\n2.`FontColor` and `BackgroundColor` value: only supports RGB value. For example: `FFC0CB` \n\n3.`LeftIndent` value: a positive pixel length.  \n\n4.`Paragraph` value: `h1` for Heading 1, `h2` for Heading 2, or `h3` for Heading 3. \n\n5.`AddLink` value: must be a valid URL, with an `http` or `https` prefix. For example: `https://example.com`"}},"additionalProperties":false}}},"additionalProperties":false,"description":"Information about the app mention message."}},"additionalProperties":false}},"additionalProperties":false},"Interactive_message_selectEvent":{"type":"object","properties":{"event":{"type":"string","description":"Name of the event."},"payload":{"type":"object","properties":{"accountId":{"type":"string","description":"The account ID of the user sending the command."},"channelName":{"type":"string","description":"Channel in which the message was sent. "},"messageId":{"type":"string","description":"Unique ID of the message."},"original":{"type":"object","properties":{"head":{"type":"object","properties":{"sub_head":{"type":"object","properties":{"text":{"type":"string"}}},"text":{"type":"string"}}},"body":{"type":"array","items":{"type":"object","properties":{"select_items":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"value":{"type":"string"}}}},"text":{"type":"string"},"type":{"type":"string"}}}}},"description":"Original message sent to user."},"robotJid":{"type":"string","description":"Unique credential of the Chatbot."},"selectedItems":{"type":"array","description":"Value of item selected by the user.","items":{"type":"object","properties":{"value":{"type":"string"}}}},"timestamp":{"type":"integer","description":"Time command message was sent.","format":"date-time"},"toJid":{"type":"string","description":"JID of the channel or user the message was sent to."},"userId":{"type":"string","description":"User sending the command."},"userJid":{"type":"string","description":"JID of user who is sending the command."},"userName":{"type":"string","description":"User's display name."}}}}}}},"tags":[{"name":"webhook"}],"servers":[{"url":"https://{your-endpoint-url}"}]}