Партнёрское API
Партнёрское API — это отдельный machine-to-machine доступ для организаций-партнёров ВойсЛайнс. Оно помогает управлять клиентскими организациями через интеграцию: создавать и обновлять Роботов, Базы контактов, контакты и webhook-уведомления без ручной работы в личном кабинете.
Что можно автоматизировать
- Получать список клиентских организаций, закреплённых за партнёром.
- Создавать, обновлять и удалять Роботов, включая выбор доступного голоса и запрет тестовых звонков.
- Создавать Базы контактов, управлять контактами и запускать или останавливать обзвон.
- Настраивать карту дозвона, в том числе распределение попыток по дням.
- Получать номера для звонка Роботу и входящие номера Баз контактов как read-only данные.
- Получать финансовые операции за период в JSON и CSV: суммы, а для связанных звонков — Робота, вид звонка и полную длительность.
- Настраивать webhook-уведомления о результатах звонков.
Робота можно удалить только после отвязки от всех неудалённых Баз, включая выключенные. Запрет тестовых звонков блокирует звонок на добавочный номер Робота, но не отключает обычные исходящие звонки и входящие в Базу. Уже начатые разговоры продолжаются.
В финансовой выдаче входящий звонок Роботу без Базы, включая демонстрационный, отмечен как test. Данные звонка могут отсутствовать, а его полная длительность повторяется в каждой связанной операции — это не оплачиваемые минуты. Правила сверки и nullable-поля описаны в PDF.
Где взять доступ
API-ключи создаются в партнёрской панели. Если раздел партнёрского API не отображается или ключи не создаются, обратитесь к администратору ВойсЛайнс: для организации должен быть включён партнёрский режим и доступ к API.
Документация для разработчика
Полный контракт API вынесен в PDF: там описаны авторизация, лимиты, endpoints, DTO, ошибки, webhook и примеры запросов. Для автогенерации клиента можно использовать OpenAPI-спецификацию.