API ЭТОЧАТБОТ
Как из вашей системы писать людям в бот: ключи, контакты, отправка сообщений и запуск сценариев.
Статей · 7
API ЭТОЧАТБОТ: с чего начать
Как ваша система может сама написать человеку в чат-бот: выпуск ключа, проверка запросом GET /me, первое сообщение и честные ограничения мессенджеров.
Ключ доступа: выпуск, хранение, отзыв
Где выпустить ключ к API бота, почему его показывают только один раз, как заменить потерянный, как правильно хранить и чем он отличается от публичного ключа виджета чата на сайте.
Контакты: как адресовать человека
Что такое chat_id, где его взять, как привязать к нему свой external_id — и почему chat_id приходит строкой, а не числом.
Отправка сообщения
Как отправить человеку сообщение через POST /messages: поля запроса, лимиты текста и кнопок, примеры на curl, PHP и Python, разбор ошибок и случаи, когда вместо этого лучше запускать сценарий.
Триггерные уведомления: запуск сценария
Как из своей системы запускать сценарии бота: вы передаёте событие и данные переменными, а текст, кнопки и логика остаются в конструкторе — и меняются без правки кода.
Чат на сайте: посетители и кто онлайн
Методы, которых нет у мессенджеров: кто на сайте прямо сейчас, все посетители включая молчунов, карточка человека с историей страниц — и как ему написать.
Ошибки, ограничения и частые вопросы
Все коды ошибок API ЭТОЧАТБОТ в одной таблице, честный разбор ограничений мессенджеров и ответы на вопросы, которые возникают у всех при первой интеграции.
Не нашли нужную тему?
Напишите в поддержку — в чат или на почту. Помогаем по шагам в рабочее время.