Cambio incompatible en HubSpot: Help Desk reemplaza los comentarios por notas y la Conversations API dará error desde el 23 de septiembre

HubSpot está unificando cómo los equipos de servicio dejan contexto interno en un caso. En lugar de mantener dos mecanismos paralelos, comentarios de hilo dentro de Help Desk por un lado y notas sobre registros del CRM por otro, la plataforma se queda con las notas. El objetivo declarado es que la experiencia sea consistente y use el mismo tipo de registro que los usuarios ya crean sobre contactos, empresas y negocios.

El cambio tiene una fecha dura para quien integra por API: 23 de septiembre de 2026.

¿Qué endpoint se rompe exactamente?

El afectado es POST /conversations/v3/conversations/threads/{threadId}/messages cuando se usa con "type": "COMMENT" para agregar comentarios a un hilo de conversación.

A partir del 23 de septiembre de 2026, si el hilo corresponde a una cuenta de canal asociada a una bandeja de entrada con "type": "HELP_DESK", ese endpoint empezará a devolver un error. El error es de categoría VALIDATION_ERROR, con subcategoría ConversationsApiError.HELPDESK_INBOX_CANNOT_PUBLISH, y el mensaje indica que publicar comentarios en hilos de HelpDesk está prohibido por esa vía y sugiere usar la Notes API.

Un punto que conviene subrayar porque evita pánico innecesario: los hilos en una bandeja de conversaciones normal no cambian. Ahí las integraciones pueden seguir creando comentarios sin modificaciones. El corte aplica solo a bandejas de tipo Help Desk.

¿Cómo se detecta si un hilo está afectado?

HubSpot documenta dos caminos. El reactivo es simplemente verificar si aparece el mensaje de error y, en ese caso, crear una nota en vez de un comentario.

El proactivo tiene tres pasos: revisar el originalChannelAccountId en el detalle del hilo, obtener el inboxId de esa cuenta de canal por su identificador, y consultar la propiedad type en el detalle de la bandeja para saber si es HELP_DESK o una bandeja de conversaciones.

¿Qué hay que cambiar en la integración?

La migración va hacia notas. Las notas se crean con la CRM Notes API y deben asociarse al ticket usando el associatedTicketId que viene en el detalle del hilo. Si la integración además lee comentarios existentes, hay que cambiar esa lectura para que traiga las notas asociadas al ticket.

Hay un detalle operativo que no conviene pasar por alto: los comentarios existentes no se migran a notas. Seguirán siendo visibles para los usuarios en Help Desk durante y después de la migración, pero quedan como un registro histórico separado. Cualquier reporte, automatización o auditoría que hoy dependa de leer comentarios va a quedar mirando un archivo congelado mientras la actividad nueva se acumula en otro lado.

Del lado del producto, el cambio de comentarios a notas en Help Desk está en beta pública. HubSpot recomienda que, después de actualizar la integración, se avise a los usuarios finales para que activen la beta y puedan ver las notas creadas por la integración. Quienes no estén en la beta las verán cuando la función se libere a todos.

Análisis de Revenue Hub

Este es el tipo de anuncio que un líder comercial ignora porque suena a asunto de desarrollo, y que después aparece como un problema de servicio al cliente. La pregunta correcta no es técnica sino operativa: ¿alguna parte de nuestro proceso de soporte escribe contexto interno en HubSpot desde un sistema externo? Si la respuesta es sí, hay una fecha en el calendario. Si nadie en la empresa sabe la respuesta, ese desconocimiento es el hallazgo real.

En los portales que vemos en Chile y Latinoamérica, los candidatos típicos son integraciones que empujan contexto a Help Desk desde un ERP, desde un sistema de terreno, desde un bot de WhatsApp o desde un middleware armado hace años por un proveedor que ya no está. Ninguna de esas piezas va a fallar ruidosamente: el endpoint devolverá un error de validación y, según cómo esté escrito el cliente, es perfectamente posible que el error se registre en un log que nadie mira mientras los agentes empiezan a atender casos sin el contexto que antes llegaba solo. Esa es la falla cara, y es silenciosa.

La recomendación es hacer dos cosas antes del 23 de septiembre, en ese orden. Primero, inventariar qué integraciones escriben comentarios en bandejas Help Desk, que es una revisión de una hora. Segundo, decidir explícitamente qué pasa con el histórico: como los comentarios no se migran, si hay reportería o auditoría apoyada en ellos hay que definir si se extrae ese histórico ahora o se acepta la discontinuidad. Aprovechando el mismo ejercicio, vale la pena mirar el resto de los cambios de plataforma que HubSpot tiene anunciados, porque este no es el único con fecha en los próximos meses y conviene agruparlos en una sola ventana de trabajo en vez de reaccionar de a uno.