Roistat REST API: POST /project/calltracking/call/list — История звонков

Чтобы получить визит и сделку для каждого звонка, добавьте visit и order в extend. В записи звонка: id, caller, callee, duration, status, date, link (запись), visit_id, order_id.

Параметр	Где	Тип	Обяз.	Описание
project	query	string	да	Номер проекта
filters	body	object	нет	Фильтры (например, по диапазону дат в and)
sort	body	array	нет	Сортировка
limit	body	integer	нет	Число записей
offset	body	integer	нет	Смещение
extend	body	array	нет	visit, order

Базовые URL

• Боевой: https://cloud.roistat.com/api/v1

Авторизация

Тип: API-ключ

Ключ API (один на пользователя, действует для всех его проектов) берётся в профиле: https://cloud.roistat.com/user/profile/api. Передаётся в заголовке Api-key (рекомендуется; параметр key в URL небезопасен). Номер проекта — в параметре project строки запроса; без него работают только /user/projects и /account/project/create.

curl 'https://cloud.roistat.com/api/v1/project/proxy-leads?project=12345&period=2021-07-07-2021-09-24' \
    --request GET \
    --header 'Content-type: application/json' \
    --header 'Api-key: {KEY}'

Нюансы

• По умолчанию все методы — POST; GET допускается для методов, оканчивающихся на /list, и для отдельных ресурсов (проекты, прокси-лиды, детали сделки).
• Тело — JSON или XML; поддерживается CORS; время по умолчанию — UTC+0.
• По умолчанию все ответы, включая ошибки, приходят с HTTP 200; заголовок Use-Http-Code: 1 включает реальные HTTP-коды.
• Ответы содержат data, total, status.
• Список сделок с extend: visit: при limit больше 1000 — 1 запрос в минуту, больше 100 — 5, меньше 100 — 10; без extend — 20 в минуту.

Сценарии с этим методом

• Забирать заявки и звонки с источниками

---

Если этого недостаточно — официальная документация: https://help-en.roistat.com/API/methods/about/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/roistat.md