Wave Desktop supports the functions of Wave administrator.

Wave administrator can configure Wave related functions as an enterprise administrator (UCM administrator). Currently, you can configure LiveChat’s Chatbot, view and message records, and enable the third-party integration interface for sending messages.

PREREQUISITES

The UCM administrator should enable the Wave Administrator privileges for the specific extension by accessing the administrator web UI of the UCM, then navigate to Extension/Trunk > Extensions, then on “User Portal/Wave Privileges”, select “Wave Administrator” as shown in the figure below.

OPEN MANAGEMENT PORTAL

Chatbot

To configure the Chatbot feature please refer to the Chatbot Configuration Guide: https://documentation.grandstream.com/knowledge-base/live-chat-chatbot-admin-guide/

Integration

Third-party systems can send notification messages to Wave users through the following interfaces.

For example, the third-party system “Helpdesk” sends notifications to Wave users when there is a new ticket or the ticket status changes, and then the “Helpdesk” system uses the interface to send notification messages to the specified extension or email address.

These extension users can receive notification messages when they log in to the Wave desktop or mobile client, as follows:

Enable Interface Link

To set an Interface Link please follow the steps below:

1. Log in to the Wave client, and the Wave administrator opens the management page in Application > Management Portal > Integration.
2. Click to enable interface link. After enabling, all the following interface links will be valid. Otherwise, all interface links will be invalid.

Add Interface Link

Users can create different interface links for different third-party systems to facilitate the management of the use of third-party systems.

1. Log in to the Wave client, and the Wave administrator opens the management page in Application > Management Portal > Integration.
2. Click “Add” to add a new interface link.

How to Call the Interface

Third-party systems can call the interface link through the following method to send notification messages to Wave users.

Post:

/gsim/notifyingAssistant/:urlToken

Request example:

curl -i /gsim/notifyingAssistant/:urlToken

Header:

Parameter:

Request Parameter Example:

#!/bin/bash

body='{"to":["1001"],"title":"my title...","description":"my description...","data":"{}","target":"208806031344000888888"}';
secret="my_token"; 
signature=$(echo -n "$body" | openssl -sha256 -hmac "$secret"| awk '{print $2}');
curl -X POST -d "$body" -k "https://c074ad2abcd.a.gdms.cloud/gsim/notifyAssistant/0-aae3e891849641069cfc37ea3d677d98-c074ad2a4b5c" -H "X-Hub-Signature-256: sha256=$signature";

Body Example:

{
	"to": [
		"support@test.com",
		"1001"
	],
	"title": "my title...",
	"description": "my description...",
	"messageType": "json",
	"target":"208806031344000888888",
	"data": "{\"TicketID\":\"123456\",\"TicketNumber\":\"654321\",\"ProductMode\":\"xxx\",  \"TicketTitle\":\"[title]\",\"TicketDescription\":\"[description]\",\"MacAddress\":\"[MAC]\",\"Bug\":\"[bug]\",\"TicketURL\":\"[...]\"}"
} 

Response:

Response Parameter Example:

{
     "im": {
          "action": "notifyAssistant",
          "type": "resp",
          "tid": 1709082631725,
          "errorCode": 0,
          "errorInfo": "success"
     }
}

Error Code List:

Edit/Delete Interface Link

1. Log into Wave Desktop client and open the management page in Application > Management Portal Integration
2. Click the button to edit the interface link.Only the APP Name and Token can be edited, and the others cannot be edited.

3. Click on the button to delete the interface. After deletion, the link to this interface will be invalid.

REFERENCES

Live Chat Chatbot Admin Guide

Wave Desktop – User Guide

Live Chat – User Guide