Browse documentation

Integrations

Microsoft Teams

Send your Lineman cost digest and spend alerts into a Teams channel as an Adaptive Card. You create a webhook in Teams, paste the URL into Lineman, and send a test card to prove it lands.

Not generally available yet. Teams sits behind the integrations feature flag, so the connect page is hidden for accounts that do not have it turned on and the steps below would have nowhere to paste the URL. Ask us to enable it before you set the webhook up.

Create the webhook in Teams

  1. 1In Teams, open the channel the digest should land in and choose Workflows from the channel menu.
  2. 2Pick the template Post to a channel when a webhook request is received.
  3. 3Confirm the team and channel it posts to, then finish the flow.
  4. 4Copy the URL it shows you at the end. That URL is the entire credential: anyone holding it can post into the channel, so do not put it in a ticket, an email or a chat. Lineman stores it encrypted and never shows it back to you.

This replaces the old Office 365 connectors. Microsoft has retired them, so an Incoming Webhook connector set up in a channel years ago has either stopped posting or soon will. A Workflows URL is the modern equivalent and takes the same card.

Connect it in Lineman

  1. 1Open Dashboard, Integrations, Microsoft Teams and paste the URL. You have to be an administrator of your Lineman company to save it; other members can see the connection but not change it.
  2. 2Label the team and channel if you like. Those labels are only for your own reference in the dashboard, so you can see where the digest goes without opening Teams.
  3. 3Press Test. It posts a real Adaptive Card into the channel with zeroed figures, so go and look at Teams: the destination is only proven once a card has actually arrived.

Pasting a fresh URL over the old one is also the repair. Saving replaces the stored URL and clears the previous failure, so a destination marked broken goes back to healthy without you disconnecting it first.

Only Microsoft webhook hosts are accepted

Lineman posts to this URL from our servers on a schedule, so an arbitrary address would turn the digest into a request forwarder pointed wherever it was told. The URL must be https and on a host Teams actually mints webhooks on: webhook.office.com, logic.azure.com, azure-apihub.net or powerplatform.com.

Anything else is refused the moment you save, not quietly on the first digest, and the message names the host that was rejected: host "hooks.example.com" is not a recognised Microsoft webhook host. In practice that error nearly always means a URL from a different tool went into the wrong box.

If your tenant mints webhooks somewhere else, send us the host and we will add it. We will not post to an unrecognised host on trust, so widening the list is a deliberate change on our side rather than something you can override in the form.

What lands in the channel

  • Three figures and a button. The card shows the period it covers, total spend, and what Lineman saved you, with an Open Cost Explorer button through to the full breakdown.
  • It is an Adaptive Card pinned to version 1.4. That is not the newest version, it is the newest one Teams renders reliably across desktop, web and mobile. A card that arrives blank on someone's phone is worse than a plain one that renders everywhere.
  • So look at the test card on a phone as well as a desktop. That is what the Test button is for, and it is the only way to know the choice holds for the Teams clients your people actually use.
  • The card is posted full width. Teams defaults to a narrow column, which truncates the figures on desktop.

If the webhook stops working

  • Deleting the workflow in Teams does not tell Lineman. The next delivery is rejected by Microsoft, and rather than counting that as sent, Lineman marks the destination as broken and records the reason, so you see it the next time you open the integration page.
  • A failed test is recorded the same way. If you press Test, it fails and you walk away, the destination is still flagged when you come back rather than looking connected.
  • Pause rather than disconnect if you only want the digest to stop for a while. The URL is kept, deliveries are skipped, and Test is refused while it is paused, so turn it back on before you test.

Reading the numbers

  • Money is in US dollars. Every amount on the card is a formatted dollar figure. Lineman does not report money in cents, so there is nothing to divide or convert.
  • The figures cover the whole company. The digest is company-wide, not the spend of whoever connected it, so pick a channel whose members are allowed to see company totals.
Back to Integrations