Propiedades de clientes de Help Scout: configuración, límites y API
Kira
Katelin Teen
Última edición 6 de noviembre de 2026

Una propiedad de cliente de Help Scout es un campo de datos personalizado en el perfil del contacto. Puedes crear hasta 50 contact properties y 50 company properties, en cinco tipos, y aparecen en la barra lateral de la conversación de cada bandeja. Rellénalas a mano, con Zapier, la API de la bandeja o Beacon identify, y úsalas para ramificar workflows y respuestas guardadas en Plus o Pro. Usa las propiedades para datos sobre la persona y campos personalizados para datos sobre una conversación. El CLI de eesel permite a un agente de código conectar eesel con Help Scout y probar respuestas antes, aunque un administrador de Help Scout sigue teniendo que aprobar la conexión.
¿Qué son las propiedades de clientes de Help Scout?
Son los campos de "quién es esta persona". El artículo de propiedades de Help Scout ahora titula la función Contact and Company Properties, y dice que eliges qué detalles seguir, los añades manualmente o mediante programación, y tu equipo los ve en cada conversación. La URL y la API siguen diciendo "customer", por lo que ambos nombres circulan.

Contenido típico, según los propios ejemplos de Help Scout: un ID de usuario, zona horaria, ID de plan, estado de facturación, nombre de cuenta o la fecha en que alguien se convirtió en contacto. El valor práctico es que un agente que abre una conversación ya no tiene que abrir la herramienta de facturación para saber si el remitente está en una prueba gratuita o un plan anual. Si aún estás decidiendo herramienta, mis páginas de review de Help Scout y alternativas a Help Scout cubren el panorama más amplio.
¿Cómo se crea una propiedad, y cuáles son los límites?
Ve a Settings, luego Properties, luego elige Contact o Company. Solo los Account Owners y Administrators pueden crearlas o editarlas, aunque todos pueden verlas. Las reglas que decidirán si tu configuración aguanta:
- Cincuenta de cada. Hasta
50contact properties y50company properties, global en todas las bandejas. - Cinco tipos. Texto (hasta 255 caracteres), número, URL (se muestra como enlace clicable), fecha y desplegable (hasta 100 opciones).
- Nombre de hasta 100 caracteres. El nombre es la etiqueta que ven los agentes.
- El ID distingue mayúsculas. Se genera a partir del nombre, puedes sobrescribirlo, y solo permite guiones y guiones bajos.
- El tipo y el ID quedan fijos. Puedes editar el nombre mostrado después, pero no el tipo ni el ID.
- El borrado es inmediato. Help Scout dice que no hay forma de restaurar una propiedad borrada, y una propiedad nueva con el mismo ID no trae de vuelta los datos.
El ID fijo es lo que más importa. Si Zapier o el código de tu app envían planName y alguien crea la propiedad como PlanName, el valor se pierde en silencio. Copia el ID desde la página de settings (al hacer clic se copia al portapapeles) y entrega ese string exacto a tus desarrolladores. Los campos de ticket personalizados de Zendesk tienen un bloqueo similar en el tipo de campo, igual que los campos de ticket de Freshdesk.
¿Qué planes de Help Scout incluyen propiedades de clientes?
La documentación da dos respuestas ligeramente distintas, así que aquí están ambas. El cuadro de planes del artículo de propiedades dice todos los planes de pago. La referencia de la API de JavaScript de Beacon dice que las propiedades de clientes están disponibles en Standard, Plus y Pro, con gestión de companies en Plus y Pro. El plan Free no se nombra en ninguna de las dos, así que yo lo comprobaría antes de construir sobre él.
| Plan | Precio en la página de precios | Propiedades | Uso en workflows, respuestas guardadas, vistas |
|---|---|---|---|
| Free | 5 usuarios, 1 bandeja, 1 sitio de Docs | No listado | No listado |
| Standard | $25 por usuario al mes | Sí | No, según la documentación |
| Plus | $45 por usuario al mes | Sí | Sí |
| Pro | $75 por usuario al mes | Sí | Sí |
La página de precios describe la función como recoger y mostrar hasta 50 datos adicionales del cliente, y pone los workflows avanzados en Plus. Los precios son tarifas por usuario con un selector mensual y anual. Mi análisis de precios de Help Scout calcula el coste de un equipo completo. La división que hay que recordar: los equipos en Standard pueden guardar y ver propiedades, pero actuar sobre ellas automáticamente es una función de Plus.
¿Cómo se rellenan las propiedades?
Cuatro vías, y la primera es con la que todos empiezan. El artículo de propiedades repasa cada una.

- A mano. Haz clic en una propiedad en la tarjeta de la barra lateral para editarla en el sitio, o abre Customers, luego Contacts, luego la pestaña Properties del perfil.
- Zapier. La acción Create Customer lista tus contact properties bajo los campos de perfil estándar. La acción Update Customer Properties necesita el Contact ID, así que añade un paso Find Customer primero si tu trigger no te da uno. Mis notas sobre IA de Zapier cubren el lado de la automatización.
- Beacon identify. Pasa el ID exacto de la propiedad como clave en
Beacon('identify', ...). Los valores se sincronizan desde tu sistema de facturación o app cada vez que el visitante carga Beacon. - La API de la bandeja. Para importaciones masivas o una sincronización continua, el endpoint de Update Customer Properties recibe un
PATCHa/v2/customers/{id}/properties.
Beacon('identify', {
name: 'Steve Aoki',
email: 'steve@aoki.com',
signature: 'YOUR_SERVER_GENERATED_SIGNATURE_HERE',
Subscription: 'Free Plan',
'Favorite-Movie': '' // una cadena vacía elimina este valor
})
Según la referencia de la API de JavaScript de Beacon, las claves deben coincidir con IDs de propiedades existentes, incluidas las mayúsculas, los tipos de valor deben coincidir, y las propiedades que faltan en una llamada no se tocan. Las company properties son más limitadas: la documentación dice que puedes actualizarlas a través de la API pública, mientras que Zapier y Beacon identify todavía no las soportan. Combina identify con Secure Mode si quieres perfiles firmados, como se explica en mi entrada sobre campos de formulario de Beacon de Help Scout y en mi guía de integraciones de Help Scout.
¿Qué acepta la API para cada tipo?
La API es más estricta que la interfaz, que es donde suelen fallar las importaciones masivas. Todo esto viene de la referencia del endpoint de actualización:
| Tipo de propiedad | Formato de la API | Ejemplo |
|---|---|---|
| Número | Entero | 5 |
| Texto | Cadena, máximo 255 caracteres | "green" |
| URL | URL válida | "google.com" |
| Fecha | YYYY-MM-DD | "2019-01-02" |
| Desplegable | id o label de la opción | "Tesla" |
Las operaciones son solo replace y remove, la ruta es el slug de la propiedad con una barra inicial, y un éxito devuelve 204 No Content. La propiedad debe crearse antes, en la web app o mediante el endpoint Create Property Definitions, y GET /v2/customer-properties lista las definiciones con los IDs de sus opciones de desplegable. Al leer un cliente, cada propiedad llega con su value, una etiqueta text para los desplegables y un objeto source que identifica qué subsistema la actualizó por última vez.
¿En qué se diferencian las propiedades de los campos personalizados de la conversación?
Las propiedades viven en la persona, así que la siguen a cada conversación. Los campos personalizados viven en una conversación y, como cubrí en mi entrada sobre campos de formulario de Beacon, están atados a una bandeja, con hasta 10 por bandeja en Plus y Pro. El consejo de Help Scout es directo: usa propiedades para detalles específicos de un contacto, y campos personalizados para detalles de la situación, como el tipo de pregunta.

Mi regla general: si la respuesta seguiría siendo cierta el mes que viene en otra conversación, es una propiedad. Si describe la pregunta de hoy, es un campo. Una conversación que se mueve entre bandejas mantiene las propiedades del cliente porque son globales, una razón más para poner ahí los datos de plan y cuenta. Otras herramientas dividen igual, como en segmentos de usuario de Zendesk y etiquetas de CRM.
¿Dónde ven los agentes las propiedades, y pueden buscarlas?
En la barra lateral de la conversación, dentro de las tarjetas de Customer y Company. Cada persona puede mostrar u ocultar propiedades desde el menú de tres puntos de la tarjeta, así que la vista ordenada de un compañero no cambia la de otro. Hacer clic en el avatar abre un panel combinado con los detalles del perfil y las propiedades, y hacer clic en una propiedad la edita en el sitio. La página del perfil tiene una pestaña Properties dedicada.

Las propiedades también aparecen en la búsqueda global bajo el encabezado Customer Properties. En Plus y Pro, las condiciones de workflow de Help Scout incluyen una condición Customer Property, así que un workflow puede buscar conversaciones que incluyan o excluyan un valor, y el mismo artículo dice que las propiedades se pueden usar en respuestas guardadas y vistas de bandeja. Eso convierte un nombre de plan guardado en enrutamiento, y mis guías de asignación automática de tickets, enrutamiento inteligente y triage de tickets cubren qué hacer después. Las respuestas guardadas de Help Scout son el otro lugar donde un nombre de plan guardado da sus frutos.
¿Qué propiedades conviene crear primero?
Empieza por las tres que cambian cómo respondes, no por las que simplemente están disponibles.
- Plan o nivel. Un desplegable (
planName) permite que un workflow etiquete los niveles más altos y los asigne a tu cola más sénior, y es la propiedad individual más útil para las mejores prácticas de SLA. - ID de cuenta o usuario. Una propiedad de texto permite que un agente la pegue directamente en tu herramienta de admin. Usa en su lugar una propiedad de URL si puedes enlazar al perfil de facturación, ya que las URL se muestran como enlaces clicables.
- Fecha de renovación o inicio. Una propiedad de fecha responde "cuánto tiempo llevan con nosotros" sin necesidad de buscarlo.
Evita cualquier cosa que solo rellenarías para un puñado de personas. Una propiedad que está vacía en el 90 por ciento de los perfiles es ruido en la barra lateral, y tienes un tope duro de 50. Mantén cortas las opciones del desplegable, porque la API acepta la etiqueta de la opción, y cambiarle el nombre puede romper una sincronización que envía el texto antiguo.
¿Dónde entra un agente de IA con las propiedades de clientes?
eesel es un compañero de IA para helpdesk que trabaja dentro de la bandeja de Help Scout. Su documentación de configuración de Help Scout lista una acción Find customer que encuentra clientes por email o nombre y, en chats de equipo, también lee detalles de contacto, las notas de tu equipo y sus valores de propiedad, como el plan. Una acción List properties lista las propiedades de cliente y organización que guarda tu cuenta. La documentación también dice que las acciones marcadas como solo en chats de equipo funcionan únicamente cuando un compañero se lo pregunta al agente, en el chat del dashboard o en una ejecución programada, y no están disponibles mientras responde a un cliente.
Así que aquí va el resumen honesto. Un compañero puede preguntarle a eesel "¿en qué plan está este cliente?" y obtener una respuesta del perfil. Mientras eesel redacta una respuesta para un cliente, la lectura documentada de propiedades no forma parte de ese flujo, y no encontré ninguna acción documentada que escriba propiedades. El patrón que yo usaría es dejar que un workflow de Help Scout convierta la propiedad en una etiqueta en Plus o Pro, y luego dejar que el agente actúe sobre la etiqueta, como describo en triage de tickets con IA. Mis entradas sobre el agente de IA de Help Scout y IA para Help Scout amplían la configuración.
Mi ejemplo real más cercano está en otro helpdesk. MentorShow, una plataforma francesa de aprendizaje online, opera eesel sobre HubSpot Service Hub. Sus instrucciones le dicen al agente que lea el hilo y el registro de HubSpot del miembro, incluido el estado de la suscripción, la próxima fecha de renovación y los tickets anteriores, porque un problema de inicio de sesión de alguien sin suscripción activa no es un problema de inicio de sesión. Entre el 8 de agosto y el 8 de septiembre de 2026, eesel leyó unas 1.200 conversaciones y tickets de HubSpot y escribió 432 borradores para el equipo, cada uno dejado como nota interna para que una persona lo enviara. Ese es el trabajo que hace una propiedad de plan en Help Scout: dar a quien responda el contexto de la cuenta antes de escribir la primera palabra. Ve también la integración con HubSpot.
Para un agente de código, el CLI de eesel puede ejecutar npx @eesel/cli integrations connect helpscout_v2 para mostrar las opciones de conexión, y eesel chat te deja hacer preguntas de prueba antes. Conectar la bandeja sigue necesitando que un administrador o propietario de la cuenta de Help Scout lo apruebe en el navegador.
¿Qué errores conviene evitar con las propiedades?
- Un ID que no coincide.
planNameno esPlanName. Copia el ID desde la página de settings. - Borrar una propiedad para ordenar. Los datos desaparecen de todos los contactos y no se pueden recuperar.
- Guardar un dato de la conversación como propiedad. "Tipo de solicitud" se sobrescribe con cada nueva conversación. Usa un campo personalizado.
- Tipos de valor incorrectos. Una fecha debe ser
YYYY-MM-DDpor la API, y un número debe ser un entero. - Construir enrutamiento sobre Standard. La condición de workflow necesita Plus o Pro.
- Esperar company properties desde cualquier vía. Zapier y Beacon identify todavía no las soportan.
Prueba un contacto de extremo a extremo antes de una importación masiva. Pon el valor, encuéntralo en la barra lateral, dispara el workflow y comprueba el resultado. Si más adelante añades un agente, empieza con Leave draft reply y mantén Send reply desactivado hasta que las respuestas sean fiables, algo que explico en workflows de aprobación de soporte al cliente y el traspaso de un agente de IA. Para configuraciones relacionadas de Help Scout, consulta conversaciones aplazadas, detección de colisiones y desvío de tickets con IA. Resolución en el primer contacto explica por qué el contexto en el perfil da sus frutos.
Prueba eesel con tu bandeja de Help Scout
Si tus propiedades ya te dicen quién está en qué plan, eesel para Help Scout es la siguiente capa que yo añadiría. Trabaja dentro de la bandeja, lee tu sitio de Docs y conversaciones pasadas, y deja que un compañero le pregunte sobre el plan de un cliente a partir del perfil. Puedes probar eesel con 100 créditos gratis durante 7 días, y después los planes de pago empiezan en $299 al mes por 500 créditos, donde un ticket o chat es un crédito (precios de eesel). ¿Comparando opciones? Mira mi resumen de mejor IA para Help Scout, o Help Scout frente a Front.
Preguntas frecuentes
¿Qué son las propiedades de clientes en Help Scout?
¿Cuántas propiedades de clientes se pueden crear en Help Scout?
50 contact properties y 50 company properties por cuenta, válidas en todas las bandejas. Cada una tiene uno de cinco tipos: texto, número, URL, fecha o desplegable. Consulta precios de Help Scout para el coste de cada plan.¿Qué planes de Help Scout incluyen propiedades de clientes?
¿Cómo se actualizan las propiedades de clientes de Help Scout con la API?
PATCH a /v2/customers/{id}/properties con operaciones replace o remove, usando el slug de la propiedad como ruta. La propiedad debe existir antes. Mi guía de API de Help Scout cubre la API más amplia.¿Cuál es la diferencia entre propiedades de clientes y campos personalizados en Help Scout?
¿Puede Beacon identify rellenar las propiedades de clientes de Help Scout?
Beacon('identify', ...) y el valor se sincroniza con el contacto cada vez que carga Beacon. Poner un valor como cadena vacía lo elimina. Consulta mi entrada sobre campos de formulario de Beacon.