6 Notify_wxteams
Chris Caron edited this page 2023-02-12 14:11:13 -05:00

Webex Teams Notifications

  • Source: https://teams.webex.com
  • Icon Support: No
  • Message Format: Markdown
  • Message Limit: 1000 Characters per message

Account Setup

To use this plugin, you need to first access https://teams.webex.com and make yourself an account if you don't already have one. You'll want to create at least one 'space' before getting the 'incoming webhook'.

Next you'll need to install the 'Incoming webhook' plugin found under the 'other' category here: https://apphub.webex.com/integrations/

These links may not always work as time goes by and websites always change, but at the time of creating this plugin this was a direct link to it.

If you're logged in, you'll be able to click on the 'Connect' button. From there you'll need to accept the permissions it will ask of you. Give the webhook a name such as 'apprise'.

When you're complete, you will receive a URL that looks something like this:

https://api.ciscospark.com/v1/webhooks/incoming/\
       Y3lzY29zcGkyazovL3VzL1dFQkhPT0sajkkzYWU4fTMtMGE4Yy00

image

The last part of the URL is all you need to be interested in. Think of this URL as:

  • https://api.ciscospark.com/v1/webhooks/incoming/{token}

So as you can see, we have is 3 separate tokens. These are what you need to build your apprise URL with. In the above (simplified) example, the tokens are:

  • Token: Y3lzY29zcGkyazovL3VzL1dFQkhPT0sajkkzYWU4fTMtMGE4Yy00

Note: Apprise supports this URL as-is (as of v0.7.7); you no longer need to parse the URL any further. However there is slightly less overhead (internally) if you do.

Syntax

Valid syntax is as follows:

  • https://api.ciscospark.com/v1/webhooks/incoming/{token}
  • https://webexapis.com/v1/webhooks/incoming/{token}
  • wxteams://{token}/
  • webex://{token}/

Parameter Breakdown

Variable Required Description
token Yes The tokens provided to you after creating a incoming-webhook

Example

Send a Webex Teams notification:

# Assuming our {token} is T1JJ3T3L2DEFK543
apprise -vv -t "Test Message Title" -b "Test Message Body" \
   wxteams:///T1JJ3T3L2DEFK543/