Cómo mover productos a la papelera en Zoho Desk

Mover productos a la papelera en Zoho Desk se realiza mediante una única llamada a la API DELETE al endpoint /api/v1/products, que traslada los productos seleccionados a la papelera en lugar de eliminarlos de forma permanente.

Por qué es importante

Cuando necesitas retirar o limpiar registros de productos en Zoho Desk sin destruirlos permanentemente, moverlos a la papelera te ofrece una red de seguridad recuperable. Esto es especialmente útil durante reorganizaciones del catálogo o al dar de baja productos que aún pueden estar referenciados en tickets históricos. Conocer la operación correcta de la API y los ámbitos OAuth necesarios garantiza que tu integración o automatización lo gestione de forma limpia.

Paso a paso

Paso 1. Confirma que tu token OAuth incluye el ámbito correcto de Zoho Desk antes de realizar cualquier llamada a la API. Para operaciones a nivel de productos y configuración, tu token debe cubrir ámbitos como Desk.settings.ALL o el permiso Desk.settings.DELETE correspondiente. Sin el ámbito adecuado, la solicitud será rechazada en la capa de autorización. ^[3]

Paso 2. Construye tu solicitud DELETE apuntando al endpoint de productos. La operación es deletemoveproductstotrash y la ruta base es:

DELETE /api/v1/products

Este endpoint acepta un diccionario de parámetros de consulta opcional (p) que puedes usar para especificar qué producto o productos mover. ^[1]

Paso 3. Pasa los parámetros de filtro o identificador necesarios dentro del diccionario p. Por ejemplo, si utilizas el cliente Python, la llamada tiene este aspecto:

result = client.delete_move_products_to_trash(p={"id": "your_product_id"})

El método envía una solicitud DELETE a /api/v1/products con tus parámetros añadidos como parámetros de consulta. ^[1]

Paso 4. Inspecciona la respuesta de la API para confirmar que la operación se realizó correctamente. Una operación de papelera exitosa devolverá un objeto de respuesta que indica que los productos han sido movidos. Si la respuesta contiene un código de error, revisa la configuración de tu ámbito y los valores de los parámetros antes de volver a intentarlo. ^[1]

Paso 5. Si trabajas en una integración multiproducto que también gestiona artículos o tickets, ten en cuenta que cada tipo de entidad tiene su propio endpoint de papelera dedicado. Los artículos usan DELETE /api/v1/helpcenter/{helpcenter_id}/articles y los tickets usan POST /api/v1/tickets/trash — estas son operaciones independientes y no deben confundirse con el endpoint de productos. ^{[2] [4]}

Errores comunes

• Ámbitos OAuth ausentes o insuficientes. La causa más frecuente de una solicitud fallida es un token que carece del ámbito Desk.settings.DELETE o Desk.settings.ALL necesario. Verifica siempre que tu configuración ZOHODESKSCOPES incluya permisos a nivel de configuración antes de desplegar. ^[3]

• Confusión de métodos HTTP entre tipos de entidad. Mover productos a la papelera usa DELETE, mientras que mover tickets a la papelera usa POST a /api/v1/tickets/trash. Mezclar el verbo HTTP o la ruta del endpoint dará lugar a una operación fallida o no deseada. ^{[1] [4]}

• Omisión del parámetro p. Si no se proporciona ningún identificador de producto en los parámetros de consulta, es posible que la API no sepa sobre qué registros actuar. Confirma siempre qué campos identificadores espera el endpoint e inclúyelos en el diccionario p. ^[1]

• Discrepancia de centro de datos. Zoho Desk está disponible en varios centros de datos (.com, .eu, .in, etc.). Asegúrate de que tu URL base coincida con el centro de datos donde está alojada tu organización de Desk; de lo contrario, las solicitudes fallarán o se enrutarán incorrectamente. ^[5]

Qué verificar

• Cobertura de ámbitos: Verifica que tu token OAuth activo incluya Desk.settings.DELETE o Desk.settings.ALL y que el token no haya expirado. ^[3]
• Endpoint y método correctos: Confirma que estás llamando a DELETE /api/v1/products — no a los endpoints de papelera de artículos o tickets — y que los identificadores de producto se pasan en el parámetro p. ^[1]
• Validación de la respuesta: Tras la llamada, comprueba la respuesta de la API para verificar un estado de éxito y confirma que el producto ya no aparece en tu lista de productos activos (debería estar ahora en la papelera, recuperable si es necesario). ^[1]

---

*Beam Help es un recurso de soporte experto independiente para usuarios de Zoho — no somos el soporte oficial de Zoho. Para problemas a nivel de plataforma o consultas de facturación, contacta directamente con Zoho.*