Cisco Webex

the cisco webex connector allows for streamlined communication within webex by automating message handling and collaboration directly through the swimlane platform cisco webex is a leading enterprise solution for video conferencing, online meetings, screen share, and webinars the cisco webex connector for swimlane turbine enables users to automate communication and collaboration workflows within their security operations by integrating with webex, security teams can streamline incident response by sending messages, managing content, and coordinating team efforts directly through the swimlane platform this connector enhances real time communication and collaboration, ensuring rapid dissemination of critical information and cohesive team action during security incidents prerequisites to effectively utilize the cisco webex connector with swimlane turbine, ensure you have the following prerequisites custom authentication with cisco webex using the following parameter url the base endpoint url for the cisco webex api asset setup to use the cisco webex connector with swimlane turbine, you need to set up custom authentication with one of the following configurations oauth2 access token authentication with these parameter url endpoint for the cisco webex api service access token token used to authenticate api requests oauth2 refresh token authentication with these parameters url endpoint for the cisco webex api service client id your cisco webex application's client identifier client secret the secret key associated with your cisco webex application refresh token a token used to obtain a new access token when the current one expires capabilities this cisco webex connector provides the following capabilities create a message delete a message edit a message get message details list direct messages list messages notes https //developer webex com/docs/authentication https //developer webex com/docs/api/v1/messages the swimlane team will provide a python script and instructions on how to use the script to generate the access token and refresh token using oauth2 0 configurations cisco webex custom authentication cisco webex custom authentication using access token or client credentials configuration parameters parameter description type required url a url to the target host string required access token the access token string optional client id the client id string optional client secret the client secret string optional refresh token the refresh token string optional verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions create a message post a message in plain text, rich text, or html to a cisco webex room, with an option to include a file attachment endpoint url /v1/messages method post input argument name type required description files object optional upload file the public url to a binary file to be posted into the room only one file is allowed per message uploaded files are automatically converted into a format that all webex clients can render files file string optional parameter for create a message files file name string optional name of the resource roomid string optional the room id of the message parentid string optional the parent message to reply to topersonid string optional the person id of the recipient when sending a private 1 1 message topersonemail string optional the email address of the recipient when sending a private 1 1 message text string optional the message, in plain text if markdown is specified this parameter may be optionally used to provide alternate text for ui clients that do not support rich text markdown string optional the message, in markdown format the maximum message length is 7439 bytes html string optional the message, in html format the maximum message length is 7439 bytes attachments array optional content attachments to attach to the message attachments contenttype string optional the content type of the attachment attachments content object optional adaptive card content attachments content type string required must be adaptivecard attachments content version string required adaptive card schema version attachments content body array optional the card's elements attachments content body type string optional request body data attachments content body text string optional request body data attachments content body size string optional request body data attachments content actions array optional the card's actions attachments content actions type string optional type of the resource attachments content actions url string optional url endpoint for the request attachments content actions title string optional response content input example {"json body" {"roomid" "y2lzy29zcgfyazovl3vzl1jpt00vymjjzwixywqtndnmms0zyju4ltkxndctzje0ymiwyzrkmtu0","parentid" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvzwm1ztizzjatn2rhms0xmwu5ltg2ntgtztkzyzniodzjzmfm","topersonid" "y2lzy29zcgfyazovl3vzl1bft1bmrs9mmdzknzfhns0wodmzltrmytutytcyys1jyzg5yji1zwvlmmx","topersonemail" "julie\@example com","text" "project update a new project plan has been published on box http //box com/s/lf5vj the pm for this project is mike c and the engineering manager is jane w ","markdown" " project update a new project plan has been published \[on box]\(http //box com/s/lf5vj) the pm for this project is <@personemail\ mike\@example com> and the engineering manager is <@personemail\ jane\@example com> ","html" "\<h3>i am more than text and less than a title\</h3>","attachments" \[{"contenttype" "application/vnd microsoft card adaptive","content" {"type" "adaptivecard","version" "1 0","body" \[{"type" "textblock","text" "adaptive cards","size" "large"}],"actions" \[{"type" "action openurl","url" "http //adaptivecards io","title" "learn more"}]}}]}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier parentid string unique identifier roomid string unique identifier roomtype string type of the resource topersonid string unique identifier topersonemail string output field topersonemail text string output field text markdown string output field markdown html string output field html files array output field files personid string unique identifier personemail string output field personemail mentionedpeople array output field mentionedpeople mentionedgroups array output field mentionedgroups attachments array output field attachments attachments contenttype string type of the resource attachments content object response content attachments content type string type of the resource attachments content version string response content attachments content body array request body data attachments content body type string request body data attachments content body text string request body data attachments content body size string request body data output example {"status code" 200,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw fe650b9d c43e 4970 a1b7 fb7fa6ffa907, routergw fe650b9d c43e 4970 a1b7 ","date" "tue, 24 sep 2024 09 45 20 gmt","x envoy upstream service time" "800","vary" "origin,accept encoding","content encoding" "gzip","content type" "application/json","server" "istio envoy","transfer encoding" "chunked"},"reason" "ok","json body" {"id" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvotjkyjniztatndnizc0xmwu2lthhzt delete a message deletes a specific message in cisco webex using the provided message id endpoint url /v1/messages/{{messageid}} method delete input argument name type required description path parameters messageid string required the unique identifier for the message input example {"path parameters" {"messageid" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvzmmzzjywyjetzdawny0xmwviltlkmtitodawm2qxmwrjmjvi"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw 67bab0bf 352a 4f98 a9e1 aa84ee352d0a, routergw 67bab0bf 352a 4f98 a9e1 ","date" "tue, 24 sep 2024 10 30 00 gmt","x envoy upstream service time" "172","vary" "origin","server" "istio envoy"},"reason" "no content","response text" ""} edit a message update a previously posted message in cisco webex by specifying the messageid and roomid, limited to 10 edits endpoint url /v1/messages/{{messageid}} method put input argument name type required description path parameters messageid string required the unique identifier for the message roomid string optional the room id of the message text string optional the message, in plain text if markdown is specified this parameter may be optionally used to provide alternate text for ui clients that do not support rich text the maximum message length is 7439 bytes markdown string optional the message, in markdown format if this attribute is set ensure that the request does not contain an html attribute html string optional the message, in html format the maximum message length is 7439 bytes input example {"json body" {"roomid" "y2lzy29zcgfyazovl3vzl1jpt00vymjjzwixywqtndnmms0zyju4ltkxndctzje0ymiwyzrkmtu0","text" "project update a new project plan has been published on http //example com/s/lf5vj the pm for this project is mike c and the engineering manager is jane w ","markdown" " project update a new project plan has been published on \<http //example com/s/lf5vj> the pm for this project is <@personemail\ mike\@example com> and the engineering manager is <@personemail\ jane\@example com> ","html" "\<h3>i am more than text and less than a title\</h3>"},"path parameters" {"messageid" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvzmmzzjywyjetzdawny0xmwviltlkmtitodawm2qxmwrjmjvi"}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier parentid string unique identifier roomid string unique identifier roomtype string type of the resource text string output field text markdown string output field markdown html string output field html files array output field files personid string unique identifier personemail string output field personemail mentionedpeople array output field mentionedpeople mentionedgroups array output field mentionedgroups attachments array output field attachments attachments contenttype string type of the resource attachments content object response content attachments content type string type of the resource attachments content version string response content attachments content body array request body data attachments content body type string request body data attachments content body text string request body data attachments content body size string request body data attachments content actions array response content attachments content actions type string type of the resource output example {"status code" 200,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw 9dbc4c33 6c55 4667 9ed0 3ccaf178dc44, routergw 9dbc4c33 6c55 4667 9ed0 ","date" "tue, 24 sep 2024 10 14 04 gmt","x envoy upstream service time" "359","vary" "origin,accept encoding","content encoding" "gzip","content type" "application/json","server" "istio envoy","transfer encoding" "chunked"},"reason" "ok","json body" {"id" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvotjkyjniztatndnizc0xmwu2lthhzt get message details retrieve detailed information for a specific message in cisco webex using the provided message id endpoint url /v1/messages/{{messageid}} method get input argument name type required description path parameters messageid string required the unique identifier for the message input example {"path parameters" {"messageid" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvzmmzzjywyjetzdawny0xmwviltlkmtitodawm2qxmwrjmjvi"}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier parentid string unique identifier roomid string unique identifier roomtype string type of the resource text string output field text markdown string output field markdown html string output field html files array output field files personid string unique identifier personemail string output field personemail mentionedpeople array output field mentionedpeople mentionedgroups array output field mentionedgroups attachments array output field attachments attachments contenttype string type of the resource attachments content object response content attachments content type string type of the resource attachments content version string response content attachments content body array request body data attachments content body type string request body data attachments content body text string request body data attachments content body size string request body data attachments content actions array response content attachments content actions type string type of the resource output example {"status code" 200,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw 0534d02d fc2a 4455 9930 4a1cf490c5c7, routergw 0534d02d fc2a 4455 9930 ","cache control" "no cache, no store,no cache, no store","date" "tue, 24 sep 2024 10 16 48 gmt","x envoy upstream service time" "194","vary" "origin,accept encoding","content encoding" "gzip","content type" "application/json","server" "istio envoy","transfer encoding" "chunked"},"reason" "ok","json body" {"id" "y2lzy2 list direct messages retrieves a sorted list of all messages from a specified 1 1 cisco webex room, including content attachments, using personid or personemail endpoint url /v1/messages/direct method get input argument name type required description parameters parentid string optional list messages with a parent, by id parameters personid string optional list messages in a 1 1 room, by person id parameters personemail string optional list messages in a 1 1 room, by person email input example {"parameters" {"parentid" "2lzy29zcgfyazovl3vzl01fu1nbr0uvzwm1ztizzjatn2rhms0xmwu5ltg2ntgtztkzyzniodzjzmfm","personid" "y2lzy29zcgfyazovl3vzl1bft1bmrs9mnwiznje4ny1jogrkltq3mjctogiyzi1mowm0nddmmjkwndy","personemail" "matt\@example com"}} output parameter type description status code number http status code of the response reason string response reason phrase items array output field items items id string unique identifier items parentid string unique identifier items roomid string unique identifier items roomtype string type of the resource items text string output field items text items markdown string output field items markdown items html string output field items html items files array output field items files items personid string unique identifier items personemail string output field items personemail items attachments array output field items attachments items attachments contenttype string type of the resource items attachments content object response content items attachments content type string type of the resource items attachments content version string response content items attachments content body array request body data items attachments content body type string request body data items attachments content body text string request body data items attachments content body size string request body data items attachments content actions array response content items attachments content actions type string type of the resource items attachments content actions url string url endpoint for the request output example {"status code" 200,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw 0534d02d fc2a 4455 9930 4a1cf490c5c7, routergw 0534d02d fc2a 4455 9930 ","cache control" "no cache, no store,no cache, no store","date" "tue, 24 sep 2024 10 16 48 gmt","x envoy upstream service time" "194","vary" "origin,accept encoding","content encoding" "gzip","content type" "application/json","server" "istio envoy","transfer encoding" "chunked"},"reason" "ok","json body" {"items" \[{}] list messages retrieves all messages from a specified cisco webex room, including content and attachments, identified by the roomid parameter endpoint url /v1/messages method get input argument name type required description parameters roomid string required list messages in a room, by id parameters parentid string optional list messages with a parent, by id parameters mentionedpeople string optional list messages with these people mentioned, by id use me as a shorthand for the current api user only me or the person id of the current user may be specified bots must include this parameter to list messages in group rooms (spaces) parameters before string optional list messages sent before a date and time parameters beforemessage string optional list messages sent before a message, by id parameters max number optional limit the maximum number of messages in the response cannot exceed 100 if used with mentionedpeople input example {"parameters" {"roomid" "y2lzy29zcgfyazovl3vzl1jpt00vymjjzwixywqtndnmms0zyju4ltkxndctzje0ymiwyzrkmtu0","parentid" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvzwm1ztizzjatn2rhms0xmwu5ltg2ntgtztkzyzniodzjzmfm","mentionedpeople" "y2lzy29zcgfyazovl3vzl1bft1bmrs8yndlmnzrkos1kyjhhltqzy2etodk2yi04nzllzdi0mgfjntm","before" "2016 04 21t19 01 55 966z","beforemessage" "y2lzy29zcgfyazovl3vzl01fu1nbr0uvotjkyjniztatndnizc0xmwu2lthhztktzgq1yjnkzmm1njvk","max" 100}} output parameter type description status code number http status code of the response reason string response reason phrase items array output field items items id string unique identifier items parentid string unique identifier items roomid string unique identifier items roomtype string type of the resource items text string output field items text items markdown string output field items markdown items html string output field items html items files array output field items files items personid string unique identifier items personemail string output field items personemail items mentionedpeople array output field items mentionedpeople items mentionedgroups array output field items mentionedgroups items attachments array output field items attachments items attachments contenttype string type of the resource items attachments content object response content items attachments content type string type of the resource items attachments content version string response content items attachments content body array request body data items attachments content body type string request body data items attachments content body text string request body data items attachments content body size string request body data items attachments content actions array response content output example {"status code" 200,"response headers" {"x content type options" "nosniff, nosniff","trackingid" "routergw 00d9b2da 1859 4b7b b6a9 b8cdd1a10c2f, routergw 00d9b2da 1859 4b7b b6a9 ","cache control" "no cache, no store,no cache, no store","date" "tue, 24 sep 2024 10 26 49 gmt","x envoy upstream service time" "220","vary" "origin,accept encoding","content encoding" "gzip","content type" "application/json","server" "istio envoy","transfer encoding" "chunked"},"reason" "ok","json body" {"items" \[{}] response headers header description example cache control directives for caching mechanisms no cache, no store,no cache, no store content encoding http response header content encoding gzip content type the media type of the resource application/json date the date and time at which the message was originated tue, 24 sep 2024 09 45 20 gmt server information about the software used by the origin server istio envoy trackingid http response header trackingid routergw fe650b9d c43e 4970 a1b7 fb7fa6ffa907, routergw fe650b9d c43e 4970 a1b7 fb7fa6ffa907 transfer encoding http response header transfer encoding chunked vary http response header vary origin x content type options http response header x content type options nosniff, nosniff x envoy upstream service time http response header x envoy upstream service time 220