DOS AI/ ДокументацияВойти →
🎬Видео скоро появится
Нажми, когда разберёшься с уроком. Галочка появится в меню слева.

Урок 33. Публичный API и своя интеграция по API

Для продвинутых и разработчиков: связать DOS AI со своими системами — учётом, складом, сайтом. Обычному владельцу этот урок не обязателен.

💡 Простыми словами

Если у тебя есть свой сайт, склад или программа учёта, ты можешь соединить их с ботом двумя способами:

  1. API-ключ — чтобы твоя программа могла управлять DOS AI (читать лидов, слать сообщения) от твоего имени.
  2. «Своя интеграция по API» — чтобы бот дёргал твой сервер (проверить остаток товара, создать заказ, прочитать из базы).

📍 Где: глобальное меню → «Для разработчиков» (ключи); функции → «Своя интеграция по API».

🎞️ Слайды урока

Урок 33 · для продвинутых
Публичный API и своя интеграция
Связать DOS AI со своими системами — сайтом, складом, учётом. Обычному владельцу этот урок не обязателен.
1 / 7

📖 Непонятные слова — на пальцах (для новичка — можно пропустить весь урок)

  • API — «розетка», через которую программы соединяются и обмениваются данными. Как штепсель: любой прибор, у кого подходящая вилка, может подключиться. Тебе-владельцу это не обязательно — урок для тех, у кого есть свои IT-системы.
  • API-ключ (dos_sk_live_…) — длинный пароль, по которому твоя программа управляет DOS AI от твоего имени. Как ключ от служебного входа: у кого он есть — тот может войти. Поэтому давай минимальные права.
  • Только чтение / чтение+запись — что разрешает ключ: смотреть данные или ещё и менять. Как «читательский билет» против «редакторского».
  • Вебхук — способ боту постучаться в твой сервер и получить ответ. Пример: «есть на складе айфон?» → «да, 3 шт». Как позвонить в другой отдел и уточнить.
  • Эндпоинт — конкретный адрес на твоём сервере, куда бот стучится. Как номер кабинета: звонишь именно туда, где ответят по нужному вопросу.

🎯 Зачем это нужно

Чтобы автоматизировать связку «бот ↔ твои системы». Пример: бот при вопросе «есть на складе?» сам стучится в твою складскую программу и отвечает актуальным остатком. Или твоя CRM забирает лидов из DOS AI по расписанию.

🔑 API-ключи

Ключи вида dos_sk_live_…:

  • Права: только чтение или чтение+запись;
  • Область: на весь аккаунт или один проект;
  • Необязательный срок действия. Есть примеры запросов (curl). Ключи бесплатны.

🔧 Своя интеграция по API (бот → твой сервер)

В функциях выбираешь тип «Своя интеграция по API» и настраиваешь: адрес (URL), метод, авторизацию, тело запроса с переменными {{...}}, обработку ответа. Бот вызовет твой эндпоинт по ходу диалога.

⚠️ Устаревших http_get/http_post больше нет — используется «Своя интеграция по API».

📌 Пример

Интернет-магазин: клиент спрашивает «Айфон 15 в наличии?». Бот вызывает функцию «Своя интеграция по API» → стучится в API магазина → получает «да, 3 шт» → отвечает клиенту и предлагает оформить.

✅ Когда нужно / 🚫 когда нет

  • ✅ Есть свои системы (сайт/склад/CRM/учёт) и нужна автоматическая связка.
  • 🚫 Обычному бизнесу без своих IT-систем это не нужно — хватает готовых шаблонов и интеграций.

⚠️ Частые ошибки

  • Дали ключу «чтение+запись» и широкую область без нужды → лишний риск. Давай минимальные права.
  • Ждут http_get/http_post — их нет, это «Своя интеграция по API».

❓ Вопросы новичка

  • Мне, обычному владельцу, это нужно? Скорее всего нет. Для записи, оплат, отправки файлов хватает готовых шаблонов. API — для тех, у кого есть свой сайт/склад/учёт и разработчик.
  • API-ключи платные? Нет, ключи бесплатны. Платишь только за обычную работу бота (баланс).
  • Какие права давать ключу? Минимально нужные: если программе достаточно читать лидов — «только чтение», на один проект. Меньше прав — меньше риска при утечке.
  • Где http_get/http_post? Их больше нет. Кастомный HTTP теперь — «Своя интеграция по API» (тип webhook).

🚀 Что дальше

Дальше — Урок 34: язык выражений (подстановка живых данных).

🔗 Подробнее (техническая документация)