Update the existing solution
Download the currently published app from Downloads & guides. Compare its version with the tenant app catalogue before changing anything. Replace/update the existing solution and retain its solution ID, rather than deploying a second copy.
Review the app’s deployment scope and any updated API requests. Test on a pilot site, then ask users to refresh SharePoint. Keep your previous package for a controlled rollback.
The assistant does not appear
Check that the app is enabled and deployed to the target modern site. For tenant-wide deployment, inspect the Tenant Wide Extensions list. Microsoft notes that activation through that list can take up to 20 minutes.
The floating extension requires the page’s supported Bottom placeholder. Try the SHaiRO Workspace web part on a modern page to distinguish page placement from backend activation.
Awaiting activation or approval unavailable
Open Consent & activation. Confirm Microsoft permissions, verified tenant/site details, client assignment, approval, active client/reseller access and available trial/paid entitlement.
Copy the displayed installation reference. Newly discovered installations need SHaiRO administration to assign them before the reseller can manage them.
Network, CORS or blocked requests
Ask your IT administrator to inspect the failing request’s status and destination in the browser’s Network panel. SHaiRO needs access to its dashboard/API and Microsoft services. Security challenges or origin blocks on service endpoints can prevent onboarding.
Send the exact error, time, site URL, installation reference and package version to support. Redact bearer tokens, cookies and private keys. Do not disable security controls broadly to make one request pass.
A question remains pending
Usage may still be settling after a service interruption. Check the ledger before sending the same question repeatedly. Preserve the request/reference and ask administration to reconcile an ambiguous outcome against trusted usage.
Refreshing during a question can interrupt its display while the server still settles the request. Browser-local history does not guarantee recovery of an interrupted reply.
A file or mailbox result is missing
Check the signed-in account, the approved site/folder, feature toggles, Microsoft delegated permissions and the supported file formats. Scanned PDFs, attachments and shared mailboxes are outside the current supported retrieval path.
If the workspace’s Open workspace link fails, confirm a site owner published SitePages/SHaiRO.aspx in the current web.