Viber 2 Way message status

Example of request to receive Viber 2 Way message status. Viber 2 Way service is designed to get feedback on a message from a consumer.

URI: /api/json.php

All requests to API are sent in JSON format using the POST method.

Header parameters

Requests must contain header Content-Type: application/json, otherwise, the request will be considered invalid even if it has valid JSON.

Request parameters

authstringrequired Your API key, which can be obtained in your personal cabinet

datalist[object]required List of objects with request parameters typestringrequired Request type idnumberrequired Unique message identifier in the client system

Request example

{
    "auth": "bb56a4369eb19***cfec6d1776bd25",
    "data": [
        {
            "type": "status",
            "id": 100500
        }
    ]
}

Response parameters

successinteger Result of request execution

errorstring Error text, returned if success=false

datalist[object] List of objects with the results of request execution successboolean Request execution result returned in the data packet dataobject Request execution result idnumber Unique message identifier in the client system typestring Message type: sms, viber, rcs statusstring Current message status (see Message statuses reference) replieslist[object] List of replies to the message datetimestring Date and time of receipt of the response Format: YYYYY-MM-DDThh:mm:ss±hh:mm messagestring Text of message mediaobject Object containing information about the media file attached to the message urlstring Link to media file filenamestring Media file name filesizenumber Media file size

Response examples

Successful

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": true,
    "data": [
        {
            "success": true,
            "data": {
                "id":10500,
                "type": "viber",
                "status": "REPLIED",
                "replies": [
                    {
                        "datetime": "2022-05-01T12:01:02+03:00",
                        "message": "Please wait"
                    },
                    {
                        "datetime": "2022-05-03T14:21:17+03:00",
                        "media": {
                            "url": "https://url.com/home/vibermedia/",
                            "filename": "invoice.pdf",
                            "filesize": 67983
                        }
                    },
                    {
                        "datetime": "2022-05-03T14:21:17+03:00",
                        "message": "Correct invoice",
                        "media": {
                            "url": "https://url.com/home/vibermedia/",
                            "filename": "invoice.pdf",
                            "filesize": 68934
                        }
                    }
                ]
            }
        }
    ]
}

Access denied

HTTP Status Code: 200
Content Type: JSON application/json

{
    "success": false,
    "error": "Access denied"
}