# Activar Customer Journeys mediante una entrada basada en API

La entrada basada en API le permite iniciar un Customer Journey en el momento en que ocurre un evento de negocio específico. Para iniciar una campaña, debe enviar una solicitud de API especial.


## Configuración

1. Cree un Journey con una entrada basada en API

<video src="/customer-journey-api-based-entry-1.webm" alt="Interfaz del Customer Journey Builder que muestra cómo crear un nuevo Journey con el elemento de entrada basada en API" autoplay loop muted playsinline />

2. Haga doble clic en el paso de entrada basada en API. Se abrirá la ventana de configuración de la entrada.

3. Puede modificar el contenido de los pushes y los correos electrónicos cada vez que se inicie el Journey utilizando marcadores de posición de contenido. El valor de cada marcador de posición se puede cambiar en la solicitud. Si no necesita esta opción, puede omitir este paso.

> Por ejemplo, está creando un Journey para notificar a los suscriptores cuando se publique un nuevo episodio de podcast. Usando un marcador de posición de contenido, puede cambiar el título del podcast cada vez que inicie el Journey.

Primero, agregue los nombres de los marcadores de posición en la ventana de configuración de la entrada basada en API. Puede usar cualquier nombre que le resulte conveniente.

<video src="/customer-journey-api-based-entry-2.webm" alt="Ventana de configuración de la entrada basada en API que muestra cómo agregar nombres de marcadores de posición para contenido dinámico" autoplay loop muted playsinline />

Ahora, cree un [Preset](/es/product/content/presets/) de push o correo electrónico e inserte el marcador de posición en lugar del texto que desea modificar. El marcador de posición debe estar en uno de los siguientes formatos según sus necesidades:

* `{placeholder_name|format_modifier|}` – si el valor del marcador de posición no se especifica al iniciar la campaña, los usuarios verán un espacio vacío en su lugar.
* `{placeholder_name|format_modifier}` – si el valor del marcador de posición no se especifica y no se ha asignado previamente a un usuario (en caso de que haya utilizado una etiqueta como marcador de posición), el mensaje no se enviará.

<details>

<summary>Modificadores de formato</summary>

* CapitalizeFirst – pone en mayúscula la primera letra del valor de un marcador de posición;
* CapitalizeAllFirst – pone en mayúscula las primeras letras de todas las palabras en el valor de un marcador de posición si el valor consta de más de una palabra;
* UPPERCASE – cambia todas las letras a mayúsculas;
* lowercase – cambia todas las letras a minúsculas;
* regular – inserta el valor de un marcador de posición exactamente como se especifica en la solicitud, sin modificaciones.

</details>

<img src="/customer-journey-api-based-entry-3.webp" alt="Editor de presets de push que muestra un ejemplo de sintaxis de marcador de posición con modificadores de formato en el contenido del mensaje"/>

<Aside type="note">
También puede usar un nombre de etiqueta existente en lugar de un nombre de marcador de posición. En este caso, debe configurar la sobrescritura de este valor de etiqueta por el valor especificado en la solicitud como se describe a continuación.
</Aside>

Al configurar el paso de Push o Correo electrónico en su Journey, seleccione el preset creado y active la opción **Personalizar mensaje con atributos de evento**. Seleccione los marcadores de posición que desea modificar en la solicitud al iniciar el Journey. Elija una **Entrada basada en API** como origen y el nombre del marcador de posición como atributo dinámico:

<video src="/customer-journey-api-based-entry-4.webm" title="Configuración del paso de Push o Correo electrónico que muestra la opción Personalizar mensaje con atributos de evento y la selección del origen de la entrada basada en API" autoplay loop muted playsinline />

Haga clic en **Aplicar** para guardar los cambios.

4\. En la ventana de configuración de la entrada, copie la plantilla de solicitud para modificarla:

<img src="/customer-journey-api-based-entry-5.webp" alt="Ventana de configuración de la entrada basada en API que muestra la plantilla de solicitud de API con el formato de la cabecera de autorización"/>
<Aside>
Para iniciar un Journey a través de la API, debe incluir un token de autorización válido en la cabecera de Autorización.

**Formato de cabecera requerido**

 ```http
 Authorization: Api <your_api_token>
 ```
 **Ejemplo**

 ```http
 Authorization: Api c8dc6435-xxxxxxxxxxxxxxx
 ```
</Aside>

5. Agregue filtros de audiencia al parámetro "filter" usando el [lenguaje de segmentación](/es/developer/api-reference/segmentation-filters-api/segmentation-language/). Tenga en cuenta que necesita configurar las [etiquetas](/es/developer/guides/audience-and-segmentation/tags/) necesarias con antelación.

Por ejemplo, si desea dirigir el Journey a los usuarios que agregaron el artículo _Socks_ a su _Wishlist_, el valor de "filter" debe tener el siguiente aspecto:

```
    "filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"
```

En este ejemplo, debe tener una etiqueta _Wishlist_ configurada en su aplicación.

<Aside type="note">
El código de su aplicación se agregará automáticamente al parámetro "filter" en el formato `A(\"12345-12345\")`. Por favor, no lo elimine ni lo modifique.

Además, tenga en cuenta que las comillas ("") y las barras invertidas (\\) deben escaparse con una barra invertida (\\) en las consultas JSON.
</Aside>

6. Si ha configurado marcadores de posición, especifique el contenido deseado como sus valores:

<img src="/customer-journey-api-based-entry-6.webp" alt="Plantilla de solicitud de API que muestra la configuración de los valores de los marcadores de posición para el contenido dinámico en el inicio del Journey"/>

7. Si la opción **Límites de tasa de mensajes** está habilitada, se limitará el número de usuarios que ingresan al Journey a la vez cada segundo. Puede usar el valor predeterminado de 5000 usuarios por segundo o establecer otro número.

<img src="/customer-journey-api-based-entry-7.webp" alt="Configuración de la entrada basada en API que muestra la opción de Límites de tasa de mensajes con un valor predeterminado de 5000 usuarios por segundo"/>

<Aside type="tip">
Recomendamos mantener el valor entre 5000 y 10000 usuarios por segundo. Si el valor es demasiado bajo, su audiencia podría tardar más en entrar en el Journey. Si el valor es demasiado alto, el servicio que procesa sus datos puede sobrecargarse.
</Aside>

8. Si planea reiniciar su campaña con frecuencia y no quiere que los mismos usuarios entren en el Journey varias veces, establezca el [Límite de frecuencia](/es/product/customer-journey/journey-settings#frequency-capping).

> Por ejemplo, ha creado una campaña para notificar a los usuarios sobre una reducción de precio para un producto específico. Desea volver a lanzar el Journey varias veces enviando varias solicitudes con diferentes filtros de audiencia. En este caso, puede agregar un Límite de frecuencia para que la notificación no se envíe repetidamente a los usuarios que coincidan con múltiples filtros.

9. Si desea que un Journey se inicie cada vez que ocurra un determinado evento de negocio, automatice la solicitud utilizando el webhook. Una vez que ocurra el evento, el webhook debería enviar automáticamente la solicitud para iniciar el Journey.

También puede enviar la solicitud manualmente si no necesita automatización.

<Aside type="note">
* Si cambia las condiciones de segmentación al enviar una nueva solicitud, esto no afectará a los usuarios que ya han entrado en el Journey.
* Si cambia el contenido del mensaje al enviar una nueva solicitud, todos los usuarios recibirán la nueva versión del mensaje (incluidos aquellos que ya entraron en el Journey pero que aún no han recibido este mensaje).
</Aside>