-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'Jerome-main-patch-39107' into 'main'
Update documentation on email, discord, and teams notifications See merge request documentation/uilicious-docs-v3!38
- Loading branch information
Showing
40 changed files
with
58 additions
and
156 deletions.
There are no files selected for viewing
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added
BIN
+241 KB
...ic/static/img/jobs/discord-notifications/discord-notification-setup-webhook.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added
BIN
+308 KB
...ublic/static/img/jobs/teams-notifications/jobs__teams__example-notification.png
Oops, something went wrong.
Binary file added
BIN
+291 KB
.vuepress/public/static/img/jobs/teams-notifications/jobs__teams__step1.png
Oops, something went wrong.
Binary file added
BIN
+452 KB
.vuepress/public/static/img/jobs/teams-notifications/jobs__teams__step2.png
Oops, something went wrong.
Binary file added
BIN
+333 KB
.vuepress/public/static/img/jobs/teams-notifications/jobs__teams__step3.png
Oops, something went wrong.
Binary file added
BIN
+333 KB
.vuepress/public/static/img/jobs/teams-notifications/jobs__teams__step4.png
Oops, something went wrong.
Binary file added
BIN
+1.53 MB
.vuepress/public/static/img/jobs/teams-notifications/jobs__teams__step5.png
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
70 changes: 15 additions & 55 deletions
70
how-to-guides/Setting-up-jobs/set-up-discord-notifications.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,75 +1,35 @@ | ||
--- | ||
# Write a short description about the page. This will be displayed on google search results. | ||
description: Learn how to setup scheduled job notification on UIlicious via Discord webhook. | ||
description: In this guide, learn how to setup Discord notifications for jobs. | ||
--- | ||
|
||
# Set up Discord Notifications | ||
# Setting Discord Notifications for Jobs | ||
|
||
In this section, you will learn how to set up notifications on Discord using their provided webhook. | ||
You can setup jobs to set notifications about the test outcomes to specific channels in your Discord server. | ||
|
||
This section will guide you through the steps of setting up and integrating Discord Webhooks with UIlicious. It will provide you with a brief overview of Discord. | ||
In article, we'll cover how to setup notifications for jobs in Discord. | ||
|
||
* [Prerequisites](set-up-discord-notifications.md#prerequisites) | ||
* Setting up Discord Notifications in UIlicious | ||
* Step 1: [View the Notifications Section in UIlicious](set-up-discord-notifications.md#step-1-view-the-notifications-section-in-uilicious) | ||
* Step 2: [Making a Webhook URL in Discord](set-up-discord-notifications.md#step-2-making-a-webhook-in-discord) | ||
* Step 3: [Add the Webhook URL to Your UIlicious Notification Settings](set-up-discord-notifications.md#step-3-add-the-webhook-url-into-your-uilicious-notification-settings) | ||
[[toc]] | ||
|
||
Once you have properly configured your webhook URL and added it to your Notification Settings, UIlicious can send test run alerts to your Discord channel. | ||
## Step 1: Creating a webhook on Discord | ||
|
||
### Prerequisites | ||
First, open "**Server Settings**" on your Discord Server. | ||
|
||
* Active Discord Account | ||
* Know how to [Schedule an Automated Job](./schedule-a-job.html) | ||
* Basic Knowledge of Webhooks | ||
![](/static/img/jobs/discord-notifications/Discord_Server_Settings.png) | ||
|
||
### Step 1: View the Notifications Section in UIlicious | ||
Next, under "Apps", click "**Integrations**". Then, click "**Create Webhook**". | ||
|
||
To view the Notifications section, you can open the **Monitoring** tab in UIlicious studio. | ||
![](/static/img/jobs/discord-notifications/Discord_Webhook_Button.png) | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652652332/ui-licious/setting-up-notifications/monitoring-tab-active.png) | ||
|
||
In **Monitoring**, you can view your complete list of jobs. | ||
Now, **enter a name** for the bot (e.g. UI-licious Jobs), and **select a channel** for receiving the notifications. Then, click "**Copy Webhook URL**". | ||
|
||
Then, click on the **Schedule New Job** button. | ||
![](/static/img/jobs/discord-notifications/discord-notification-setup-webhook.png) | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1649282897/UI-licious:%20Monitoring/scheduleaJob-2\_klnawl.png) | ||
## Step 2: Configure Discord Notification for Job | ||
|
||
Scroll down to the **Notifications** section. | ||
Open the Settings for the job. Under "Notifications", **enable "Notify by Webhook"**, **select "Others"** for the type of Webhook, and **paste the Webhook URL**. Save the changes. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652652712/ui-licious/setting-up-notifications/scroll-to-notifications-section.gif) | ||
![](/static/img/jobs/discord-notifications/Uilicious_Discord_webhook.png) | ||
|
||
Click the toggle next to **Notify by Webhook**. | ||
|
||
Then, open the dropdown menu next to **Webhook** and select **Others**. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652652028/ui-licious/setting-up-notifications/toggle\_on\_webhooks.gif) | ||
|
||
### Step 2: Making a Webhook in Discord | ||
|
||
Now, that we know where our Webhook URL goes in UIlicious, let's create our Webhook in Discord. | ||
|
||
Open **Server Settings** in Discord. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652654139/ui-licious/setting-up-notifications/scroll-to-Server-Settings-in-Discord.png) | ||
|
||
Open the **Integrations** tab, and select **Create Webhook**. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652654319/ui-licious/setting-up-notifications/go-to-integrations-and-select-create-webhook\_wjhupu.png) | ||
|
||
Feel free to customize your avatar and name your Webhook. | ||
|
||
Click the **Channel** name that you would like UIlicious to send notifications to. | ||
|
||
Then, click **Copy Webhook URL**. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652654609/ui-licious/setting-up-notifications/customize-your-webhook.png) | ||
|
||
### Step 3: Add the Webhook URL into Your UIlicious Notification Settings | ||
|
||
Now, that we have our Webhook URL, let's paste it in your UIlicious Notification Settings. | ||
|
||
Then, click the **Schedule** button. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652655093/ui-licious/setting-up-notifications/paste-your-webhook-URL-into\_UIlicious\_r0d0hf.png) | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -5,10 +5,8 @@ description: Learn how to setup scheduled job notification on UIlicious via emai | |
|
||
# Set up Email Notifications | ||
|
||
When scheduling a new job, you have the option to **Notify by Email** by turning the toggle on.  | ||
You can setup jobs to send notifications to email. | ||
|
||
![Turning on the toggle next to Notify by Email allows you to input your choice of email(s) to be notified of test run results.](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652630231/ui-licious/setting-up-notifications/open-up-email-notifications.gif) | ||
Enable "**Notify by Email**" in the Job Settings, and add one or more email addresses for receiving the notification, separated by comma. | ||
|
||
Enter your e-mail address.  | ||
|
||
If you want to send notifications to multiple emails, use a common (ex. [email protected], [email protected]). | ||
![Setting up email notifications for a job](/static/img/jobs/Job_Email_Notification.png) |
98 changes: 21 additions & 77 deletions
98
how-to-guides/Setting-up-jobs/set-up-microsoft-teams-notifications.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,101 +1,45 @@ | ||
--- | ||
# Write a short description about the page. This will be displayed on google search results. | ||
description: Learn how to setup scheduled job notification on UIlicious via Microsoft Teams webhooks. | ||
description: In this guide, learn how to setup notifications on Microsoft Team for scheduled jobs | ||
--- | ||
|
||
# Set up Microsoft Teams Notifications | ||
# Setting up Microsoft Teams notifications for Jobs | ||
|
||
In this section, you will learn how to set up notifications on Teams. | ||
You can setup notifications for the outcomes of tests triggered by jobs on Microsoft Teams. | ||
|
||
This section will guide you through the steps of setting up and integrating Teams with UIlicious. | ||
![Receive notifications on Microsoft Teams when tests fail](/static/img/jobs/teams-notifications/jobs__teams__example-notification.png) | ||
|
||
* [Prerequisites](set-up-microsoft-teams-notifications.md#prerequisites) | ||
* Setting up Teams Notifications in UIlicious | ||
* Step 1: [View the Notifications Section in UIlicious](set-up-microsoft-teams-notifications.md#step-1-view-the-notifications-section-in-uilicious) | ||
* Step 2: [Making a Webhook with Teams](set-up-microsoft-teams-notifications.md#step-2-making-a-webhook-with-teams) | ||
* Step 3: [Add the Webhook URL to Your UIlicious Notification Settings](set-up-microsoft-teams-notifications.md#step-3-add-the-webhook-url-to-your-uilicious-notification-settings) | ||
* [UIlicious Notification in Teams Example](set-up-microsoft-teams-notifications.md#uilicious-notification-in-teams-example) | ||
In this guide, we'll cover the steps to setup notifications on Microsoft Teams. | ||
|
||
Once you have properly configured your webhook URL and added it to your Notification Settings, UIlicious can send test run alerts to your Teams. | ||
[[toc]] | ||
|
||
### Prerequisites | ||
## Step 1: Create Incoming Webhook on Microsoft Teams | ||
|
||
* Active Teams Account | ||
* Know how to [Schedule an Automated Job](./schedule-a-job.html) | ||
First, open the **Settings** for the channel where you want to receive notifications. | ||
|
||
### Step 1: View the Notifications Section in UIlicious | ||
Under "**Connectors**", click "**Edit**". | ||
|
||
To view the Notifications section, you can open the **Monitoring** tab in UIlicious studio. | ||
![](/static/img/jobs/teams-notifications/jobs__teams__step1.png) | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652652332/ui-licious/setting-up-notifications/monitoring-tab-active.png) | ||
Search for "**Incoming Webhooks**", and click "**Configure**" to add a new Webhook. If "Incoming Webhook" is not available as a connector, please contact your Microsoft Teams administrator to enable the connector for your team. | ||
|
||
In **Monitoring**, you can view your complete list of jobs. | ||
![](/static/img/jobs/teams-notifications/jobs__teams__step2.png) | ||
|
||
Then, click on the **Schedule New Job** button. | ||
**Enter a name** for the webhook, for example "UI-licious Job", then click "Create". | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1653413563/ui-licious/setting-up-notifications/scheduleajob\_c9hyqi.png) | ||
![](/static/img/jobs/teams-notifications/jobs__teams__step3.png) | ||
|
||
Name your job. | ||
Once the webhook is created, **copy the webhook URL**. | ||
|
||
Then, scroll down to the **Notifications** section. | ||
![](/static/img/jobs/teams-notifications/jobs__teams__step4.png) | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1652652712/ui-licious/setting-up-notifications/scroll-to-notifications-section.gif) | ||
|
||
**Note**: You can choose **When** to receive notifications, there are two options available: \ | ||
**Always** or **Error**. | ||
## Step 2: Configure Webhook Notification for job | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1653501856/ui-licious/setting-up-notifications/telegram/when-to-receive-notifications.png) | ||
Open the settings for the job, and under "Notifications", **enable "Notify by Webhook"**, **select "Microsoft Teams"** as the type of Webhook, and paste the webhook URL. Save the changes. | ||
|
||
Next, click the toggle next to **Notify by Webhook**. | ||
![](/static/img/jobs/teams-notifications/jobs__teams__step5.png) | ||
|
||
Then, open the dropdown menu next to **Webhook** and **** select **Microsoft Teams**. | ||
Once configured, you will start receiving notifications on test outcomes in your Microsoft Teams channel. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1654117021/ui-licious/setting-up-notifications/teams/teams-notifications-on.gif) | ||
|
||
### Step 2: Making a Webhook with Teams | ||
|
||
First, launch the Microsoft Teams application. | ||
|
||
Next, click the **Apps** icon. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512636/ui-licious/setting-up-notifications/teams/teams-1\_kt8y4q.png) | ||
|
||
Then, search for "**Incoming Webhooks**". | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512636/ui-licious/setting-up-notifications/teams/teams-2\_xsejxr.png) | ||
|
||
Click the **Add to a team** button. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512636/ui-licious/setting-up-notifications/teams/teams-3\_cl2brx.png) | ||
|
||
Then, click **Setup a Connector**. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512636/ui-licious/setting-up-notifications/teams/teams-5\_pydcb6.png) | ||
|
||
Click **Configure,** and add a name for your Webhook. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512636/ui-licious/setting-up-notifications/teams/teams-7\_kdtxkn.png) | ||
|
||
Name your Webhook. | ||
|
||
Then, click **Create**. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512638/ui-licious/setting-up-notifications/teams/teams-9\_eyn6fo.png) | ||
|
||
Next, copy your Webhook URL as we will use this in your UIlicious Notifications Settings. | ||
|
||
Just a heads-up, this is what successfully setting up a Webhook looks like: | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655512637/ui-licious/setting-up-notifications/teams/teams-10\_rrca2m.png) | ||
|
||
### Step 3: Add the Webhook URL to Your UIlicious Notification Settings  | ||
|
||
Head back to UIlicious and scroll down to the Notifications section. | ||
|
||
Next to Webhook URL, paste in the URL that you copied earlier. | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1655513147/ui-licious/setting-up-notifications/teams/teams-example.png) | ||
|
||
### UIlicious Notification in Teams Example | ||
|
||
![](https://res.cloudinary.com/di7y5b6ed/image/upload/v1656342911/ui-licious/setting-up-notifications/teams/successful-notification-microsoft-teams\_rrnb90.png) | ||
![Receive notifications on Microsoft Teams when tests fail](/static/img/jobs/teams-notifications/jobs__teams__example-notification.png) |