Как отправлять ответы на приглашения, отметки о прибытии и фото мероприятия в другие приложения
Webhooks позволяют вашему мероприятию сообщать другим приложениям о том, что происходит, в тот же момент. Когда гость отвечает на приглашение, его отмечают на входе или в галерее появляется новое фото, Fotify отправляет небольшое сообщение на выбранный вами адрес. Оттуда оно может попасть в вашу CRM, таблицу Google, канал Slack, цепочку писем или на ваш собственный сервер.
Подключиться можно двумя способами:
- Zapier или Make без кода: подключитесь с помощью API-ключа и выберите, что должно происходить.
- Собственный URL для webhook: Fotify отправляет на него подписанное JSON-сообщение.
Webhooks, Zapier и Make входят в тариф Professional и выше, а также в каждое мероприятие по подписке на мероприятия.
Что умеет отправлять Fotify
Каждый webhook отслеживает один или несколько из этих моментов:
- Получен ответ на приглашение: гость ответил на приглашение или изменил свой ответ. Включает имя, email, телефон, ответ, размер группы, комментарии и ответы на ваши собственные вопросы.
- Гость отмечен на входе: гостя отметили при входе, с данными о группе и о том, кто пришёл.
- Новое фото или видео: в галерее появилось что-то новое. Фото приходят со ссылкой на изображение, которая действует 7 дней. Фото, ожидающие одобрения, отправляются после того, как вы их одобрите, а фото из приватных альбомов не отправляются никогда.
- Мероприятие началось: вы запустили мероприятие, и гости могут загружать файлы.
- Мероприятие завершено: вы завершили мероприятие или закончился период загрузки.
Шаг 1: подключите Zapier или Make
- В панели управления Fotify откройте Настройки аккаунта → Интеграции.
- Введите название ключа, например «Zapier», и нажмите Создать ключ.
- Сразу скопируйте ключ. В целях безопасности он показывается только один раз.
- Откройте приложение Fotify в Zapier или Make по этим ссылкам (в их каталогах приложений его пока нет) и вставьте ключ, когда оно попросит подключиться.
- Выберите триггер, например New RSVP response или New photo or video, и укажите ваше мероприятие в списке.
В списке мероприятий показаны те, которыми вы управляете и тариф которых включает webhooks. Каждый включённый Zap или сценарий появляется на странице Webhooks мероприятия с пометкой Zapier или Make.
Вместо приложения Fotify можно также использовать Webhooks by Zapier → Catch Hook в Zapier или Custom webhook в Make: скопируйте выданный ими адрес и добавьте его как URL для webhook на шаге 2.
Шаг 2: добавьте URL для webhook
- Откройте мероприятие в панели управления и прокрутите до карточки Webhooks, Zapier и Make.
- Нажмите Настроить webhooks, затем Добавить webhook.
- Вставьте адрес, который должен получать сообщения. Он должен начинаться с
https://и быть доступен из интернета. - Отметьте, что отправлять, при желании добавьте метку и нажмите Добавить webhook.
- Скопируйте секрет подписи, показанный над новым webhook, и сохраните его в вашем приёмнике.
- Нажмите Отправить тестовое событие, чтобы убедиться, что всё доходит.
Добавлять и менять webhooks могут только те, кто управляет мероприятием, и для каждого момента нужен доступ к его данным: для событий с гостями нужен доступ к списку гостей, для событий с фото — доступ к галерее.
Как выглядит сообщение
Каждое сообщение — это POST с телом в формате JSON:
{
"id": "4f1c2e9a-7b2d-4c1e-9a8f-2d3b4c5e6f70",
"type": "rsvp.responded",
"createdAt": "2026-06-01T18:24:05.000Z",
"event": { "id": "…", "name": "Ana & Leo's Wedding" },
"data": {
"rsvp": {
"firstName": "Alex",
"lastName": "Rivera",
"email": "alex@example.com",
"status": "accepted",
"confirmedGuests": 2
}
}
}
status ответа RSVP принимает одно из значений: accepted, declined, not_answered, attended, pending_approval (ждёт вашего подтверждения) или waitlisted. У гостя, который ждёт подтверждения или находится в листе ожидания, confirmedGuests равно 0, а размер группы, о котором он просил, указан в requestedGuests; rsvp.responded срабатывает снова, когда вы подтверждаете или отклоняете такого гостя.
Значение id не меняется при повторной отправке сообщения, поэтому ваш приёмник может пропускать дубликаты. Заголовки указывают момент (Fotify-Event) и само сообщение (Fotify-Delivery).
Даты самого мероприятия, такие как eventDate и eventTime, указываются в часовом поясе площадки, так, как их видят ваши гости.
Как проверить, что сообщение пришло от Fotify
Каждое сообщение содержит заголовок Fotify-Signature вида t=1780000000,v1=5257a8…. Чтобы его проверить:
- Возьмите
t(время отправки) и необработанное тело запроса. - Вычислите HMAC-SHA256 от
t+.+ тело, используя секрет подписи вашего webhook. - Сравните результат с
v1и отклоняйте сообщения, у которыхtстарше 5 минут.
В Node.js:
const crypto = require("crypto");
function isFromFotify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
Секрет можно показать снова или создать новый в карточке webhook. Новый секрет сразу заменяет старый.
Повторные попытки, журнал доставки и отключение webhooks
- Отвечайте статусом 2xx в течение 10 секунд, чтобы подтвердить получение сообщения.
- Неудачные сообщения повторяются 8 раз примерно за 4 часа.
- Журнал доставки в каждом webhook показывает все сообщения за последние 30 дней с их статусом, ответом и полным телом. Нажмите Отправить снова, чтобы отправить сообщение ещё раз.
- Webhook отключается сам, если его URL не отвечает 50 раз подряд, если получатель отвечает
410 Gone(так Zapier и Make сообщают, что Zap или сценарий удалён) или если добавивший его человек больше не имеет доступа к мероприятию. В карточке указана причина. Включите его снова, когда проблема будет устранена: вы станете тем, от чьего имени он действует.
Настройка webhooks с помощью ИИ-ассистента
Если вы подключили ИИ-ассистента, например Claude, можно попросить его показать webhooks мероприятия, добавить новый, отправить тест или удалить. URL нужно сообщить ему самим, а секрет подписи он покажет вам один раз.
Часто задаваемые вопросы
В: Какой тариф мне нужен? О: Webhooks, Zapier и Make входят в тариф Professional и выше и в каждую подписку на мероприятия. На других тарифах карточка Webhooks указывает тариф, который их включает.
В: Нужен ли мне аккаунт в Zapier или Make? О: Да, чтобы использовать Zapier или Make, нужен аккаунт в них. Для webhooks на ваш собственный URL больше ничего не требуется.
В: Сколько webhooks может быть у мероприятия? О: До 25, включая те, что создают Zapier и Make.
В: Почему фото не дошло до моего webhook? О: Фото отправляются, когда появляются в галерее. Фото, ожидающее одобрения, отправляется после того, как вы его одобрите, а фото из приватных альбомов не отправляются никогда.
В: Можно ли для теста использовать URL на моём компьютере?
О: Нет. Fotify отправляет данные только на публичные адреса https://. Для проверки с вашего компьютера используйте туннельный сервис или инспектор запросов.
В: Что будет с моими webhooks, если я отзову API-ключ? О: Zapier и Make больше не смогут создавать и удалять подписки с этим ключом. Удалите ненужные подписки на странице Webhooks мероприятия.
Была ли эта статья полезной?