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

Estas 5 herramientas integradas leen o escriben datos en el perfil del comprador autenticado. Puedes añadirlas a habilidades personalizadas. Algunas herramientas requieren que selecciones entradas cuando las añades, como el tipo de evento o las propiedades de perfil.

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

Para ver estas herramientas, ve a Customer Agent > Conectores y, a continuación, selecciona Klaviyo. Puedes añadirlas a una habilidad personalizada desde el editor de habilidades.

Cuándo usar cada uno

Obtener perfil

Úsalo cuando el agente necesite saber con quién está hablando (propiedades como el nombre, las preferencias de email, la dirección guardada en su perfil o cualquier propiedad personalizada que almacenes).

Ejemplo: «¡Hola, Sarah!» Veo que la dirección de tu perfil termina en 1234. ¿Deberíamos usar esa de nuevo?»

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é he añadido recientemente al carrito?» La habilidad adjunta Get Profile Events con Tipo de evento = Added to Cart y muestra la lista de elementos.

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 habilidad necesiten los detalles clave predictivos de Klaviyo (valor de vida del cliente, riesgo de abandono o próxima compra prevista).

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.

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

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

Para Update Profile Property, crea la propiedad personalizada en Klaviyo antes de añadir la herramienta a una skill. Por ejemplo, configúrala en un perfil de prueba para que esté disponible en el selector de propiedades de perfil.

1. Ve a Customer Agent > Habilidades y abre una habilidad personalizada, o haz clic en Crear habilidad. Para una habilidad nueva, introduce 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 ajuste opcional; a continuación, haz clic en Guardar. Consulta Configurar una herramienta al adjuntarla a continuación. Para cambiar estos ajustes 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, 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
5. Si estás creando una habilidad nueva, haz clic en Guardar como borrador para guardarla y abrir los detalles.
6. Revisa las instrucciones y, luego, haz clic en Publicar para una skill en borrador o en Actualizar para una skill activa. Esto pone los cambios a disposición en las conversaciones activas.

Configurando una herramienta cuando la conectas

Algunas herramientas de perfil tienen campos que puedes rellenar previamente en cada herramienta que insertes. El rellenado previo bloquea el valor para cada llamada a esa instancia de la herramienta, lo que te da un control más estricto y evita que el agente tenga que determinarlo durante la 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 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 recientes primero [el valor predeterminado] o los más antiguos 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 event, Sort order = Newest first, Lookback window = 30 days. Así, el agente no tiene que pensar en esas opciones (ya están integradas).

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

Obtener listas y segmentos de perfiles te permite seleccionar el tipo de pertenencia para devolver listas, segmentos o ambos. De forma predeterminada, devuelve ambos.

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

Cuando el comprador te indique su preferencia de aroma, llama a Actualizar propiedad de perfil para guardarla en la propiedad scent_preference usando una de las siguientes: floral, earthy, citrus, fresh. Escribe solo si el comprador lo confirma explícitamente. Confirma el guardado al comprador en una sola frase solo si la herramienta indica que se realizó correctamente. Si falla, explica que la preferencia no se guardó.

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

(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 Get Profile u Get Profile Events. 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 propiedades de perfil solo escribe en las propiedades de perfil personalizadas que ya existen en los perfiles de tu empresa. Los campos del sistema (Email, nombre, número de teléfono, subcampos de ubicación) y los campos derivados (created, first active, $id) no se pueden editar. Primero, crea la propiedad personalizada en Klaviyo y, después, selecciónala en propiedades de perfil cuando configures la herramienta.
• 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.
• Confirmar escribe al comprador. Después de que la herramienta indique que se ha completado correctamente, un breve "Entendido, he guardado eso como tu preferencia" cierra el ciclo.
• 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 configurarlo. 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 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 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 pide al comprador que inicie sesión primero. Una vez que se identifica, 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 propiedad ya debe existir en tu cuenta para que aparezca en el selector de propiedades de perfil. Créalo primero en Klaviyo (por ejemplo, configúralo en un perfil de prueba o mediante un flujo) y luego selecciónalo cuando configures la herramienta. No es necesario que ya esté configurado en el perfil de todos los clientes.

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

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

Próximos pasos

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

Artículos relacionados