Skip to content

Notify_stride

lead2gold edited this page Mar 13, 2018 · 4 revisions

Stride Notifications

Account Setup

Stride is the successor to Hipchat. It requires you to create a custom app and assign it to your channel you create.

Let's start from the beginning:

  1. When you sign-up with stride.com, the site will ask if you want to join a group or creating your own. Brand new users will start their own while companies might have already formed a group you want to join.
  2. Once you get set up, you'll have the option of creating a channel (or if you joined your companies group, you might already see channels you can join in front of you). Either way, you need to be in a channel before you get to the next step.
  3. Once you're in a channel you'll want to connect apprise (this notification service) up. To do this, you need to go to the App Manager (on right hand side in your browser) an choose to 'Connect your own app'.
    • It will ask you to provide a 'token name' which can be whatever you want. This will be used for reference later. Click the Create button when you're done.
    • When it completes it will generate a token that looks something like:
      HQFtq4pF8rKFOlKTm9Th
      This is important and we'll referenced it as your {auth_token}.
    • If you scroll down it will also generate you a conversation URL that might look like:
      https://api.atlassian.com/site/ce171c45-09ae-4fac-a73d-5a4b7a322872/conversation/a54a80b3-eaad-4524-9a3a-f6653bcfb100/message
      Think of this URL like this:
      https://api.atlassian.com/site/{cloud_id}/conversation/{convo_id}/message. Specifically pay close attention to the {cloud_id} and {convo_id} because you will need this to build your custom URL with.

Syntax

The valid syntax is as follows:

  • stride://{auth_token}/{cloud_id}/{convo_id}

Parameter Breakdown

Variable Required Description
auth_token Yes The Authorization token that is created for you once you create your Custom App (that you associate with your channel).
cloud_id Yes This is extracted from the URL that is created for you when you create your Custom App (the same one that is identified above).
Note: This is the first part of the conversation URL:
https://api.atlassian.com/site/{cloud_id}/conversation/{convo_id}/message
convo_id Yes This is extracted from the URL that is created for you when you create your Custom App (the same one that is identified above).
Note: This is the second part of the conversation URL:
https://api.atlassian.com/site/{cloud_id}/conversation/{convo_id}/message

Example

Send a stride notification:

# Assuming our {auth_token} is HQFtq4pF8rKFOlKTm9Th
# Assuming our {cloud_id} is ce171c45-09ae-4fac-a73d-5a4b7a322872
# Assuming our {convo_id} is a54a80b3-eaad-4524-9a3a-f6653bcfb100
apprise stride://HQFtq4pF8rKFOlKTm9Th/ce171c45-09ae-4fac-a73d-5a4b7a322872/a54a80b3-eaad-4524-9a3a-f6653bcfb100
Clone this wiki locally