Who can use this feature?
All users
Qwil Messenger enables users to interact with our app user interface to integrate and automate the use of the channel via URL deep links.
Essentially, a user can navigate to a specific part or function of the app via a properly constructed URL. Currently, we support the following deep link URL actions:
- Start a new chat
- Navigate to an existing chat, or message within a specific chat.
- Export a PDF transcript of a chat.
- Export chat attachments.
- Pre-fill a client or staff invitation
- Search in data reviewer
Note: This is a web-only feature.
Security and Usage Considerations:
To use a deep link successfully, the following considerations apply.
- The browser session launched using the URL shortcut is responsible for managing the authentication and permission level access of the user to perform the actions associated with the URL deep link.
- If a user has remembered their credentials via a browser cookie, the user following a deep link will not have to enter any security credentials and the action of the URL link will be performed seamlessly when the link is followed from another application.
- If authentication is required, the link will still work after the details have been entered.
- If a user has authentication access to the app but not the permission levels required to follow the link, then an error in the application itself will be displayed to the user that attempts to follow the link.
How to start a new chat with deep links:
Specific parameters can be used to construct a deep link to start a new chat. New chats must have at least one participant. Optionally, they can have additional participants, a specific chat title and a first message to be automatically sent.
Here is a list of the parameters that can be used to construct a deep link to start a new chat:
To start a new chat, a URL needs to be constructed that complies with the following parameters and formatting conventions:
https://web.qwil.io/web/organisations/[ORGANISATION_UUID]/u/0/chats/create? [IDENTIFIERS(n)=value]&[TITLE=value]&[MESSAGE=value]
Example 1
Create a new chat with Beatrice Wilhelm whose external identifier is C-289878 as a participant.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/u/0/chats/create?identifiers[0]=C-289878
Example 2
Create a new chat with Beatrice Wilhelm and whose external identifier is C-289878 as well as Raj Patel whose external identifier is C-289881 as participants.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/u/0/chats/create?identifiers[0]=C-289878&identifiers[1]=C-289881
Example 3
Create the same chat as above in example 2 but add a bespoke title of “Qwil Demo”.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/u/0/chats/create?identifiers[0]=C-289878&identifiers[1]=C289881&title=Qwil Demo
Example 4
Create the same chat as above in example 3 but add automatically send message text “Hi There”.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/u/0/chats/create?identifiers[0]=C-289878&identifiers[1]=C289881&title=Qwil Demo&message=Hi There
How to Export from a chat with deep links:
The two parameters required to export chat attachments and PDF transcript are:
- [ORGANISATION_UUID] - The unique UUID specific to the Qwil organisation within which the chat exists. Can be found in the URL once logged into the Qwil organisation on web.
- [CHAT] - The unique UUID specific to the chat, can be found in the URL after "Chats/"
To export a chat PDF, a URL needs to be constructed that complies with the following parameters and formatting conventions:
https://web.qwil.io/web/organisations/[ORGANISATION_UUID]/0/chats/[CHAT]/pdf
And to export chat attachments:
https://web.qwil.io/web/organisations/[ORGANISATION_UUID]/0/chats/[CHAT]/zip
Example 1
Download a chat transcript with Beatrice Wilhelm, with chat uuid: 00420cfc-0ab6-4dbc-98ed-7cc98e827059,
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/chats/00420cfc-0ab6-4dbc-98ed-7cc98e827059/pdf
Example 2
Export chat transcripts for the same chat with Beatrice Wilhelm:
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/chats/00420cfc-0ab6-4dbc-98ed-7cc98e827059/zip
How to pre-fill an invitation using deep links:
Specific parameters can be used to construct a deep link to pre-fill an invitation. All fields are optional. When you follow a deep link to fill an invitation, fields will be prepopulated in the invitation modal for you to review them before sending out the invitation.
Here is a list of the parameters that can be used to construct a deep link to pre-fill an invitation:
To pre-fill an invitation, a URL needs to be constructed that complies with the following parameters and formatting conventions. All values are optional:
https://web.qwil.io/web/organisations/[ORGANISATION_UUID]/0/profile/clients/create? [FIRSTNAME=value]&[LASTNAME=value]&[EMAIL=value]&[PHONENUMBER=value]&[IDENTIFIER=value]
Example 1
Create a client invitation for Beatrice Wilhelm using her email beatrice@example.com.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/profile/clients/create?firstName=Beatrice&lastName=Wilhem&email=beatrice@example.com
Example 2
Create a client invitation for Beatrice Wilhelm using her email beatrice@example.com and identifier C-3509.
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/profile/clients/create?firstName=Beatrice&lastName=Wilhem&email=beatrice@example.com&identifier=C-3509
Example 3
Create a staff invitation for Jeremy Sanders using his email jeremy@example.com, phone number +447788998877 and job title Relationship manage
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/profile/staff/create?firstName=Jeremy&lastName=Sanders&email=jeremy@example.com&phoneNumber=+447788998877
How to use deep links with data reviewer:
Specific parameters can be used to construct a deep link to find conversations in data reviewer. You must have data reviewer permission to access the functionality via a deep link. According to your permission level, certain fields may be mandatory.
- For level 1 & 2 you must provide at least one participant or one chat uuid.
- For level 3 all fields are optional.
When you follow a deep link with data reviewer search parameters, the data reviewer page will be loaded with your filtering fields populated.
To search in data reviewer, a URL needs to be constructed that complies with the following parameters and formatting conventions.
https://web.qwil.io/web/organisations/[ORGANISATION_UUID]/0/audit/[PARTICIPANTS=%5Bvalue%5D]=true&[SENDERS=%5Bvalue%5D]=true
Example 1
Find a chat with Beatrice Wilhem (UUID 003903f1-0150-4874-ab36-f5d37f1e6411) as participant and Chris Donaldson (UUID 00390ef6-e0a2-4921-95a8-321d96c92dd8) as a sender
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/audit?participants%5B003903f1-0150-4874-ab36-f5d37f1e6411%5D=true&senders%5B00390ef6-e0a2-4921-95a8-321d96c92dd8%5D=true
Example 2
Find a chat with Beatrice Wilhem (email beatrice@example.com) and filter by attachments only
https://web.qwil.io/web/organisations/00360470-ef19-40e2-be01- c058293dc29b/0/audit?participantEmailss%5Bbeatrice@example.com%5D=true&attachments=true