Uso de datos de respuesta de webhook en su journey

Resumen

Cuando mapea valores de una respuesta de webhook, Pushwoosh los almacena como variables que puede usar más adelante en el journey, en cualquier lugar donde de otro modo usaría un atributo de Evento.

Nota

Para agregar un elemento Webhook y configurar el Mapeo de respuesta, consulte Webhook.

Guardar un valor de webhook como un Tag con Actualizar perfil de usuario

Un Webhook puede devolver datos de un sistema externo, como un ID de usuario de CRM o el estado de una suscripción, que Pushwoosh aún no almacena en el perfil del usuario. Actualizar perfil de usuario guarda los valores mapeados como Tags para que pueda usarlos en segmentos, contenido dinámico y en pasos posteriores del journey.

Ejemplo: guardar un ID de usuario de CRM como un Tag

Un nuevo usuario se registra en su aplicación y el journey crea un registro coincidente en su CRM. Guardar el ID de usuario de CRM devuelto como un Tag le permite hacer referencia o actualizar el mismo registro de CRM más tarde, por ejemplo, desde otro journey o una llamada de Webhook de seguimiento, en lugar de crear un registro duplicado cada vez que el usuario vuelve a entrar en el journey.

Flujo del Journey: Entrada basada en disparador → Webhook → Actualizar perfil de usuario → finalizar la rama

1. Cree un journey con Entrada basada en disparador en el evento SignUp.
2. Agregue un elemento Webhook después del paso de entrada. Asígnele un nombre (por ejemplo, Crear usuario en CRM) y establezca la URL de la solicitud en su punto final de creación de usuarios de CRM.
3. En Mapeo de respuesta, establezca Ruta en el campo de ID de la respuesta (por ejemplo, data.user.id) y Atributo en crm_user_id.

4. Agregue un elemento Actualizar perfil de usuario después del paso Webhook.

5. En Valor de Tag dinámico, haga clic en + Valor dinámico. En Tag, seleccione el Tag que almacena el ID de CRM (créelo con antelación si es necesario). En Evento, seleccione el paso de webhook por el nombre que le dio (Crear usuario en CRM). En Valor dinámico, seleccione crm_user_id.

6. Finalice la rama: agregue un elemento de Salida o déjela sin una conexión saliente.

Precaución

Si falta el valor del webhook para un usuario (la respuesta no fue JSON, la Ruta no se resolvió o la llamada falló), Pushwoosh omite esa actualización de Tag. El Tag mantiene su valor anterior o permanece sin establecer, y el journey continúa sin errores en este paso. Ejecute Probar webhook antes del lanzamiento para confirmar su mapeo. Más información.

Programar un retraso a partir de un valor de webhook con Retraso de tiempo

Las fechas de visita, los plazos de renovación y las ventanas de entrega a menudo se encuentran en un sistema externo de reservas o facturación. Después de que un Webhook mapea la fecha de la respuesta de la API, Retraso de tiempo puede pausar el journey hasta ese momento, por ejemplo, 2 días antes de una cita, para que el siguiente mensaje se envíe a tiempo.

Ejemplo: programar un recordatorio a partir de una fecha en la respuesta

Un usuario reserva una cita en su aplicación. El journey obtiene la fecha de la visita de su sistema de reservas y envía un recordatorio push 2 días antes de la visita.

1. Cree un journey con Entrada basada en disparador en el evento AppointmentBooked.
2. Agregue un elemento Webhook después del paso de entrada. Asígnele un nombre (por ejemplo, Obtener detalles de la cita) y establezca la URL de la solicitud en la API de su sistema de reservas.
3. En Mapeo de respuesta, establezca Ruta en el campo de fecha de la respuesta (por ejemplo, appointment.date) y Atributo en visit_date.

4. Agregue un elemento de Retraso de tiempo después del paso Webhook. Seleccione Basado en datos de usuario/evento, establezca Obtener fecha de en Evento, establezca Evento en el paso de webhook por el nombre que le dio (Obtener detalles de la cita), establezca Valor del evento en visit_date y establezca el retraso en Antes de 2 Días.

5. Si los usuarios pueden reservar con menos de 2 días de antelación a la visita, habilite Dividir en ramas si la fecha está en el pasado o la fecha está vacía en el elemento Retraso de tiempo. Esto crea dos ramas, En el pasado y En el futuro. Consulte Dividir ramas cuando la fecha está en el pasado o vacía.
6. Agregue un paso Push con su mensaje de recordatorio. Si la división está habilitada, agregue este Push en ambas ramas: En el pasado (enviar inmediatamente) y En el futuro (después del Retraso de tiempo).
7. Finalice cada rama: agregue un elemento de Salida o déjela sin una conexión saliente.

Precaución

Si el valor mapeado falta o no es una fecha válida, el usuario sale del journey con un error en este paso.

Si la visita es en menos de 2 días, el objetivo de Antes de 2 Días ya está en el pasado cuando el usuario llega a Retraso de tiempo, y el usuario abandona el journey sin errores y sin recordatorio, a menos que habilite Dividir en ramas si la fecha está en el pasado o la fecha está vacía.

A diferencia de Actualizar perfil de usuario, que deja el Tag sin cambios y continúa, Retraso de tiempo detiene al usuario cuando la fecha falta, no es válida o está en el pasado (sin división de ramas). Asegúrese de que su webhook devuelva de manera confiable una fecha en un formato compatible. Ejecute Probar webhook antes del lanzamiento. Más información.

Cosas a tener en cuenta

• Sintaxis de la ruta: use una ruta separada por puntos (por ejemplo, data.user.id). No se admiten comodines ni filtros. Consulte Mapeo de respuesta de Webhook para obtener más detalles.
• Tamaño de la respuesta: las respuestas de más de 64 KB no se procesan para el mapeo.
• Pruebas: ejecute Probar webhook en el elemento Webhook antes de usar valores mapeados en un journey en vivo.