Для работы с API необходим токен, который можно получить в разделе личного кабинета Интеграции -> API и Webhooks -> API. Токен необходимо передавать в заголовке запроса Access-Token. Пример запроса:
POST /widget-service/v1/api/widget-request/user-form/create HTTP/1.1
Host: api.calltouch.ru
Access-Token: <token>
...
{"routeKey": "key1", "phone": "79992223344"}
| Код | Описание |
|---|---|
| 1 | Синтаксическая ошибка JSON в запросе или запрос пустой |
| 2 | Передача данных по API отключена в настройках проекта |
| 3 | Сайт не активирован |
| 4 | Сайт не найден по указанному mod_id |
| 5 | Нет доступа к сайту |
| 6 | Некорректный идентификатор сайта |
| 7 | Достугнут лимит запросов |
| 10001 | Заявка не будет отправлена на прозвон, баланс недостаточен |
| 10002 | Заявка не будет отправлена на прозвон, услуга обратного звонка отключена |
| 10003 | Невозможно создать заявку, нет активных виджетов с указанным ключом |
| 10004 | Невозможно создать заявку, указанная сессия не найдена |
| 10005 | Превышен лимит отправки заявок в рамках сессии, если передан sessionId |
| 10006 | Превышен лимит отправки заявок на один и тот же номер телефона, если не передан sessionId |
| 10007 | Превышен лимит минимального интервала между отправкой заявок по номеру телефону или сессии |
| 10008 | Невозможно создать заявку, номер телефона находится в черном списке |
| 10009 | Невозможно создать заявку, номер телефона используется в пуле подменных номеров |
| 10010 | Невозможно создать заявку, указанный отдел не найден |
| 10011 | Получена заявка в нерабочее время с ключом %roteKey%, которая пришла с формы на странице сайта %siteUrl%. Для обработки таких заявок, необходимо включить сеттинг "Собирать заяви в нерабочее время" в табе "Настройки" виджета. |
| 10012 | Невозможно создать заявку, номер телефона не разрешен |
| 10013 | Невозможно создать заявку, номер телефона некорректный |
| 10014 | Произошла ошибка при попытке подтвердить заявку: %error% |
| 10015 | Ошибка валидации. Проверьте корректность введенного номера. |
| 10016 | Пользовательское поле %alias% не найдено |
| 10017 | Пользовательское поле %alias% не соответствует типу поля %type% |
| 20001 | Звонок не найден |
| 20002 | Параметр logId не передан или имеет неправильный формат |
| 20003 | Не найден лог импорта звонка |
| 20004 | Поле callReferenceId должно быть уникально в рамках сайта |
| 20005 | Указано несуществующее пользовательское поле |
| 20006 | Указаное пользовательское поле должно иметь числовое значение |
| 20007 | Указаное пользовательское поле должно быть датой в формате "DD-MM-YYYY" или "DD-MM-YYYY hh:mm:ss" |
| 30001 | Заявка не найдена |
| 30002 | Заявка с таким requestNumber уже существует |
| 30003 | Указано несуществующее пользовательское поле |
| 30004 | Указаное пользовательское поле должно иметь числовое значение |
| 30005 | Указаное пользовательское поле должно быть датой в формате "DD-MM-YYYY" или "DD-MM-YYYY hh:mm:ss" |
| 40001 | Сделка не найдена |
| 40006 | Действие невозможно, т.к. найдено несколько сделок с одинаковым orderNumber. Чтобы выполнить операцию, выгрузите сделки с этим orderNumber, решите какую из них обновить, и отправьте запрос на обновление повторно, используя orderId (уникальный ID сделки внутри Calltouch), он будет присутствовать в выгрузки сделок. |
| 40007 | Неизвестная ошибка |
| 40012 | Нельзя удалить все статусы, должен остаться хотя бы один |
| 40013 | В списке находятся не существующие ID`s истории |
| 40015 | Процесса создания сделок по API с переданным logId не найдено. |
| 40016 | Указаны не все SiteIds, по которым ранее был произведен запрос на создание сделок. |
| 40017 | Параметр logId не передан или имеет неправильный формат. |
| 50001 | Указанный номер в личном кабинете Calltouch не найден |
| 50002 | Тип пула может иметь значение offline |
| 50003 | Вид пула может иметь значение static |
| 50004 | Не передан обязательный параметр displayOptions |
| 50005 | Номер уже используется в другом пуле |
| 50006 | Номер не прикреплен к пулу |
| 50007 | errors.api.redirect_type_is_not_available |
| 60001 | Не найдена задача импорта с указанным jobId |
| 70001 | Не найдены настройки cpa интеграции для переданных site_id и platform_name |
| 80001 | Лид с таким calltouchLeadId не найден в указанном ID сайта siteId |
| 80002 | Указано несуществующее пользовательское поле |
| 80003 | Указаное пользовательское поле должно иметь числовое значение |
| 80004 | Указаное пользовательское поле должно быть датой в формате "DD-MM-YYYY" или "DD-MM-YYYY hh:mm:ss" |
| 90001 | Исчерпан часовой лимит баллов по сайту |
| 90002 | Исчерпан суточный лимит баллов по сайту |
| 100001 | Не найдено внешней метрики с таким названием, импорт невозможен. |
| 100002 | Указано некорректное значение идентификатора лога импорта |
| 110001 | Импорта клиентов с переданным logId не найдено |
| 110002 | Импорта клиентов с переданным logId уже удалён |
| 110003 | Указаны некорректные контакты, или они были отфильтрованы по настроенному блек-листу |
| 120001 | Не найден активный виджет чата |
| 120002 | Не найден диалог |
| 120003 | Диалог назначен другому оператору |
| 120004 | Недостаточно прав для ответа на Whatsapp сообщения |
| 120005 | Достигнут лимит на количество одновременно взятых диалогов |
| 120006 | Это сообщение уже было создано |
| 120007 | Оператор пытается закрыть диалог, взятый другим оператором |
| 120008 | Закрытие диалога без ответа оператора выключено |
| 120009 | Превышен максимально допустимый размер загружаемого файла |
| 120010 | Недопустимый тип файла |
| 120011 | Файл не найден |
| 120012 | Оператор не может писать в завершенный диалог |
| 120013 | У оператора отсутствует лицензия |
| 120014 | Нельзя перевести диалог на данного оператора |
| 120015 | Нельзя перевести диалог на указанный отдел |
| 120016 | Сообщение не найдено |
| 120017 | Оператор не найден |
| 120018 | Оператор не имеет доступа к проекту |
| 130001 | Скоринг не найден |