Objective

Allow the iAdvize conversation panel to be opened in external tools used by our clients via an iFrame or through the automatic opening of the conversation panel in a new tab.

Use case

Automatic opening of the conversation panel when connecting to the client tool.

(ex: CRM other than Salesforce or Coheris for which we already have connectors).

Process

1. Prerequisite - definition of the user journey (agent)

First, define “functionally” how you imagine things from a “user journey” perspective:

There are three options for users who connect to the client tool to access the iAdvize conversation :

Option 1 : Automatic opening of the conversation panel in a new page/ tab when operators are connected to the client’s tool => solution that would allow them to automatically connect to the iAdvize conversation panel as soon as they arrive in the client’s tool (can be completed with one of the following two solutions).

Option 2 : Open the conversation panel in a <iframe> tag in a tab / category / page of the client tool.

Option 3 : A link/button that leads to a new page/tab.

Then it is important to set whether you expect your users to sign in to iAdvize manually in addition to your other tool.

If so, a simple link to the iAdvize conversation panel would be enough and users will have to enter their identifiers (which will potentially be different from those of the client tool) => time-consuming solution for users

If not, automatically connect them using the SSO provided by iAdvize.

(Save the iAdvize SSO token on the client tool side for each existing user, which you can pass as a URL parameter to access the conversation panel): this will have the effect of automatically connecting them in the iAdvize conversation panel

=> preferred solution - saving time for users

2. Technical operation details of options 2 & 3

Link option:

Clicking on this link will open the conversation panel in a new page or tab. This link will be integrated in the element of the page of your choice (button, text..)

https://ha.iadvize.com/admin/login?key=xxxxxxxxxxxxxxxx

Key = token SSO (see more info above SSO provided by iAdvize)

iframe option:

Very similar to the above option, you can enter the above url in the src attribute of the iframe html tag.

Ex: <iframe src="https://ha.iadvize.com/admin/login?key=xxxxxxxxxxxxxxxx"></iframe>

3. To keep in mind

Screen resolutions: The following recommendations apply to the iFrame dimensions of the iAdvize interface:

The recommended optimal resolution:

Width: 1920px
Height: 930px

The recommended resolution:

Width: 1440px
Height: 750px

The minimum recommended resolution:

Width: 1280px
Height: 650px

Example

Integrate the iAdvize conversation panel into an existing tool