Исходящий вебхук заявок
HTTPS-адрес, секрет подписи, тело JSON и проверка отправки.
Если своя CRM или таблица принимает заявки по адресу, Photosquare отправит туда JSON после каждой отправки формы. Это исходящий вебхук: мы зовём ваш URL, вы отвечаете кодом 2xx.
Путь: Настройки → Интеграции → Вебхук (/settings/integrations/webhook). Настраивает владелец или администратор.
Для amoCRM и Битрикс24 отдельный вебхук не нужен — там свои экраны. Обзор — в статье Интеграции: обзор.
Добавить приёмщик
- Нажмите Добавить приёмщик.
- Задайте название — так приёмщик появится в форме: «Вебхук · название».
- Вставьте URL только с HTTPS. Локальный компьютер и закрытые адреса не подойдут.
- По желанию укажите секрет подписи. Мы подпишем тело запроса HMAC-SHA256. Если секрет уже сохранён, поле можно оставить пустым — он не изменится.
- При создании включите Назначить на все формы, если нужно. Иначе отметьте приёмщик на вкладке Хранилище у конкретных форм.
- Сохраните.
[изображение: экран приёмщика вебхука — название, URL, секрет подписи]
Вебхуков на сайт немного: общий лимит приёмщиков плюс отдельный потолок на этот тип. Если кнопка неактивна, удалите лишний адрес.
Проверить отправку
На сохранённом приёмщике нажмите Проверить отправку. На ваш URL уйдёт пробная заявка. Нужен ответ со статусом 2xx. Если ответ другой, в журнале будет ошибка.
Какое тело приходит
Метод — POST, тип application/json. Поля только добавляются, старые не ломаем. Сейчас в теле:
| Поле | Что внутри |
| event | Всегда form_submission — заявка с формы. |
| deliveredAt | Время отправки. |
| websiteId | Идентификатор сайта. |
| form | id и название формы. |
| submissionId | Идентификатор заявки. |
| pageUrl | Адрес страницы, с которой отправили форму. На старых страницах поле иногда пустое — это не мешает доставке. |
| contact | Имя, email и телефон, если такие поля были на форме. |
| fields | Остальные ответы: заголовок и значение. |
| utm | Метки source, medium, campaign, content, term — из скрытых полей или из адреса страницы. |
Если задан секрет, в запросе будет заголовок X-Photosquare-Signature вида sha256=… — подпись всего тела. Проверяйте её на своей стороне, прежде чем принимать заявку.
Ответ ждем до 10 секунд. Если сервер не ответил 2xx, Photosquare повторит отправку несколько раз, затем строка в журнале станет «Ошибка». Кнопка Повторить запускает ещё одну попытку.
Частые вопросы
| Вопрос | Ответ |
| Нужно ли публиковать сайт? | После галочки «Отправлять в» — нет. Публикация нужна, только если меняли саму форму на странице. |
| Почему URL не сохраняется? | Принимается только публичный HTTPS. Проверьте, что адрес открывается из интернета и не ведёт на localhost. |
| Какие заявки уходят? | Те, что отправили с формы, у которой отмечен этот приёмщик. Событие в теле — form_submission. |