Previous

Next

Exercise - Create incoming webhooks

Completed

In this exercise, you’ll learn how to register an incoming webhook in a Microsoft Teams channel and post a message to it.

Register a new incoming webhook

Now let's add an incoming webhook to a team in Microsoft Teams. In the browser, navigate to https://teams.microsoft.com and sign in with the credentials of a Work and School account.

Once you're signed in, select a channel in a team you want to add the webhook to. From the channel's page, select the + in the top navigation:

On the Add a tab dialog, select Manage apps in the lower right corner:

This will take you to the Manage Channel page. Select the More apps button:

On the Apps page, search for the incoming webhook app and select it.

Select the Add to a team button. On the next page, enter the name of a channel to add the webhook to, and select the Set up a connector:

On the Incoming Webhook configuration screen, enter the name Dwarf Planet Details and select the Create button (you may need to scroll down in the dialog as the Create button isn't visible by default, as in the following screenshot):

The dialog will add a new input box that contains the endpoint for you should post to after creating the incoming webhook. Copy this value:

Test the incoming webhook

The next step is to submit a post to it to display a message in the channel after configuring the incoming webhook. Do this by submitting an HTTPS request to the webhook endpoint provided.

Using the free tool Postman, create a new request to the point endpoint:

• set the request to a POST

• set the endpoint to the webhook endpoint you copied at the end of the previous section

• set the Content-Type header to application/json on the Headers tab:

  

• add the following JSON to the Body tab and select the raw option:

  {
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "summary": "Dwarf planet Pluto details",
    "sections": [{
      "activityTitle": "Dwarf planet Pluto details",
      "activityImage": "https://upload.wikimedia.org/wikipedia/commons/e/ef/Pluto_in_True_Color_-_High-Res.jpg",
      "facts": [
        {
          "name": "Description",
          "value": "Pluto is an icy dwarf planet in the Kuiper belt, a ring of bodies beyond the orbit of Neptune. It was the first Kuiper belt object to be discovered and is the largest known dwarf planet. Pluto was discovered by Clyde Tombaugh in 1930 as the ninth planet from the Sun. After 1992, its status as a planet was questioned following the discovery of several objects of similar size in the Kuiper belt. In 2005, Eris, a dwarf planet in the scattered disc which is 27% more massive than Pluto, was discovered. This led the International Astronomical Union (IAU) to define the term \"planet\" formally in 2006, during their 26th General Assembly. That definition excluded Pluto and reclassified it as a dwarf planet."
        },
        {
          "name": "Order from the sun",
          "value": "9"
        },
        {
          "name": "Known satellites",
          "value": "5"
        },
        {
          "name": "Solar orbit (*Earth years*)",
          "value": "247.9"
        },
        {
          "name": "Average distance from the sun (*km*)",
          "value": "590637500000"
        },
        {
          "name": "Image attribution",
          "value": "NASA/Johns Hopkins University Applied Physics Laboratory/Southwest Research Institute/Alex Parker [Public domain]"
        }
      ]
    }],
    "potentialAction": [{
      "@context": "http://schema.org",
      "@type": "ViewAction",
      "name": "Learn more on Wikipedia",
      "target": ["https://en.wikipedia.org/wiki/Pluto"]
    }]
  }
  

  

Send the card to Microsoft Teams by selecting the Send button.

In the browser, navigate back to the Conversations tab in the channel where you installed the incoming webhook. You should see a message containing your card:

Summary

In this exercise, you learned how to register an incoming webhook in a Microsoft Teams channel and post a message to it.

Test your knowledge

1.

What options can a developer use when sending a message to an incoming webhook?

A web service can send a message that contains text, a card, markdown, or HTML to implement basic or rich messages.

A web service can send a message that contains text, a card, markdown to implement basic or rich messages.

A web service can send a message that contains text or markdown to implement basic or rich messages. Cards and HTML aren't supported.

2.

How can developers submit a message to an incoming webhook?

After registering the incoming webhook, submit the message in the body of an HTTP POST to the endpoint provided by Microsoft Teams.

After registering the incoming webhook, submit the message in the body of an HTTP GET to the endpoint provided by Microsoft Teams.

After registering the incoming webhook, submit the message in the body of an HTTP POST to the endpoint provided by Microsoft Teams and include the HMAC in the HTTP authorization header.

You must answer all questions before checking your work.

Continue