1. Overview
  2. Invitations

1 Overview

To establish communication with another user (chat or video/audio) we can either:

  • Search for them and open direct communication
  • Add them to a space
  • Create a space and invite them to it

It is important to note that that we can only search for users that are members of the same organization as us or that are in a space with us. To communicate with users outside our organization we must send them an invite link to join a space with us.

2 Invitations

In Avaya Spaces, a member or admin can invite others to a space. Each space has a unique ID, passed to invitees through a URL link, such as https://spacesapis.avayacloud.com/spaces/invites/590b2342340466e51c2fd3c/join?inviteInfo=eyJzcGfsdxxxx.

The invite URL for a space is (usually) passed to invitees via email. There are two options for this:

  1. Emailing from the Avaya Spaces server: let Avaya Cloud take care of the email invites.
  2. Emailing from another server: you can call the API to get invitation data and send the invitation email by yourself.

Each invitee receives the same invitation link, which easily brings them to the space. The following scenarios may occur:

  1. The user is logged in to Avaya Cloud Accounts. The user's browser must present an authenticated session cookie/Avaya Spaces JWT. This is the simplest case, allowing users easy access to the space.
  2. The user is not logged in to Avaya Cloud Accounts. Avaya Spaces will direct the browser to a login page, allowing invitees to join as a user (requiring a login or signup) or as a guest (anonymous).

Should the user choose to join anonymously, their browser will call the anonymous login API to recieve a JWT. All further REST API calls will have that token in the HTTP authorization header.

To log into Avaya Cloud Accounts, the user can type their username and password or use SSO (google/office365/salesforce). Be careful- even after the user has logged in successfully, their email might not be on the invitation list, in which case they should be treated as an anonymous user.