Main Header

Excel Online for SignalPress

Updated on July 30, 2026

Use Settings to configure delivery, Routing to select events, Logs to inspect delivery history, and Help for this guide. Routing requires Tier 1; Tier 2 adds request rules. Log visibility, payload previews, and deletion can be delegated separately with Tier 2 role permissions.

Send signals to Excel Online to append rows through Microsoft Graph.

Excel Online is a premium SignalPress service. The active license must include service_excel_online or *.

Hub service ID: excel-online. Index: Integrations Overview. Target from PHP: Service Targeting.

Append SignalPress events to an Excel workbook stored in OneDrive. Each event is written as one row with summary columns and a Payload column containing redacted JSON.

Microsoft connection

Excel Online uses your site's own Microsoft Entra (Azure) app, not a shared SignalPress account. You register an app in Azure, paste the credentials into SignalPress, then connect the Microsoft account that should own the log workbook.

Once connected, SignalPress can:

  1. Browse or create a OneDrive folder where the log workbook will live.
  2. Create the log workbook (SignalPress - {your-domain} - Logs.xlsx) in that folder.
  3. Append rows when SignalPress events are routed to Excel Online.

Each site keeps its own OAuth tokens, folder choice, and workbook. Nothing is sent through SignalPress servers–WordPress talks to Microsoft Graph directly using the credentials you saved.

Setup checklist

  1. Save your application (client) ID, directory (tenant) ID, and client secret (Value) in the Microsoft Entra setup section.
  2. Click Connect Microsoft account and approve access.
  3. Click Select folder or Create folder.
  4. Click Create log workbook.
  5. Enable Excel Online, save settings, and send a Test connection event.

If folder browsing stops working after an update, click Disconnect Microsoft, then connect again so Microsoft refreshes OneDrive permissions.

Send a signal

Send events to Excel Online by name in the services option, or enable routing so matching events reach the workbook automatically.

PHP

sp_capture(
	'order_completed',
	[
		'order_id' => 12345,
		'total'    => 99.00,
		'currency' => 'USD',
	],
	[
		'source'   => 'checkout',
		'services' => [ 'excel-online' ],
	]
);

SignalPress adds one row at the top of the sheet (newest first) with timestamp, event name, project, source, environment, message, and a Payload column containing the full redacted event JSON. Sensitive keys such as passwords and API tokens are redacted before export.

Client secret (Value)

When you create a client secret in Microsoft Entra → Certificates & secrets, Azure shows two columns:

  • Secret ID — a GUID. Do not paste this into SignalPress.
  • Value — a long string shown once when the secret is created. Paste this into the Client secret (Value) field in SignalPress.

If you did not copy the Value when it was created, add a new client secret in Azure and paste the new Value into SignalPress.

Microsoft Entra setup

  1. Open SignalPress → Excel Online → Settings.
  2. Follow the Microsoft Entra setup steps in the integration settings:
  • Create or select an app registration in Microsoft Entra
  • Add a Web redirect URI (copy the redirect URI from SignalPress)
  • Add delegated Microsoft Graph permissions: Files.ReadWrite, User.Read, offline_access
  • Create a client secret (Value) under Certificates & secrets
  1. Paste the application ID, directory (tenant) ID, and client secret (Value) into SignalPress, then save settings.

Most Azure app registrations are single-tenant and require the tenant ID. You can find it on the app registration Overview page in Microsoft Entra. Only use common as the tenant ID if you explicitly configured the app as multi-tenant.

Connect and create the log workbook

  1. Click Connect Microsoft account and approve access.
  2. Click Select folder to browse OneDrive, or Create folder to make a new one.
  3. Click Create log workbook. SignalPress creates SignalPress - {your-domain} - Logs.xlsx.
  4. Enable the integration and save settings again if needed.

Test the connection

Use Test connection on the Settings tab. SignalPress adds a test row at the top of the sheet (below the header).

Workbook layout

  • Row 1 is a header: Timestamp, Event, Project, Source, Environment, Message, Payload.
  • Each new event is inserted on row 2, so the newest entry stays on top.
  • The Payload column contains compact, redacted JSON for the full event properties (Excel’s per-cell limit is about 32,000 characters).

Sensitive payload keys (tokens, passwords, secrets) are redacted before export. Existing workbooks created before this layout was introduced will not show a Payload header until you recreate the log workbook or add the column manually.

Routing

Use the Routing tab to limit which events reach the workbook:

  • Routing Environment — production, staging, development, or local
  • Routing Minimum Level — debug, info, warning, error, critical
  • Include / Exclude Event Patterns and Include Sources — wildcard filters
  • Request Rules (Tier 2) — user, role, and path conditions

Filtered events appear in the delivery log with reason filtered.

Excel Online vs Microsoft Teams

  • Excel Online (this integration) stores event logs in an Excel workbook in OneDrive.
  • Microsoft Teams is a separate SignalPress integration that sends alerts to a Teams channel via a workflow webhook.