Files
portal/app/resources/help/api-i-webhook.md
T
Дмитрий c5125e981e feat(bot): выбор модели + три замка безопасности + инструкция 51 статья
Прогнал 250 вопросов через настоящий вебхук шесть раз и сравнил четыре модели
вслепую силами судей-агентов. Итоги — в docs findings.

Модель. Появился переключатель services.jivo_bot.llm: yandex (данные не покидают
РФ) либо aitunnel (зарубежные модели через российский шлюз). По слепому сравнению
Claude Haiku 4.5 выиграл финал у Gemini 157:24 и у обеих моделей Яндекса: он
полнее, точнее по кнопкам и цифрам и говорит как человек, а не справочник.

Три замка, потому что живая модель = самоуверенная модель:
- PersonalDataMask — телефоны и почта вырезаются ДО отправки в любую модель
  (клиент оставляет номер в чате; за границу ПДн уходить не должны).
- ChatTextCleaner — markdown и смайлики (Jivo их не рисует): было 191 ответ
  с разметкой, стало 0.
- AnswerGuard — режет юридические гарантии («вас не оштрафуют», «мы гарантируем»,
  «не нарушаем закон») и ЛЮБУЮ цену, которой нет в выданных статьях. Пусто после
  чистки → зовём живого специалиста.

Поиск по инструкции переписан: выбрасываются вопросительные слова (из-за них
«какие у вас тарифы» находило выгрузку в Excel), ранжирование сперва по заголовку
и синонимам, выдача — три РАЗНЫЕ статьи и каждая целиком, плюс починка опечаток
(«каг сазадь праэкт») и учёт прошлой реплики в коротких «а это платно?».

Инструкция: 40 → 51 статья. Новые — по фактам владельца: бесплатный тест и
подарок 1000 ₽, «мы канал, а не реклама», СМС → через час звонок, средние
показатели (8–12 из 100 разговаривают, ещё 5–7 по СМС), номер не вернётся
30 дней, замена брака, вывод остатка, поддержка 24/7, удаление данных, ниши.
Вычищено враньё: минус баланса, «списали без заявки», пауза вечером, выходные,
«Вся РФ», статус «Отказ» (его нет — есть «Не реализовано»), amoCRM, платный
повторный сбор, нарастающий итог тарифных ступеней.

Тесты: 106 из 106. Каждая найденная тупость закреплена тестом.

НЕ НА ПРОДЕ. Выкат — только по прямой команде владельца.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-12 20:44:48 +03:00

3.2 KiB

title, tour, topics
title tour topics
API-ключ и вебхук — интеграция с вашей системой api api, ключ, апи ключ, интеграция, webhook, вебхук, вебхуки, получать заявки в свою crm, отправлять заявки в crm, интеграция с моей crm, интеграция с амосрм, amocrm, битрикс24, забирать заявки автоматически, передача событий, потерял ключ, перевыпустить ключ, подпись, secret, тестовый запрос, endpoint, автоматическая отправка событий, документация по api

Настройки → вкладка «API и Webhook».

API-ключ нужен, чтобы ваша система могла обращаться к порталу и забирать заявки. Ключ показывается полностью только один раз — сразу после создания. Дальше видно лишь его начало. Потеряли — единственный путь «Перегенерировать»: портал выдаст новый, а старый перестанет работать немедленно, и все интеграции на нём придётся обновить.

Вебхук — пока только проверка связи. Вы указываете адрес на своей стороне (только https://) и нажимаете «Тестовый webhook» — портал отправит туда один пробный запрос и покажет, каким кодом ответила ваша система. При сохранении адреса выдаётся секрет для подписи — он тоже показывается один раз, сохраните сразу.

Честно и важно: автоматическая отправка настоящих событий (новая заявка, смена статуса) пока не подключена. Сколько бы вы ни настраивали вебхук, кроме тестового запроса на ваш адрес сейчас ничего не придёт. Мы обязательно сообщим, когда эта возможность появится — не тратьте время на приёмник событий заранее.

Как забирать заявки в свою систему прямо сейчас: через API-ключ (постоянный доступ к данным) или выгрузкой в Excel/CSV в разделе «Сделки».

Готовых интеграций с amoCRM, Битрикс24 и другими CRM у нас нет — коробочной кнопки «подключить amoCRM» не существует. Забрать заявки к себе можно двумя честными путями: силами вашего программиста через API-ключ либо выгрузкой в Excel/CSV. Если нужна техническая помощь по API — напишите на support@liderra.ru.