Herramientas de perfil de Customer Agent

Qué aprenderás

Qué hacen las herramientas de perfil de Customer Agent y cómo configurar el acceso a ellas. Estas herramientas leen o escriben datos en el perfil de Klaviyo de un comprador identificado para personalizar respuestas, responder preguntas específicas de la cuenta y recopilar datos nuevos.

Las cinco herramientas de perfil

Customer Agent incluye cinco herramientas de perfil. Revisa los permisos antes de usarlo: las herramientas pueden estar disponibles directamente, solo a través de habilidades o bloqueadas. La identificación del perfil y los requisitos de configuración de cada herramienta siguen aplicándose.

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.

Encuentra estas herramientas en Customer Agent > Conectores. También puedes incluirlas en una habilidad personalizada cuando un flujo de trabajo necesite instrucciones específicas.

Antes de usar las herramientas de perfil

Revisa los permisos en Customer Agent > Conectores. Permitir siempre habilita el uso directo. Solo en habilidades requiere que la herramienta se incluya en una habilidad. Bloqueado impide el uso, incluso a través de una habilidad. Para escrituras que necesiten comprobaciones específicas de política o consentimiento, usa Composer para configurar una habilidad personalizada y los permisos adecuados. Prueba con un perfil de prueba antes de usar el flujo de trabajo con los compradores.

Más información sobre las herramientas y los permisos.

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?»

Get Profile también devuelve dónde está el comprador: el país que Customer Agent detectó para la conversación y la ubicación en el perfil. Úsalo para gestionar la misma solicitud de forma diferente según el país.

Ejemplo: «Llama a Obtener perfil para comprobar el país del comprador. Si el país es Canadá, explica que los pedidos se envían desde nuestro almacén de Toronto.»

Para limitar una habilidad completa o una parte del contenido a algunos países, usa regiones. Consulta Cómo configurar Customer Agent para varios países y regiones.

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.)

Registrar eventos personalizados desde una skill

Utiliza la herramienta independiente Send Event para convertir los detalles recopilados en una conversación en un evento en el perfil de Klaviyo del comprador. Por ejemplo, una habilidad de garantía puede registrar un evento Warranty Claim Started con el producto y el problema notificado. Puedes utilizar la métrica y las propiedades del evento en segmentos, flujos y elaboración de informes. Update Profile Property cambia un valor del perfil; Send Event registra una actividad con propiedades para esa ocurrencia.

Send Event está en beta y debe estar disponible en la cuenta. Requiere un comprador autenticado y una métrica existente y activa en Klaviyo. El selector de métricas muestra métricas existentes; no crea una nueva. En el chat web, introducir una dirección de email en un mensaje por sí solo no autentica al comprador.

Configurar evento de envío

1. Abre o crea la skill en Customer Agent > Skills. En How to respond, escribe / e inserta Send Event en el punto en el que se deba registrar el evento. Indica al agente qué detalles debe recopilar antes de ejecutar la herramienta y cuándo no debe registrar un evento.
2. Selecciona la herramienta insertada para abrir su configuración. En Métrica, elige la métrica existente con la que registrar eventos.
3. En Propiedades del evento, selecciona Añadir propiedad para cada detalle que quieras guardar. Introduce un Nombre de propiedad y elige su Origen. Mantén los nombres de las propiedades y los formatos de valores coherentes con los segmentos y los flujos que los usarán.
   • El agente decide: elige un tipo de valor (texto, número o verdadero o falso) y añade una descripción que explique qué debe extraer el agente de la conversación. Por ejemplo, usa issue_description como Texto y descríbelo como el problema que el comprador informó.
   • Un valor fijo: introduce el valor que se enviará cada vez que se ejecute esta herramienta, como source = Customer Agent.
   • El perfil del cliente: selecciona un campo de perfil compatible: ID de perfil de Klaviyo, email, número de teléfono, nombre o apellidos. Este selector no ofrece propiedades de perfil personalizadas arbitrarias.
4. Haz clic en Guardar en la barra lateral de herramientas y guarda el borrador de la habilidad. Revisa las instrucciones para asegurarte de que el evento se registre solo después de que esté disponible la información necesaria.

Ejemplo: registrar una solicitud de garantía

Selecciona una métrica Warranty Claim Started existente. Añade product_name e issue_description con The agent decides como fuente y Text como tipo de valor. Añade source con un valor fijo de Customer Agent. En las instrucciones de la habilidad, indica al agente que recopile el producto y el problema, que pida los detalles que falten y, a continuación, que ejecute Send Event después de que el comprador confirme la solicitud. Registrar el evento no crea una reclamación ni envía un reemplazo; esas acciones necesitan su propio flujo de trabajo.

Prueba y verifica el evento

Prueba la skill con un perfil de comprador de prueba y comprueba tanto los casos correctos como los de falta de información. Trata una llamada de Send Event como una escritura real: los eventos registrados pueden activar flujos. Usa una métrica de prueba o excluye el perfil de prueba del alcance de producción mientras haces pruebas.

En Klaviyo, ve a Analytics > Métricas y busca la métrica seleccionada en la herramienta. Abre el feed de actividad o abre el registro de actividad del perfil del comprador de prueba y comprueba que los valores del evento y de las propiedades sean correctos. Busca el nombre de la métrica que hayas elegido; los eventos personalizados no necesariamente incluyen «Customer Agent» en su nombre. Verifica el evento antes de activar la habilidad.

Si no aparece ningún evento, confirma que Send Event esté disponible en la cuenta, el comprador esté autenticado, se haya seleccionado una Métrica válida y las instrucciones de la skill lleguen a la herramienta insertada. Comprueba el resultado de la herramienta antes de volver a intentarlo: cada llamada correcta registra un evento nuevo, por lo que repetir la llamada puede crear duplicados.

Para los eventos integrados que Customer Agent registra automáticamente, consulta Referencia de datos de eventos de Customer Agent.

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.
• Usa Composer para configurar el comportamiento que necesites. Describe cuándo leer o escribir datos del perfil y las reglas que se deben seguir. Composer puede ajustar los permisos de las herramientas, redactar instrucciones personalizadas de habilidades y actualizar las directrices para que las revises y las pruebes. Por ejemplo: «Usa la actividad reciente del carrito del comprador para recomendar productos similares».
• Usa regiones antes de ramificar por país. Si una habilidad completa solo se aplica en algunos países, configura regiones en la habilidad. Usa Obtener perfil cuando una habilidad necesite una pequeña diferencia por país.

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.
• Update Profile Property no registra eventos. Para registrar un evento personalizado durante una conversación con un comprador autenticado, utiliza la herramienta independiente Send Event en una skill de Customer Agent. Selecciona la métrica en la que se va a escribir y configura las propiedades del evento usando respuestas del modelo, valores fijos o los datos de perfil del comprador.
• 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