Битрикс24
Входящий вебхук, права CRM и пользователи, приёмщик и проверка лида.
Заявки с сайта появляются в Битрикс24 сами — лидом или сделкой, в той воронке, которую вы выбрали. Подходит и облако, и коробка: нужен только входящий вебхук с правами CRM.
Путь: Настройки → Интеграции → CRM → Битрикс24 (/settings/integrations/bitrix24). Подключает владелец или администратор.
Обзор раздела — в статье Интеграции: обзор. amoCRM подключается иначе — там вход через аккаунт, без вставки ссылки. См. amoCRM.
Создать входящий вебхук в Битрикс24
- В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук (формулировки меню чуть отличаются в облаке и коробке).
- Выдайте права CRM и Пользователи.
- Скопируйте URL вебхука целиком — он начинается с
https://и содержит секретный фрагмент.
Этот адрес — как пароль. После сохранения в Photosquare он больше не покажется целиком, только маска.
Подключить в панели
- Вставьте URL в поле URL входящего вебхука.
- Нажмите Подключить.
Photosquare проверит адрес. Если ссылка неверная или прав не хватает, подключение не сохранится — появится сообщение, что нужно выдать права CRM и Пользователи.
[изображение: экран Битрикс24 — поле URL входящего вебхука и кнопка «Подключить»]
После подключения видны имя портала и список приёмщиков. Чтобы сменить вебхук, отключите интеграцию и вставьте новый URL. Кнопка Отключить останавливает отправки, журнал доставок остаётся.
Добавить приёмщик
- Нажмите Добавить приёмщик.
- Задайте название внутри Photosquare.
- Выберите воронку, этап и при желании ответственного. Если Битрикс24 отдал список источников, появится ещё поле Источник в CRM.
- Поправьте тему заявки, если нужно. Переменные те же, что у amoCRM:
{formName},{name},{pageUrl}. - При создании можно включить Назначить на все формы.
- Сохраните. Затем отметьте приёмщик на вкладке Хранилище у нужных форм.
Портал без режима лидов получит сделку, остальные — лид. Отдельный переключатель «лид или сделка» в панели не показывается: тип видно в журнале после первой отправки.
Проверить отправку
На экране приёмщика нажмите Проверить отправку. В Битрикс24 появится настоящий лид или сделка с темой «Тест Photosquare». Если API отклонил запрос, на экране будет текст ошибки — приёмщик не «притворится» рабочим.
Повторные заявки с тем же телефоном или почтой Photosquare постарается привязать к уже найденному контакту, а не плодить дубли.
Частые вопросы
| Вопрос | Ответ |
| Подходит ли коробка на своём сервере? | Да, если вебхук открывается по HTTPS. Локальный адрес и закрытые сети не подойдут. |
| Почему «Нужна проверка»? | Чаще всего отозвали права вебхука или сменили секрет. Выдайте снова CRM и Пользователи, отключите подключение и вставьте актуальный URL. |
| Свои поля CRM | Уходят имя, почта, телефон, тема и примечание. Отдельные пользовательские поля Битрикс24 в этой версии не назначаются. |