Запуск звонков с переменными
Отправляете номер и набор полей, агент звонит и подставляет их в разговор. Можно передать уникальный сценарий на один конкретный звонок.
API и вебхуки для обзвона
Встройте голосовой обзвон в свой продукт: запускайте звонки из своей системы, забирайте результаты событиями и управляйте кампаниями без входа в кабинет. Документация лежит прямо в личном кабинете.
Запуск звонка
ключ активен
POST /api/v1/calls
Authorization: Api-Key ldz_••••••••
{
"agent_id": "a_2417",
"phone": "+79165554412",
"vars": {
"name": "Сергей",
"order": "А-1042"
}
}200 звонок поставлен в очередь,
итог придёт вебхуком
До 50 переменных на звонок и до 5000 контактов за запрос
5 000 контактов
За один запрос в приёмник кампании, дубли не создаются
До 50 переменных
Передаются в один запуск звонка и подставляются в сценарий
Права по ключу
Чтение и запись раздельно, чувствительные операции выдаются явно
Коротко
- Через API запускаются звонки с переменными, создаются и ставятся на паузу кампании, догружаются контакты и забирается аналитика.
- Результат звонка приходит событием на ваш адрес, опрашивать API по расписанию не нужно.
- Ограничения: до 5000 контактов за запрос, до 50 переменных на звонок, дневной лимит и срок жизни у каждого ключа.
Возможности
Что доступно через API
Всё, что делается руками в кабинете, доступно и программно.
Кампании и контакты
Создание, запуск и пауза кампании, догрузка контактов пакетами до 5 000 за запрос. У каждой кампании свой адрес приёма, работающий бесконечно.
История и аналитика
Результаты звонков, расшифровки, метрики по кампаниям и агентам. Свои дашборды строятся на ваших данных без выгрузок руками.
Справочники и списки
Каталог получателей переводов, чёрный список, статусы операторов и баланс. Чёрный список можно пополнять из своей системы автоматически.
События вместо опроса
Не нужно дёргать API по расписанию: результат звонка сам приходит на указанный адрес сразу после разговора.
Подключение ИИ-помощника
Совместимый ассистент подключается к API и отвечает на вопросы о ваших данных обычными словами: сколько звонков вчера, сколько осталось на счету.
Доступ
Ключи с раздельными правами
Ключ выдаётся под задачу, а не «на всё». Так интеграция подрядчика не получает доступ к записям разговоров, если он ей не нужен.
| Право ключа | Что позволяет |
|---|---|
| Чтение и запись раздельно | Ключу можно дать только чтение статистики, только запись контактов или обе возможности сразу. |
| Чувствительные права выдаются явно | Запуск звонков и доступ к расшифровкам не включаются по умолчанию: их нужно отметить осознанно. |
| Срок жизни и дневной лимит | У ключа есть дата окончания и потолок запросов в сутки. Забытый ключ перестаёт работать сам, а сбойный скрипт не выест квоту. |
| Документация в кабинете | Полное описание методов лежит внутри платформы и всегда соответствует той версии, которая у вас работает. |
Цепочка
Что происходит после запроса
Ответ 200 означает «принято в очередь», а не «дозвонились». Итог приходит отдельным событием.
- POST /callsномер и переменные
- Очередьлимиты кампании
- Наборкарусель и маркировка
- Разговорагент или оператор
- Вебхукитог
Ответ 200 означает «принято в очередь», а не «дозвонились»: результат приходит отдельным событием
С чего начать
Первый запрос за полчаса
Порядок такой же, как у любого нормального API: ключ, тестовый вызов, подписка на события, боевой запуск.
1
Создайте ключ под задачу
Отметьте только те права, которые нужны интеграции. Поставьте срок жизни и дневной лимит: это дешевле, чем потом разбираться, кто исчерпал квоту.
2
Сделайте пробный звонок на свой номер
Первый вызов лучше отправить себе: видно, как подставились переменные и как звучит сценарий на реальной линии.
3
Подпишитесь на события
Укажите адрес, на который платформа будет присылать итоги разговоров. Тестовая отправка проверяет, что ваш обработчик отвечает как надо.
4
Проверьте обработку ошибок
Номер в нерабочем формате, исчерпанный баланс, контакт в чёрном списке — платформа возвращает понятную причину, её стоит обработать сразу.
5
Запускайте на части базы
Первые сотни звонков через API покажут, где ваша логика расходится с реальностью, пока цена ошибки мала.
Сценарии
Зачем это на практике
Четыре типовые задачи, ради которых обычно и берутся за API.
Звонок сразу после заявкиФорма на сайте отправляет запрос, и агент перезванивает через секунды, пока человек ещё на странице. Скорость первого касания решает больше, чем текст скрипта.
Обзвон по событию в своей системеИзменился статус заказа, подошёл срок платежа, освободилось место в группе — ваша система сама ставит звонок в очередь.
Свои отчёты и дашбордыДанные звонков забираются в вашу аналитику и складываются с рекламными расходами и продажами. Стоимость лида считается по всей цепочке, а не только по звонкам.
Обмен с нестандартной CRMСамописная или отраслевая система, которой нет в каталоге интеграций, подключается через вебхуки за несколько часов.
Автоматическое пополнение чёрного спискаКлиент отписался в рассылке или попросил не звонить в чате — ваша система сразу вносит номер в чёрный список платформы, и обзвон его больше не наберёт.
Вопросы к данным обычными словамиК API подключается совместимый ИИ-помощник, и на вопрос «сколько звонков вчера» или «сколько осталось на счету» приходит ответ без построения отчёта.
Ограничения
О чём стоит знать заранее
Честный список рамок, чтобы вы спроектировали интеграцию сразу правильно, а не переделывали после первого нагрузочного дня.
01
Дневной лимит на ключ
У каждого ключа свой потолок запросов в сутки. Для массовой догрузки контактов выгоднее слать пакетами до 5 000, а не по одному.
02
События надёжнее опроса
Забирать результаты, дёргая API по кругу, можно, но это быстро упирается в лимит. Подписка на события решает задачу без расхода квоты.
03
Переменных до пятидесяти
В один запуск звонка помещается до 50 полей. Если данных больше, разумнее передавать идентификатор и подтягивать остальное на своей стороне.
04
Чувствительные права отдельно
Запуск звонков и доступ к расшифровкам не выдаются автоматически. Если интеграция подрядчика их не получила, дело не в сбое, а в правах ключа.
05
Документация только в кабинете
Публичной ссылки на описание методов нет: оно лежит внутри платформы и совпадает с вашей версией.
Вопросы и ответы
Что чаще всего спрашивают
Нужен ли API, если есть готовая интеграция
Как забирать результаты звонков
Лучше событиями: платформа сама шлёт итог на ваш адрес после каждого разговора. Опрашивать API по расписанию не нужно.
Сколько контактов можно загрузить за раз
До 5 000 в одном запросе к приёмнику кампании. Дубли не создаются, форматы номеров нормализуются автоматически.
Можно ли передать свой сценарий на один звонок
Да. В запуск звонка передаются переменные и уникальный сценарий, который сработает только для этого вызова.
Где взять документацию
Она лежит в личном кабинете и всегда соответствует вашей версии платформы. Отдельно скачивать и сверять версии не нужно.
Можно ли управлять кампаниями программно
Да: создание, запуск и пауза кампании доступны через API наравне с кабинетом. Это позволяет включать обзвон по расписанию вашей системы, а не платформы.
Что вернётся, если номер в чёрном списке
Платформа не станет звонить и вернёт понятную причину отказа. Обрабатывать её стоит сразу: иначе ваша система будет считать такие попытки успешными.
Встройте обзвон в свой продукт
Ключи с правами, вебхуки и документация — всё в личном кабинете.
Страница обновлена