Использование данных ответа вебхука в Journey

Обзор

Когда вы сопоставляете значения из ответа вебхука, Pushwoosh сохраняет их как переменные, которые вы можете использовать позже в Journey везде, где иначе бы использовали атрибут события.

Примечание

Чтобы добавить элемент Webhook и настроить Response mapping, см. Webhook.

Сохранение значения из вебхука как тега с помощью элемента «Обновить профиль пользователя»

Webhook может возвращать данные из внешней системы, такие как ID пользователя в CRM или статус подписки, которые Pushwoosh еще не хранит в профиле пользователя. Элемент «Обновить профиль пользователя» сохраняет сопоставленные значения как теги (Tags), чтобы вы могли использовать их в сегментах, динамическом контенте и на последующих шагах Journey.

Пример: сохранение ID пользователя из CRM как тега

Новый пользователь регистрируется в вашем приложении, и Journey создает соответствующую запись в вашей CRM. Сохранение возвращенного ID пользователя из CRM в качестве тега (Tag) позволяет вам ссылаться на ту же запись в CRM или обновлять ее позже, например, из другого Journey или при последующем вызове Webhook, вместо создания дублирующей записи каждый раз, когда пользователь повторно входит в Journey.

Схема Journey: Вход по триггеру → Webhook → Обновить профиль пользователя → конец ветки

1. Создайте Journey с элементом «Вход по триггеру» по событию SignUp.
2. Добавьте элемент Webhook после шага входа. Назовите его (например, Create user in CRM) и установите URL-адрес запроса на эндпоинт создания пользователя в вашей CRM.
3. В разделе Response mapping установите Path на поле ID в ответе (например, data.user.id) и Attribute на crm_user_id.

4. Добавьте элемент «Обновить профиль пользователя» после шага Webhook.

5. В разделе Dynamic Tag Value нажмите + Dynamic Value. В поле Tag выберите тег, в котором хранится ID из CRM (при необходимости создайте его заранее). В поле Event выберите шаг вебхука по заданному вами имени (Create user in CRM). В поле Dynamic Value выберите crm_user_id.

6. Завершите ветку — добавьте элемент «Выход» или оставьте ее без исходящего соединения.

Осторожно

Если значение из вебхука отсутствует для пользователя (ответ не был в формате JSON, Path не был разрешен или вызов не удался), Pushwoosh пропускает обновление этого тега. Тег сохраняет свое предыдущее значение или остается неустановленным, и Journey продолжается без ошибки на этом шаге. Запустите тестирование вебхука перед запуском, чтобы подтвердить ваше сопоставление. Узнать больше.

Планирование задержки на основе значения из вебхука с помощью элемента «Задержка по времени»

Даты визитов, сроки продления и окна доставки часто хранятся во внешней системе бронирования или биллинга. После того как Webhook сопоставит дату из ответа API, элемент «Задержка по времени» может приостановить Journey до этого момента, например, за 2 дня до встречи, чтобы следующее сообщение было отправлено вовремя.

Пример: планирование напоминания на основе даты из ответа

Пользователь записывается на прием в вашем приложении. Journey получает дату визита из вашей системы бронирования и отправляет push-напоминание за 2 дня до визита.

1. Создайте Journey с элементом «Вход по триггеру» по событию AppointmentBooked.
2. Добавьте элемент Webhook после шага входа. Назовите его (например, Get appointment details) и установите URL-адрес запроса на API вашей системы бронирования.
3. В разделе Response mapping установите Path на поле даты в ответе (например, appointment.date) и Attribute на visit_date.

4. Добавьте элемент «Задержка по времени» после шага Webhook. Выберите Based on user/event data, установите Get date from в значение Event, установите Event на шаг вебхука по заданному вами имени (Get appointment details), установите Event value в visit_date и установите задержку на Before 2 Days.

5. Если пользователи могут записаться менее чем за 2 дня до визита, включите опцию Split to branches if the date’s in the past or date is empty в элементе «Задержка по времени». Это создаст две ветки: In the past и In the future. См. Разделение на ветки, если дата в прошлом или пуста.
6. Добавьте шаг Push с вашим сообщением-напоминанием. Если разделение включено, добавьте этот Push в обе ветки: In the past (отправить немедленно) и In the future (после «Задержки по времени»).
7. Завершите каждую ветку — добавьте элемент «Выход» или оставьте ее без исходящего соединения.

Осторожно

Если сопоставленное значение отсутствует или не является допустимой датой, пользователь выходит из Journey с ошибкой на этом шаге.

Если до визита осталось менее 2 дней, цель Before 2 Days уже будет в прошлом, когда пользователь достигнет элемента «Задержка по времени», и пользователь покинет Journey без ошибки и без напоминания, если вы не включите опцию Split to branches if the date’s in the past or date is empty.

В отличие от элемента «Обновить профиль пользователя», который оставляет тег без изменений и продолжает выполнение, «Задержка по времени» останавливает пользователя, если дата отсутствует, недействительна или находится в прошлом (без разделения на ветки). Убедитесь, что ваш вебхук надежно возвращает дату в поддерживаемом формате. Запустите тестирование вебхука перед запуском. Узнать больше.

Что следует помнить

• Синтаксис Path: используйте путь, разделенный точками (например, data.user.id). Подстановочные знаки и фильтры не поддерживаются. Подробности см. в разделе Сопоставление ответа вебхука.
• Размер ответа: ответы размером более 64 КБ не обрабатываются для сопоставления.
• Тестирование: запустите тестирование вебхука в элементе Webhook перед использованием сопоставленных значений в активном Journey.