Incoming Webhooks

Incoming Webhooks

Integration by Cisco Systems

Published Jul 2 2018

Connect

to connect

Published Jul 2 2018

Incoming Webhooks

Integration by Cisco Systems
Send messages to Cisco Webex Teams from other services.

Incoming webhooks let you post messages in Webex Teams spaces when an event occurs in another service that supports webhooks. Webhook events trigger in near real-time allowing your Webex Teams spaces to stay in sync with events happening outside of Webex Teams.

 

To use incoming webhooks, simply connect this integration to your Webex Teams account, create a new webhook below, and configure your service to post messages to the provided URL. The incoming webhook URL expects an HTTP request with a JSON payload which includes the message in either a plaintext field or Markdown-formatted field.

 

To send a plaintext message, make an HTTP POST to the URL and provide the message body in the text field of the request:

 

curl -X POST -H "Content-Type: application/json" ∖
-d '{"text" : "This is a message from a Cisco Webex Teams incoming webhook."}' ∖   "https://api.ciscospark.com/v1/webhooks/incoming/<incoming_webhook_url>"

 

To send a formatted message, make an HTTP POST to the URL and provide the message body (in Markdown format) in the markdown field:

 

curl -X POST -H "Content-Type: application/json" ∖
-d '{"markdown" : "This is a formatted message from a Cisco Webex Teams incoming webhook."}' ∖   "https://api.ciscospark.com/v1/webhooks/incoming/<incoming_webhook_url>".

 

See our Webex Teams for Developer documentation about formatting messages for more examples of how you can create richly-formatted messages in Webex Teams.