Voximplant Management API: Выгрузить историю звонков

Сценарий из mcp-everything. Актуально на 2026-10-24.

Длительность, стоимость, записи разговоров — для отчётов и контроля качества.

1. Запроси историю: GetCallHistory с from_date и to_date в формате YYYY-MM-DD HH:mm:ss и timezone. Без дат вернётся последний месяц.
2. Чтобы получить отдельные звонки и записи разговоров, передай with_calls = true и with_records = true.
3. За запрос — до 1000 сессий (count), дальше листай через offset.
4. Фильтры по номерам клиентов — remote_number, по приложению — application_id; несколько значений — через «;».

h = vox("GetCallHistory", from_date="2026-10-01 00:00:00", to_date="2026-10-24 23:59:59",
        timezone="Europe/Moscow", with_calls="true", with_records="true", count=1000, offset=0)
for session in h["result"]:
    print(session["call_session_history_id"], session.get("duration"))

Базовые URL

• Боевой: https://api.voximplant.com

Авторизация

Тип: Bearer-токен

Сервисный аккаунт: JSON-файл с ключом (account_id, key_id, private_key) создаётся в панели управления (https://manage.voximplant.com/settings/service_accounts) или методом CreateKey. Клиент подписывает JWT алгоритмом RS256 (iss — ID аккаунта, iat, exp; в заголовке токена kid — key_id) и передаёт его в заголовке Authorization: Bearer <token>. Токен короткоживущий (в библиотеках — около минуты), его генерируют на каждый запрос.

Методы сценария

POST /platform_api — GetCallHistory: история звонков

Длительность, стоимость, логи и др. Без дат — интервал по умолчанию (месяц).

Параметр	Где	Тип	Обяз.	Описание
cmd	body	string	да	GetCallHistory
from_date	body	string	нет	Начало, YYYY-MM-DD HH:mm:ss
to_date	body	string	нет	Конец
timezone	body	string	нет	Часовой пояс дат
call_session_history_id	body	string	нет	ID сессий через ;, до 1000
application_id	body	integer	нет	ID приложения
user_id	body	string	нет	ID пользователей через ;
remote_number	body	string	нет	Номера клиентов через ;
local_number	body	string	нет	Номера платформы через ;
with_calls	body	boolean	нет	Включить звонки внутри сессий
with_records	body	boolean	нет	Включить записи
desc_order	body	boolean	нет	Обратный порядок
count	body	integer	нет	До 1000 записей
offset	body	integer	нет	Пропуск, до 10000

Нюансы

• Параметры передаются формой (multipart/form-data); списки — строкой через ;.
• Даты — YYYY-MM-DD HH:mm:ss.
• При ошибке в ответе объект error с полями code и msg.
• Некоторые методы (отчёты, детали списков в CSV) возвращают файл application/octet-stream.
• Всего в API около 400 методов: правила и сценарии, очереди ACD и SmartQueue, ключи и роли, KV-хранилище, SIP, push-учётки, дочерние аккаунты, счета.

Другие сценарии

• Позвонить клиенту из своей системы
• Автообзвон по списку номеров
• Отправить SMS с номера Voximplant
• Создать приложение и пользователя для звонков из браузера или приложения

---

Если этого недостаточно — официальная документация: https://voximplant.com/docs/references/httpapi Вся интеграция одним документом: https://mcp-everything.ru/integrations/voximplant.md