Crear y actualizar

Estos endpoints crean y editan la definición del journey: su título, configuración y los puntos en el lienzo. No inician el journey. Utiliza Ciclo de vida para ello.

Ambos aceptan y devuelven el objeto de journey.

Consejo

Escribir un gráfico de journey completo en JSON es difícil. Cada punto tiene sus propios campos y condiciones de canal (Referencia de punto). El flujo de trabajo más fiable es construir el journey una vez en el constructor de Customer Journey, leerlo de nuevo desde una respuesta de creación/actualización y, a continuación, utilizar estos endpoints para clonarlo o ajustarlo programáticamente.

Crear

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway

Crea un nuevo journey en el estado STATUS_DRAFT.

Solicitud

Campo	Requerido	Tipo	Descripción
title	Sí	string	Nombre del journey.
params	Sí	JourneyParams	Configuración para todo el journey. params.application_code es requerido.
points	No	array of Point	Elementos del journey en el lienzo y sus conexiones.
comments	No	array of JourneyComment	Comentarios del lienzo.

Ejemplo de solicitud

Crear un journey

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Welcome series",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

Respuesta

Devuelve el nuevo objeto de journey. Lee el UUID del journey desde info.uuid y úsalo para las siguientes llamadas de actualización y ciclo de vida.

Ejemplo de respuesta

{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "status": "STATUS_DRAFT",
    "params": { "application_code": "XXXXX-XXXXX" }
  },
  "points": [],
  "comments": []
}

Ejemplo de journey completo

Un cuerpo Create completo para un pequeño flujo de bienvenida. El gráfico es:

Start by segment ──default──▶ Send push ──default──▶ Wait 1 day ──default──▶ Boolean splitter ──output1──▶ Send email ──default──▶ Exit
                                                                                              └──default───────────────────────────▶ Exit

Los puntos se conectan a través del info.next_point_uuid de cada salida. Ten en cuenta las claves de salida: cada punto utiliza default, excepto el divisor booleano, que añade output1 para la rama de condición coincidente (default es su alternativa). El punto de salida no tiene salidas — y es opcional: dejar info.next_point_uuid sin establecer en cualquier otra salida finaliza el journey de la misma manera.

{
  "title": "Welcome series",
  "params": {
    "application_code": "XXXXX-XXXXX",
    "user_id_track_change_policy": "TRACK"
  },
  "points": [
    {
      "uuid": "11111111-1111-1111-1111-111111111111",
      "title": "New signups",
      "point_type": "POINT_TYPE_START_BY_SEGMENT",
      "position": { "x": 80, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "22222222-2222-2222-2222-222222222222" } }
      ],
      "point_data": {
        "start_by_segment": {
          "application_code": "XXXXX-XXXXX",
          "filter_code": "AAAAA-BBBBB"
        }
      }
    },
    {
      "uuid": "22222222-2222-2222-2222-222222222222",
      "title": "Welcome push",
      "point_type": "POINT_TYPE_SEND_PUSH",
      "position": { "x": 340, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "33333333-3333-3333-3333-333333333333" } }
      ],
      "point_data": {
        "send_push": {
          "application_code": "XXXXX-XXXXX",
          "title": "Welcome!",
          "content": "Thanks for joining — here's how to get started."
        }
      }
    },
    {
      "uuid": "33333333-3333-3333-3333-333333333333",
      "title": "Wait 1 day",
      "point_type": "POINT_TYPE_WAIT",
      "position": { "x": 600, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "44444444-4444-4444-4444-444444444444" } }
      ],
      "point_data": {
        "delay": { "sec": 86400 }
      }
    },
    {
      "uuid": "44444444-4444-4444-4444-444444444444",
      "title": "Opened the push?",
      "point_type": "POINT_TYPE_BOOLEAN_SPLITTER",
      "position": { "x": 860, "y": 200 },
      "outputs": [
        { "identity": { "key": "output1", "order": 1 },
          "info": { "title": "Matched", "next_point_uuid": "55555555-5555-5555-5555-555555555555" } },
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "Everyone else", "next_point_uuid": "66666666-6666-6666-6666-666666666666" } }
      ],
      "point_data": {
        "boolean_splitter": {
          "split_strategy": "SPLIT_FILTER",
          "load_policy": "ALL",
          "filter_code": "CCCCC-DDDDD"
        }
      }
    },
    {
      "uuid": "55555555-5555-5555-5555-555555555555",
      "title": "Follow-up email",
      "point_type": "POINT_TYPE_SEND_EMAIL",
      "position": { "x": 1120, "y": 120 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "66666666-6666-6666-6666-666666666666" } }
      ],
      "point_data": {
        "send_email": {
          "application_code": "XXXXX-XXXXX",
          "preset_code": "12345-67890"
        }
      }
    },
    {
      "uuid": "66666666-6666-6666-6666-666666666666",
      "title": "Exit",
      "point_type": "POINT_TYPE_EXIT",
      "position": { "x": 1380, "y": 200 },
      "outputs": [],
      "point_data": {
        "terminator": {}
      }
    }
  ],
  "comments": []
}

Actualizar

PUT https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}

Reemplaza la definición de un journey existente. Envía la definición completa. Los puntos y comentarios que envíes reemplazarán a los actuales.

Parámetros de ruta

Nombre	Tipo	Descripción
uuid	string	ID del Journey a actualizar.

Solicitud

Campo	Tipo	Descripción
title	string	Nuevo nombre del journey.
params	JourneyParams	Nueva configuración para todo el journey.
points	array of Point	Nuevo conjunto completo de puntos.
comments	array of JourneyComment	Nuevo conjunto completo de comentarios.
autosave	bool	Cuando es true, el cambio se trata como un autoguardado del editor. El valor por defecto es false.

Ejemplo de solicitud

Renombrar y reconfigurar un journey

curl -X PUT https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/11111111-2222-3333-4444-555555555555 \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Welcome series v2",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

Respuesta

Devuelve el objeto de journey actualizado.

Actualizar y reanudar

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}/resume

Aplica ediciones a un journey y lo reanuda en una sola llamada. Esto es el equivalente a una Actualización seguida de un Inicio del ciclo de vida. El cuerpo de la solicitud coincide con Actualización. Utiliza esto cuando edites un journey en pausa que quieras volver a poner en el estado STATUS_RUNNING.

Renombrar

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}/rename

Cambia solo el título del journey, sin tocar sus puntos o configuración.

Campo	Requerido	Tipo	Descripción
title	Sí	string	Nuevo nombre del journey.

Ejemplo de solicitud

Renombrar un journey

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/11111111-2222-3333-4444-555555555555/rename \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Welcome series (Q3)" }'

Relacionado

Objeto de journey

Ciclo de vida

Iniciar por API