API и вебхуки: бот для ваших форм, приложений и систем

Когда нужен API

• Своя форма или калькулятор на сайте, и вы хотите, чтобы бот отвечал прямо в ней, а не в отдельном окне чата.
• Мобильное приложение со своим чатом поддержки или заказа.
• Внутренние системы, которым нужно знать о новых заявках: учётная система, телефония, собственная CRM.

Что умеет API

• Принимать обращения. Вы отправляете сообщение клиента, бот отвечает по тем же знаниям и правилам, что и в остальных каналах.
• Отдавать заявки и разговоры вашим системам по ключу с нужными правами.
• Присылать вебхуки о новых заявках и сообщениях. Каждый вебхук подписан, чтобы ваша система могла проверить, что событие пришло от нас.

Все обращения из API видны в общей ленте кабинета, а заявки — во встроенной CRM или в подключённой Битрикс24 и amoCRM.

Ключи и права

Ключи выпускает владелец кабинета в настройках безопасности. У каждого ключа свой набор прав, его можно отозвать в любой момент. Не передавайте ключ в код, который выполняется в браузере посетителя: обращения с сайта лучше отправлять через ваш сервер.

Тариф

API и вебхуки входят в тариф «Про». Если вам нужен только чат на сайте, API не нужен: окно чата ставится одной строкой кода — подробнее на странице чата для сайта.