4.8.2 Создание закрытого обращения

/cc/appeals/create-closed-appeals

Этот обновленный метод позволяет создавать обращение в КЦ сразу в статусе "Закрыто". При этом, в поле "Ответственный" данного обращения будет указан системный пользователь, от имени которого отправляются запросы.

Данный метод вы можете применять, к примеру, чтобы добавить в КЦ информацию о ранее состоявшейся коммуникации с Клиентом через Telegram.

Параметры метода:

№ Параметры с уровнем вложенности Параметры с уровнем вложенности Параметры с уровнем вложенности Тип Обяза-тель-ное Описание
№ 1 2 3 Тип Обяза-тель-ное Описание
1 product_id integer Да ID продукта, обязательное(для событий на шине), числовое
2 channel_type integer Да Канал обращения. Значения 0-10: 0 – неизвестно, 1 – звонок, 2 – Site, 3 – VK, 4 – Facebook, 5 – Viber, 6 – Telegram, 7 – SMS, 8 – Email, 9 – WhatsApp, 10 - yandex dialogs
3 direction integer Да Направление обращения: 0 – входящее, 1 - исходящее
4 entry_point String Да Точка входа обращения
5 create String Да Дата/время создания обращения
6 end String Нет Дата\время завершения обращения
7 tag_id String Нет Тематики обращения
8 comment String Нет Комментарий к обращению
9 rate integer Нет Оценка обращений по шкале от 1 до 5. Возможные значения: 1, 2, 3, 4, 5.
10 result integer Да Результат обращения. Важно, при значении меньше, либо равно 0, результат обрабатывается как 1 (обработано). Возможные значения: 1 - обработано 2 - переведено 3 - истекло время ожидания ответа 4 - не отвечено 5 - спам 6 - отправка запрещена
11 assign_user_id integer Нет ID сотрудника (abonent_id), назначенного на обработку обращения
12 close_user_id integer Нет ID сотрудника (abonent_id), закрывшего обращение
13 group_id String Нет ID Группы, на которую было распределено обращение
14 chat Object Нет История переписки
14.1 text String Нет Текст сообщения
14.2 time String Нет Время отправки сообщения
14.3 sender String Нет Имя отправителя
15 client_info Object Нет Информация о клиенте
15.1 name String Нет Имя клиента
15.2 phone String Нет Номер телефона
16 contact Object Нет Информация о контакте
16.1 source_id Object Нет Информация о пользователе в соц. сети
type String Нет Тип источника (vpbx, amo, exch, google...)
index integer Нет Номер источника
16.2 contact_id String Нет ID контакта в разрезе источника

Пример запроса:

POST https://app.mango-office.ru/vpbx/cc/appeals/create-closed-appeals

vpbx_api_key = 1234567890qwerty,
sign = 1234567890qwerty,
json =

{
    "channel_type": 0,
    "direction": 0,
    "entry_point": "string",
    "create": "1642667259",
    "end": "1642667259",
    "tag_id": 0,
    "comment": "string",
    "rate": 1,
    "result": 1,
    "assign_user_id": 0,
    "close_user_id": 0,
    "group_id": "string",
    "chat": {
        "text": "string",
        "time": "1642667259",
        "sender": "string"
    },
    "client_info": {
        "name": "string",
        "phone": "string"
    },
    "contact": {
        "source_id": {
            "type": "string",
            "index": 0
        },
        "contact_id": "string"
    }
}

В результате обработки запроса, формируются и передаются JSON-данные, содержащие следующие параметры:

№ Параметр Тип Обяза-тель-ный Описание
1 result Результат выполнения запроса; - 1000 - удачное выполнение; - 3100 - переданы неверные параметры команды; - 31хх - неверные параметры; - 3300 - объект не существует; - 5xxx – ошибка сервера
2 appeal_id integer ИД обращения

Пример ответа:

{
    "result": 1000,
    "appeal_id": 14136224
}
Предыдущая