Home › Knowledgebase › Notifications
Knowledgebase

Setting up Notifications

Learn how to configure user and resource notifications in Alira — including webhook integrations with Microsoft Teams and Slack using Adaptive Cards.

~10 min read
Settings › Notifications
Teams & Slack supported
1

User Notifications

User notification settings are found at Settings › Notifications › User. These control how individual users receive alerts across the platform.

Notification Types

An application-wide toggle that lets you enable or disable In-App or Email notifications for your users.

Global Settings

Control notification support on a per-module basis across the entire platform. Toggle each module on or off to suit your organisation’s needs.

Edit Channels

Globally override notification types per module — giving administrators fine-grained control over how and where alerts are delivered.

2

Resource Notifications

Resource notifications are configured at Settings › Notifications › Resource. This is where you set up webhooks to send automated alerts to Microsoft Teams or Slack whenever access events occur.

2.1 — Generate a Webhook URL

Before creating a webhook in Alira, you first need to generate a webhook URL from your chosen platform. Follow the steps below for your provider.

Microsoft Teams
  1. Open the Teams App
  2. Open Workflows (you may need to click the ellipsis …)
  3. Select Templates
  4. Search for “Send webhook alerts to a chat (or to a channel)” and select it
  5. Select where you want the webhook to send messages — any user, group, or channel is supported. Note: you cannot send to “(You)”.
  6. Click Save
  7. Copy the webhook link and save it — you’ll need it when configuring the webhook in Alira.
Note: You cannot send messages to the “(You)” personal chat — any other user, group or channel is supported.
Slack
  1. Go to https://api.slack.com/apps
  2. Click Create New App
  3. Choose From scratch
  4. Give it a name (e.g. Alira Notifications) and choose your Slack workspace
  5. In the left menu, select Incoming Webhooks
  6. Toggle Activate Incoming Webhooks → On
  7. Click Add New Webhook
  8. Pick the channel you want to post to, then click Allow
  9. Slack generates a webhook URL — copy it for the next step.
Tip: On your Slack App’s Basic Information page, you can customise icons and colours to match your brand.

2.2 — Creating a Webhook in Alira

Navigate to Settings › Notifications › Resource and click the + button to create a new webhook. Fill in the fields below.

Name
Enter a relevant, descriptive name for this webhook (e.g. Teams Access Alerts).
Channel Type
Select Webhook from the dropdown.
Webhook URL
Paste the URL generated in Step 2.1.

Events

Select which access events should trigger this webhook. You can subscribe to one or more of the following:

ap.resource.requested

Triggered when any Access or Software resource is requested by a user.

ap.resource.approval_required

Triggered when a resource request requires approver action before it can proceed.

ap.resource.approved

Triggered when a resource request that required approval has been approved.

ap.resource.denied

Triggered when a resource request requiring approval has been denied.

Request Body Template

The Request Body Template defines the payload sent to your webhook. For Microsoft Teams, use the Adaptive Cards schema. For Slack, use the Block Kit JSON format.

Use {{eventType}}, {{userName}}, {{resourceName}}, {{comment}}, {{resourceDescription}} and {{timestamp}} as dynamic template variables — Alira replaces these with live values at send time.
3

Adaptive Card Examples

Below are ready-to-use templates. Click Copy Code on any example and paste it directly into the Request Body Template field in Alira. Preview the card rendering on the left to pick the style that suits your team.

Teams Example 1 — Basic
Type: ap.resource.requested
Jane Smith has requested access to SharePoint Intranet
Justification: Required for the Q3 project handover
Open Approvals
JSON — Adaptive Card 
{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    { "type": "TextBlock", "text": "Type: {{eventType}}", "wrap": true },
    { "type": "TextBlock", "text": "{{userName}} has requested access to {{resourceName}}", "wrap": true },
    { "type": "TextBlock", "text": "Justification: {{comment}}", "wrap": true },
    { "type": "TextBlock", "text": "[Open Approvals](https://alira.kocho.co.uk/demo/ap/manage/approvals)", "wrap": true }
  ]
}
Teams Example 2 — Hero
Alira Request
SharePoint Intranet • Access Request
User Jane Smith
Justification
Required for the Q3 project handover and data review.
Open Approvals
JSON — Adaptive Card 
{
  "type": "AdaptiveCard", "version": "1.4",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "body": [
    {
      "type": "Container", "style": "emphasis", "bleed": true,
      "items": [{
        "type": "ColumnSet",
        "columns": [
          { "type": "Column", "width": "auto", "items": [{ "type": "Image", "url": "https://cdn-ukwest.onetrust.com/logos/.../Kocho_Primary_Ebony_320px_w_RGB.png", "size": "Large", "altText": "Kocho" }] },
          { "type": "Column", "width": "stretch", "items": [
            { "type": "TextBlock", "text": "Alira Request", "weight": "Bolder", "size": "Medium", "color": "Accent", "wrap": true },
            { "type": "TextBlock", "text": "{{resourceName}} • Access Request", "spacing": "None", "wrap": true }
          ]}
        ]
      }]
    },
    { "type": "ColumnSet", "spacing": "Medium", "separator": true, "columns": [
      { "type": "Column", "width": "auto", "items": [{ "type": "TextBlock", "text": "User", "weight": "Bolder", "wrap": true }] },
      { "type": "Column", "width": "stretch", "items": [{ "type": "TextBlock", "text": "{{userName}}", "wrap": true }] }
    ]},
    { "type": "Container", "spacing": "Medium", "items": [
      { "type": "TextBlock", "text": "Justification", "weight": "Bolder", "color": "Accent" },
      { "type": "TextBlock", "text": "{{comment}}", "wrap": true }
    ]},
    { "type": "ActionSet", "spacing": "Medium", "separator": true, "actions": [{ "type": "Action.OpenUrl", "title": "Open Approvals", "url": "https://alira.kocho.co.uk/demo/ap/manage/approvals" }] }
  ]
}
Teams Example 3 — Compact
KOCHO
Jane Smith is requesting SharePoint Intranet
Reason: Required for Q3 project handover
Open Approvals
JSON — Adaptive Card 
{
  "type": "AdaptiveCard", "version": "1.4",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "body": [
    { "type": "ColumnSet", "columns": [
      { "type": "Column", "width": "auto", "items": [{ "type": "Image", "url": "https://cdn-ukwest.onetrust.com/logos/.../Kocho_Primary_Ebony_320px_w_RGB.png", "size": "Large", "altText": "Kocho" }] },
      { "type": "Column", "width": "stretch", "items": [
        { "type": "TextBlock", "text": "{{userName}} is requesting {{resourceName}}", "wrap": true, "weight": "Bolder" },
        { "type": "TextBlock", "text": "Reason: {{comment}}", "isSubtle": true, "wrap": true, "spacing": "None" }
      ]}
    ]},
    { "type": "ActionSet", "spacing": "Medium", "separator": true, "actions": [{ "type": "Action.OpenUrl", "title": "Open Approvals", "url": "https://alira.kocho.co.uk/demo/ap/manage/approvals" }] }
  ]
}
Teams Example 4 — Detailed
KOCHO
Jane Smith is requesting SharePoint Intranet
Reason: Required for Q3 project handover
Request Details
UserJane Smith
ResourceSharePoint Intranet
DescriptionInternal team collaboration portal
Requested On2025-04-24 09:41
Open Approvals
JSON — Adaptive Card 
{
  "type": "AdaptiveCard", "version": "1.4",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "body": [
    { "type": "ColumnSet", "columns": [
      { "type": "Column", "width": "auto", "items": [{ "type": "Image", "url": "https://cdn-ukwest.onetrust.com/logos/.../Kocho_Primary_Ebony_320px_w_RGB.png", "size": "Large", "altText": "Kocho" }] },
      { "type": "Column", "width": "stretch", "items": [
        { "type": "TextBlock", "text": "{{userName}} is requesting {{resourceName}}", "wrap": true, "weight": "Bolder", "size": "Medium" },
        { "type": "TextBlock", "text": "Reason: {{comment}}", "wrap": true, "isSubtle": true, "spacing": "None" }
      ]}
    ]},
    { "type": "Container", "spacing": "Medium", "separator": true, "items": [
      { "type": "TextBlock", "text": "Request Details", "weight": "Bolder", "color": "Accent" },
      { "type": "ColumnSet", "columns": [
        { "type": "Column", "width": "auto", "items": [
          { "type": "TextBlock", "text": "User", "weight": "Bolder" },
          { "type": "TextBlock", "text": "Resource", "weight": "Bolder" },
          { "type": "TextBlock", "text": "Description", "weight": "Bolder" },
          { "type": "TextBlock", "text": "Requested On", "weight": "Bolder" }
        ]},
        { "type": "Column", "width": "stretch", "items": [
          { "type": "TextBlock", "text": "{{userName}}", "wrap": true },
          { "type": "TextBlock", "text": "{{resourceName}}", "wrap": true },
          { "type": "TextBlock", "text": "{{resourceDescription}}", "wrap": true },
          { "type": "TextBlock", "text": "{{timestamp}}", "wrap": true }
        ]}
      ]}
    ]},
    { "type": "ActionSet", "spacing": "Medium", "separator": true, "actions": [{ "type": "Action.OpenUrl", "title": "Open Approvals", "url": "https://alira.kocho.co.uk/demo/ap/manage/approvals" }] }
  ]
}
Teams Approval Notification
✅
Jane Smith’s request for SharePoint Intranet has been approved!
JSON — Adaptive Card 
{
  "type": "AdaptiveCard", "version": "1.4",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "body": [{
    "type": "ColumnSet", "columns": [
      { "type": "Column", "width": "auto", "items": [{ "type": "Image", "url": "https://png.pngtree.com/png-vector/20250205/ourmid/pngtree-green-check-mark-3d-glossy-icon-tick-symbol-success-choice-correct-png-image_15399016.png", "size": "Medium", "altText": "Approved" }] },
      { "type": "Column", "width": "stretch", "items": [{ "type": "TextBlock", "text": "{{userName}}'s request for {{resourceName}} has been approved!", "wrap": true, "weight": "Bolder" }] }
    ]
  }]
}
Teams Denied Notification
❌
Jane Smith’s request for SharePoint Intranet has been denied.
JSON — Adaptive Card 
{
  "type": "AdaptiveCard", "version": "1.4",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "body": [{
    "type": "ColumnSet", "columns": [
      { "type": "Column", "width": "auto", "items": [{ "type": "Image", "url": "https://png.pngtree.com/png-vector/20250529/ourmid/pngtree-red-cross-mark-png-image_16410570.png", "size": "Medium", "altText": "Denied" }] },
      { "type": "Column", "width": "stretch", "items": [{ "type": "TextBlock", "text": "{{userName}}'s request for {{resourceName}} has been denied!", "wrap": true, "weight": "Bolder" }] }
    ]
  }]
}
Slack Slack Block Kit Example
🔔 Alira Notifications
Type: ap.resource.requested
Jane Smith has requested access to SharePoint Intranet
Justification: Required for Q3 project handover
Open Approvals
JSON — Slack Block Kit 
{
  "blocks": [
    { "type": "section", "text": { "type": "mrkdwn", "text": "*Type:* {{eventType}}\n*{{userName}}* has requested access to *{{resourceName}}*" } },
    { "type": "section", "text": { "type": "mrkdwn", "text": "*Justification:* {{comment}}" } },
    { "type": "actions", "elements": [{ "type": "button", "text": { "type": "plain_text", "text": "Open Approvals" }, "url": "https://alira.kocho.co.uk/demo/ap/manage/approvals" }] }
  ]
}
Further reading: Explore the full Adaptive Cards schema at adaptivecards.io/explorer — and Slack’s Block Kit documentation at docs.slack.dev.
Alira by Kocho © 2025 Kocho Group Ltd · Registered in England & Wales