Start here
As a clinic owner or admin, open Integrations → Slack, install in your own workspace, choose a channel and events, select Save, then send a test and confirm its arrival in Slack. Invite @Orvexa AI before using a private channel.
1. Install in your clinic workspace
Sign in as a clinic owner or admin, open Integrations, then choose Slack. Select Add to Slack, confirm the intended workspace in Slack, review the requested permissions, and allow the install. Your Slack workspace may require an administrator to approve app installations.
This connects your clinic to its own workspace. It does not invite customers into Orvexa’s Slack channels or another clinic’s workspace. A workspace already linked to another clinic cannot be connected here.
- Return to Slack notifications and confirm the displayed workspace name.
- An unavailable install button means server configuration is missing; contact support without sharing tokens.
- Cancelling or using an expired install link does not complete the connection. Start again from Add to Slack.
2. Choose a public or private channel
In Channel & events, choose the channel where the clinic wants alerts. Public channels can be available without inviting the bot. For a private channel, invite @Orvexa AI in Slack first, then refresh the channel list in Orvexa and select it. Installing the app alone does not give it membership in private channels.
- Use the channel’s Add apps control or /invite @Orvexa AI in Slack.
- If a channel is missing, check the workspace, app membership, and whether the channel is archived, then refresh the list.
- Choose a channel whose membership is appropriate for clinic operational alerts.
3. Save channel and notification preferences
Choose which events to post: Form submitted, Report finished, Report failed, and Integration sync failed. Select Save after choosing the channel or changing event switches. Unsaved changes do not change delivery.
- A connected workspace without a saved channel is not ready for notifications.
- Report finished means generation finished and the report is ready for provider review; it does not mean a provider approved or delivered it.
- Only a clinic owner or admin can change these settings.
4. Send and verify a test message
After saving, select Send test message. This deliberately posts one non-clinical message in the saved channel. Open Slack and confirm Orvexa AI appears in the expected workspace and channel; a saved setting alone does not prove delivery.
- Save any pending changes before testing.
- If posting fails, read the displayed error and confirm private-channel membership and app permissions.
- If a test succeeds but event alerts do not appear, confirm the relevant event switch is saved and that a new matching event occurred.
Reconnect or disconnect
For a revoked token, removed app, or Needs attention status, select Reconnect Slack, authorize the intended workspace again, confirm the saved channel and event switches, and send a fresh test. Reconnecting is an authorization step, not proof of notification delivery.
Disconnect stops this clinic’s connection and attempts to revoke its bot token. To remove the app from Slack itself, use the workspace’s app management controls. Ask the workspace administrator if you cannot manage the installation.
What Slack receives
Notifications contain the event type, form or template name (or integration provider), time, and a link back to Orvexa AI. They exclude patient names, form answers, and report content. Keep patient information out of form and template names because those labels can appear in Slack.
The app requests permission to post messages and list available public/private channels; this notification integration does not request channel-history scopes. Opening a notification link still requires access to the clinic in Orvexa. Slack channel membership does not grant clinic access.
- Use Orvexa for clinical details and provider review.
- For support, share the time and non-sensitive error, never patient records, bot tokens, or OAuth credentials.