Introduction
The CINNOX Open API Reports provides endpoints to retrieve detailed records from the CINNOX database related to your CINNOX service account.
Such as:
| API Endpoint | Description | Remark |
|---|---|---|
| Get Enquiry details | This endpoint allows you to query all enquiry details such as the enquiry ID, status, visitor name, label ID, enquiry duration, deep link and others. | The current version supports the following enquiry channels: - Tag / Directory - Web link - Campaign - Virtual Number - Facebook Messenger - LINE - WOZTELL - Third Party Channel |
| Get Enquiry chat details | This endpoint allows you to query closed enquiry - chat history between the staff and the visitor. | You can only query one closed enquiry - chat history at one time. |
| Get Call details | This endpoint allows you to query all 1-on-1 call details such as the caller, called party, call duration and others. | |
| Get Conference details | This endpoint allows you to query all conference call details such as the host, participants, call duration and others. | |
| Get Recording File details | This endpoint allows you to query the recording files of the recorded 1-on-1 calls or conference calls. | You can query one or more call recording files at one time. |
| Get SMS details | This endpoint allows you to query SMS details such as the staff sender, sender address, recipient and others. | |
| Get Enquiry Overview matrix | This endpoint allows you to query the enquiry overview matrix details. These includes the total number of received inquiries, the total number of ongoing enquiries, the total number of missed enquiries, and others. | You can query up to 90 days of the overview matrix data. |
| Get Channel Type list | This endpoint allows you to query the list of supported channel types. | |
| Get Channel Type details | This endpoint allows you to query the list of supported channel type details. | The current version supports the following channels: - Directory - Web link (*Coming soon) - Campaign - Virtual Number - Facebook Messenger - LINE - Third Party Channel |
| Create/Edit/Delete Enquiry event subscription | This endpoint allows you to create a new webhook event or edit the subscribed event for an application. And also allow you to delete the enquiry event under your application account. | The event hook will return the enquiry information when it triggers the events below: - When there is a new incoming enquiry. - When the enquiry status changed (Status: Open, Handling, Missed and Closed). |
Please be noted that the recording file download URL does not have any permission control. Please do not share it with any unauthorised third party.
CINNOX Open API support up to 500 requests per min per service account.