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

33 lines
3.2 KiB
Markdown

---
title: API-ключ и вебхук — интеграция с вашей системой
tour: api
topics: 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`.