Referencia de puntos

Cada punto lleva un objeto point_data con exactamente una clave anidada, que coincide con el point_type del punto (consulte la asignación de point-type → clave). Esta página documenta la estructura bajo cada clave.

Nota

Los puntos de entrada, temporización, división, acción y conversión se documentan en su totalidad a continuación.

Para los puntos de mensajería (send_*, inapp), esta página cubre solo los campos estructurales: a qué preset o contenido hacer referencia y qué configuración de canal pasar. El contenido del mensaje en sí se define en el preset y se documenta en la API de Presets y en la documentación por canal. Algunos campos hacen referencia a objetos anidados que reflejan los controles en el constructor de Customer Journey.

Puntos de entrada

Un Journey necesita al menos un punto de entrada. Todos los puntos de entrada tienen una única salida default.

start_by_segment

Ingresa a los usuarios que coinciden con un segmento. POINT_TYPE_START_BY_SEGMENT.

Campo	Tipo	Descripción
application_code	string	Código de aplicación.
filter_code	string	Código de segmento/filtro que define la audiencia.
repeat	SegmentRepeat	Programación opcional de entrada recurrente (consulte SegmentRepeat).
start_at	timestamp	No procesar antes de esta hora (ISO 8601).
is_deactivated	bool	Indica si este punto de entrada está desactivado.

message_bus (entrada por evento)

Ingresa a los usuarios cuando activan un evento. POINT_TYPE_EVENT.

Campo	Tipo	Descripción
event_name	string	Nombre del evento a escuchar.
application_code	string	Código de aplicación.
event_conditions	PointEventCondition[]	Condiciones que se comparan con los atributos del evento.
active_period	Period	Ventana de tiempo durante la cual el disparador está activo.
multi_entry	MultiEntry	Cómo un usuario puede ingresar más de una vez (consulte MultiEntry).
attribute_entry	AttributeEntry	Inscribir los ID de usuario que se encuentran en un atributo de evento en lugar del usuario que activó el evento (consulte AttributeEntry).
allow_reenter	bool	Indica si los usuarios pueden volver a entrar en el Journey.

AttributeEntry

Inscribe los ID de usuario que se encuentran en un atributo de evento, en lugar del usuario que activó el evento. Refleja Usuarios de un atributo de evento en el constructor de Customer Journey.

Campo	Tipo	Descripción
enabled	bool	Indica si se deben inscribir los usuarios nombrados en un atributo de evento en lugar del usuario que activó el evento.
attribute_name	string	Nombre del atributo de evento que contiene el ID de usuario (o la lista de ID de usuario) a inscribir.

start_by_api

Punto de entrada alimentado por la llamada Start by API. POINT_TYPE_START_BY_API.

Campo	Tipo	Descripción
application_code	string	Código de aplicación.
attributes	string[]	Nombres de los atributos personalizados que se pueden pasar en los attribute_values de una solicitud Start by API.
is_deactivated	bool	Indica si este punto de entrada está desactivado.

Puntos de temporización

delay (espera)

Pausa a cada usuario durante un intervalo fijo o calculado. POINT_TYPE_WAIT. El objeto point_data.delay establece exactamente una de las siguientes claves de intervalo:

Clave de intervalo	Tipo	Descripción
sec	uint64	Esperar un número fijo de segundos.
exact_time	ExactTime	Esperar hasta una hora del día (hour, minute).
exact_date_time	ExactDateTime	Esperar hasta una fecha y hora absolutas.
exact_week_days_time	ExactWeekDaysTime	Esperar hasta horas específicas en días de la semana específicos (mapa del día 0=Lunes … 6=Domingo → ExactTime).
dynamic_time	DynamicTime	Esperar en relación con un valor de una etiqueta o evento.

Un dynamic_time con split_branches: true añade una rama output1 (consulte claves de salida).

DynamicTime

Campo	Tipo	Descripción
from	enum DynamicTimeFrom	Indica si la hora base proviene de una etiqueta o de un evento.
direction	enum DynamicTimeDirection	Desplazamiento antes o después de la hora base.
duration	uint64	Tamaño del desplazamiento.
unit	enum DynamicTimeUnit	Unidad de duration (minutos, horas, días, …).
split_branches	bool	Dividir a los usuarios en ramas separadas cuando sus tiempos calculados difieren.
tag_name	string	Etiqueta que contiene la hora base (cuando from es una etiqueta).
event_name / event_attribute / point_id	string	Fuente del evento de la hora base (cuando from es un evento).

wait_event

Espera hasta que los usuarios activen un evento (o un tiempo de espera). POINT_TYPE_WAIT_EVENT. La salida default es la ruta no activada. La ruta activada es output1 o, con un script, una rama por condición.

Campo	Tipo	Descripción
events	PointWaitEventInfo[]	Eventos a esperar.
conditions_script	string	Script opcional para lógica compleja de múltiples eventos. Sus nombres de condición analizados se convierten en las claves de salida.
multi_entry	MultiEntry	Comportamiento de reingreso.

Puntos de división y filtrado

boolean_splitter

Dirige a los usuarios por ramas según una condición. POINT_TYPE_BOOLEAN_SPLITTER.

Campo	Tipo	Descripción
split_strategy	enum	SPLIT_FILTER (por segmento), SPLIT_TAGS (por condiciones de etiqueta) o SPLIT_EVENTS (por condiciones de evento).
load_policy	enum	ALL (cualquiera de los dispositivos del usuario puede coincidir) o FILTER (solo el dispositivo actual).
filter_code	string	Código de segmento, cuando split_strategy es SPLIT_FILTER.
filter_expressions	FilterExpression[]	Condiciones de etiqueta, cuando split_strategy es SPLIT_TAGS: una rama output adicional por expresión.
event	BooleanSplitterEventInfo	Condiciones de evento, cuando split_strategy es SPLIT_EVENTS: una rama output adicional por condición.

ab_splitter

Divide aleatoriamente a los usuarios en variantes ponderadas. POINT_TYPE_AB_SPLITTER. Las claves de salida son output0, output1, … (una por entrada en split, indexada desde 0. No hay default).

Campo	Tipo	Descripción
split	uint32[]	Porcentaje para cada rama. Debe sumar 100. El índice i se asigna a la clave de salida output{i}.
auto_select_winner	bool	Indica si se debe elegir automáticamente una rama ganadora.
winner_strategy	enum	ANY_GOAL o SPECIFIC_GOAL.
goal_uuid	string	Objetivo utilizado para determinar el ganador (con SPECIFIC_GOAL).
winner_split	uint32	Número de la rama ganadora (base 1, 0 = aún no hay ganador).

filter

Permite que solo los usuarios que coinciden continúen (default), dirigiendo el resto a output1. POINT_TYPE_FILTER.

Campo	Tipo	Descripción
filter	enum Filter	Una comprobación predefinida: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS o CUSTOM.
filter_raw	string	Expresión de filtro personalizada, cuando filter es CUSTOM.

Puntos de acción

set_tags

Actualiza las etiquetas del usuario. POINT_TYPE_SET_TAGS.

Campo	Tipo	Descripción
application_code	string	Código de aplicación.
tags	Tag[]	Etiquetas a escribir.

Tag

Campo	Tipo	Descripción
name	string	Nombre de la etiqueta.
type	enum TagType	Tipo de datos y operación: TYPE_STRING, TYPE_INTEGER, TYPE_DATE, TYPE_BOOLEAN, TYPE_LIST, TYPE_LIST_APPEND, TYPE_LIST_REMOVE, TYPE_DYNAMIC, …
value	oneof	Exactamente una clave de valor que coincida con type: str, int, bool, date, price, version, timezone, list o dynamic.

web_hook

Envía una solicitud HTTP saliente. POINT_TYPE_WEBHOOK. Salida única default.

Campo	Tipo	Descripción
method	string	Método HTTP (GET, POST, PUT, …).
url	string	URL de destino.
request_template	string	Plantilla del cuerpo de la solicitud. Admite plantillas Liquid.
headers	map<string, string>	Cabeceras HTTP.
disabled	bool	Solo lectura. true cuando Pushwoosh desactiva automáticamente el webhook después de errores repetidos.
reactivate	bool	Solo escritura. Establezca true para volver a habilitar un webhook desactivado.

Puntos de conversión

goal_event

Realiza un seguimiento de un objetivo de conversión. POINT_TYPE_GOAL_EVENT. No tiene salidas.

Campo	Tipo	Descripción
event_name	string	Nombre del evento objetivo.
application_code	string	Código de aplicación.
event_conditions	PointEventCondition[]	Condiciones que se comparan con los atributos del evento objetivo.
is_throw_out	bool	Indica si se debe eliminar al usuario del Journey una vez que se alcanza el objetivo.
is_cancel_event	bool	Indica si este es un objetivo negativo (de cancelación).

Puntos de salida

terminator

Finaliza el Journey para el usuario. POINT_TYPE_EXIT. Objeto vacío ({}) y sin salidas.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

Un punto terminador es opcional. Dejar sin establecer el info.next_point_uuid de una salida finaliza el Journey para el usuario de la misma manera que lo hace un terminador explícito; ambos casos se cuentan de la misma manera, como Salidas, no como errores.

Puntos de mensajería

Todos los puntos de mensajería envían a través de un canal y comparten una envoltura común. Cada uno tiene una única salida default a menos que se habilite un divisor (consulte claves de salida).

Campos comunes:

Campo	Tipo	Descripción
application_code	string	Código de aplicación.
preset_code	string	Preset (plantilla) para enviar. inapp utiliza richmedia_code en su lugar.
content / title	string	Contenido del mensaje en línea, cuando no se utiliza un preset (depende del canal).
campaign_code	string	Código de campaña para seguimiento. Se crea automáticamente si se omite.
split_params	BehaviorSplitter	Opcional: esperar una interacción y ramificar en función de ella.
message_type	enum	Tipo de mensaje Marketing vs transaccional (controla el manejo del grupo de control). No utilizado por send_email, que tiene su propio par email_type/email_category a continuación.

Tipos de puntos y sus campos adicionales notables:

Tipo de punto	Clave point_data	Notas
POINT_TYPE_SEND_PUSH	send_push	split_params (comportamiento) más un divisor de entrega pueden producir hasta tres salidas. send_by_user_id, wait_optimal_time.
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category (ver más abajo). Consulte la API de Email.
POINT_TYPE_SEND_SMS	send_sms	Consulte SMS.
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	Un preset de respuesta rápida añade una salida por respuesta (clave = valor de la respuesta). Consulte WhatsApp.
POINT_TYPE_SEND_TELEGRAM	send_telegram	Canal de Telegram.
POINT_TYPE_SEND_KAKAO	send_kakao	Consulte Kakao.
POINT_TYPE_SEND_LINE	send_line	Consulte la API de LINE.
POINT_TYPE_SEND_DATA	send_data	Mensaje de datos silencioso (sin interfaz de usuario).
POINT_TYPE_INAPP	inapp	Utiliza richmedia_code, expire_in_days, capping.

Precaución

En send_email, email_type debe omitirse o establecerse exactamente en marketing o transactional — en minúsculas, cualquier otro valor es rechazado. email_category es obligatorio cuando email_type es marketing, y debe ser el código de una categoría existente, no su nombre para mostrar.

Esto no se comprueba cuando se crea o actualiza el punto, solo cuando el Journey se valida o se inicia. Un valor incorrecto se guarda sin error y solo aparece en ese momento.

Tipos compartidos

SegmentRepeat

Campo	Tipo	Descripción
enabled	bool	Indica si la entrada recurrente está activada.
frequency	string	daily, weekly, monthly o dates.
every	uint32	Repetir cada N períodos.
dates	string[]	Fechas específicas, cuando frequency es dates.
time	SegmentRepeatTime	Configuración de la hora del día.

Objetos de tiempo

• ExactTime: { "hour": 0–23, "minute": 0–59 }.
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

Campo	Tipo	Descripción
enabled	bool	Indica si se debe esperar una interacción y ramificar en función de ella.
interval	uint64	Segundos a esperar por la interacción.

MultiEntry

Controla cuántas sesiones activas puede tener un usuario en el Journey al mismo tiempo. Refleja Controlar cuántas sesiones puede tener un usuario al mismo tiempo en el constructor de Customer Journey. Utilizado por el punto de entrada de evento y wait_event.

Campo	Tipo	Descripción
enabled	bool	Indica si un usuario puede tener múltiples sesiones activas al mismo tiempo. false: una sesión activa por usuario. true: múltiples sesiones activas por usuario.
attribute_name	string	Opcional. Atributo de evento que define el alcance de cada sesión. Cuando se establece, un usuario puede tener una sesión activa por cada valor distinto de este atributo (por ejemplo, una por order_id). Los eventos con el mismo valor comparten una sesión. Deje vacío para agrupar todas las entradas del usuario.

Relacionado

Objeto Journey

Crear y actualizar

API de Presets