Oki-Toki предоставляет REST API для интеграции колл-центра с вашими системами: CRM, сайтами, ботами и внутренними сервисами. Базовый адрес — https://home.oki-toki.net/api/v1/, ответы в формате JSON.
Ключ API создаётся в личном кабинете (раздел «Интеграции»). Каждый запрос авторизуется этим ключом — подробности в разделе Authenticating requests.
Полная интерактивная документация со всеми методами, параметрами и готовыми примерами кода (PHP, curl, JavaScript, Python) живёт по адресу one.oki-toki.net/docs/api. Ниже — карта разделов: что умеет каждая группа методов и где смотреть детали.
Возможности API по разделам
Звонки (Calls)
Данные о конкретном звонке: добавление и получение произвольной информации по звонку, скачивание записи разговора по идентификатору сессии.
Контакты (Contacts)
Работа с CRM Оки-Токи: создание и обновление контактов, выгрузка карточек и связанных с ними данных — для синхронизации с внешними CRM.
Автообзвоны (Dialers)
Управление автообзвонами: список дайлеров, добавление задач (номеров) в обзвон, отмена задач, контроль состояния. Основной инструмент интеграции лидогенерации с обзвоном.
Интеграции (Integrations)
Служебные методы для связи с внешними системами и вебхуков — события Оки-Токи в ваши сервисы.
Списки (Lists)
Чёрные и белые списки номеров: проверка наличия значения, добавление и удаление записей.
Проекты (Projects)
Данные анкет и проектов: структура полей, записи анкет — всё, что операторы заполняют в карточках.
Очереди (Queues)
Состояние очередей входящих звонков: статусы, загрузка, операторы на линии — для дашбордов и мониторинга в реальном времени.
Отчёты (Reports)
Журнал звонков с фильтрами по датам и номерам, сводные отчёты по звонкам, очередям и пользователям — сырьё для вашей аналитики и BI.
SMS
Отправка SMS и работа с SMS-рассылками через подключённых провайдеров.
Пользователи (Users)
Управление операторами: смена статуса пользователя (например, перевод в перерыв из внешней системы), данные по занятости.
С чего начать
Создайте ключ API в кабинете, откройте интерактивную документацию и выполните первый запрос из готового примера. Если что-то не получается — напишите в нашу техподдержку через тикет в кабинете, поможем с интеграцией.