Skip to content

Notifications & Integrations

Aimee.ai can send real-time notifications to your team's chat channels when important events happen — such as a learner completing an assignment or a new course being published.

Accessible to: Workspace Owners and Admins

Supported Providers

Provider Format How It Works
Microsoft Teams Adaptive Card v1.4 Rich cards with facts, scores, and action buttons delivered via Incoming Webhook
Slack Block Kit Structured messages with headers, fields, and buttons delivered via Incoming Webhook
Webhook (Custom) JSON + HMAC Raw JSON payload with X-Aimee-Signature HMAC-SHA256 header for verification

Supported Events

Event Trigger Information Included
Assignment Completed Learner finishes a scored session Learner name, course title, score, pass/fail, debrief link
Assignment Created Admin assigns a course to a learner Learner name, course title, due date
Course Published Admin publishes a new course version Course title, version label, block count

Setting Up a Notification Channel

Navigate to Settings → Integrations → Chat Notifications.

Microsoft Teams

  1. In Microsoft Teams, go to the target channel
  2. Click ⋯ → Workflows → choose "Post to a channel when a webhook request is received"
  3. Follow the wizard and copy the generated webhook URL
  4. In Aimee.ai, click Add Channel → select Microsoft Teams
  5. Paste the webhook URL and give it a name (e.g. "Training Alerts")
  6. Click Add Channel

Slack

  1. Go to api.slack.com/apps and create a new app (or select existing)
  2. Enable Incoming Webhooks under Features
  3. Click Add New Webhook to Workspace and select a channel
  4. Copy the generated webhook URL
  5. In Aimee.ai, click Add Channel → select Slack
  6. Paste the webhook URL and click Add Channel

Custom Webhook

  1. Set up an HTTP endpoint that accepts POST requests
  2. In Aimee.ai, click Add Channel → select Webhook (Custom)
  3. Paste your endpoint URL and click Add Channel

Webhook Security

Custom webhooks include an X-Aimee-Signature header containing an HMAC-SHA256 signature of the request body. Use the webhook secret (shown when creating the connection) to verify the signature and confirm the request came from Aimee.ai.

Event Filtering

By default, a channel receives all events. To subscribe to specific events only:

  1. When adding a channel, select the events you want from the toggle buttons
  2. Leave all deselected to receive everything

Managing Channels

Each channel in the list shows:

  • Provider icon and name
  • Webhook URL (truncated)
  • Event badges — which events are subscribed (if filtered)

Available Actions

Action Description
Toggle (green/grey switch) Enable or disable the channel without deleting it
Test Send a sample notification to verify the webhook is working
Delete (trash icon) Permanently remove the channel

Card Simulator

The built-in Card Simulator lets you preview exactly how notifications will appear in each provider — without sending any real messages.

  1. In the Chat Notifications panel, find the Card Simulator section
  2. Select a provider (Teams, Slack, or Webhook)
  3. Select an event to preview
  4. See a visual rendering of the card

Tip

Use the simulator to verify your setup before going live. The Teams preview matches Adaptive Card Designer, and the Slack preview matches Block Kit Builder.

Delivery & Reliability

All notifications are queued for reliable delivery:

  • 5 delivery attempts with exponential backoff (30s, 60s, 2m, 4m, 8m)
  • Each delivery attempt is logged in the integration events audit trail
  • Failed deliveries do not block platform operations (fire-and-forget)

CRM Webhooks

In addition to chat notifications, the CRM Webhooks section (also under Integrations) allows you to send raw event data to external CRM systems. These use HMAC-signed JSON payloads and are useful for triggering automated workflows in tools like HubSpot, Salesforce, or custom platforms.

See the API Documentation for the full webhook payload schema.