Telerecovery Initial Video Provider Setup
RecoveryLink has transitioned to optional integrations for telerecovery video that allows for our customers to integrate their preferred video providers (Zoom, Google Meet, or Microsoft Teams), versus only using the telerecovery solution built on Twilio. For customers that have telerecovery enabled, enterprise administrations will need to follow initial setup steps for each of their service organizations to have the option to use their enabled and preferred video providers within the RecoveryLink application for video engagements with participants. The following guide provides an overview for this enterprise setup:
Zoom Configuration Guide
- Navigate to Zoom Marketplace: Open your web browser and go to the Zoom Marketplace.
- Sign In: Log in with your Zoom account credentials. Please note this should be an admin account which has permissions to access the app marketplace.
- Create a New App: Once logged in, navigate to the "Develop" dropdown menu in the top right corner and select "Build App". This option is for creating apps that require server-to-server interactions without user interaction.
- Choose App Type: You will be directed to a page where you can select the “General App” option. Fill in the necessary information for your app, including its name, a short description, and other relevant settings.
- App Type Settings: Select User-managed as the app management type. This setup allows individual users within your organization to grant permissions for meeting creation without requiring the app to be installed at the account level.
- Fill Out App Information: Complete all required fields with details specific to the app. This will include naming the app and providing a description that clearly explains its functionality and purpose.
Configure Your Server-to-Server OAuth App
- Set Up App Credentials: Zoom will generate a Client ID and Client Secret for the app. These credentials are crucial for authenticating your application with Zoom's API and must be stored securely. Please make sure when inputting the Client ID and Client Secret into RecoveryLink setup screens, that you use the Client ID and Client Secret from the "development" portion of the new Zoom app.
Configure Redirect URL (OAuth Redirect URL):
Add the URIs where users can be redirected after accepting consent: https://trs-prod.microservice.myrecoverylink.com/Zoom/callback
3. Add features: You don’t need to do anything on this page and may skip.
4. Configure Scopes: Scopes define the permissions your app will have. The only scope to be set is: meeting:write:meeting
- Add your app: No need to do anything in this section. The app is ready. There’s no need to publish it since it’s an internal app
Documentation Links
Google Meet Configuration Guide
To set up a Google Account for creating calendar events with Google Meet conferences on behalf of a user, follow the steps below. This process involves creating a project in Google Cloud, enabling the Calendar API, configuring the OAuth Consent Screen, and creating an OAuth 2.0 Credential within that project.
Step 1: Create a New Project in Google Cloud
- Go to the Google Cloud Console.
- Sign in with the Google Account if prompted.
- Click on Select a project at the top of the page
- If there's an existing project, select it from the list or click on New Project to create a new one.
Step 2: Enable the Calendar API
- Go to the APIs & Services in the Google Cloud Console.
- Click + ENABLE APIS AND SERVICES.
- Search for "Google Calendar API" and select it from the list.
- Click Enable to enable the API for your project.
Step 3: Configure the OAuth Consent Screen
The OAuth Consent Screen is what the admin user will see when he is asked to grant the application access to their Google data.
From the sidebar, go to APIs & Services > OAuth consent screen.
Configure the Consent Screen
User Type: Choose whether your application will be available to external users or just within your organization (Internal).
Click on Create.
Fill Out the Consent Screen Details
- App information: Provide the app name, user support email, and developer contact information.
- App logo: Optionally, upload a logo for your app.
Authorized domains: Add domains that will be used for OAuth redirection.
Application Homepage link, Application Privacy Policy link, and - Application Terms of Service link (if applicable).
Add Scopes
Under Scopes for Google APIs, click Add or Remove Scopes.
In the Add scopes dialog, search for and/or add the following scopes:
- https://www.googleapis.com/auth/calendar (required)
- https://www.googleapis.com/auth/admin.reports.audit.readonly (optional - for viewing meets data)
Click Update after adding the scopes and then Save and Continue.
Save and Submit for Verification
- Once all details are provided, click Save and Continue to review all the details.
Step 4: Create OAuth 2.0 Credentials
- Navigate to Credentials
In the Google Cloud Console, go to APIs & Services > Credentials.
Create Credentials
- Click Create Credentials at the top of the page.
Select OAuth client ID.
Configure OAuth Client ID
- Application type: Choose the appropriate type for your application, e.g., Web application.
- Name: Enter a name for your credentials.
Authorized JavaScript origins: Add URLs that are allowed to host your application.
Authorized redirect URIs: Add the URIs where users can be redirected after authentication.
Create and get Credentials
- Click Create. Copy the client ID and client secret and paste this information in the setup window of RecoveryLink.
Step 5: Enable/Configure Google Meet audit logs
(Optional - If admin.reports.audit.readonly scope was selected)
Accessing Google Meet audit logs through Google Workspace can provide detailed information about the usage of Google Meet, including actual meeting durations, participants, and other relevant data.
Enable Audit Log in Google Workspace
- Go to the Google Admin Console.
- Navigate to Reporting > Audit and investigation > Meet log events.
- Check if Meet logging is enabled. If not, you may need to configure or will allow it depending on your specific admin settings.
Documentation Links
- Google Cloud Console
- https://cloud.google.com/iam/docs/creating-managing-service-accounts
- https://developers.google.com/calendar
- https://support.google.com/a/
Microsoft Teams Configuration Guide
Please contact RecoveryLink support at support@myrecoverylink.com for detailed instructions and guidance in integrating microsoft teams. Please note that Teams integration is complex and requires additional steps and is not the preferred recommended integration provider.