8 min прочитаноintermediateПоследнее обновление: 9 нояб. 2026 г.

Как отправлять ответы на приглашения, отметки о прибытии и фото мероприятия в другие приложения

Webhooks позволяют вашему мероприятию сообщать другим приложениям о том, что происходит, в тот же момент. Когда гость отвечает на приглашение, его отмечают на входе или в галерее появляется новое фото, Fotify отправляет небольшое сообщение на выбранный вами адрес. Оттуда оно может попасть в вашу CRM, таблицу Google, канал Slack, цепочку писем или на ваш собственный сервер.

Подключиться можно двумя способами:

  • Zapier или Make без кода: подключитесь с помощью API-ключа и выберите, что должно происходить.
  • Собственный URL для webhook: Fotify отправляет на него подписанное JSON-сообщение.

Webhooks, Zapier и Make входят в тариф Professional и выше, а также в каждое мероприятие по подписке на мероприятия.

Что умеет отправлять Fotify

Каждый webhook отслеживает один или несколько из этих моментов:

  • Получен ответ на приглашение: гость ответил на приглашение или изменил свой ответ. Включает имя, email, телефон, ответ, размер группы, комментарии и ответы на ваши собственные вопросы.
  • Гость отмечен на входе: гостя отметили при входе, с данными о группе и о том, кто пришёл.
  • Новое фото или видео: в галерее появилось что-то новое. Фото приходят со ссылкой на изображение, которая действует 7 дней. Фото, ожидающие одобрения, отправляются после того, как вы их одобрите, а фото из приватных альбомов не отправляются никогда.
  • Мероприятие началось: вы запустили мероприятие, и гости могут загружать файлы.
  • Мероприятие завершено: вы завершили мероприятие или закончился период загрузки.

Шаг 1: подключите Zapier или Make

  1. В панели управления Fotify откройте Настройки аккаунта → Интеграции.
  2. Введите название ключа, например «Zapier», и нажмите Создать ключ.
  3. Сразу скопируйте ключ. В целях безопасности он показывается только один раз.
  4. Откройте приложение Fotify в Zapier или Make по этим ссылкам (в их каталогах приложений его пока нет) и вставьте ключ, когда оно попросит подключиться.
  5. Выберите триггер, например 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

  1. Откройте мероприятие в панели управления и прокрутите до карточки Webhooks, Zapier и Make.
  2. Нажмите Настроить webhooks, затем Добавить webhook.
  3. Вставьте адрес, который должен получать сообщения. Он должен начинаться с https:// и быть доступен из интернета.
  4. Отметьте, что отправлять, при желании добавьте метку и нажмите Добавить webhook.
  5. Скопируйте секрет подписи, показанный над новым webhook, и сохраните его в вашем приёмнике.
  6. Нажмите Отправить тестовое событие, чтобы убедиться, что всё доходит.

Добавлять и менять 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…. Чтобы его проверить:

  1. Возьмите t (время отправки) и необработанное тело запроса.
  2. Вычислите HMAC-SHA256 от t + . + тело, используя секрет подписи вашего webhook.
  3. Сравните результат с 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 мероприятия.

Была ли эта статья полезной?

Похожие статьи