Herramientas de perfiles de Customer Agent

Objetivos del artículo

Cuáles son las herramientas de perfiles de Agente de Clientes, qué hace cada una de ellas y cómo utilizarlas en sus habilidades. Estas herramientas permiten que tu agente lea y escriba en el perfil de Klaviyo de un comprador durante una conversación, para que pueda personalizar las respuestas, responder preguntas de "¿qué es lo mío?" y capturar nuevos datos para volver al perfil.

Las cinco herramientas de perfiles

Agente de Clientes viene con cinco herramientas integradas que leen o escriben datos en el perfil del comprador autenticado. No los configuras, ya que están disponibles para añadirlos a cualquier habilidad.

Los cinco resuelven automáticamente al comprador desde el contexto de la conversación (su correo electrónico, teléfono o ID de perfil). Solo funcionan para compradores identificados.

Puedes encontrar las cinco en la página Herramientas en Agente de Clientes y adjuntarlas a cualquier habilidad del editor de habilidades.

Nota: Estas herramientas están en versión beta. Están disponibles para todas las marcas en el Agente de Clientes, no se requiere un registro separado, pero la función aún se está ampliando y puede cambiar.

Cuándo utilizar cada uno

Obtener perfil

Úsalo cuando el agente necesite saber con quién está hablando: propiedades como el nombre, las preferencias de correo electrónico, la última dirección de envío o cualquier propiedad personalizada que almacenes.

Ejemplo: "Hola, Sarah! Veo que vuestro último pedido fue enviado a la dirección que termina en 1234. ¿Deberíamos usar esa otra vez?"

Obtener eventos del perfil

Utilízalo cuando el agente necesite saber lo que el comprador ha hecho. Pedidos, aperturas de correo electrónico, envíos de formularios, vistas de página, suscripciones: cualquier cosa rastreada como un evento en el perfil.

Ejemplos:

• Un comprador pregunta: “¿Cuándo fue mi último pedido?” La skill adjunta Obtener eventos del perfil con Tipo de evento = Placed Order y responde con la fecha.
• Un comprador pregunta: “¿Qué había en mi carrito?” La habilidad adjunta Obtener eventos del perfil con Tipo de evento = Added to Cart y enumera los elementos de vuelta.

Puedes elegir el tipo de evento y otros ajustes en la barra lateral de la herramienta cuando la adjuntes; consulta Configurar una herramienta cuando la adjuntes a continuación.

Obtén listas de perfiles y segmentos

Utiliza cuándo el comportamiento del agente debe depender del público al que se dirige el comprador. ¿Cliente VIP? ¿Ya estás en la lista de reposición de stock? ¿Excluido de los correos electrónicos promocionales?

Ejemplo: Si el comprador está en el segmento VIP, el agente ofrece una actualización de cortesía en una devolución.

Obtén el resumen predictivo del perfil

Utilízalo cuando el comprador o la habilidad necesiten la información predictiva de Klaviyo: valor de vida del cliente, riesgo de abandono, próxima compra esperada o puntaje de estado del cliente.

Ejemplo: Una habilidad de retención comprueba el riesgo de abandono antes de ofrecer un descuento de ahorro: los compradores de alto riesgo obtienen una oferta más sólida.

Actualizar propiedad del perfil

Úsalo cuando el agente deba escribir algo en el perfil del comprador durante una conversación: respuestas a cuestionarios, preferencias, comentarios, cualquier cosa que de otro modo capturarías en un formulario.

Ejemplos:

• Un comprador responde un cuestionario: “Prefiero aromas terrosos.” → El agente escribe scent_preference: earthy.
• Un comprador da comentarios durante una devolución: “No me quedó, viene reducido”. → El agente guarda last_return_reason: sizing.

Una vez que una propiedad está en el perfil, todas las demás partes de Klaviyo pueden utilizarla: flujos, segmentos, campañas y futuras conversaciones de Agente de Clientes.

Cómo utilizar estas herramientas en una habilidad

1. Abre la habilidad que deseas actualizar (o crea una nueva).
2. En el editor de habilidades, adjunta las herramientas de perfil que necesitas.
3. Si la herramienta tiene entradas de configuración, rellénalas (consulta más abajo).
4. En la sección Cómo responder, dile a la habilidad cuándo y cómo utilizar cada herramienta. Sé específico:
   • Cuándo el agente debe llamar a la herramienta
   • Qué debe hacer con el resultado
   • Para Actualizar la propiedad del perfil: qué propiedad escribir, en qué formato debe estar el valor y cuándo no escribir

Configurando una herramienta cuando la conectas

Algunas herramientas de perfil tienen entradas que puedes rellenar previamente a nivel de habilidad. El llenado previo bloquea el valor de cada llamada que realiza la habilidad, lo que te brinda un control más estricto y evita que el agente tenga que resolverlo en tiempo de ejecución.

El ejemplo principal esObtener eventos del perfil. Cuando lo adjuntas a una habilidad, puedes configurar lo siguiente:

• Tipo de evento (obligatorio) — qué métrica obtener (p. ej., Placed Order, Checkout Started, Added to Cart, Opened Email, Viewed Product).
• Límite: cantidad de eventos recientes a devolver. Utiliza 1 si solo necesitas el más reciente.
• Orden: el más reciente primero o el más antiguo primero.
• Ventana de retrospectiva: qué tan atrás para buscar. Predeterminado: 90 días.

Por ejemplo, una habilidad que necesita ver el carrito más reciente del comprador podría adjuntar Get Profile Events con Event type = Checkout Started, Limit = 1, Sort order = Newest first, Lookback window = 30 days. Así, el agente ya no tiene que pensar en esas decisiones: ya vienen integradas.

Ejemplo de fragmento "Cómo responder" (Actualizar la propiedad del perfil):

Cuando el comprador te indique su preferencia de aroma, llama a Actualizar propiedades del perfil para guardarla en la propiedad scent_preference usando una de estas opciones: floral, earthy, citrus, fresh. Solo escribe si el comprador lo confirma explícitamente. Confirma al comprador que se guardó, en una sola oración.

Ejemplo de fragmento "Cómo responder" (Obtener perfil + Obtener eventos del perfil):

Cuando el comprador te pregunte por sus pedidos recientes, llama a Obtener eventos del perfil para recuperar su historial de pedidos. Resume los resultados con la fecha, el recuento de artículos y el estado actual. Si el comprador te pregunta quién es o qué hay en el archivo, usa Obtener perfil.

(Adjunta Get Profile Events con Event type = Placed Order, Limit = 3, Sort order.)

Consejos

• Lee antes de escribir. Si estás personalizando una respuesta, adjunta primero Obtener perfil o Obtener eventos del perfil. El agente no puede hacer referencia a los datos que no ha extraído.
• La propiedad tiene que existir primero y tiene que ser una propiedad personalizada. Actualizar la propiedad del perfil solo escribe en propiedades personalizadas del perfil que ya existen en los perfiles de tu empresa. Los campos del sistema (Correo electrónico, Nombre, Número de teléfono, Subcampos de ubicación) y los campos derivados (Creado, Primera vez activo, $id) no se pueden escribir. Crea primero la propiedad personalizada en Klaviyo y luego apunta la habilidad con el nombre exacto.
• Restringe el valor establecido al escribir. Explica los valores permitidos en las instrucciones de habilidad ("uno de: floral, terroso, cítrico, fresco"). De lo contrario, el agente escribirá mensajes de texto gratuitos y tus segmentos no coincidirán.
• Dile al agente cuándo no escribir. "Solo escribe si el comprador confirma explícitamente" evita sobrescribir accidentalmente.
• Confirma las escrituras al comprador. Un breve "Entendido, lo guardé como prefieras" cierra el bucle.
• Haz coincidir la herramienta con la pregunta. "¿Qué compré?" → Eventos del perfil. "¿Soy VIP?" → Listas y segmentos. "¿Qué tan probable es que abandone?" → Resumen predictivo.
• Utiliza Agent Builder para conectarlos. Describe lo que deseas en inglés sencillo y Agent Builder adjuntará las herramientas adecuadas y escribirá las instrucciones de habilidad para ti. Por ejemplo: "Quiero que mi habilidad de recomendaciones analice lo que había en el carrito del comprador para recomendar algo similar".

Lo que estas herramientas no hacen

• No trabajan directamente en conversaciones anónimas. Si el agente quiere llamar a una de estas herramientas y el comprador no está identificado, se le pedirá que inicie sesión primero. Una vez identificados, la herramienta se ejecuta.
• Actualizar la propiedad del perfil no crea nuevos compradores. El perfil ya debe existir.
• Actualizar propiedad del perfil no escribe eventos. La redacción de eventos será una herramienta aparte, próximamente.
• Ninguna de las herramientas de lectura modifica los datos. Solo buscan.

Preguntas frecuentes

¿Puedo escribir en alguna propiedad con Actualizar propiedad del perfil?

Solo propiedades del perfil personalizadas (las que defines en los perfiles, como scent_preference o isMom). Los campos del sistema — Email, First Name, $phone_number, subcampos de ubicación como $locale_country y campos de parche de lista como Viewed Items — hoy no se pueden escribir. Los campos derivados que el sistema calcula por ti (Created, First Active, $id) son de solo lectura de forma permanente.

¿Qué pasa si la propiedad aún no existe?

La herramienta solo lee y escribe propiedades que ya existen en los perfiles. Crea primero la propiedad en Klaviyo (por ejemplo, ponla en un perfil de prueba o mediante un flujo) y luego apunta la habilidad por su nombre.

¿Una habilidad puede llamar a varias herramientas de perfil en un solo turno?

Sí. Una habilidad puede llamar a cualquier combinación de herramientas de perfil en una sola respuesta, por ejemplo, Obtener perfil y Obtener eventos del perfil juntos para construir una imagen más completa antes de responder.

¿Qué ocurre con los compradores anónimos?

Si el agente intenta utilizar una de estas herramientas y el comprador no está identificado, se le pedirá que inicie sesión. Una vez identificados, la herramienta se ejecuta y la conversación continúa.

¿Estas herramientas están sujetas a las mismas reglas de consentimiento que el resto de Klaviyo?

Sí. Los datos fluyen a través del modelo estándar de consentimiento y perfiles de Klaviyo.

Siguientes pasos

• Comprender las herramientas del Agente de Clientes
• Comprender las habilidades
• Cómo crear una habilidad totalmente personalizada

Artículos relacionados