{
"title": "Cómo crear organizaciones utilizando la API de Zendesk: Una guía completa",
"slug": "zendesk-api-create-organization",
"locale": "es",
"date": "2026-03-02",
"updated": "2026-03-02",
"template": "default",
"excerpt": "Una guía paso a paso para crear organizaciones a través de la API de Zendesk, que cubre la autenticación, los formatos de solicitud, los campos personalizados y los patrones de implementación del mundo real.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk API",
"Organizations API",
"Customer Support",
"API Tutorial",
"Developer Guide"
],
"readTime": 9,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Cómo crear organizaciones utilizando la API de Zendesk: Una guía completa",
"description": "Una guía paso a paso para crear organizaciones a través de la API de Zendesk, que cubre la autenticación, los formatos de solicitud, los campos personalizados y los patrones de implementación del mundo real.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-dcfab4dd-2a16-4848-9dee-837aebf2e3ee"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-dcfab4dd-2a16-4848-9dee-837aebf2e3ee",
"coverImageAlt": "Imagen del banner para Cómo crear organizaciones utilizando la API de Zendesk: Una guía completa",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Preguntas Frecuentes",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "¿Qué método de autenticación utiliza el endpoint de la API de Zendesk para crear organizaciones?",
"answer": "El endpoint utiliza la autenticación básica HTTP. Combina su dirección de correo electrónico con `/token:` y su token de API, codifica el resultado en base64 y lo incluye en el encabezado de autorización. El formato es `Authorization: Basic {base64(email/token:api_token)}`."
},
{
"question": "¿Puedo crear organizaciones con el endpoint de la API de Zendesk para crear organizaciones utilizando solo una contraseña en lugar de un token de API?",
"answer": "Si bien técnicamente es posible, se recomienda encarecidamente utilizar tokens de API. Los tokens son más seguros porque se pueden revocar independientemente de la contraseña principal de su cuenta y le permiten crear credenciales separadas para diferentes integraciones."
},
{
"question": "¿Qué sucede si intento crear una organización con el endpoint de la API de Zendesk para crear organizaciones utilizando un nombre duplicado?",
"answer": "La API devuelve un error 422 Entidad no procesable con un mensaje que indica que el nombre ya ha sido tomado. Los nombres de las organizaciones deben ser únicos en toda su cuenta de Zendesk."
},
{
"question": "¿Cómo configuro los valores de los campos personalizados cuando utilizo el endpoint de la API de Zendesk para crear organizaciones?",
"answer": "Incluya un objeto organization_fields en el cuerpo de su solicitud con claves que coincidan con sus claves de campo personalizadas y valores en el formato apropiado para cada tipo de campo. Puede encontrar las claves de los campos en el Centro de administración en Organizaciones y luego en Campos."
},
{
"question": "¿Existe un límite de velocidad para el endpoint de la API de Zendesk para crear organizaciones?",
"answer": "Sí, la API de organizaciones tiene un límite de velocidad de 700 solicitudes por minuto. Si excede esto, recibirá una respuesta 429 Demasiadas solicitudes. Implemente una lógica de retroceso exponencial y reintento para las integraciones de producción."
},
{
"question": "¿Puedo utilizar el endpoint de la API de Zendesk para crear organizaciones para mapear automáticamente a los usuarios por dominio de correo electrónico?",
"answer": "Sí. Incluya una matriz domain_names en su solicitud con los dominios de correo electrónico que desea mapear automáticamente. Cuando los usuarios con direcciones de correo electrónico coincidentes envían tickets, se agregarán automáticamente a esa organización."
}
],
"supportLink": null
}
}
---
Las organizaciones son una de las funciones más potentes de [Zendesk](https://www.zendesk.com) para gestionar las relaciones con los clientes a escala. Le permiten agrupar usuarios, enrutar tickets automáticamente y controlar la visibilidad de las conversaciones de soporte. Si bien puede crear organizaciones manualmente a través de la interfaz de Zendesk, el verdadero poder proviene de la automatización de este proceso a través de la [API de Zendesk](https://developer.zendesk.com/api-reference).
Ya sea que esté migrando desde otra plataforma, sincronizando con su CRM o creando un flujo de registro de autoservicio, saber cómo crear organizaciones a través de la [API de organizaciones de Zendesk](https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/) es esencial para cualquier implementación seria. Esta guía lo guía a través de todo lo que necesita saber, desde la autenticación hasta el manejo de casos extremos. Si está buscando automatizar la gestión de organizaciones más allá de las llamadas API básicas, [eesel AI](https://www.eesel.ai) puede encargarse de todo el flujo de trabajo por usted.
## Lo que necesitará para comenzar
Antes de sumergirse en el código, asegúrese de tener estos requisitos previos en su lugar:
- **Una cuenta de Zendesk con acceso de administrador.** Solo los administradores y agentes con roles personalizados pueden crear organizaciones a través de la API.
- **Un token de API.** Deberá generarlo desde su Centro de administración de Zendesk en Aplicaciones e integraciones > API > API de Zendesk.
- **Su subdominio de Zendesk.** Esta es la primera parte de su URL de Zendesk (por ejemplo, `suempresa` en `suempresa.zendesk.com`).
- **Una herramienta para realizar solicitudes HTTP.** Mostraremos ejemplos usando cURL, Python y JavaScript, así que elija lo que funcione para su pila.
La [API de Zendesk](https://developer.zendesk.com/api-reference) utiliza la autenticación básica con una combinación de dirección de correo electrónico y token de API. Esto es más seguro que usar su contraseña y le permite controlar el acceso de forma granular.
## Paso 1: Genere su token de API de Zendesk
Su token de API es la clave que permite que su código se autentique con Zendesk. Aquí le mostramos cómo crear uno:
1. Inicie sesión en su cuenta de Zendesk como administrador
2. Haga clic en el icono **Centro de administración** en la barra lateral
3. Vaya a **Aplicaciones e integraciones** > **API** > **API de Zendesk**
4. Haga clic en la pestaña **Configuración**
5. Habilite **Acceso de token** si aún no está activado
6. Haga clic en el icono **más (+)** para agregar un nuevo token
7. Dele un nombre descriptivo como "API de gestión de organizaciones"
8. Copie el token inmediatamente (Zendesk solo lo muestra una vez)
Guarde este token de forma segura. Trátelo como una contraseña. Cualquiera que tenga su token puede acceder a sus datos de Zendesk a través de la API.
**Consejo profesional:** Cree tokens separados para diferentes integraciones en lugar de reutilizar uno en todas partes. Esto facilita la revocación del acceso si es necesario sin interrumpir otros sistemas.
## Paso 2: Comprenda el endpoint de organizaciones
La [API de organizaciones](https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/) sigue las convenciones REST. Para crear una organización, realizará una solicitud POST a:
https://{subdominio}.zendesk.com/api/v2/organizations
El cuerpo de la solicitud es un objeto JSON que contiene las propiedades de la organización. Aquí le mostramos cómo se ve una solicitud de creación mínima:
```json
{
"organization": {
"name": "Acme Corporation"
}
}
El único campo obligatorio es name (nombre), y debe ser único en toda su cuenta de Zendesk. No puede incluir caracteres de barra vertical (|) en el nombre, o la solicitud fallará.
Más allá de lo básico, puede establecer varias propiedades útiles:
| Campo | Tipo | Propósito |
|---|---|---|
domain_names | array | Dominios de correo electrónico que mapean automáticamente a los usuarios a esta organización |
external_id | string | El ID único de su sistema para esta organización |
group_id | integer | Asigne automáticamente los tickets de esta organización a un grupo específico |
organization_fields | object | Valores de campos personalizados que ha definido |
shared_tickets | boolean | Permita que los usuarios vean los tickets de los demás |
shared_comments | boolean | Permita que los usuarios comenten los tickets de los demás |
tags | array | Etiquetas para aplicar a la organización |
details | string | Notas públicas sobre la organización |
notes | string | Notas privadas solo visibles para los agentes |
La autenticación utiliza HTTP Basic Auth. Combine su dirección de correo electrónico con /token: y su token de API, luego codifique el resultado en base64. El encabezado se ve así:
Authorization: Basic {credenciales_codificadas_en_base64}
Paso 3: Cree su primera organización
Pongamos esto en práctica con ejemplos de código funcional. Cada ejemplo crea una organización con campos comunes que realmente usaría.
Usando cURL
SUBDOMAIN="suempresa"
EMAIL="admin@suempresa.com"
TOKEN="su_token_de_api_aqui"
curl -X POST "https://${SUBDOMAIN}.zendesk.com/api/v2/organizations" \
-H "Content-Type: application/json" \
-u "${EMAIL}/token:${TOKEN}" \
-d '{
"organization": {
"name": "Acme Corporation",
"domain_names": ["acme.com", "acmecorp.com"],
"external_id": "CRM-12345",
"tags": ["enterprise", "priority"],
"details": "Cliente empresarial desde 2020"
}
}'
Usando Python
import requests
import base64
subdomain = "suempresa"
email = "admin@suempresa.com"
token = "su_token_de_api_aqui"
credentials = base64.b64encode(
f"{email}/token:{token}".encode()
).decode()
organization = {
"organization": {
"name": "Acme Corporation",
"domain_names": ["acme.com", "acmecorp.com"],
"external_id": "CRM-12345",
"tags": ["enterprise", "priority"],
"details": "Cliente empresarial desde 2020"
}
}
response = requests.post(
f"https://{subdomain}.zendesk.com/api/v2/organizations",
headers={
"Content-Type": "application/json",
"Authorization": f"Basic {credentials}"
},
json=organization
)
if response.status_code == 201:
created_org = response.json()["organization"]
print(f"ID de organización creada: {created_org['id']}")
print(f"Nombre: {created_org['name']}")
else:
print(f"Error: {response.status_code}")
print(response.json())
Usando JavaScript/Node.js
const axios = require('axios');
// Configuration
const config = {
subdomain: 'suempresa',
email: 'admin@suempresa.com',
token: 'su_token_de_api_aqui'
};
// Organization data
const organization = {
organization: {
name: 'Acme Corporation',
domain_names: ['acme.com', 'acmecorp.com'],
external_id: 'CRM-12345',
tags: ['enterprise', 'priority'],
details: 'Cliente empresarial desde 2020'
}
};
// Make the request
axios.post(
`https://${config.subdomain}.zendesk.com/api/v2/organizations`,
organization,
{
headers: {
'Content-Type': 'application/json'
},
auth: {
username: `${config.email}/token`,
password: config.token
}
}
)
.then(response => {
const org = response.data.organization;
console.log(`ID de organización creada: ${org.id}`);
console.log(`Nombre: ${org.name}`);
})
.catch(error => {
console.error('Error:', error.response?.data || error.message);
});
Una creación exitosa devuelve HTTP 201 con el objeto de organización completo, incluido el campo id generado automáticamente que necesitará para futuras actualizaciones.
Paso 4: Trabaje con campos de organización personalizados
La mayoría de las implementaciones de Zendesk utilizan campos personalizados para almacenar datos adicionales de la organización, como niveles de cuenta, regiones o ID de CRM. Aquí le mostramos cómo trabajar con ellos a través de la API.
Primero, necesita saber qué campos personalizados existen. Puede encontrarlos en su Centro de administración de Zendesk en Objetos y reglas > Organizaciones > Campos, o recuperarlos a través de la API:
curl "https://{subdominio}.zendesk.com/api/v2/organization_fields" \
-u "{email}/token:{token}"
Cada campo personalizado tiene una clave única (como account_tier o region). Cuando esté creando o actualizando una organización, inclúyalos en el objeto organization_fields:
{
"organization": {
"name": "Acme Corporation",
"organization_fields": {
"account_tier": "enterprise",
"region": "north_america",
"crm_id": "CRM-12345",
"contract_value": 50000
}
}
}
El formato del valor depende del tipo de campo:
- Campos de texto: Valores de cadena
- Campos desplegables: El valor de la etiqueta de opción (no el nombre para mostrar)
- Campos numéricos: Números (no cadenas)
- Campos de fecha: Formato ISO 8601 (
2024-01-15) - Campos de casilla de verificación: Booleano (
trueofalse)
Caso de uso común: Sincronización de datos de organización desde su CRM. Configure un webhook o un trabajo programado que envíe actualizaciones a Zendesk cada vez que los detalles de la cuenta cambien en su sistema principal. Esto mantiene a los agentes de soporte trabajando con información actual.
Paso 5: Maneje errores y casos extremos
El código de producción necesita manejar las cosas que salen mal. Estos son los errores más comunes que encontrará:
401 No autorizado
Esto significa que sus credenciales no son válidas. Compruebe que:
- Su token de API sea correcto y no haya sido revocado
- Su dirección de correo electrónico coincida con la cuenta que posee el token
- Está utilizando el formato correcto:
email/token:token(tenga en cuenta la parte/token:)
422 Entidad no procesable
La solicitud se entendió pero no se pudo procesar. Causas comunes:
- Nombre duplicado: Los nombres de las organizaciones deben ser únicos. Compruebe primero las organizaciones existentes.
- Caracteres no válidos: Los nombres no pueden contener caracteres de barra vertical (|).
- Faltan campos obligatorios: El campo
name(nombre) es obligatorio. - Valores de campo personalizados no válidos: Asegúrese de que los valores desplegables coincidan exactamente con las opciones definidas.
429 Demasiadas solicitudes
Ha alcanzado el límite de velocidad de Zendesk. La API de organizaciones permite 700 solicitudes por minuto. Si necesita crear organizaciones en masa, agregue retrasos entre las solicitudes:
import time
for org_data in organizations:
response = requests.post(url, json=org_data, auth=auth)
if response.status_code == 429:
# Espere y vuelva a intentarlo
time.sleep(1)
response = requests.post(url, json=org_data, auth=auth)
# Procese la respuesta...
time.sleep(0.1) # Sea amable con la API
Mejor práctica: Al crear integraciones, siempre verifique los códigos de estado de la respuesta e implemente un retroceso exponencial para los errores 429. Registre las solicitudes fallidas para que pueda volver a intentarlas más tarde.
Automatización de la gestión de organizaciones con eesel AI
La gestión manual de organizaciones no es escalable. A medida que crece su base de clientes, mantener las organizaciones de Zendesk sincronizadas con su CRM, sistema de facturación y otras herramientas se convierte en una carga operativa importante.
Aquí es donde podemos ayudar. En eesel AI, hemos creado un compañero de equipo de IA que se integra directamente con Zendesk y puede automatizar los flujos de trabajo basados en la organización.
Así es como nuestros clientes utilizan eesel AI con organizaciones:
- Asignación automática de organizaciones: Cuando llega un ticket, nuestra IA puede buscar al solicitante en su CRM, crear o actualizar su organización en Zendesk y enrutar el ticket al equipo correcto en función de las propiedades de la organización.
- Escalada inteligente: Podemos leer los campos personalizados de la organización (como el nivel de cuenta o el nivel de SLA) y escalar los tickets de los clientes empresariales automáticamente.
- Respuestas conscientes de la organización: Nuestra IA redacta respuestas que hacen referencia a detalles específicos de la organización, como los términos del contrato, los administradores de cuentas dedicados o los problemas anteriores.
A diferencia de la creación de integraciones de API personalizadas, eesel AI aprende de sus datos y flujos de trabajo existentes. Usted describe lo que quiere en inglés sencillo (como "Si el nivel de la organización es empresarial, copie al administrador de la cuenta"), y nuestra IA se encarga de las llamadas API, el manejo de errores y la lógica.
Puede comenzar con nuestro copiloto de IA redactando respuestas para la revisión del agente, luego subir de nivel a la automatización completa a medida que crea confianza. La mayoría de los equipos ven el retorno de la inversión en dos meses.
Comience a construir con la API de organizaciones de Zendesk
Ahora tiene todo lo que necesita para crear y administrar organizaciones mediante programación en Zendesk. Repasemos los pasos clave:
- Genere un token de API desde su Centro de administración de Zendesk
- Estructure su solicitud POST a
/api/v2/organizationscon los datos de la organización - Maneje la respuesta JSON para obtener el ID de la organización creada
- Utilice campos personalizados para almacenar datos específicos de la organización
- Implemente el manejo de errores adecuado para el código de producción
La API de organizaciones es solo el comienzo. También puede actualizar organizaciones, fusionar duplicados, administrar membresías de organizaciones y configurar reglas comerciales basadas en organizaciones.
Para casos de uso avanzados, como importaciones masivas o sincronización bidireccional con otros sistemas, considere si una solución impulsada por IA podría ahorrarle tiempo a su equipo. Pruebe eesel AI gratis durante 7 días y vea cómo la automatización puede transformar sus operaciones de soporte.
Compartir esta entrada
Article by
