Notas de la documentación - agosto 2025
En agosto publicamos una serie de mejoras en la documentación para que sea más fiable al construir integraciones y más fácil de usar en el día a día. A continuación resumimos los cambios más relevantes y cómo pueden ayudar a equipos de desarrollo, arquitectos de soluciones y responsables de producto.
General
Refinamos las guías de notificaciones push para iOS y Android explicando cómo evitar que el emisor reciba su propio push mediante excluded_devices en APNS y pn_exceptions en FCM. Además aclaramos que el registro de push en móvil va por canal individual y añadimos una nota de solución de problemas para respuestas HTTP 400 con causas comunes.
SDKs
Completamos la documentación de subscribe y presencia: invocar subscribe abre la conexión pero es necesario registrar listeners de eventos para recibir mensajes. En suscripciones con wildcard los objetos de mensaje incluyen publisher con el emisor, channel con el canal real y subscription con la coincidencia wildcard. También explicitamos que las wildcards no están soportadas para channel groups en la documentación de Presence; use nombres de grupo exactos.
Reorganizamos la sección de encriptación para convertirla en una página de referencia de primer orden en cada SDK. Ahora es más sencillo configurar el módulo criptográfico, elegir entre AES-CBC 128 legado y 256 recomendado, ver ejemplos de encrypt y decrypt incluyendo cifrado parcial cuando aplica, y detectar clientes antiguos con avisos de compatibilidad.
En los SDK de Chat para Kotlin y JavaScript añadimos guías de gestión de conexión con un listener de estado (ONLINE OFFLINE ERROR) y métodos para desconectar y reconectar suscripciones, incluidas muestras de código y flujos recomendados para restaurar conectividad.
El SDK Dart incluye documentación actualizada sobre logging y políticas de reintento de subscribe. Ahora es posible habilitar logs estructurados, ajustar la verbosidad en tiempo de ejecución y configurar la política de reintentos del módulo de red, que por defecto es exponencial.
Para PHP y Unreal aceleramos el uso de ejemplos extraídos directamente de los repositorios en GitHub, de forma que los snippets siempre estén actualizados y alineados con el código fuente del SDK.
Events y Actions
Actualizamos la API de Events y Actions con un modelo de paginación estándar page y size más metadatos de paging, añadimos un catálogo de tipos de mensaje accesible vía GET /v2/messages/message-types con filtros, y simplificamos la entrada de rutas usando messageTypeName y version en lugar de messageTypeId. También incorporamos parámetros opcionales como subkey y account_id donde aplica y revisamos ejemplos y formato.
BizOps y Auto Moderation
Channel Monitor ahora incluye una sección de Auto Moderated Messages para revisar contenido que fue bloqueado automáticamente por spam, publicado con palabras enmascaradas o reportado para revisión. Puede filtrarse por tipo y marcar items como Not spam para retroalimentar el sistema.
Además presentamos dos rutas para Auto Moderation: una gestionada por BizOps que permite provisionar una Function de Before Publish o Fire sin código para aplicar detección de spam y enmascarado de palabras, y una ruta self managed que genera código para integrar la configuración de Auto Moderation dentro de su Function existente cuando ya hay una Function por canal.
Illuminate
Si incrusta la interfaz Illuminate en un sitio externo ahora puede tematizarla mediante parámetros hex en la URL de embed, lo que facilita alinear la UI con la identidad de marca usando parámetros como primaryColor secondaryColor backgroundColor surfaceColor textPrimaryColor y textSecondaryColor.
Markdown para máquinas
Publicamos una versión machine friendly en Markdown de cada página de la documentación bajo la misma URL con sufijo .md. Dos botones en cada página permiten copiar el Markdown o abrir la versión .md para facilitar búsquedas, automatizaciones e integraciones con IA y modelos de lenguaje. Este formato reduce ruido, mantiene anclas estables y mejora la ingestión automatizada y los diffs deterministas.
Sobre Q2BSTUDIO
En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, con experiencia en inteligencia artificial, ciberseguridad y servicios cloud para AWS y Azure. Diseñamos soluciones de inteligencia de negocio y Power BI para convertir datos en decisiones accionables, y desarrollamos agentes IA y soluciones de ia para empresas que impulsan la automatización y la eficiencia operativa.
Si busca desarrollar productos a medida o modernizar arquitecturas existentes puede conocer nuestros servicios de desarrollo en Desarrollo de aplicaciones y software a medida y explorar nuestras capacidades de inteligencia artificial en servicios de inteligencia artificial para empresas. También ofrecemos consultoría en ciberseguridad y pentesting, servicios cloud aws y azure, automatización de procesos, y soluciones de business intelligence con Power BI para mejorar la toma de decisiones.
Palabras clave relevantes incluidas en esta nota: aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA power bi.
Contacto y siguientes pasos
Si desea que adaptemos estas prácticas a su equipo o integraciones, nuestro equipo en Q2BSTUDIO puede ayudar a implementar las mejores prácticas de encriptación, gestión de conexiones, moderación de contenido y automatización para su plataforma. Contáctenos para evaluar su caso y planificar una hoja de ruta técnica acorde a sus objetivos.
