Frequently Asked Questions

Why am I not receiving emails from Relay?

To make sure you receive emails from Relay, please make sure to add us to your list of safe senders. If our emails don't appear in your inbox at first, please make sure to search from our @teamrelay.co email domain as we may be in your spam/junk folder.

Gmail

  1. If you're using Gmail and see a Relay email in your Spam Folder, it's important to click Report not Spam as shown below.

  2. In addition, we advise creating a filter rule to ensure Relay emails are kept out of the Spam Folder.
  3. On a computer browser, go into your Gmail Search Box and search for @teamrelay.co.
  4. Select the filter button on the right side (circled in yellow).

  5. Click Create filter.

  6. Select the checkbox next to Never send it to Spam.

  7. Select Create filter.

Outlook

  1. If you're using Outlook and see a Relay email in your Junk Email Folder, select Not junk > Not junk (or Not spam > Not spam). You can also open the message and select the It's not junk link at the top.
  2. In addition, we advise adding Relay to your Safe Sender list.
  3. Select Junk > Junk E-mail Options.
  4. Select Safe Senders.
  5. Under Safe senders and domain, select Add.
  6. Enter @teamrelay.co and select Add.
  7. Then select Apply.
Why am I not seeing Chrome banner notifications?

Please note that these notifications will appear for a few seconds and slide away when there are no interactions with them. One way to check all the notifications received while you are away from your computer is to go to the notifications center in the Relay extension. See below:

If you're using Windows

  • Make sure your Focus Assist is OFF

  • Check Chrome Settings

    1. Open a new browser tab in Google Chrome
    2. Type in chrome://flags and hit Enter
    3. Search for "Enable system notifications" (for Chrome version 90 and above) or "Enable native notifications" (for Chrome Version older than 90). In the drop-down menu next to it, select "Disabled".

    4. This will prompt you to restart Chrome. Go ahead and do so.
    5. After restarting Chrome, you should be able to get notifications on your desktop from now on, although they will be in a slightly different style than you are used to.

If you're using MacOS

  • Make sure your Do Not Disturb is OFF

  • Make sure Banner/Alerts notifications are enabled for Chrome

    • Go to Settings > Notifications > select Google Chrome
    • Make sure Banner or Alerts chosen, and "Allow Notifications" is ON
  • Check Chrome Settings

    1. Open a new browser tab in Google Chrome
    2. Type in chrome://flags and hit Enter
    3. Search for "Enable system notifications" (for Chrome version 90 and above) or "Enable native notifications" (for Chrome Version older than 90). In the drop-down menu next to it, select "Disabled".

    4. This will prompt you to restart Chrome. Go ahead and do so.
    5. After restarting Chrome, you'll need to click "Accept Permissions" when you see this prompt

    6. You should be able to get notifications on your desktop from now on, although they will be in a slightly different style than you are used to.
How do I install and log into the Relay Chrome Extension?
  1. Check your email. You should receive an email invitation from Relay to log in.

  2. Finish creating your Relay account. Click the invitation link in your email and complete registering your account. Note: You MUST use the same email used in the Relay invitation.

    • If you received the email to your Gmail account, then you can click Sign in With Google.
    • Otherwise, you'll need to create a password.
  3. Download the Relay extension. You'll be prompted to download the extension once you're logged in by clicking Install Extension. You'll be sent to download it on the Chrome Web Store by clicking Add to Chrome.

  4. Click Add extension when you see the download prompt.

  5. Pin Relay on your browser. Click on the puzzle piece icon (top right corner) and then Click the pushpin icon next to the Relay icon. This will help you see all Relays assigned to you.

  6. Once logged in, you'll see this:

  7. Make sure you have enabled notifications to receive reminders on any outstanding action items.
  8. All new and outstanding Relays will appear on the Relay app indicated with a red badge.
How do I integrate Relay with Okta - SSO?

To connect your Okta organisation to Relay & allow Okta users to login as Relay users, please follow this guide.

  1. Setup an app for Relay to connect to in Okta dashboard
  2. Update the app's config & policy
  3. Assign users/groups to the app
  4. Submit the Okta app's information to Relay dashboard
  5. Login with Okta from Relay

Setup an app for Relay to connect to in Okta dashboard

  1. In your Okta dashboard, navigate to Applications > Applications:

  2. From there, click on Create App Application and fill in as below:

  3. Click Next. It will redirect you to the new app's config page:

  4. Fill in Name & logo you can set as your preference (we suggest you set the name as Relay to make it easy for management). Set Grant type as Implicit (hybrid).

  5. Next, scroll down and fill in the Sign-in redirect URIs as https://dashboard.teamrelay.co/sso/okta. You can also remove the default Sign-out redirect URIs:

  6. Next, in the Trusted Origins section, fill in the Base URIs as https://dashboard.teamrelay.co/. This will allow Relay to send/request data from the Okta dashboard:

    If you don't see this step, see How do I integrate Relay with Okta - SSO > Update the app's config & policy.

  7. Finally, in the Assignments section, you can choose to assign the groups you want to have access to this app:

    Select one:

    • Allow everyone: Everyone in your organization will have access to this app, which means they can all login into Relay with their Okta accounts.
    • Limit access to selected groups: Only allow selected groups to login into Relay with Okta accounts.
    • Skip for now: If you are not sure what to pick, we suggest you pick this option. You can make the assignment later.
  8. Hit Save to end the creation process.
  9. After the app has been successfully created, it will appear in the list of apps in Applications > Applications page:

    To manage the app, you can click on its name & it will bring you into the app's setting page.

Update the app's config & policy

  1. From the app's setting page, click on the Sign On tab. Scroll down and make sure User Authentication policy is set to Password only:

  2. Check if you have added https://dashboard.teamrelay.co to the list of Trusted Origins. From Dashboard > Security > API page, select the Trusted Origin tab and add the link there if it's not there yet:

Assign users/groups to the app

  1. From the app's setting page, click on the Assignments tab:

  2. You can see a table that will list all of the users/groups that you have assigned to this app. To assign new users/groups, click the Assign button. You can choose between assigning individuals and groups:

    For example, if you chose Assign to People, you can select each user you want to use the app:

  3. Okta will prompt you to setup their profile (app-specific, meaning the profile is for this app only) before saving the assignment:

    The fields will be pre-filled with the user's default profile, so if you don't have to make any change, just hit Save & Go Back. This will bring you back to the previous screen (showing list of users to assign). From here, you can assign another user, or hit Done to complete the assignment.

Submit the Okta app's information to Relay dashboard

You can only setup Okta integration in Relay dashboard if you are a Relay manager.

  1. From the dashboard, go to Settings page:

  2. Go to Okta Integration tab:

  3. Here you will need to provide Relay with 3 pieces of data: Domain, Client ID and Client Secret. You can get them from the app you just created in the last step.

    In your Okta dashboard, navigate to the app's setting page:

    The needed data is right in the beginning of the page so you just have to copy them over to Relay dashboard. Relay will prompt you to save the config you just put in, so go ahead and click Save.

    Congrats, you have just successfully integrated Relay with Okta!

Login with Okta from Relay

  1. After integration, assigned users from your Okta organization will be able to login into Relay with their Okta accounts. From the login page, hit Sign-in with Okta:

  2. Users will have to enter their email for Relay to verify first:

    If the email is of a valid account, Relay will prompt them with the complete login form:

  3. Now users can fill in the password & finish the sign-in!
How do I integrate Relay with Okta - Event Hook?

To allow Relay to track the user-base of your Okta organisation, please follow this guide. Make sure you have created a Relay app in the Okta dashboard & provide the needed configuration as instructed in How do I integrate Relay with Okta - SSO.

  1. What does Okta Event Hook do?
  2. Create an Event Hook
  3. Turn on Webhook Autosync feature
  4. (Advanced feature) Create an API token to allow a scheduled autosync of the user-base
  5. (Advanced feature) Turn on Scheduled Autosync feature

What does Okta Event Hook do?

Okta Event Hook will inform Relay of the changes you make to your Okta user-base, such as:

  • Assign/Unassign a user from the Relay app
  • Suspend/Unsuspend a user
  • Deactivate/Delete a user
  • ...

Relay will response accordingly by creating Relay users matched with the Okta ones, or deactivate Relay accounts that are no longer allowed to access the Relay app on Okta. This helps Relay ensure a similar & convenient experience in user management, where Okta is now the single source-of-truth.

Create an Event Hook

  1. In your Okta dashboard, navigate to Workflow > Event Hooks:

  2. From there, click on Create Event Hook and fill in as below:

  3. Click Save & Continue. It will redirect you to the verification dialog:

  4. Click Verify and wait for Okta to verify Relay's endpoint. After verifying successfully, you can see the new event hook appear in the table:

Turn on Webhook Autosync feature

  1. In your Relay dashboard, navigate to Settings > Okta and toggle the Webhook Autosync feature:

  2. Congratulations! You have finished setting up an Okta Event Hook for Relay. You can now test it by making some test changes in your Okta dashboard (e.g. try assigning a test user to Relay app). You can go back and toggle off the feature anytime if you want to pause it.

    However, please keep in mind that the event hook can only track changes from the moment it's created, so existing data will not be synced. In order to sync existing data (e.g. users that have already been assigned to Relay app previously), please see the next section.

(Advanced feature) Create an API token to allow a scheduled autosync of the user-base

  1. In your Okta dashboard, navigate to Security > API > Tokens:

  2. Click Create Token and choose a name you like for the API, then submit. Now copy down the newly-created token & make sure you save it somewhere else, because this will be the only time you are allowed to see it:

(Advanced feature) Turn on Scheduled Autosync feature

  1. In your Relay dashboard, navigate to Settings > Okta. Provide the API token & toggle the Scheduled Autosync feature:

  2. Congratulations! You have finished setting up the Scheduled Autosync feature. Relay will now try to sync Okta & Relay user-base in a scheduled, daily job. You can go back and toggle off the feature anytime if you want to pause it.
How do I integrate Relay with Okta - Group Syncing?

To sync an Okta group from your organisation with a Relay group, please follow this guide. Make sure you have created a Relay app in the Okta dashboard & provide the needed configuration as instructed in How do I integrate Relay with Okta - SSO. Ensure that you have also provided an API token as mentioned in How do I integrate Relay with Okta - SSO > (Advanced feature) Create an API token to allow a scheduled autosync of the user-base.

  1. Update the Event Hook
  2. Sync an Okta group to a Relay group
  3. Unsync an Okta group from a Relay group

Update the Event Hook

  1. In your Okta dashboard, navigate to Workflow > Event Hooks:

  2. From there, click on the name of the Event Hook & add 2 new event types: User added to group and User removed from group.

  3. Click Save & Continue. It will redirect you to the verification dialog:

  4. Click Verify and wait for Okta to verify Relay's endpoint.

Sync an Okta group to a Relay group

  1. In your Relay dashboard, navigate to Workspace > Groups, you should see a Sync With Okta button.

  2. To be able to see this button, you have to configured the Okta config correctly. Clicking on the button will open up this dialog:

  3. What you should know about the 2 actions:

    1. Create a Relay audience: Relay will create new Relay audiences that tracks the selected Okta groups. All Okta users will also be imported (if needed) and appended to the correct audiences. Name of the new audiences will be based on the original Okta groups. For example, an Okta group Testers will be Testers - Okta in Relay.
    2. Append to a Relay audience: Relay will import (if needed) and append the users from the selected Okta groups to an existing Relay audience.
  4. Click Confirm. After Relay has finished processing your request, you should be able to see the newly linked Okta group reflected in the table.

  5. From now on, changes to the linked Okta groups will be reflected in the respective Relay groups.

Unsync an Okta group from a Relay group

  1. In your Relay dashboard, navigate to Workspace > Groups and select a group to view its details. You have to select a group that's linked to an Okta group.
  2. At the bottom of the detail page, you should see a new section Synced with Okta Groups.

  3. Now you can unsync from any Okta group you want. Future changes to the unsynced groups will not trigger any change in the Relay audiences.