AI Webhooks API

AI Webhooks API: підключіть агентів до будь-якої системи

Отримуйте події в реальному часі, запускайте агентів програмно й надсилайте дані куди завгодно. Webhooks API, це те, як розробники розширюють MyChatBot під власний стек.

Почати безкоштовно Замовити демо
Події в реальному часіREST і webhooksКастомні інструментиMCP-інтеграціїСинхронізація CRM і данихБезпечно й з областями дозволів
01

Слухайте кожну подію

Підписуйтеся на події повідомлень, лідів, угод і передач у момент, коли вони стаються.

02

Запускайте агентів на вимогу

Викликайте дію агента зі свого бекенду, вихідні повідомлення, follow-ups, оновлення.

03

Будуйте кастомні інструменти

Відкривайте власні функції агентам через Webhooks і MCP для індивідуальних сценаріїв.

04

З областями дозволів і безпечно

Токени з обмеженою областю, підписані payload-и й мʼяка деградація за замовчуванням.

Що таке Webhooks API і кому він потрібен

Webhooks API — це канал у MyChatBot, який ви під’єднуєте самостійно. Якщо ваша платформа вміє надсилати й приймати HTTP-запити, ваш AI-агент може спілкуватися з її користувачами: платформа передає кожне повідомлення користувача, а відповідь агента повертається на URL, яким керуєте ви.

Вбудовані канали, як-от WhatsApp, Telegram чи Website Widget, підключаються прямо в застосунку. Webhooks API закриває решту — системи, яких MyChatBot не підтримує нативно.

Він добре підходить для:

  • власних чат-застосунків і чату всередині мобільного застосунку;
  • наявної системи підтримки клієнтів, яку ви хочете зберегти;
  • IoT-пристроїв з обміном повідомленнями;
  • будь-якої сторонньої платформи без нативного каналу MyChatBot.

У вашому продукті користувачам відповідає асистент, якого ви підключили до цього каналу, — з його інструкціями, знаннями та підключеними інструментами. Ваші розробники відповідають за передачу даних, а розмову веде MyChatBot.

Як повідомлення проходить через MyChatBot

Кожна інтеграція тримається на трьох значеннях: API token, який ви генеруєте, Unique page_id, який ви обираєте, і Reply webhook URL — HTTPS-ендпоінт на вашому боці. Коли все заповнено, кожне повідомлення проходить п’ять кроків:

  1. Користувач пише на вашій платформі, а ваш бекенд надсилає повідомлення POST-запитом у форматі JSON на вхідний webhook URL, указаний на сторінці Channels. Обов’язкових полів чотири: client_id, page_id, platform і text.
  2. MyChatBot перевіряє, що канал увімкнено для цього page_id.
  3. Повідомлення додається до історії розмови користувача за client_id. Якщо ви надіслали посилання на аудіо, запис спершу перетворюється на текст.
  4. Агент читає розмову й пише відповідь.
  5. Відповідь надходить на ваш Reply webhook URL як form-encoded запит із полями text, images, file і audio. Довга відповідь може прийти кількома частинами, тож додавайте їх по черзі.

Для кожного користувача тримайте client_id незмінним: саме так розмова триває далі, а не починається заново. Також можна передати необов’язкові поля client_name і client_avatar та масив attachments із посиланнями на файли чи зображення.

Ключові можливості

Голос в обидва боки

Додайте посилання audio у вхідне повідомлення, і MyChatBot автоматично розшифрує запис, тож агент сприйме його як звичайне повідомлення. Увімкніть Voice reply settings і оберіть голос — тоді відповіді міститимуть посилання на аудіо поруч із текстом.

Налаштування каналу

  • Reply Delay (s) додає паузу перед відповіддю: так відповіді виглядають природніше, а серію швидких повідомлень легше обробити разом.
  • Ignore Reactions пропускає реакції, які інакше запускали б небажані відповіді.
  • Quick comment reply задає необов’язкову коротку публічну відповідь у гілці коментарів, а повна відповідь надходить приватно.

Зрозумілі коди відповіді

Вхідний webhook повертає стандартні HTTP-коди: 200 — повідомлення прийнято, 400 — некоректний запит або бракує обов’язкового поля, 401 — API token не збігається, 500 — під час обробки сталася помилка, і запит варто повторити.

Усі налаштування асистента

Розмову через Webhooks API веде асистент, якого ви налаштовуєте на сторінці Agent configuration, тож його інструкції, Knowledge Base і підключені інтеграції працюють і тут. Збережені зміни діють з наступної відповіді в усіх каналах.

Як це поєднується з іншими каналами та інтеграціями

Webhooks API — один із каналів на сторінці Channels, поруч із WhatsApp, Instagram, Telegram, Viber, TikTok, Facebook, Gmail, SMS, Calls і Website Widget. Канал може бути підключений лише до одного асистента, а канали можна розподілити між кількома асистентами.

MyChatBot має й інші способи під’єднати ваші системи:

  • Trigger Outreach в Automations: зовнішня система надсилає POST на унікальний webhook URL, щоб створити лід і за потреби доручити агенту написати клієнту — про оновлення замовлення, нагадування про запис чи подію в CRM. Можна створити до 20 іменованих тригерів у режимі Capture only або Capture and send outreach і передати значення context, яке агент використає в повідомленні.
  • Інтеграції з CRM: KeyCRM, SalesDrive, Bitrix24, Kommo, Zoho, Salesforce, GoHighLevel і HubSpot, щоб кваліфіковані чати потрапляли до CRM як ліди чи угоди. Перегляньте всі інтеграції.
  • Custom MCP: додаткові можливості для асистента через ваш власний MCP-сервер.
  • Тригери Agents Platform: секретне webhook-посилання або подія в підключеному застосунку запускає рутину чи агента.

Коли розмову перебирає людина і які є обмеження

Правила передачі розмови задаються в Handoff Control на сторінці Agent configuration і стосуються чатів асистента:

  • Stop word for manual handoff: коли оператор пише ключове слово, чат переходить у режим оператора.
  • Implicit operator handoff: будь-яке повідомлення оператора перемикає чат у режим оператора. Оберіть цей режим або ключове слово — разом вони не працюють.
  • Silent handoff: клієнт не отримує сповіщення про перемикання.
  • Auto return: якщо його ввімкнено, агент знову вмикається в чаті за замовчуванням через 24 години або через власний інтервал від 1 хвилини до 1 тижня.

Докладніше про передачу розмови людині.

Кілька обмежень варто врахувати заздалегідь:

  • page_id у кожному повідомленні має точно збігатися з Unique page_id каналу, а сам канал має бути ввімкнений. Інакше повідомлення ігнорується.
  • Коли асистент на паузі — вручну чи за розкладом Work Hours, — він не відповідає у своїх каналах. Повідомлення, що надійшли в цей час, лишаються без відповіді, але їх бачить команда, і пізніше асистент на них не відповідає.
  • Якщо на балансі акаунта закінчилися кошти, асистенти вимикаються автоматично. Після поповнення перевірте перемикач статусу.
  • Відповіді, що надходять на Reply webhook URL, показує користувачам ваша платформа, а не MyChatBot.

Як налаштувати

  1. Відкрийте Channels і оберіть агента, якого хочете підключити.
  2. Виберіть Webhooks API у списку каналів.
  3. Заповніть API token, Unique page_id і Reply webhook URL.
  4. Увімкніть Connect agent to this channel і задайте Reply Delay (s).
  5. Натисніть Connect Webhooks API і скопіюйте вхідний webhook URL зі сторінки Channels.
  6. Надішліть тестове повідомлення з client_id, page_id, platform і text та переконайтеся, що відповідь прийшла на ваш ендпоінт.

Відповіді не надходять? Найчастіше причина в розбіжності page_id або у вимкненому каналі. Код 401 означає, що токен у запиті не збігається з API token на екрані каналу. Щоб згодом відключити канал, відкрийте той самий екран і натисніть Revoke.

Перед запуском протестуйте асистента в приватному чаті й увімкніть перемикач каналу лише після перевірки налаштувань. Тарифи наведено на сторінці цін.

Поширені запитання

Чи потрібен розробник, щоб користуватися Webhooks API?

Так, без розробки не обійтися. Підключення каналу в застосунку займає лише кілька полів, але ваша платформа має надсилати повідомлення користувачів у форматі JSON до MyChatBot і приймати відповіді на власний Reply webhook URL. Якщо вам потрібен лише чат на сайті, простіший варіант — вбудований Website Widget.

Що має містити повідомлення, надіслане до MyChatBot?

Обов’язкових полів чотири: client_id, page_id, platform і text. Необов’язкові — client_name, client_avatar, audio для голосового повідомлення та attachments для посилань на файли чи зображення. Для кожного користувача тримайте client_id незмінним, щоб його розмова тривала далі.

Як повертаються відповіді агента?

MyChatBot надсилає кожну відповідь на ваш Reply webhook URL як form-encoded запит із полями text, images, file і audio. Довга відповідь може надійти кількома частинами одна за одною, тож додавайте їх по черзі.

Чи підтримує Webhooks API голосові повідомлення?

Так, в обидва боки. Надішліть посилання audio, і MyChatBot розшифрує запис, перш ніж агент відповість. Увімкніть Voice reply settings і оберіть голос — тоді відповіді міститимуть посилання на аудіо поруч із текстом.

Чому агент не відповідає на мої повідомлення?

Найчастіше причина в розбіжності page_id або у вимкненому каналі. Перевірте, що page_id у запиті точно збігається з Unique page_id і що перемикач Connect agent to this channel увімкнено. Код 400 означає некоректний запит або відсутнє обов’язкове поле, а 401 — що API token не збігається.

Чи може зовнішня система створювати ліди або ініціювати повідомлення клієнтам?

Так, через Trigger Outreach в Automations. Ваша система надсилає POST із номером телефону чи email, а також необов’язковими name і context на унікальний webhook URL тригера, і MyChatBot створює лід та може доручити агенту написати клієнту. Сам URL є ключем доступу, тож бережіть його як пароль.

Чи може оператор перебрати розмову?

Так. Handoff Control на сторінці Agent configuration перемикає чат у режим оператора за стоп-словом або після будь-якого повідомлення оператора, а Silent handoff приховує перемикання від клієнта. Якщо ввімкнено Auto return, агент знову вмикається автоматично через 24 години або через заданий інтервал.

Будуйте на API MyChatBot

Візьміть API-ключ, підпишіться на події й випустіть першу інтеграцію за пів дня.

Почати безкоштовно