Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mycelium-ai.co/llms.txt

Use this file to discover all available pages before exploring further.

Microsoft 365 uses a webhook receiver (paid runtime) via Microsoft Graph change notifications.

​
Webhook receiver (paid runtime)

POST /webhooks/microsoft365/{tenant_id}
Signature: Microsoft Graph validates webhook endpoints with a validationToken challenge on subscription creation. Ongoing notifications arrive with a client state token that the receiver validates.

​
Setup

  1. Register an Azure AD application with Microsoft Graph API permissions:
    • ChannelMessage.Read.All (Teams messages)
    • Mail.Read (Exchange mail)
    • Sites.Read.All (SharePoint)
    • Files.Read.All (OneDrive)
  2. Create Graph change notification subscriptions pointing to https://runtime.myceliumai.co/webhooks/microsoft365/{your_tenant_id}.
  3. Add to the runtime env:
    • MS365_TENANT_ID_{TENANT_ID}
    • MS365_CLIENT_ID_{TENANT_ID}
    • MS365_CLIENT_SECRET_{TENANT_ID}
    • MS365_CLIENT_STATE_{TENANT_ID} (random secret for notification validation)
Graph subscriptions expire every 60 minutes for most resources; the runtime renews automatically.

​
Events ingested

M365 surfaceMemory categoryNotes
Teams channel msgfactThread context, mentions, reactions
Teams chatfactDirect messages and group chats
Exchange mailfactSender, subject, body excerpt
SharePoint pagefactPage edits captured on save
OneDrive filefactFile create/modify events; content not stored

​
Retry behavior

Failed deliveries land in the per-tenant dead-letter folder. Replay via: 
POST /admin/webhooks/replay/{tenant_id}/{event_id}