Звонки через REST API: как отправить лид с сайта и получить итог обратно
Команда Sado AI · · 3 мин чтения
Коротко
REST API — простой способ, которым программы отправляют друг другу запросы через интернет. В звонках это работает так: ваш сайт, приложение или внутренняя программа отправляет новый лид в Sado, ИИ-оператор сразу звонит, а итог — краткое резюме и следующий шаг — возвращается в вашу систему вебхуком. С каждым лидом передавайте телефон, имя, тему, основание для звонка и свой ID. Если у вас Битрикс24 или другое готовое подключение, API не обязателен.
REST API простыми словами
API — договорённый язык, на котором одна программа говорит другой: «вот лид, позвоните ему». В REST API запрос отправляется на обычный интернет-адрес, данные идут в формате JSON, а кто отправил, проверяется по секретному ключу.
Например, когда на сайте нажимают «Отправить», ваш сервер отправляет в Sado один запрос: телефон, имя и тему. Для владельца бизнеса смысл простой: лид пришёл с сайта — никто ничего не переносит, звонок начинается сам.
Что даёт API для звонков
- Заполнили форму на сайте — оператор сразу звонит клиенту, пока тот ещё на сайте.
- В мобильном приложении нажали «Перезвоните мне» — то же самое.
- Список из вашей внутренней программы, например завтрашние доставки, уходит на обзвон.
- Лид из Instagram или рекламной формы — так же: сервис, который собирает лиды, передаёт их в API.
- Итоги возвращаются в ваш отчёт или CRM: кто заинтересовался, кто записался, какой следующий шаг.
Что отправляется вместе с лидом
| Данные | Пример | Зачем |
|---|---|---|
| Телефон | +998 XX XXX XX XX | Для звонка |
| Имя | Азиз | Обращаться к клиенту по имени |
| Тема | 2-комнатная квартира | Оператор знает, с чего начать разговор |
| Основание для звонка | Заявка на сайте | Звонят только тем, кому можно звонить |
| Ваш ID | site-form-1042 | Если лид отправлен дважды, второй не создаётся |
Точные названия полей и полная документация — на странице для разработчиков.
Шаги для разработчика
- Прочитайте страницу для разработчиков: там примеры запросов и полная документация.
- Получите API-ключ и храните его только на сервере. Не вставляйте его в код сайта, в браузер или в чат.
- Когда с формы приходит лид, отправляйте запрос со своего сервера.
- Проверяйте ответ: при ошибке запишите её в журнал и повторите позже с тем же ID.
- Чтобы получать итог, подключите адрес вебхука. Как это работает: как работает вебхук.
- Отправьте тестовый лид со своим номером, примите звонок и проверьте, что итог вернулся в вашу систему.
Безопасность и правила
- API-ключ — это пароль: если его кто-то увидел, сразу замените на новый.
- Отправляйте только тех, кому можно звонить: оставивших заявку, давших согласие или ваших клиентов.
- На номер, где сказали «не звоните мне», больше не звонят.
- Часы звонков, дневной лимит и кнопка остановки — в кабинете; настройте их до запуска API.
- Не отправляйте лишнего: телефона, имени и темы достаточно.
Нужен ли API или можно без разработчика
Чаще всего API не обязателен. С Битрикс24 есть готовое подключение: как только лид попадает на выбранную стадию, оператор звонит. amoCRM, Google Таблицы, 1С, BILLZ и МойСклад наша команда подключает вместе с вами. Если список в Excel, достаточно загрузить его в раздел «Автообзвон».
Оплата при любом способе одна: только минуты разговора, 800 сум за минуту. Подробнее: автообзвон, ИИ-звонки с Битрикс24 и цены. Попробуйте вживую или позвоните 78 778 01 23.
Вопросы
Что нужно, чтобы звонить через API?
Разработчик, API-ключ Sado и сервер, который отправляет лиды. Полная документация и примеры запросов — на странице для разработчиков.
Когда оператор звонит лиду из API?
Сразу, в пределах заданных вами часов звонков. Часы и дневной лимит вы задаёте в кабинете сами.
Можно отправить через API целый список?
Да. Если отправить список через API, оператор позвонит каждому. Часы звонков и дневной лимит задаются в кабинете.
Сколько стоит звонок через API?
В Sado оплачиваются только минуты разговора: 800 сум за минуту, без абонплаты и платы за подключение. Номера, которые не ответили, ничего не стоят.