Что такое API простыми словами и как отправлять заявки голосовому ИИ-оператору по API
Команда Sado AI · · 3 мин чтения
Коротко
API (Application Programming Interface, программный интерфейс) — договорённые правила, по которым одна программа просит другую сделать работу или дать данные: на какой адрес, какой запрос отправить и какой ответ получить. Оплата через Click или Payme на сайте, карта на сайте, Telegram-боты — всё это работает через API. В голосовом ИИ-операторе ваша система по API отправляет новую заявку, оператор сразу звонит, а итог звонка возвращается в вашу систему.
API простыми словами
В ресторане вы не заходите на кухню: называете официанту блюдо из меню, он передаёт заказ повару и приносит блюдо. API — это и есть официант. Одна программа не лезет внутрь другой, а просит по договорённым правилам и получает ответ.
- Интернет-магазин платёжной системе: «Создай оплату на 250 000 сум за этот заказ».
- Служба доставки картографическому сервису: «Сколько километров между этими адресами?»
- Telegram-бот Telegram: «Отправь этому человеку вот это сообщение».
Из чего состоит запрос к API
| Часть | Что это | Пример |
|---|---|---|
| Адрес | Куда идёт запрос | Адрес приёма заявок |
| Ключ | Подтверждает, кто спрашивает | Секретный API-ключ из кабинета |
| Запрос | Что отправляется | Имя, телефон, курс, почему можно звонить |
| Ответ | Что вернулось | «Принято» или причина ошибки |
API работает, когда вы спрашиваете. А когда система сама присылает сообщение о событии, это вебхук: что такое вебхук.
Пример: учебный центр в Ташкенте
«Bilim Plus» (название придумано) ведёт курсы английского и математики. Форма записи на сайте попадает в собственную программу центра. Раньше заявки ждали день-два, теперь так:
- Родитель заполняет форму на сайте: имя ребёнка, возраст, курс.
- Программа центра сразу отправляет в Sado по API: имя, телефон, курс и основание звонка — «заявка с сайта».
- ИИ-оператор сразу звонит и записывает на бесплатный пробный урок.
- Итог звонка возвращается в программу центра, администратор видит, кого и когда ждать.
Sado: Здравствуйте, это Малика из учебного центра «Bilim Plus». Вы только что оставили заявку на английский, поэтому звоню.
Клиент: Да, для сына. Ему двенадцать, начальный уровень.
Sado: Понятно. Сначала бесплатный пробный урок, там же определим уровень. Удобно в субботу в десять или в воскресенье в два?
Клиент: В субботу в десять.
Sado: Хорошо, записала на субботу, десять утра. В пятницу позвоним напомнить.
Как звучит звонок:
Зачем API голосовому ИИ-оператору
- Отправка заявок: на каждую заявку из вашей системы оператор сразу звонит (исходящие звонки).
- Получение итогов: звонки, резюме и следующий шаг возвращаются в вашу программу.
- Цены и остатки: вы обновляете каталог по API, и в звонке оператор называет только цены из каталога.
- Когда API не нужен: с Bitrix24 есть готовая интеграция, Excel-список вы загружаете в кабинет сами (Excel и Google Sheets), amoCRM и 1С подключает наша команда.
Другие примеры для учебных центров: ИИ-оператор для образования. Технические детали: для разработчиков.
Чек-лист перед подключением API
- Давайте API-ключ только разработчику, не пишите его в чат и в открытый код.
- Дайте каждой заявке свой номер: если ту же заявку отправят повторно, вторая не создастся.
- Указывайте основание звонка для каждого человека: оставил заявку, дал согласие или ваш клиент. В Узбекистане есть закон о персональных данных.
- Задайте в кабинете часы звонков и дневной лимит.
- Сначала отправьте одну тестовую заявку и проверьте звонок и итог.
Оплачиваются только минуты разговора: 800 сум за минуту. Попробуйте вживую или позвоните 78 778 01 23. Другие ответы: вопросы о Sado.
Вопросы
Нужен ли программист, чтобы работать с API?
Да, чтобы подключить свою систему к API, нужен разработчик. Если у вас Bitrix24 или Excel, API не обязателен: в Sado есть готовые пути, настраивает их наша команда.
Что такое API-ключ?
Это секретная строка вроде пароля: она подтверждает, что запрос пришёл от вашей компании. В Sado ключ создаётся в настройках кабинета и показывается только один раз.
Чем API отличается от вебхука?
В API ваша программа спрашивает и получает ответ. Вебхук система присылает сама, когда произошло событие. Обычно их используют вместе.