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 5 herramientas de perfil

Estas 5 herramientas integradas leen o escriben datos en el perfil del comprador autenticado. Puedes agregarlas a habilidades personalizadas. Algunas herramientas requieren que selecciones entradas cuando las agregues, como el tipo de evento o la propiedad del perfil.

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

Para ver estas herramientas, ve a Agente de Clientes > Conectores y luego selecciona Klaviyo. Puedes agregarlas a una habilidad personalizada desde el editor de habilidades.

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 dirección guardada en su perfil o cualquier propiedad personalizada que almacenes.

Ejemplo: “¡Hola, Sarah! ” Veo que la dirección en tu perfil termina en 1234. ¿Deberíamos usar esa otra vez?”

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

Ejemplo: “Llama a Get perfil para verificar el país del comprador. Si el país es Canadá, explica que los pedidos se envían desde nuestro almacén en Toronto.”

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

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é agregué recientemente a mi carrito?” La habilidad adjunta Obtener eventos del perfil con Tipo de evento = Added to Cart y vuelve a mostrar la lista de artículos.

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

Úsalo cuando el comprador o la habilidad necesite la información predictiva de Klaviyo: valor de vida del cliente, riesgo de abandono o próxima compra esperada.

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.

Las predicciones no están disponibles para todos los perfiles. Indica a la habilidad qué hacer cuando falten datos predictivos, como continuar sin una oferta basada en predicciones.

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

Para Actualizar propiedades del perfil, crea la propiedad personalizada en Klaviyo antes de agregar la herramienta a una habilidad. Por ejemplo, configúrala en un perfil de prueba para que esté disponible en el selector de propiedades del perfil.

1. Ve a Agente de Clientes > Habilidades y abre una habilidad personalizada, o haz clic en Crear habilidad. Para una habilidad nueva, ingresa el nombre y completa Cuándo usar esta habilidad.
2. En Cómo responder, escribe / y selecciona una herramienta de perfil en el menú Herramientas.
3. Si se abre la barra lateral de configuración de la herramienta, selecciona las entradas obligatorias y cualquier configuración opcional, y luego haz clic en Guardar. Consulta Configurar una herramienta al adjuntarla a continuación. Para cambiar esta configuración más adelante, haz clic en la herramienta insertada en el editor. Repite los pasos 2–3 para cada herramienta que necesites.
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
5. Si estás creando una nueva habilidad, haz clic en Guardar como borrador para guardarla y abrir los detalles.
6. Revisa las instrucciones y luego haz clic en Publicar para una habilidad en borrador o en Actualizar para una habilidad en vivo. Esto hace que los cambios estén disponibles en las conversaciones en vivo.

Configurando una herramienta cuando la conectas

Algunas herramientas de perfil tienen entradas que puedes completar previamente para cada herramienta que insertes. Completar previamente fija el valor para cada llamada a esa instancia de la herramienta, lo que te da un control más preciso y evita que el agente tenga que resolverlo durante la 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 — el número máximo de eventos que se devolverán. Elige 1, 5, 10, 25 o 50. El valor predeterminado es 10. Para recuperar el evento más reciente, selecciona 1 evento y Más nuevos primero.
• Orden de clasificación — Los más nuevos primero (valor predeterminado) o Los más antiguos 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 event, Sort order = Newest first, Lookback window = 30 days. Así, el agente ya no tiene que pensar en esas decisiones: ya vienen integradas.

Actualizar propiedades del perfil requiere que selecciones propiedades del perfil. Elige la propiedad personalizada existente que la herramienta debe actualizar y, luego, haz clic en Guardar. En Cómo responder, dile al agente qué valores guardar y cuándo guardarlos.

Obtener listas y segmentos del perfil te permite seleccionar el tipo de membresía para devolver listas, segmentos o ambos. De forma predeterminada, devuelve ambos.

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 solo si la herramienta informa que se realizó correctamente. Si falla, explica que no se guardó la preferencia.

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

Cuando el comprador pregunte sobre sus pedidos recientes, llama a Get Perfil Events para recuperar su historial de pedidos. Resume las fechas y los detalles del pedido disponibles registrados en esos eventos. Si el comprador pregunta quién es o qué hay registrado, usa Get perfil.

(Adjunta Obtener eventos de perfil con Tipo de evento = Placed Order, Límite = 5 events, Orden de clasificación = Más recientes primero.)

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 primero tiene que existir, y tiene que ser una propiedad personalizada. Actualizar propiedades del perfil solo escribe en las propiedades del perfil personalizadas 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 (Created, First con actividad, $id) no se pueden escribir. Primero crea la propiedad personalizada en Klaviyo y luego selecciónala en Propiedades del perfil cuando configures la herramienta.
• 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. Después de que la herramienta reporte éxito, un breve "Entendido, guardé eso como tu preferencia" cierra el ciclo.
• 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.
• Usa Composer para conectar esto. Describe lo que quieres en inglés sencillo y Composer adjuntará las herramientas adecuadas y redactará las instrucciones de la habilidad para que las revises y publiques. Por ejemplo: "Quiero que mi habilidad de recomendaciones analice lo que había en el carrito del comprador para recomendar algo similar."
• Usa regiones antes de ramificar por país. Si una habilidad completa solo aplica en algunos países, configura regiones en la habilidad. Usa Obtener perfil cuando una habilidad necesita una pequeña diferencia por país.

Lo que estas herramientas no hacen

• No funcionan directamente en conversaciones anónimas. En el chat web, si el agente necesita una de estas herramientas y el comprador no está identificado, se le pide al comprador que primero inicie sesión. Una vez que se identifica, 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 propiedad ya debe existir en la cuenta para que aparezca en el selector de propiedades del perfil. Primero, créala en Klaviyo (por ejemplo, configúrala en un perfil de prueba o mediante un flujo) y luego selecciónala cuando configures la herramienta. No es necesario que ya esté configurada en el perfil de cada comprador.

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

En el chat web, si el agente necesita una de estas herramientas y el comprador no está identificado, se le solicita al comprador que inicie sesión. Una vez que está identificado, 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 perfil y consentimiento de Klaviyo. Guardar una preferencia personalizada con Actualizar propiedades del perfil no suscribe al comprador a marketing.

Siguientes pasos

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

Artículos relacionados