Uso de acciones de Iterable en flujos de acciones

Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

¿Qué plan tengo?

Suite, todas las versiones

Team, Growth, Professional, Enterprise o Enterprise Plus

Support

Team, Professional o Enterprise

Resumen: ◀▼

Los flujos de acciones se pueden conectar a Iterable usando una clave de API del lado del servidor para automatizar la administración del perfil de usuario, el seguimiento de eventos, los comentarios y las campañas de correo electrónico. Las acciones incluyen crear, actualizar y buscar usuarios, enviar correos electrónicos disparados y administrar campañas. Utilice una cuenta de servicio exclusiva para la integración y especifique el centro de datos correcto para garantizar una autenticación adecuada y una automatización fluida del flujo de trabajo en todas las plataformas.

Si el generador de acciones se conecta con sistemas externos, como Iterable, los administradores pueden integrar Zendesk con sistemas externos en los flujos de trabajo automatizados, lo que mejora la colaboración y mantiene una experiencia fluida en las distintas plataformas.

Nota: Los pasos asociados a los sistemas externos en los flujos de acciones se denominan colectivamente acciones externas.

En este artículo se tratan los siguientes temas:

• Conectar Iterable con el generador de acciones
• Usar acciones de Iterable en flujos de acciones

Conectar Iterable con el generador de acciones

Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

Las siguientes prácticas son las más recomendadas a la hora de conectarse a sistemas externos para usarlos en flujos de acciones:

• Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, conviene usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
• Todas las integraciones solicitan acceso a los ámbitos necesarios. Sin embargo, es importante que revise y valide los ámbitos antes de autorizar la conexión al sistema externo.
• Cuando necesite administrar credenciales para herramientas que funcionan con claves API (como OpenAI), lo mejor es guardar las claves en una bóveda o con un administrador de credenciales.

Para crear una clave de API

La conexión con Iterable requiere una clave de API del lado del servidor del proyecto de Iterable. Las claves de API de solo lectura no funcionarán. Asegúrese de crear una clave de API del lado del servidor con los permisos de escritura correspondientes.

1. Inicie sesión en su cuenta de Iterable.
2. Vaya a Integrations > API Keys.
3. Cree una nueva clave de API del lado del servidor.
4. Guarde la clave o mantenga abierta la ventana para poder copiarla y pegarla en Zendesk.

   La necesitará al conectar Iterable con el generador de acciones.

Para conectar el generador de acciones con Iterable

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones > Flujos de acciones.
2. Cree o edite un flujo de acciones.
3. Abra la barra lateral de pasos.
4. En Acciones externas, haga clic en Iterable.
5. Haga clic en Conectar.
6. Siga las instrucciones de Iterable para autenticarse y completar la conexión.
   • Ingrese su clave de API del lado del servidor de Iterable.
   • Especifique la región del centro de datos (EE. UU. o UE). Si su cuenta de Iterable está alojada en el centro de datos de la Unión Europea, debe especificar "UE" como el centro de datos. Si se deja vacía, la conexión se envía de manera predeterminada al centro de datos de Estados Unidos (api.iterable.com). Si se usa el centro de datos equivocado, se producirán fallas de autenticación.
   Nota: Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.

Después de conectarse al sistema, verá un indicador de conexión y detalles sobre la instancia a la que está conectado, así como las acciones disponibles para Iterable.

Usar acciones de Iterable en flujos de acciones

Están disponibles las siguientes acciones de Iterable:

• Crear usuario
• Actualizar usuario
• Buscar usuario
• Crear evento
• Agregar comentario
• Enviar correo electrónico al usuario
• Buscar campaña
• Mostrar campañas

Crear un usuario

Utilice la acción Crear usuario para crear un nuevo perfil de usuario en Iterable. Si el usuario ya existe, su perfil se actualizará con la información proporcionada (comportamiento de inserción).

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Email Opcional: User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Salida	Estado de éxito, mensaje, correo electrónico e ID de usuario.

Actualizar un usuario

Utilice la acción Actualizar usuario para actualizar un perfil de usuario existente en Iterable. Si el usuario no existe, se creará un nuevo perfil con la información proporcionada (comportamiento de inserción).

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Email Opcional: User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Salida	Estado de éxito, mensaje, correo electrónico e ID de usuario.

Buscar a un usuario

Utilice la acción Buscar usuario para recuperar un perfil de usuario por dirección de correo electrónico o ID de usuario.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Identifier type, Identifier value
Salida	Detalles del perfil de usuario como correo electrónico, ID de usuario, fecha de registro, fecha de actualización del perfil y campos de datos personalizados.

Crear un evento

Utilice la acción Crear evento para hacer seguimiento de un evento personalizado para un usuario en Iterable. Los eventos se pueden usar para segmentación, disparadores de campaña y análisis.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Email, Event name Opcional: User ID, Data fields Event ID, Campaign, Template,Create new fields
Salida	Estado de éxito, mensaje, nombre del evento, correo electrónico, ID de usuario e ID del evento.

Agregar un comentario

Utilice la acción Agregar comentario para agregar un comentario o una nota a un perfil de usuario. El comentario se almacena como un campo personalizado en los campos de datos del usuario.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Email, Comment Opcional: User ID, Field name
Salida	Estado de éxito, mensaje, correo electrónico, ID de usuario y nombre de campo donde se almacenó el comentario.

Enviar un correo electrónico a un usuario

Utilice la acción Enviar correo electrónico al usuario para enviar un correo electrónico disparado a un usuario usando una campaña de Iterable. La campaña debe estar en un estado que se pueda disparar.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Campaign, Recipient email Opcional: Data fields, Send at
Salida	Estado de éxito, mensaje, ID de campaña, correo electrónico del destinatario y hora de envío programada.

Buscar una campaña

Utilice la acción Buscar campaña para obtener detalles de la campaña, como nombre, estado, tipo e información de plantilla.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Requerido: Campaign
Salida	Detalles de la campaña como ID, nombre, estado, tipo, ID de plantilla, ID de listas, hora de envío, fecha de creación y fecha de actualización.

Mostrar campañas

Utilice la acción Mostrar campañas para obtener todas las campañas de su proyecto de Iterable.

Esta acción tiene las siguientes entradas y salidas:

	Variables
Entrada	Ninguna
Salida	Matriz de objetos de campaña que contiene ID, nombre, estado y tipo, además del recuento total.