Webhooks Setup for Microsoft Teams

For activating notifications through Weebhooks on the team follow the following steps

  • Login to your teams

  • Go to the apps section and search for Weebhooks

  • Select Incoming Webhooks

  • Select the team or channel where you want to get the notifications

  • To set an incoming webhook Provide a name and click create

  • Copy the URL to save it on the clipboard as this URL will be required to be pasted in the Notification section on the DBSync Notification page

Once Teams setup is completed go to the DBSync Notification Page

  • Configure Webhooks Notifications Settings

    Receive Notifications Click the checkbox next to the desired event options. There are 3 main event options that can be configured are shown in the image below:

    • Process

    • Started- Click the checkbox next to the icon 'Started' if you wish to be notified when a process is started. For eg: If you enable this option you will be notified when a process such as 'Clean Copy', 'DB to Source', etc starts running.

    • Completed- Click the checkbox next to the icon 'Completed' if you wish to be notified when a process is completed. For eg: If you enable this option you will be notified when a process such as 'Clean Copy', 'DB to Source', etc completes.

    • Errored- Click the check-box next to the icon 'Errored' if you wish to be notified when errors arrears in the process or the process fails. For eg: If you enable this option you will be notified when a process such as 'Clean Copy', 'DB to Source', etc encounters errors or fails.

    Methods of Configuration Notifications

    POST method:

    • This method is used if the user wants to define the payload.

    • From the URL drop-down menu choose the POST method option.

    • Fill in all the details: URL, HEADERS, CONTENT TYPE, and PAYLOAD

    For example:

    Let us consider that a user wants to get notified in TEAMS.

    Enter details as follows:

    URL:POST URL: https://avankia.webhook.office.com/webhookb2/cfef3183-e63b-4f97-a5dc-5c038f23ce19@c86b5726-2a50-4b12-9703-ce9be669e77d/IncomingWebhook/95072733741343179cb2e3f28a4567ae/28fcde24-5b09-4aae-b25d-761b199a6f33

    1. Content-Type:

    Content-type:

    Content type: application/JSON

    1. Payload:

    Payload: (Freeform)

    { 'text' : 'date=$date; format ="yyyy-MM-dd hh:mm:ss"$ profile=$profile$ command=$command$ zoneId=$zoneId; default="EST"$ errorCount=$errorCount$' }

    • The screen will appear as below:

    • You can format your calls for multiple parameters.

    • The above example: The user required details such as:

    date, time, profile, and error.

    • There is a specific list of supported expressions that have to be followed for writing the various required parameters in the URL while running the POST method.

    • These can be found listed under “Supported Expressions”. Various conditions for these parameters can also be listed.

    • Once you enter all parameters Click SAVE

    • Click Test Connection and verify the same.

    In this manner, the user can define their own Payload and provide the parameters in the standard expressions format with/without conditions to receive the respective POST notifications in their communication channel.

  • Supported Expressions:

    Using Conditions:

    If else conditions are supported, however, we need to specify a boolean variable from the supported list for conditions:

    Syntax:

    $if(variable1)$value1$elseif(variable2)$value2$else$value3$endif$

    Example

    $if(isError)$$errorCount$$else$0$endif$