zendesk-custom-objects-create-type
eesel Team
Last edited 27 febrero 2026
{
"title": "Cómo crear un tipo de objeto personalizado en Zendesk: Una guía completa",
"slug": "zendesk-custom-objects-create-type",
"locale": "es",
"date": "2026-02-27",
"updated": "2026-02-27",
"template": "default",
"excerpt": "Una guía paso a paso para crear tipos de objetos personalizados en Zendesk, que cubre tanto los métodos de API como los del Centro de administración con ejemplos prácticos.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"Custom Objects",
"API",
"Admin Center",
"Tutorial"
],
"readTime": 11,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Cómo crear un tipo de objeto personalizado en Zendesk: Una guía completa",
"description": "Una guía paso a paso para crear tipos de objetos personalizados en Zendesk, que cubre tanto los métodos de API como los del Centro de administración con ejemplos prácticos.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-52c48c7c-a1bf-48cb-bcc2-360921f95f3b"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-52c48c7c-a1bf-48cb-bcc2-360921f95f3b",
"coverImageAlt": "Imagen del banner para Cómo crear un tipo de objeto personalizado en Zendesk: Una guía completa",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Puedo cambiar una clave de objeto personalizado después de crearla?",
"answer": "No, la clave del objeto es permanente una vez creada. Si necesita una clave diferente, tendrá que eliminar el objeto y crear uno nuevo. Esto también elimina cualquier registro existente, así que planifique cuidadosamente su nomenclatura por adelantado."
},
{
"question": "¿Cómo creo un tipo de objeto personalizado de Zendesk si no soy administrador?",
"answer": "No puede. Solo los administradores tienen permiso para crear y modificar tipos de objetos personalizados. Si necesita objetos personalizados para su equipo, solicite a un administrador que los cree por usted o solicite acceso de administrador."
},
{
"question": "¿Cuál es la diferencia entre la nueva API de objetos personalizados y la API heredada de Sunshine?",
"answer": "La nueva API utiliza puntos de conexión como /api/v2/custom_objects y es el enfoque recomendado actualmente. La API heredada de Sunshine utiliza /api/sunshine/objects/types y tiene una estructura de datos diferente basada en JSON Schema. Si está empezando de cero, utilice la nueva API."
},
{
"question": "¿Puedo usar objetos personalizados en los disparadores y automatizaciones de Zendesk?",
"answer": "Sí, pero con limitaciones. Puede usar campos de relación de búsqueda en los disparadores de tickets para verificar si un ticket tiene un registro de objeto personalizado relacionado. También puede usar marcadores de posición para incluir datos de objetos personalizados en acciones de disparador y notificaciones por correo electrónico."
},
{
"question": "¿Cómo importo datos existentes a objetos personalizados?",
"answer": "Utilice el Importador de datos en el Centro de administración. Prepare un archivo CSV con columnas que coincidan con las claves de sus campos, incluya una columna external_id para la coincidencia y cárguelo a través de Centro de administración > Objetos y reglas > Importador de datos."
},
{
"question": "¿Qué sucede si elimino un tipo de objeto personalizado?",
"answer": "Eliminar un tipo de objeto elimina permanentemente todos los registros de ese tipo. Esta acción no se puede deshacer. Asegúrese de exportar cualquier dato que necesite conservar antes de eliminarlo."
}
],
"supportLink": null
}
}
---
Los objetos estándar de Zendesk, como tickets, usuarios y organizaciones, cubren la mayoría de las necesidades de soporte. Pero, ¿qué sucede cuando su empresa tiene datos únicos que no encajan en esas casillas predefinidas? Los [objetos personalizados de Zendesk](https://developer.zendesk.com/documentation/custom-data/v2/getting-started-with-custom-objects/) le brindan la flexibilidad de modelar sus datos exactamente como los necesita.
Los objetos personalizados le permiten extender el modelo de datos de Zendesk para almacenar información específica de su negocio. Ya sea que esté rastreando licencias de software, garantías de productos o detalles de suscripción, los objetos personalizados le brindan la flexibilidad de modelar sus datos exactamente como los necesita.
En esta guía, aprenderá cómo crear un tipo de objeto personalizado en Zendesk utilizando dos métodos: la API REST para configuraciones automatizadas y el Centro de administración para un enfoque de apuntar y hacer clic. También veremos cómo herramientas como [eesel AI](https://www.eesel.ai/integrations/zendesk) pueden funcionar junto con sus datos personalizados para automatizar los flujos de trabajo de soporte.
## Crear un tipo de objeto personalizado a través de la API
El método de la API le brinda un control preciso y le permite automatizar la creación de objetos en múltiples instancias de Zendesk. Aquí le mostramos cómo crear un tipo de objeto personalizado de Zendesk mediante programación.
### Paso 1: Habilite los objetos personalizados en su cuenta
Antes de que pueda usar la API, un administrador debe activar la función:
1. Navegue a **Centro de administración** > **Objetos y reglas** > **Objetos personalizados**
2. Haga clic en **Comenzar** para habilitar la función
3. Si ha utilizado previamente objetos personalizados heredados, verá un banner para probar la nueva experiencia
### Paso 2: Crear el objeto personalizado
Una vez habilitado, use el [punto de conexión para crear objetos personalizados](https://developer.zendesk.com/api-reference/custom-data/custom-objects/custom_objects/#create-custom-object) para definir su objeto:
**Punto de conexión:** `POST /api/v2/custom_objects`
**Parámetros requeridos:**
- `key`: Un identificador único para su objeto (no se puede cambiar más tarde)
- `title`: El nombre para mostrar en singular (por ejemplo, "Licencia de software")
- `title_pluralized`: El nombre para mostrar en plural (por ejemplo, "Licencias de software")
Aquí hay un ejemplo completo de cURL:
```bash
curl --request POST https://{subdomain}.zendesk.com/api/v2/custom_objects \
--header "Content-Type: application/json" \
-u {email_address}/token:{api_token} \
--data-raw '{
"custom_object": {
"key": "software_license",
"title": "Software License",
"title_pluralized": "Software Licenses"
}
}'
Respuesta esperada (201 Creado):
{
"custom_object": {
"url": "https://{subdomain}.zendesk.com/api/v2/custom_objects/software_license.json",
"key": "software_license",
"created_by_user_id": "15590417147927",
"updated_by_user_id": "15590417147927",
"created_at": "2023-09-12T16:28:17Z",
"updated_at": "2023-09-12T16:28:17Z",
"title": "Software License",
"raw_title": "Software License",
"title_pluralized": "Software Licenses",
"raw_title_pluralized": "Software Licenses",
"description": "",
"raw_description": ""
}
}
La key que elija es permanente, así que elija algo descriptivo que sea consistente con sus convenciones de nomenclatura.
Paso 3: Agregue campos personalizados para definir el esquema
Un objeto sin campos es solo un contenedor vacío. Use el punto de conexión para crear campos de objetos personalizados para agregar propiedades:
Punto de conexión: POST /api/v2/custom_objects/{custom_object_key}/fields
Tipos de campos disponibles:
text: Texto de una sola línea o de varias líneasdropdown: Opciones predefinidas con etiquetascheckbox: Booleano verdadero/falsolookup: Relaciones con tickets, usuarios, organizaciones u otros objetos personalizadosdate: Valores de fechanumber: Valores enterosdecimal: Números decimalesregexp: Texto que coincide con un patrón de expresión regular
Ejemplo: Agregar un campo desplegable para el estado de la licencia
curl --request POST \
https://{subdomain}.zendesk.com/api/v2/custom_objects/software_license/fields \
--header "Content-Type: application/json" \
-u {email_address}/token:{api_token} \
--data-raw '{
"custom_object_field": {
"key": "status",
"title": "License Status",
"type": "dropdown",
"custom_field_options": [
{"name": "Active", "raw_name": "Active", "value": "active"},
{"name": "Expired", "raw_name": "Expired", "value": "expired"},
{"name": "Pending", "raw_name": "Pending", "value": "pending"}
]
}
}'
Ejemplo: Agregar una relación de búsqueda para vincular licencias a usuarios
curl --request POST \
https://{subdomain}.zendesk.com/api/v2/custom_objects/software_license/fields \
--header "Content-Type: application/json" \
-u {email_address}/token:{api_token} \
--data-raw '{
"custom_object_field": {
"key": "assigned_user",
"title": "Assigned User",
"type": "lookup",
"relationship_target_type": "zen:user"
}
}'
Los agentes ven los campos en el orden en que los crea. Si necesita reordenarlos más tarde, use el punto de conexión para reordenar los campos de objetos personalizados.
Crear un tipo de objeto personalizado en el Centro de administración
Si prefiere una interfaz visual, el Centro de administración proporciona una forma sencilla de crear objetos personalizados sin escribir ningún código.
Paso 1: Acceda a la página de objetos personalizados
- En el Centro de administración, haga clic en Objetos y reglas en la barra lateral
- Seleccione Objetos personalizados > Objetos
- Haga clic en Crear objeto
Paso 2: Configure las propiedades del objeto
Complete la información básica del objeto:
- Clave del objeto: Un identificador único (por ejemplo,
software_license). Esto no se puede cambiar más tarde. - Nombre singular: Cómo aparece el objeto en la interfaz (por ejemplo, "Licencia de software")
- Nombre plural: La forma plural que se muestra en las listas (por ejemplo, "Licencias de software")
- Descripción: Contexto opcional para otros administradores
- Visibilidad: Elija si los agentes pueden ver este tipo de objeto en la página de registros de objetos personalizados
Haga clic en Guardar para crear el objeto.
Paso 3: Defina campos personalizados
Después de guardar, verá una pestaña Campos:
- Haga clic en Agregar campo
- Seleccione un tipo de campo en el menú desplegable (texto, número, fecha, menú desplegable, casilla de verificación, búsqueda)
- Ingrese una clave de campo y un título para mostrar
- Configure las opciones específicas del tipo (por ejemplo, valores desplegables, destino de búsqueda)
- Establezca si el campo es obligatorio
- Haga clic en Guardar
Repita este proceso para cada campo que necesite. El campo estándar name se incluye de forma predeterminada, por lo que no necesita crearlo por separado.
Comprender los campos y las relaciones de los objetos personalizados
Los campos definen qué datos pueden contener sus objetos personalizados. Elegir los tipos de campo correctos hace que sus datos sean más útiles y fáciles de trabajar.
Campos estándar vs. personalizados
Cada objeto personalizado incluye automáticamente un campo name estándar. Esto sirve como el identificador principal para los registros. Puede personalizar su título (por ejemplo, cambiar "Nombre" a "Clave de licencia"), pero no puede eliminarlo.
Los campos personalizados son donde define su estructura de datos específica. Puede agregar hasta 100 campos personalizados por objeto, lo que le brinda mucha flexibilidad para modelos de datos complejos.
Tipos de campos explicados
- Campos de texto: Almacene texto de forma libre. Use una sola línea para entradas cortas (como números de serie) y varias líneas para descripciones más largas.
- Campos desplegables: Restrinja la entrada a opciones predefinidas. Útil para campos de estado, categorías o cualquier dato con un conjunto fijo de valores.
- Campos de casilla de verificación: Valores simples verdadero/falso. Bueno para indicadores como "requiere aprobación" o "está activo".
- Campos de fecha: Almacene fechas de calendario. Útil para fechas de vencimiento, fechas de compra o fechas de renovación.
- Campos de número/decimal: Almacene valores numéricos. Úselo para cantidades, montos o cualquier valor calculado.
- Campos de relación de búsqueda: El tipo de campo más potente. Estos crean conexiones entre su objeto personalizado y otros objetos de Zendesk.
Relaciones de búsqueda
Los campos de búsqueda le permiten vincular registros de objetos personalizados a:
- Tickets: Asocie una licencia, producto o activo con un ticket de soporte específico
- Usuarios: Conecte registros a los clientes que los poseen
- Organizaciones: Vincule datos a cuentas de empresa
- Otros objetos personalizados: Construya relaciones complejas (por ejemplo, licencias vinculadas a productos)
Cuando agrega un campo de búsqueda a un formulario de ticket, los agentes pueden buscar y seleccionar registros de objetos personalizados relacionados directamente mientras trabajan en los tickets. Esto lleva sus datos personalizados al flujo de trabajo de soporte.
Planifique los límites a tener en cuenta
| Límite | Suite Team/Growth | Enterprise/Professional+ |
|---|---|---|
| Objetos personalizados por cuenta | 3-5 | 30-50 |
| Campos por objeto | 100 | 100 |
| Relaciones de búsqueda por objeto | 5 | 10 |
Estos límites son topes máximos, así que planifique la estructura de su objeto en consecuencia. Si está alcanzando los límites con frecuencia, es posible que deba consolidar objetos o actualizar su plan.
Crear y administrar registros de objetos
Una vez que haya definido su tipo de objeto y sus campos, puede comenzar a crear registros reales.
Crear registros a través de la API
Use el punto de conexión para crear registros de objetos personalizados:
Punto de conexión: POST /api/v2/custom_objects/{custom_object_key}/records
curl --request POST \
https://{subdomain}.zendesk.com/api/v2/custom_objects/software_license/records \
--header "Content-Type: application/json" \
-u {email_address}/token:{api_token} \
--data-raw '{
"custom_object_record": {
"name": "LICENSE-2024-001",
"custom_fields": {
"status": "active",
"assigned_user": "123456789"
}
}
}'
Crear registros en el Centro de administración
- Vaya a Centro de administración > Objetos y reglas > Objetos personalizados > Registros
- Seleccione su tipo de objeto en el menú desplegable
- Haga clic en Agregar registro
- Complete los valores de los campos
- Haga clic en Guardar
Importación masiva con CSV
Para grandes conjuntos de datos, use el Importador de datos en el Centro de administración:
- Prepare un CSV con columnas que coincidan con las claves de sus campos
- Incluya una columna
external_idpara hacer coincidir los registros existentes - Cargue a través de Centro de administración > Objetos y reglas > Importador de datos
- Asigne columnas CSV a campos de objeto
- Revise y confirme la importación
El Importador de datos puede crear nuevos registros y actualizar los existentes en función del campo external_id.
Usar marcadores de posición en macros y disparadores
Los datos de objetos personalizados se vuelven poderosos cuando los usa en sus flujos de trabajo de soporte. Zendesk admite marcadores de posición que le permiten hacer referencia a valores de objetos personalizados en macros, disparadores y automatizaciones.
Para un campo de búsqueda con ID 123456789 en un ticket:
{{ticket.ticket_field_123456789.name}}devuelve el nombre del registro vinculado{{ticket.ticket_field_123456789.custom_fields.status}}devuelve el valor del campo de estado{{ticket.ticket_field_123456789.custom_fields.status.title}}devuelve el valor de visualización para los campos desplegables
Esto le permite crear macros dinámicas que extraen automáticamente los datos relevantes del cliente.
Límites del plan y consideraciones importantes
Antes de construir su estructura de objetos personalizados, comprenda las limitaciones:
| Plan | Límite de objetos personalizados |
|---|---|
| Suite Team | 3 |
| Suite Growth | 5 |
| Support Enterprise / Suite Professional | 30 |
| Suite Enterprise / Suite Enterprise Plus | 50 |
Limitaciones clave:
- Límite de campos: 100 campos personalizados por objeto (los campos estándar no cuentan)
- Límites de búsqueda: 5 campos de búsqueda por objeto en Team/Growth, 10 en planes superiores
- Claves inmutables: La clave del objeto no se puede cambiar después de la creación. Si comete un error, deberá eliminar y volver a crear el objeto (perdiendo los registros existentes).
- Solo para administradores: Solo los administradores pueden crear y modificar tipos de objetos. Los agentes pueden crear y editar registros si se les da permiso.
- Límites de velocidad de la API: Las operaciones masivas están sujetas a los límites de velocidad de la API estándar de Zendesk.
Mejores prácticas:
- Use convenciones de nomenclatura consistentes para las claves (las minúsculas con guiones bajos funcionan bien)
- Documente el esquema de su objeto para otros miembros del equipo
- Pruebe con un pequeño conjunto de datos antes de la importación masiva
- Planifique cuidadosamente sus relaciones de búsqueda, ya que no se pueden cambiar fácilmente más tarde
Extender su mesa de ayuda con IA
Los objetos personalizados le brindan una forma poderosa de estructurar sus datos. Pero los datos por sí solos no resuelven los problemas de soporte, necesita hacerlos procesables. La IA puede cerrar esa brecha.
eesel AI funciona como un compañero de equipo de IA dentro de su instancia de Zendesk. Aprende de los artículos de su centro de ayuda, los tickets anteriores y, sí, incluso de los datos de sus objetos personalizados. En lugar de simplemente almacenar información sobre licencias de software o garantías de productos, eesel puede usar esos datos para resolver tickets automáticamente.
Así es como funciona: conecte eesel a su cuenta de Zendesk e inmediatamente comenzará a aprender el contexto de su negocio. Cuando un cliente envía un correo electrónico sobre un problema de licencia, eesel puede buscar sus registros de objetos personalizados, verificar el estado y responder con la información correcta. No se necesita ningún agente para las búsquedas de rutina.
La diferencia con la automatización estándar es que eesel comprende el contexto. No solo coincide con las palabras clave, sino que lee el ticket, comprende lo que necesita el cliente y toma las medidas apropiadas en función de sus datos personalizados. Usted define las reglas de escalamiento en inglés sencillo ("Si la licencia ha caducado, ofrezca opciones de renovación") y eesel las sigue.
Para los equipos que ya utilizan objetos personalizados para rastrear datos complejos de clientes, agregar una capa de IA puede convertir esos datos en resoluciones automatizadas. Vale la pena explorarlo si está buscando escalar sin aumentar proporcionalmente su equipo.
Comience a construir objetos personalizados en Zendesk hoy
Ahora tiene dos métodos sólidos para crear tipos de objetos personalizados en Zendesk: la API para el control programático y el Centro de administración para la configuración visual. Ambos enfoques le permiten extender Zendesk más allá de su modelo de datos estándar para capturar la información única que necesita su negocio.
La clave es comenzar de forma sencilla. Elija un caso de uso (como el seguimiento de licencias de software o registros de productos), cree un objeto básico con algunos campos y pruébelo con su equipo. Una vez que vea cómo encajan los objetos personalizados en su flujo de trabajo, puede expandirse a modelos de datos más complejos.
Recuerde que la planificación importa. Las claves de objeto son permanentes, las relaciones de campo son difíciles de cambiar y los límites del plan son restricciones reales. Dibuje su modelo de datos antes de construir.
Para obtener una referencia detallada de la API y ejemplos adicionales, consulte la documentación oficial de objetos personalizados de Zendesk. Y si está buscando hacer más con sus datos personalizados, explore cómo eesel AI puede convertir esos datos en resoluciones de soporte automatizadas.
Compartir esta entrada
Article by
