Files
portal/app/resources/help/api-i-webhook.md
T
Дмитрий fddba0a616 feat(bot): шаг «проверьте ссылки перед переносом в поле» + ревизия инструкции на грабли
Владелец: «клиентам надо подсказывать — от того, как они сформируют поле,
зависит весь дальнейший поиск». Плюс просьба вычитать инструкцию и экскурсии
на враньё и ловушки.

Добавлено предупреждение (и в экскурсии collect-competitors/proposals, и в статьи):
перед переносом конкурента в поле открыть сайт и справочник ссылками — тот ли это
бизнес, тот ли город, живой ли адрес. По грязной карточке мы найдём не те источники,
а изучение каждого конкурента стоит 50 руб.

Ревизия (агент сверил 36 статей и 31 экскурсию с кодом) — закрыто:
1. Вебхук обещал автоматическую отправку событий, которой НЕТ. Теперь честно:
   сейчас только тестовый запрос; заявки забирать по API-ключу или выгрузкой.
2. Колонка «Город»: оговорка, что в редком запасном случае там регион проекта.
3. Отчёты: фильтры «Проект»/«Менеджер» пока только «Все» — сказано прямо.
4. Цены автоподбора: «актуальная цена всегда в самом окне».
5. Статьи «Портал на телефоне» и «Откуда заявки» больше не ведут на чужую
   экскурсию про сделки (у них своей нет — кнопки просто не будет).
6. Синонимы: «портал на телефоне» и «заявки в свою CRM» находили не то.

Pest 39/39, Vitest 1227/1227. Живой прогон вопросов — отвечает верно.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-12 13:50:19 +03:00

2.6 KiB

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

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

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

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

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

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