|
Resumen: "Ring Groups" pasa a denominarse "queues" en las APIs Live y Explore. Los clientes que utilicen las APIs Live y Explore deben actualizar sus integraciones antes del 14 de enero de 2027. Clientes afectados: Clientes con integraciones de Explore API que busquen campos por nombre y todos los clientes con integraciones de Live API que utilicen el campo, filtro o consultas afectados. |
Qué cambia y por qué
"Ring Groups" es un término específico de voz que no se ajusta a la mensajería digital. Además, en varias áreas de Talkdesk ya se ha adoptado el término "queues" como terminología estándar. Como parte de la estandarización de la terminología en toda la plataforma, este cambio de nombre se extenderá a la Explore API y a la Live API.
Los nuevos nombres de campos, filtros y consultas de colas se publicarán el 24 de septiembre de 2026 y coexistirán junto con el campo ring groups existente en la Explore API y la Live API (consulte la nota de lanzamiento). Ambos funcionan de manera idéntica; solo cambia el nombre. Sin embargo, el campo "Ring Groups" se eliminará el 14 de enero de 2027. Los clientes deben revisar sus integraciones API y actualizar cualquier referencia a "Ring Groups" para utilizar "queues" antes de esta fecha para evitar interrupciones.
Nota: Este cambio de nombre se extenderá a toda la interfaz de usuario de Talkdesk. El 24 de septiembre de 2026, todos los campos y filtros que hacen referencia a "ring groups" en los informes y conjuntos de datos de Explore cambiarán su nombre a "queues". Se publicará una nota de lanzamiento por separado antes de este cambio.
Cronograma:
- 24 de septiembre de 2026: Los nuevos campos, filtros y nombres de colas estarán disponibles. Las referencias Legacy "Ring Groups" seguirán disponibles durante el período de transición.
- Del 24 de septiembre de 2026 al 13 de enero de 2027: Los clientes afectados actualizan y validan las integraciones utilizando las nuevas referencias de colas.
- 14 de enero de 2027: Los campos, filtros y nombres de consulta de los Legacy ring groups que se indican aquí se eliminarán o renombrarán de forma permanente.
Acción requerida antes del 14 de enero de 2027: Clientes existentes (directos o revendedores)
- Identifique todos los puntos de integración que utilicen los campos JSON, filtros o nombres de consulta de los siguientes "Ring Groups".
- Actualice las integraciones para reemplazar los campos JSON relacionados con Legacy ring groups por los campos, filtros y nombres de consultas correspondientes a "queues".
- Valide las integraciones antes del 14 de enero de 2027.
Si se hace referencia a los campos por su posición en los custom reports, no se requiere ninguna acción. Si se hace referencia a los campos por su nombre, las integraciones deben actualizarse para utilizar los nuevos nombres antes de la fecha de eliminación. Se recomienda a los clientes que actualicen sus integraciones API lo antes posible. Si no se actualizan antes de la fecha límite, los informes personalizados y otras integraciones que utilicen la legacy ring groups API podrían presentar errores.
Cambios en el campo Explore API
Se añadirán nuevos campos JSON a los siguientes informes como últimos campos de la respuesta. Cuando un campo legacy se elimine posteriormente, el que lo sustituye ocupa la posición que antes ocupaba ese campo. Por lo tanto, el nuevo campo "queues" pasa a ocupar la posición de legacy ring groups una vez que se elimine.
| Informe |
Campos JSON legacy (eliminados permanentemente el 14 de enero de 2027) |
Nuevos campos JSON (disponibles desde el 24 de septiembre de 2026) |
|---|---|---|
| Contacts Report | ring_groups | queues |
| Contacts Report | handling_ring_groups | handling_queues |
| Calls Report | ring_groups | queues |
| Explore Calls Report | tags | queues |
| User Status Report | ring_groups | queues |
| Feedback Flow Report | ring_groups | queues |
| WFM Schedule Adherence Report | agent_ring_groups | agent_queues |
Cambios en los nombres de las consultas y los filtros de Live API
|
Nombre Legacy (eliminado permanentemente el 14 de enero de 2027) |
Nuevo nombre | |
|---|---|---|
| live_contacts_list (consulta) | handling_ring_groups (JSON key) | live_queue (JSON key) |
| Filtro de consulta | ring_groups | queues |
- Cambios en los nombres de las consultas de Live API
|
Nombre de la consulta Legacy (eliminado permanentemente el 14 de enero de 2027) |
Nuevo nombre de la consulta (disponible desde el 24 de septiembre de 2026) |
|---|---|
| abandon_rate_by_ring_group | abandon_rate_by_queue |
| abandoned_contacts_by_ring_group | abandoned_contacts_by_queue |
| answered_contacts_by_ring_group | answered_contacts_by_queue |
| arrived_contacts_by_ring_group | arrived_contacts_by_queue |
| avg_abandon_time_by_ring_group | avg_abandon_time_by_queue |
| avg_handle_time_by_ring_group | avg_handle_time_by_queue |
| avg_wait_time_by_ring_group | avg_wait_time_by_queue |
| inbound_contacts_by_ring_group | inbound_contacts_by_queue |
| live_contacts_in_progress_inbound_by_ring_group | live_contacts_in_progress_inbound_by_queue |
| live_contacts_in_progress_outbound_by_ring_group | live_contacts_in_progress_outbound_by_queue |
| live_contacts_in_queue_by_ring_group | live_contacts_in_queue_by_queue |
| live_contacts_inbound_by_ring_group | live_contacts_inbound_by_queue |
| live_contacts_outbound_by_ring_group | live_contacts_outbound_by_queue |
| live_users_logged_in_by_ring_group | live_users_logged_in_by_queue |
| longest_wait_time_by_ring_group | longest_wait_time_by_queue |
| longest_wait_time_ring_group_event_vol | longest_wait_time_queue_event_vol |
| longest_wait_time_ring_group_event_vol_v2 | longest_wait_time_queue_event_vol_v2 |
| max_hold_time_by_ring_group | max_hold_time_by_queue |
| missed_contacts_by_ring_group | missed_contacts_by_queue |
| outbound_connected_contacts_by_ring_group | outbound_connected_contacts_by_queue |
| outbound_contacts_by_ring_group | outbound_contacts_by_queue |
| outbound_not_connected_contacts_by_ring_group | outbound_not_connected_contacts_by_queue |
| service_level_by_ring_group | service_level_by_queue |
Recursos
- Para más información sobre todos los informes de Explore afectados, consulte los siguientes artículos:
- Para ver la lista de todas las consultas de Live API que se modificarán, consulte la Referencia de consultas en vivo en este artículo.
Manténgase al día con las alertas de productos importantes de Talkdesk al suscribirse al Boletín Semanal de Talkdesk. Consulte cómo hacerlo aquí.
Si tiene alguna pregunta o duda, póngase en contacto con su representante de Talkdesk o con el equipo de Atención al cliente en el Talkdesk Support Portal.