The OneCloud CX Mobile/Web Messaging API v2 is a RESTful API that allows developers to integrate chat and voice interactions with mobile devices or third-party applications. The CX Mobile/Web Messaging API v2 expands on our existing Mobile/Web Messaging API v1, and can be used for development of rich contact applications, such as customer-facing mobile, web, and messaging applications for advanced chat, voice, and video communications with OneCloud Contact Center-based contact centers.

Features

In addition to all the methods and events included in the v1 API, the Mobile/Web Messaging API v2 includes the following:

• Support for the Apple Push Notification service (iOS) and Firebase Cloud Messaging push notifications (Android and iOS) with the Mobile Notification Subscription method
• The Get Case History method, which returns the combined transcripts of all chat sessions linked to a specific CRM Case object
• The Close Case method, which allows a client application request to close the case associated with the chat session
• The Get Version method, which returns the version of Bright Pattern Contact Center used on the server.
• Server and client events indicating that a chat session message was delivered or read
• A server event indicating if a chat session case was set

Note

The CX Mobile/Web Messaging API v2 endpoint prefix is as follows:

https://[tenant_url]/clientweb/api/v2/

Audience

This documentation is intended for the IT personnel and developers of custom applications for Bright Pattern Contact Center-based contact centers. Readers of this documentation are expected to have expertise in web and mobile application development as well as a solid understanding of contact center operations and resources that are involved in such operations.

Sample Applications

OneCloud provides source code of sample customer-facing rich contact applications. This source code can be used as a reference for in-house application development or it can be embedded directly into the customer-facing mobile applications and/or web applications of your organization.

For web chat applications, you can download the source code by clicking the Client application button on the Messaging/Chat Scenario Entry page of the Contact Center Administrator application.

For mobile applications, you can obtain the source code by submitting a service request to OneCloud Success Management.

Example Request

The following is an example of an API request:

URL: https://tenant.cx.onecloud.com/clientweb/api/v2/chats?tenantUrl=yourcompany.brightpattern.com
Method: POST
Authorization: MOBILE-API-140-327-PLAIN appId="test", clientId="123"
Content-Type: application/json; charset=UTF-8
User-Agent: MobileClient
{
    "phone_number":"3001",
    "parameters": {
        "first_name":"John",
        "last_name":"Lee"
        }
}

Client Authentication Elements

The following elements are used for client authentication and must be specified in every client request:

Additional Information

Standard HTTP response codes whose meaning conforms to the original specification (RFC 2616) are not discussed in this document. For specification of such responses, see section 10 of http://www.ietf.org/rfc/rfc2616.txt. This document only specifies the response codes whose description deviates from the original specification (e.g., is defined more narrowly or has a different meaning).

Note: A client application can only have one active communication session at a time.

Error Body

When the response status code indicates an error, a JSON response body is provided by the server to
give more details about the error:
{"error_code": "error code", "error_message":"error message"}

Authorization Errors

Here is a list of the possible values of authorization-related error codes and error messages that are
common to all requests that require authorization.

Other Errors

Here is a list of the possible values of other error codes and error messages.