логотип CLOFF

API для интеграции

1. Постановка задачи

Для постановки задачи автоинформирования необходимо вызвать скрипт www.cloff.ru/api/ai.task.set.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
algid ID шаблона обзвона (см. Сервисы->Автоинформатор->Мои шаблоны поле №)
dtstart Дата и время запуска задачи (в случае отсутствия - текущее время)
csv_file Файл с номерами для обзвона каждая строка содержит 1 запись следующего формата: 88121112233;DESCR;TIME;FILEID;VOICEID;VOICETEXT;DIALTIMEOUT;DTEND;DTDIFF;CLIID;CCPHONE;ANI; OPGROUPID
Обязательным полем является только первое – номер для обзвона в формате 8XXXYYYYYYY для номеров РФ и 810ZZZZZZZZZZZ для международных номеров

Остальные поля:

DESCR описание (можно указать 2 значения, разделив их символом ~ тильда)
TIME дата и время обзвона номера, например 2011-07-18 14:30:00
FILEID идентификатор ранее загруженного в систему звукового файла
VOICEID тип голоса (0 – женский; 1 – мужской)
VOICETEXT текст сообщения (читается, если алгоритм содержит точку типа ТТС) Также поддерживается механизм автозамены. Для этого в нужные места текста вставляются маркеры {S}, а в следующих после текста полях – значения для замены (количество маркеров должно соответствовать количеству значений)
DIALTIMEOUT время дозвона в секундах
DTEND время жизни сообщения
DTDIFF "сдвиг" времени обзвона (время указывается для МСК, а этот параметр – поправка на часовой пояс абонента)
CLIID числовой параметр – идентификатор в "вашей" CRM позволяет впоследствии отслеживать "историю" оповещений абонента
CCPHONE номер оператора колл-центра, который будет обслуживать абонента. В случае если в шаблоне указан список номеров, а в записи заполнено это поле, то список будет проигнорирован и дозвон будет производиться только на этот номер
ANI индивидуальный АОН для звонка абоненту в формате XXXYYYYYYY без лидирующей восьмёрки
OPGROUPID ID группы операторов (списка) для второго вызова

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

2. Список номеров задачи

Для получения списка номеров задачи автоинформирования необходимо вызвать скрипт www.cloff.ru/api/ai.task.phone.list.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

3. Подробности звонков на номер

Для получения списка звонков на конкретный номер необходимо вызвать скрипт www.cloff.ru/api/ai.task.phone.detail.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
itemid ID номера в ранее поставленной задаче (см. раздел "Список номеров задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

4. Список звонков задачи

Для получения списка всех звонков в рамках конкретной задачи необходимо вызвать скрипт www.cloff.ru/api/ai.task.call.list.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

5. Приостановить задачу

Для временного прекращения обработки задачи необходимо вызвать скрипт www.cloff.ru/api/ai.task.stop.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

6. Запустить задачу

Для возобновления обработки задачи необходимо вызвать скрипт www.cloff.ru/api/ai.task.unstop.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

7. Завершить задачу

Для полного досрочного завершения обработки задачи необходимо вызвать скрипт www.cloff.ru/api/ai.task.end.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

8. Получить записи разговоров по звонку

Для получения записей распознавания речи и записей разговоров с оператором необходимо вызвать скрипт www.cloff.ru/api/ai.get.recordtalk.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
callid ID звонка задачи (см. раздел "Список звонков задачи")

В ответе сервер передаст файл с записью разговора либо распознавания (если такой файл один), или файл архива Zip, содержащий все части распознавания речи и записей разговора с оператором (если таких частей несколько). Файлы пронумерованы в порядке их записи.

Либо в случае ошибки:

9. Статус задачи

Для получения текущего статуса задачи автоинформирования необходимо вызвать скрипт www.cloff.ru/api/ai.task.get.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

1. Добавление клиента

Для добавления нового клиента необходимо:

  1. Перейти в редакторы структуры "С.У.П." > "Настройки" > "Редактор структуры" и задать для всех импортируемых полей уникальный идентификатор – столбец "Код".
    Внимание! Поле данных под номером 1: "Код" является обязательным и должно быть уникальным в рамках С.У.П..

  2. Затем вызвать скрипт www.cloff.ru/api/crm.insert.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
csv_file Файл формата CSV разделитель ";". Первая строка должна содержать "коды" полей данных для добавления.
Для добавления контактов следует использовать заголовок contact:phone – для добавления контакта типа телефон, либо contact:email для добавления адреса электронной почты. Каждая следующая строка содержит запись с данными клиента для добавления.
Внимание! Количество полей записи не должно быть меньше полей в заголовке файла. Избыточные поля в строке будут проигнорированы.

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

2. Изменение данных клиента

Для изменения (обновления) данных существующего клиента необходимо вызвать скрипт www.cloff.ru/api/crm.update.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
csv_file Файл формата CSV разделитель ";". Первая строка должна содержать "коды" полей данных для обновления.
Внимание! В списке передаваемых полей обязательно должен присутствовать уникальный идентификатор поле code. Каждая следующая строка содержит запись с данными клиента для изменения.
Внимание! Количество полей записи не должно быть меньше полей в заголовке файла. Избыточные поля в строке будут проигнорированы.

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

1. Постановка задачи

Для постановки задачи смс-рассылки необходимо вызвать скрипт www.cloff.ru/api/sms.task.set.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
sendername Имя отправителя СМС (должно быть зарегистрированным для Вас именем в системе)
text Текст отправляемого СМС сообщения
start Дата и время запуска задачи (в случае отсутствия – текущее время)
phone Номер телефона для отправки одиночного СМС сообщения (для отправки рассылки воспользуйтесь параметром csv_file)
csv_file Файл с номерами для отправки СМС рассылки (для отправки одиночного сообщения воспользуйтесь параметром phone). Каждая строка содержит номер телефона в следующем формате: 8XXXYYYYYYY (для номеров РФ).
СМС-рассылка на международные номера не осуществляется.

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

2. Статистика задачи

Для получения статуса обработки задачи СМС рассылки необходимо вызвать скрипт www.cloff.ru/api/sms.task.stat.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

2. Завершить задачу

Для завершения обработки задачи необходимо вызвать скрипт www.cloff.ru/api/sms.task.stop.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)
taskid ID ранее поставленной задачи (см. раздел "Постановка задачи")

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

1. Получение текущего баланса кабинета

Для получения текущего баланса кабинета необходимо вызвать скрипт www.cloff.ru/api/api.balance.php и методом POST передать следующие параметры:

recid Учётная запись в системе
username Имя пользователя
password Hash сумма строки, сформированной как "{Учётная запись},{Имя пользователя},{Пароль}" по алгоритму MD5 (RFC 1321)

Сумма баланса возвращается в рублях.

В ответ сервер передаст JSON объект следующего вида:

Либо в случае ошибки:

Наши контакты:

8 812 335-05-15 (Санкт-Петербург)
8 495 785-21-01 (Москва)
8 800 555-85-90 (Единый)

Звонки по всей России бесплатно


Контакты и реквизиты
Политика обработки персональных данных

CLOFF © 2015-2019

Техподдержка 24/7

E-mail: support@cloff.ru
Skype: omicrontelecom

Наше мобильное приложение: 
Доступно в Google Play Загрузите в App Store
Поддержка моб. приложения:
app-support@cloff.ru
Отзывы о нас на CRMindex

Тарифы
VOT Callback

Шаг 1. Выберите колонку. На какой телефон будут принимать звонки операторы?
SIP Москва, Санкт-Петербург. Городские номера. Москва, Санкт-Петербург. Мобильные номера. Мобильные номера РФ. Административные центры РФ. Городские номера

Областные административные центры:

Абакан; Архангельск; Астрахань; Барнаул; Белгород; Биробиджан; Благовещенск; Брянск ; Владивосток; Владимир; Волгоград; Вологда; Воронеж ; Екатеринбург; Иваново; Ижевск; Иркутск; Казань; Калининград; Калуга; Кемерово; Киров; Кострома; Краснодар; Красноярск; Курган; Курск; Липецк; Магадан; Махачкала; Мурманск; Назрань; Нальчик; Нижний Новгород; Новосибирск; Омск; Оренбург; Орел; Пенза; Пермь; Петропавловск-Камчатский; Псков; Ростов-на-Дону; Рязань; Самара; Саратов; Смоленск; Ставрополь; Сургут; Тамбов; Тверь; Тольятти; Томск; Тула; Тюмень; Улан-Уде; Ульяновск; Уфа; Хабаровск; Челябинск; Чита; Южно-Сахалинск; Ярославль.

Европейская часть РФ. Городские номера. Урал, Сибирь, Дальний Восток. Городские номера.
Шаг2 Москва, Санкт-Петербург. Городские номера. 1,25 1,5 2,5 2,5 2,05 2,35 3,02
Москва, Санкт-Петербург. Мобильные номера. 2,25 2,5 3,5 3,5 3,05 3,35 4,02
Мобильные номера РФ. 2,25 2,5 3,5 3,5 3,05 3,35 4,02
Административные центры РФ. Городские номера 1 1,8 2,05 3,05 3,05 2,6 2,9 3,57
Европейская часть РФ. Городские номера. 2,1 2,35 3,35 3,35 2,9 3,2 3,87
Урал, Сибирь, Дальний Восток. Городские номера. 2,77 3,02 4,02 4,02 3,57 3,87 4,54

Примечание: указана стоимость минуты разговора в рублях РФ с учетом НДС

Регистрация

Отличная новость!

С 1 мая регистрация пользователей осуществляется в новейшем продукте компании "Облачное рабочее место CLOFF".

Получить
доступ

Пополнение баланса и тарификация услуг

Правила пополнения баланса

  • Для пополнения баланса вы можете воспользоваться следующими видами оплаты:
    • Visa Visa
    • Master Card Master Card
    • Diners Club Diners Club
    • JCB JCB
    • Яндекс.Деньги Яндекс.Деньги
    • Банковский перевод Сбербанка России Сбербанк России
    • e-porte-port
    • WebMoney WebMoney
    • КредитПилот КредитПилот
    • QIWI кошелек QIWI кошелек
  • Все платежи осуществляются в российских рублях.
  • Электронные платежи осуществляются при помощи системы электронных платежей Ассист. Assist
  • При электронном платеже баланс пополняется автоматически сразу после получения подтверждения от Ассиста, что платеж прошел успешно.
  • При банковском переводе оператор вручную пополняет баланс в течение рабочего дня с момента поступления денежных средств на расчетный счет ООО «Омикрон».
  • Зачисленные на баланс пользователя денежные средства возврату не подлежат.
  • При оплате заказа банковской картой (включая ввод номера карты), обработка платежа происходит на сайте системы электронных платежей ASSIST, которая прошла международную сертификацию. Это значит, что Ваши конфиденциальные данные (реквизиты карты, регистрационные данные и др.) не поступают в интернет-магазин, их обработка полностью защищена и никто, в том числе CLOFF, не может получить персональные и банковские данные клиента. Verfied-by-VISA MasterCard-SecureCode
    В случае согласия пользователя, ежемесячные платежи списываются с банковской карты владельца автоматически. В данном случае, чтобы отказаться от транзакций, необходимо отправить письменное уведомление на e-mail Службы Поддержки support@cloff.ru. Отказы должны осуществляться до срока автоматического платежа.
    Для защиты информации от несанкционированного доступа на этапе передачи от клиента на сервер системы ASSIST используется протокол SSL 3.0, сертификат сервера (128 bit) выдан компанией Thawte - признанным центром выдачи цифровых сертификатов. Вы можете проверить подлинность сертификата сервера.

Порядок пополнения баланса

  • Чтобы пополнить баланс, зайдите в Личный кабинет и кликните на кнопке "Пополнить баланс".
  • Укажите способ оплаты:
    • электронный платеж;
    • банковский перевод и нажмите кнопку "Далее".
  • Введите сумму в рублях, на которую вы хотите пополнить баланс.

    Электронный платеж

  • В случае электронного платежа вы будете переведены на страницу системы электронных платежей Ассист. Assist
  • Выберите вид оплаты и нажмите "Продолжить".
  • Заполните запрашиваемые поля и нажмите на кнопку "Оплатить".
  • Результаты платежа будут переданы в ваш браузер. Сохраните информацию о платеже. В случае успешного платежа ваш баланс в системе CLOFF увеличится на перечисленную сумму.

    Банковский перевод

  • При выборе данного варианта оплаты в вашем браузере откроется страница с банковской квитанцией.
  • Распечатайте банковскую квитанцию.
  • Оплатите квитанцию в ближайшем отделении Сбербанка или другого удобного вам банка. При этом нужно помнить, что банк попросит с Вас дополнительно 3% от суммы платежа за свои услуги.
  • Отправьте заверенную банком квитанцию по факсу +7 812 322-91-00.
  • Оператор пополнит ваш баланс в течение рабочего дня с момента поступления денег на наш расчетный счет.

Правила тарификации услуг

  • Услуги оказываются только при положительном балансе лицевого счета пользователя.
  • Существуют 2 типа тарификации:
    • абонентская плата;
    • поминутная тарификация.

    Абонентская плата

  • Абонентская плата снимается авансом с баланса пользователя 1-го числа каждого месяца за целый месяц.
  • При активации услуги абонентская плата рассчитывается по формуле: номинал абонентской платы, указанный в тарифном плане для услуги, умножается на количество дней, оставшихся до конца текущего месяца, и делится на общее количество дней в текущем месяце.

    Поминутная тарификация

  • При поминутной тарификации неполные минуты округляются до целых минут.