Відправка Viber з зображенням та кнопкою

Приклад запиту для відправки Viber-повідомлення із зображенням та кнопкою, при натисканні на яку буде здійснено перехід на вказане посилання.

URI: /api/xml.php

Усі запити до API надсилаються у форматі XML за допомогою методу POST.

Параметри запиту

packagetagобов'язковий Тег для передачі облікових даних, необхідних для авторизації keyattribute | varcharобов'язковий Ваш API-ключ, який можна отримати в особистому кабінеті message-vibertagобов'язковий Тег, який визначає тип запиту msgtag Тег повідомлення idattribute | integer Числовий ідентифікатор повідомлення користувача. При використанні користувач повинен переконатися, що цей ідентифікатор є унікальним в межах його акаунта phonetag | varchar(21)обов'язковий Номер телефону одержувача повідомлення sendertag | varchar(11)обов'язковий Підпис у повідомленні typetag | stringобов'язковий Тип повідомлення: text - звичайне повідомлення image - повідомлення з зображенням button - повідомлення з зображенням і кнопкою texttagобов'язковий Текст повідомлення в кодуванні UTF8 buttontagобов'язковий Підпис, який буде відображатися на кнопці Від 1 до 19 символів urltagобов'язковий Посилання, за яким буде здійснено перехід після натискання кнопки або зображення imagetagобов'язковий URL-адреса зображення Формат зображення: .jpg .jpeg .png .gif

Приклад запиту

<?xml version="1.0" encoding="utf-8" ?>
<package key="bb56a4369eb19***cfec6d1776bd25">
    <message-viber>
        <msg id="1234">
            <phone>+380971234567</phone>
            <sender>SMSTest</sender>
            <type>image</type>
            <text>Текст повідомлення що буде надіслано через Viber</text>
            <button>Caption</button>
            <url>https://page.url</url>
            <image>https://image.url/image.png</image>
        </msg>
    </message-viber>
</package>

Параметри відповіді

packagetag Тег для передачі облікових даних, необхідних для авторизації messagetag Тег, який визначає тип запиту msgtag Тег повідомлення. Статус повідомлення повертається як параметр idattribute | integer Числовий ідентифікатор повідомлення користувача msg_idattribute | integer Числовий ідентифікатор повідомлення, призначений шлюзом

Приклади відповіді

Успішний

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

<?xml version="1.0" encoding="utf-8" ?>
<package>
    <message-viber>
        <msg id="1234" msg_id="1234568">1</msg>
    </message-viber>
</package>

Невірний ідентифікатор повідомлення

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

<?xml version="1.0" encoding="utf-8" ?>
<package>
    <message-viber>
        <msg id="7777" msg_id="0">201</msg>
    </message-viber>
</package>