Converse 2.0 Conversation API
Close, transfer and look up Converse 2.0 conversations.
Converse 2.0 was formerly known as Moobidesk Enterprise. Hostnames still use the
moobidesk.com domain.
A conversation is the unit of work in Converse 2.0 — the equivalent of a ticket. It groups every message exchanged with one contact on one channel, and carries a status, a queue and an assigned agent.
Authentication
Every request is authenticated with an apiKey / apiSecret pair issued by 8x8 for
your account. Unlike most 8x8 APIs, both are sent as properties of the JSON request
body, not as headers:
{ "apiKey": "your-api-key", "apiSecret": "your-api-secret" }
Treat both values as secrets and never log them.
Obtaining UUIDs
Every operation here needs UUIDs that only your tenant configuration can supply —
dispositionUUID, queueUUID, agentUUID, channelAccountUUID. Retrieve them with the
Converse 2.0 Setup API before calling anything in this API.
Response envelope
All operations return the same envelope:
{ "status": "Ok", "message": "Success" }
{ "status": "Failed", "message": "<error_message>" }
A failed operation is still returned with HTTP 200 and status: "Failed" — check the
status property rather than relying on the HTTP status code alone.
Contact
8x8 Converse 2.0: cpaas-sales@8x8.com