Herramientas de perfil de Customer Agent

Qué aprenderás

Qué son las herramientas de perfil de los Customer Agent, qué hace cada uno y cómo usarlas en las habilidades. Estas herramientas permiten a tus agentes leer y escribir en el perfil de Klaviyo de los compradores durante una conversación, lo que les permite personalizar las respuestas, responder a las preguntas de «cuál es mi…» y capturar nuevos datos para el perfil.

Las cinco herramientas de perfil

Customer Agent 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 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 de Herramientas en Customer Agent, y adjuntarlas a cualquier habilidad desde el editor de habilidades.

Nota: Estas herramientas están en versión beta. Están disponibles para todas las marcas en Customer Agent, sin registro independiente, pero la función aún se está ampliando y puede cambiar.

Cuándo usar cada uno

Obtener perfil

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

Ejemplo: «¡Hola, Sara! Veo que tu último pedido fue enviado a la dirección que termina en 1234. ¿Deberíamos volver a usarla?»

Obtener eventos de perfil

Úsalo cuando el agente necesite saber lo que ha hecho el comprador. Pedidos, aperturas de correo electrónico, envíos de formularios, visitas a páginas, suscripciones: cualquier cosa registrada como un evento en el perfil.

Ejemplos:

• Un comprador pregunta: «¿Cuándo fue mi último pedido?» La habilidad 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 Get Profile Events con Tipo de evento = Added to Cart y enumera los artículos.

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

Obtener listas y segmentos de perfiles

Se usa cuando el comportamiento del agente debe depender de las audiencias en las que se encuentre el comprador. Cliente vip ¿Ya estás en la lista de reposición de stock? ¿Se ha excluido de los correos electrónicos promocionales?

Ejemplo: si el comprador está en el segmento vip, el agente ofrece un cambio a un plan superior de forma gratuita en una devolución.

Obtén el resumen predictivo del perfil

Úsalo cuando el comprador o la competencia necesiten los detalles clave predictivos de Klaviyo: valor de vida del cliente, riesgo de abandono, próxima compra prevista o puntuación del 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 reciben una oferta más sólida.

Actualizar propiedad de perfil

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

Ejemplos:

• Un comprador responde a un cuestionario: «Prefiero aromas terrosos». → El agente escribe scent_preference: earthy.
• Un comprador da su opinión durante una devolución: «No me quedaba bien, tallaba pequeño». → El agente guarda last_return_reason: sizing.

Una vez que una propiedad está en el perfil, cualquier otra parte de Klaviyo puede usarla: flujos, segmentos, campañas y futuras conversaciones con Customer Agent.

Cómo usar estas herramientas en una habilidad

1. Abre la habilidad que quieras actualizar (o crea una nueva).
2. En el editor de habilidades, adjunta las herramientas de perfil que necesites.
3. Si la herramienta tiene entradas de configuración, rellénalas (consulta más abajo).
4. En la sección Cómo responder, explica a los usuarios cuándo y cómo usar cada herramienta. Sé específico:
   • Cuándo debe llamar el agente a la herramienta
   • Qué debería hacer con el resultado
   • Para Actualizar la propiedad de 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 rellenado previo fija el valor de cada llamada que hace la habilidad, lo que te da un control más estricto y evita que el agente tenga que averiguarlo en tiempo de ejecución.

Get Profile Events es el ejemplo principal. Cuando lo conectas a una habilidad, puedes configurar lo siguiente:

• Tipo de evento (obligatorio): qué métrica recuperar (p. ej., Placed Order, Checkout Started, Added to Cart, Opened Email, Viewed Product).
• Límite: el número de eventos recientes que se devolverán. Usa 1 si solo necesitas el más reciente.
• Orden: el más reciente primero o el más antiguo primero.
• Periodo retrospectivo: cuánto tiempo hay que buscar. Predeterminado: 90 días.

Por ejemplo, una habilidad que deba consultar 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 no tiene que pensar en esas opciones (ya están integradas).

Ejemplo de fragmento «Cómo responder» (Actualizar propiedad de perfil):

Cuando el comprador te indique su preferencia de aroma, llama a Actualizar propiedades de perfil para guardarla en la propiedad scent_preference usando una de estas opciones: floral, earthy, citrus, fresh. Escribe solo si el comprador lo confirma explícitamente. Confirma el guardado al comprador en una sola frase.

Ejemplo de fragmento «Cómo responder» (Obtener perfil + Obtener eventos de perfil):

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

(Adjuntar eventos de obtención de perfil con Tipo de evento = Placed Order, Límite = 3, Orden de clasificación.)

Consejos

• Lee antes de escribir. Si estás personalizando una respuesta, adjunta primero Get Profile u Get Profile Events. El agente no puede hacer referencia a los datos que no ha extraído.
• La propiedad debe existir primero y debe ser una propiedad personalizada. Actualizar propiedad de perfil solo escribe en propiedades de perfil personalizadas que ya existen en los perfiles de tu empresa. Los campos del sistema (correo electrónico, nombre, número de teléfono y subcampos de ubicación) y los campos derivados (Creado, Activo por primera vez y $id) no se pueden escribir. Crea primero la propiedad personalizada en Klaviyo y, luego, apúntala por su nombre exacto.
• Limita 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á un mensaje de texto gratuito y tus segmentos no coincidirán.
• Dile al agente cuándo no escribir. «Escribir solo si el comprador confirma explícitamente» evita las sobrescripciones accidentales.
• Confirma las escrituras para el comprador. Un breve «Lo tengo, lo he guardado como prefieras» cierra el bucle.
• Haz coincidir la herramienta con la pregunta. «¿Qué he comprado?» → Profile Events. «¿Soy vip?» → Listas y segmentos. «¿Qué probabilidad tengo de abandono?» → Resumen predictivo.
• Utiliza Agent Builder para conectarlos. Describe lo que quieras en un lenguaje sencillo y Agent Builder adjuntará las herramientas adecuadas y escribirá las instrucciones de habilidad para ti. Por ejemplo: «Quiero que mis habilidades de recomendaciones se fijen en lo que estaba en el carrito del comprador para recomendar algo similar».

Qué no hacen estas herramientas

• 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 de perfil no crea nuevos compradores. El perfil ya debe existir.
• La propiedad de perfil de actualización no escribe eventos. La redacción de eventos será una herramienta independiente, disponible próximamente.
• Ninguna de las herramientas leídas modifica los datos. Solo buscan.

PREGUNTAS FRECUENTES

¿Puedo escribir en cualquier propiedad con Actualizar propiedad de perfil?

Solo propiedades de perfil personalizadas (las que defines en 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 ) no se pueden escribir hoy. Los campos derivados que el sistema calcula por ti (Created, First Active, $id) son de solo lectura de forma permanente.

¿Y si la propiedad aún no existe?

La herramienta solo lee y escribe las propiedades que ya existen en los perfiles. Crea primero la propiedad en Klaviyo (por ejemplo, configúrala en un perfil de prueba o a través de un flujo) y, luego, apúntala 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, Get Profile y Get Profile Events juntos para crear 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í. Flujos de datos a través del modelo estándar de consentimiento y perfiles de Klaviyo.

Próximos pasos

• Herramientas de Customer Agent
• Comprender las habilidades
• Cómo crear habilidades totalmente personalizadas

Artículos relacionados