Document Property Collector subcomponents

_i18n/en/captures/property-collector-playbook.md

@@ -29,13 +29,15 @@ Property Collector stays focused on profile data. It is not a general support or
 
 Use Property Collector directly when the main purpose of the conversation is to enrich a customer profile.
 
-The playbook follows its configured collection list, asks for missing values, and saves valid answers to the profile. This works well when the business needs a reusable conversational capture for selected properties.
+The playbook follows its configured collection list, asks for missing values, and saves valid answers to the profile. This works well when the business needs a reusable conversational capture for selected properties. To use it this way, configure and enable the standalone Property Collector playbook.
 
 ### As a prerequisite for another playbook
 
 Other AI playbooks can include a Property Collector subcomponent with the profile data they need.
 
-When the source playbook detects that one or more configured properties are missing, it can temporarily hand the conversation to the enabled Property Collector. Property Collector asks only for that active set of missing properties.
+When the source playbook detects that one or more configured properties are missing, it uses that subcomponent internally. Property Collector asks only for that active set of missing properties.
+
+You do not need to enable the standalone Property Collector playbook for this case. The subcomponent is part of the source playbook's configuration and uses its own property selection.
 
 The original playbook remains responsible for the customer's task. Once the required collection is resolved, the conversation returns to that playbook instead of permanently changing ownership.
 
@@ -65,9 +67,9 @@ A required property remains part of the active collection until it is resolved o
 
 Too many required fields make a conversational capture feel like a form with no exit. Keep the required set small.
 
-## What it needs before launch
+## What it needs before direct use
 
-Before enabling Property Collector, confirm:
+Before enabling Property Collector as a standalone playbook, confirm:
 
 - The profile properties already exist in Hellotext and have useful customer-facing names.
 - You know which properties are required and which are optional.
@@ -88,7 +90,7 @@ Property Collector exposes:
 - **Tone:** the voice used while requesting information.
 - **Assignment or derivation:** who should take over when collection cannot continue automatically.
 
-Other compatible playbooks can expose a Property Collector subcomponent with their own prerequisite property list. Property Collector must be enabled before that prerequisite configuration can run.
+Other compatible playbooks can expose a Property Collector subcomponent with their own prerequisite property list. That internal configuration does not depend on the standalone Property Collector playbook being enabled.
 
 ## How the AI handles answers
 

_i18n/en/journeys/how-to-customize-a-playbook-safely.md

@@ -38,6 +38,7 @@ Consider disabling temporarily only when the change could affect live customers
 
 - You are changing the prompt of a playbook that allows prompt edits and the agent could reply incorrectly.
 - You are changing intents for a custom agent.
+- You are changing which properties a playbook must collect.
 - You are changing incoming or outgoing channels.
 - You are changing discounts or eCommerce offer rules.
 - You are editing a route with steps, conditions, branches, or assignments.
@@ -54,6 +55,7 @@ Use this table as a quick map:
 | **Tone** | Playbooks with AI-generated replies or messages | The voice and style the playbook uses to communicate. |
 | **Intents** | Custom agents and custom playbooks | Which customer messages activate that agent. |
 | **Knowledge** | Sales or support AI agents | What information the agent uses to answer. |
+| **Properties** | Playbooks that include the Property Collector subcomponent | Which missing profile data the playbook should ask for before continuing. |
 | **Incoming/outgoing channels** | Playbooks that allow channel selection | Where the playbook can reply or send. |
 | **Discounts** | Sales playbooks that allow offers | Which eCommerce offer rules and AI discount limits the agent may use. |
 | **Escalation** | AI agents, support, [Webchat]({% link _captures/webchat-widget-playbook.md %}), and some custom playbooks | Who takes over when the agent should not continue. |
@@ -129,6 +131,21 @@ Before uploading or replacing documents:
 
 After updating knowledge, use the Playground to ask questions that depend on the changed information.
 
+## Customize properties
+
+This section applies to playbooks that show a **Properties** card or a **Property Collector** subcomponent.
+
+Select only the profile data that the playbook actually needs. When it is time to collect that data, the playbook skips properties already present on the customer profile and asks only for the selected properties that are still missing.
+
+When configuring properties:
+
+- Use properties with customer-friendly names instead of internal CRM terms.
+- Keep the list short so the conversation does not become a long form.
+- If **Must collect** is available, select it only when the playbook cannot continue without that value. Other properties can remain optional.
+- Test with a profile missing every property, one that already has some of them, and a customer who declines an optional property.
+
+Behind the scenes, the playbook uses the [Property Collector]({% link _captures/property-collector-playbook.md %}) component to ask for, validate, and save the answers. You do not need to enable the standalone Property Collector playbook: the playbook you are configuring uses its own subcomponent. Enable the standalone Property Collector only if you also want to use it directly as a capture experience.
+
 ## Customize channels
 
 In general, keep automatic channel selection if the playbook already works well. Many playbooks manage channels automatically based on the conversation type, customer availability, and business setup.
@@ -224,6 +241,7 @@ If results move in the wrong direction, revert the smallest change first.
 - [How Hellotext decides whether a playbook can send]({% link _journeys/how-hellotext-decides-whether-a-playbook-can-send.md %})
 - [Troubleshoot a playbook that did not trigger or send]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %})
 - [How to write a great agent prompt]({% link _journeys/how-to-write-a-great-prompt.md %})
+- [Property Collector playbook]({% link _captures/property-collector-playbook.md %})
 - [Webchat Widget playbook]({% link _captures/webchat-widget-playbook.md %})
 - [Instant Answers playbook]({% link _journeys/instant-answers-playbook.md %})
 - [Review Builder playbook]({% link _journeys/review-builder-playbook.md %})

_i18n/es/captures/property-collector-playbook.md

@@ -29,13 +29,15 @@ Recolector de Propiedades se mantiene enfocado en los datos del perfil. No es un
 
 Usa Recolector de Propiedades directamente cuando el propósito principal de la conversación es enriquecer el perfil del cliente.
 
-El playbook sigue su lista configurada, pide los valores faltantes y guarda las respuestas válidas en el perfil. Esto funciona bien cuando el negocio necesita una captura conversacional reutilizable para ciertas propiedades.
+El playbook sigue su lista configurada, pide los valores faltantes y guarda las respuestas válidas en el perfil. Esto funciona bien cuando el negocio necesita una captura conversacional reutilizable para ciertas propiedades. Para usarlo de esta forma, configura y habilita el playbook Recolector de Propiedades independiente.
 
 ### Como requisito de otro playbook
 
 Otros playbooks con IA pueden incluir un subcomponente Recolector de Propiedades con los datos del perfil que necesitan.
 
-Cuando el playbook de origen detecta que faltan una o más propiedades configuradas, puede entregar temporalmente la conversación al Recolector de Propiedades habilitado. Recolector de Propiedades pide solamente el conjunto activo de propiedades faltantes.
+Cuando el playbook de origen detecta que faltan una o más propiedades configuradas, usa internamente ese subcomponente. Recolector de Propiedades pide solamente el conjunto activo de propiedades faltantes.
+
+No necesitas habilitar el playbook Recolector de Propiedades independiente para este caso. El subcomponente forma parte de la configuración del playbook de origen y funciona con su propia selección de propiedades.
 
 El playbook original continúa siendo responsable de la tarea del cliente. Cuando la recopilación necesaria se resuelve, la conversación vuelve a ese playbook en vez de cambiar permanentemente de ownership.
 
@@ -65,9 +67,9 @@ Una propiedad obligatoria permanece dentro de la recopilación activa hasta que
 
 Demasiados campos obligatorios hacen que una captura conversacional se sienta como un formulario sin salida. Mantén pequeño el conjunto obligatorio.
 
-## Qué necesita antes de lanzarlo
+## Qué necesita antes de usarlo directamente
 
-Antes de habilitar Recolector de Propiedades, confirma:
+Antes de habilitar Recolector de Propiedades como playbook independiente, confirma:
 
 - Las propiedades del perfil ya existen en Hellotext y tienen nombres útiles para el cliente.
 - Sabes cuáles son obligatorias y cuáles opcionales.
@@ -88,7 +90,7 @@ Recolector de Propiedades expone:
 - **Tono:** la voz que usa al pedir información.
 - **Asignación o derivación:** quién debería continuar cuando la recopilación no puede completarse automáticamente.
 
-Otros playbooks compatibles pueden mostrar un subcomponente Recolector de Propiedades con su propia lista de propiedades requeridas. Recolector de Propiedades debe estar habilitado para que esa configuración previa pueda ejecutarse.
+Otros playbooks compatibles pueden mostrar un subcomponente Recolector de Propiedades con su propia lista de propiedades requeridas. Esa configuración interna no depende de que el playbook Recolector de Propiedades independiente esté habilitado.
 
 ## Cómo maneja las respuestas la IA
 

_i18n/es/journeys/how-to-customize-a-playbook-safely.md

@@ -38,6 +38,7 @@ Considera deshabilitar temporalmente solo cuando el cambio pueda afectar a clien
 
 - Estás cambiando el prompt de un playbook que lo permite y el agente podría responder de forma incorrecta.
 - Estás cambiando intenciones de un agente personalizado.
+- Estás cambiando qué propiedades debe recopilar un playbook.
 - Estás modificando canales de entrada o salida.
 - Estás cambiando descuentos o reglas de oferta del eCommerce.
 - Estás editando una ruta con pasos, condiciones, ramas o asignaciones.
@@ -54,6 +55,7 @@ Usa esta tabla como mapa rápido:
 | **Tono** | Playbooks con respuestas o mensajes generados por IA | La voz y el estilo con los que se comunica el playbook. |
 | **Intenciones** | Agentes personalizados y playbooks personalizados | Qué mensajes de clientes activan ese agente. |
 | **Conocimiento** | Agentes de IA de venta o atención | Qué información usa el agente para responder. |
+| **Propiedades** | Playbooks que incluyen el subcomponente Recolector de Propiedades | Qué datos faltantes del perfil debe pedir antes de continuar. |
 | **Canales de entrada/salida** | Playbooks que permiten selección de canales | Dónde puede responder o enviar mensajes. |
 | **Descuentos** | Playbooks de venta que permiten ofertas | Qué reglas de oferta del eCommerce y límites de descuento con IA puede usar el agente. |
 | **Derivación** | Agentes de IA, atención, [Webchat]({% link _captures/webchat-widget-playbook.md %}) y algunos playbooks personalizados | Quién toma la conversación cuando el agente no debe seguir. |
@@ -129,6 +131,21 @@ Antes de subir o reemplazar documentos:
 
 Después de actualizar conocimiento, usa el Playground para hacer preguntas que dependan de la información cambiada.
 
+## Personaliza propiedades
+
+Esta sección aplica a los playbooks que muestran la tarjeta **Propiedades** o un subcomponente **Recolector de Propiedades**.
+
+Selecciona solamente los datos del perfil que ese playbook realmente necesita. Cuando llega el momento de recopilarlos, el playbook omite las propiedades que el cliente ya tiene y pregunta únicamente por las seleccionadas que todavía faltan.
+
+Al configurar las propiedades:
+
+- Usa propiedades con nombres claros para el cliente, no términos internos de tu CRM.
+- Mantén corta la lista para no convertir la conversación en un formulario largo.
+- Si aparece la opción **Debe recopilar**, márcala solo cuando el playbook no pueda continuar sin ese dato. Las demás propiedades pueden quedar como opcionales.
+- Prueba un perfil sin ninguna de las propiedades, otro que ya tenga algunas y un cliente que no quiera compartir una propiedad opcional.
+
+Por detrás, el playbook usa el componente [Recolector de Propiedades]({% link _captures/property-collector-playbook.md %}) para pedir, validar y guardar las respuestas. No necesitas habilitar el playbook independiente Recolector de Propiedades: el playbook que estás configurando usa su propio subcomponente. Habilita el Recolector de Propiedades independiente solo si también quieres usarlo directamente como una experiencia de captura.
+
 ## Personaliza canales
 
 En general, deja la selección automática de canales si el playbook ya funciona bien. Muchos playbooks manejan canales automáticamente según el tipo de conversación, disponibilidad del cliente y configuración del negocio.
@@ -224,6 +241,7 @@ Si los resultados se mueven en la dirección equivocada, revierte primero el cam
 - [Cómo decide Hellotext si un playbook puede enviar]({% link _journeys/how-hellotext-decides-whether-a-playbook-can-send.md %})
 - [Soluciona un playbook que no se disparó o no envió]({% link _journeys/troubleshoot-a-playbook-that-did-not-trigger-or-send.md %})
 - [Cómo escribir un gran prompt para tu agente]({% link _journeys/how-to-write-a-great-prompt.md %})
+- [Playbook Recolector de Propiedades]({% link _captures/property-collector-playbook.md %})
 - [Playbook Widget de Webchat]({% link _captures/webchat-widget-playbook.md %})
 - [Playbook Respuestas Instantáneas]({% link _journeys/instant-answers-playbook.md %})
 - [Playbook Generador de Reseñas]({% link _journeys/review-builder-playbook.md %})

_journeys/how-to-customize-a-playbook-safely.md

@@ -5,10 +5,10 @@ navigation_group: foundations
 
 en:
   title: How to customize a playbook safely
-  description: Change prompts, tone, intents, knowledge, channels, offers, and handoff rules without breaking the playbook's expected behavior.
+  description: Change prompts, tone, intents, knowledge, properties, channels, offers, and handoff rules without breaking the playbook's expected behavior.
 es:
   title: Cómo personalizar un playbook de forma segura
-  description: Cambia prompts, tono, intenciones, conocimiento, canales, ofertas y reglas de derivación sin romper el comportamiento esperado del playbook.
+  description: Cambia prompts, tono, intenciones, conocimiento, propiedades, canales, ofertas y reglas de derivación sin romper el comportamiento esperado del playbook.
 
 permalink: how-to-customize-a-playbook-safely
 permalink_es: como-personalizar-un-playbook