Skip to main content

Conversation Hook | Functional specifications

Work in progress - Conversation Hook to be released in v 4.6.1 / End Q2 2023

General purpose

This article describes the general operation of conversation hook, i.e. the principle according to which an ambassador will proactively offer his help to visitors online on the site. It replicates the in-store experience where a salesperson can offer advice to a visitor who has been looking at items for a few minutes.

Customers are identified as being the most likely to buy based on their browsing history on the site, such as the time spent and the number of pages visited.

When an ambassador wishes to do so, and if there are no pending conversations on the site, he or she will be able to offer help to site visitors.
The visitors most likely to buy will then be offered a personalised conversation with the ambassador. If the visitor accepts, they can enter the conversation directly.

Collecting browsing data

Browsing data is collected by the Community Widget, and locally stored in the browser’s local storage.

Browsing data is then sent to Popsell services as soon as the client has visited at least 3 different pages. Visitors who only viewed 1 or 2 pages are considered as unrelevant and won’t be solicited.

Data is sent on page load. Information collected is:

  • URL visited (Core URL without any parameter)

  • Time stamp (Date/time) of arrival on the page

  • Page description and main picture URL

The description and picture URL are not collected in current version; planned for a future release, in order to display to the ambassador a history of the pages visited

Data older than 7 days is deleted.

Note that not all site browsing will be tracked if the widget is not installed on every page.

No IP address or other personal information is collected.

All browsing data is stored in memory only, never recorded in a database.

Sorting visitors in a “Hot List”

Browsing data is then gathered in order to determine, for each visitor:

  • The total number of pages visited.

  • Total duration of visit, measured by capping the time spent on each page at 120 seconds.

Thus, visitors can be sorted according to their activity on the site and the chances of them being receptive to having a conversation with an ambassador.

Sorting rule = (number of pages * 60 + total duration in sec)

Trigerring rules

Once an ambassador activates the conversation hook process, the visitor number 1 in the “Hot List” is hooked for instance during 15 seconds. If he/she does not respond, or closes the widget, then visitor number 2 is contacted, and hooked during 15 seconds, etc.

  • Only visitors with an active connection (Socket) are solicited.

  • Only visitors without a conversation history are solicited.

  • Visitors are marked as hooked so they are not solicited more than once.

Hook widget interface

  • The conversation hook feature is part of the Community Widget, so it is available on all pages that embed this Community Widget.

  • When a client is solicited, the photo of the ambassador and a bubble with his message appear from a transition from the community widget tab.

  • 1 message, or 2 consecutive messages can be displayed in the bubble. These messages are not written by the ambassador, they are automatically generated.

  • These messages are not personalised in relation to the visitor's navigation, so as not to give the impression that they are being watched and not to be too intrusive.

3 cases can occur:

  1. The visitor can close the widget by clicking on the X button.
    On the ambassador's view, the hook process is immediately interrupted and switches immediately to the next visitor in the hot list.

  2. If the visitor does nothing, the hook widget disappears after 15 seconds.
    On the ambassador’s view, the process switches to the next visitor in the hot list.

  3. If the visitor clics on the bubble or on the ambassador photo, a conversation window is immediately opened which includes the first 1 or 2 automatic messages. The visitor and the ambassador can start chatting.
    The hook process is interrupted.

In all cases, the photo in the Widget tab remains that of the ambassador who made the hook.

Ambassador App interface

The conversation hook feature can be accessed from the conversation waiting list page. This feature is only available to ambassadors when the waiting list is empty: priority is given to customers who have requested a conversation themselves.

Should there be no relevant visitors in the “Hot List”, the button is hidden, and an information message is displayed.

When the hooking process is started, a counter displays the number of customers contacted. A button allows the ambassador to stop the process at any time.

The process is triggered by series of 8 attempts (maximum 8*15 sec = 2 minutes), and stopped if no visitor takes the hook. The ambassador can re-trigger a process afterwards if he or she so wishes.

Access control to the conversation hook can be defined according to the ambassador's role.

In version 4.6.1 (MVP), role Access control will not be implemented, temporary replaced by a hard-coded ambassador control.


  • Conversations from the hooking process are identified in the database, thus enabling to differentiate them in the dashboards.
    There are therefore 3 types of conversations :

    • Conversations via the Waiting List

    • Direct conversations

    • Conversations hooked

  • History of the hooking process is stored in the Popsell databases, to enable analysis of:

    • number of times the process has been triggered (i.e. number of times an ambassador has clicked to launch the hooking process)

    • number of visitors canvassed (i.e. number of times the widget has been displayed to a site visitor)

    • number of conversations and dialogues established through a hook.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.