Existe un tipo de error que irrita más que los demás: cuando todo parece estar configurado correctamente, no aparece ningún error y, aun así, no se obtiene ningún resultado. Así se manifiesta uno de los problemas más frecuentes al publicar en VK: el texto de la publicación se envía sin inconvenientes, pero la foto o el vídeo simplemente no aparecen, sin un mensaje claro que explique el motivo. No es un «error de acceso» ni un «límite excedido»: solo silencio y una publicación sin contenido multimedia allí donde debería haber una imagen o un vídeo.
Nosotros mismos tropezamos con este problema relacionado con el token de VK cuando probábamos la publicación de contenido multimedia en una fase temprana, y dedicamos bastante tiempo a averiguar por qué todo estaba configurado «tal como indica la documentación», pero el vídeo no se publicaba. Resultó que la causa era precisamente el tipo de token. Este error está tan extendido entre los principiantes que merece la pena analizarlo por separado y en detalle.
Dos tokens diferentes que parecen intercambiables
En la API de VK existe una diferencia fundamental entre el token de comunidad (community token) y el token de usuario del administrador de la comunidad (user token, obtenido mediante una autorización completa en VKontakte). Para publicaciones exclusivamente de texto a través de la API de la comunidad, normalmente basta con el token de comunidad. Por eso el problema no se manifiesta de inmediato: las primeras publicaciones de prueba con texto se publican sin problemas, creando la falsa sensación de que todo está configurado correctamente.
El problema aparece en cuanto se añade contenido multimedia a la publicación, ya sea una foto o un vídeo. La carga de archivos multimedia en VK está estructurada como un proceso de varios pasos: primero hay que obtener un servidor de carga, después subir el archivo y, por último, confirmar la carga mediante la API. En determinados pasos de esta cadena, VK exige específicamente un token OAuth de usuario del administrador de la comunidad con los permisos correspondientes, y no el token de la propia comunidad. Técnicamente, el token de comunidad no sirve para esta parte del proceso, independientemente de los permisos que se le hayan concedido formalmente en la configuración.
Por qué no muestra un error claro
Lo más desagradable de este problema es la forma en que se manifiesta en la práctica. En algunos casos, la API de VK no devuelve un error de acceso inequívoco al intentar utilizar un token inadecuado para cargar contenido multimedia: la parte textual de la publicación puede completarse correctamente, mientras que la vinculación del contenido multimedia falla silenciosamente o se procesa con limitaciones que el sistema de integración puede ni siquiera detectar directamente. Como resultado, el usuario ve una publicación publicada sin imagen y no entiende qué ocurre: la configuración parece correcta, no hay errores en los registros y, aun así, la funcionalidad no funciona.
Este es precisamente uno de esos casos en los que la «ausencia de errores» resulta más engañosa que un rechazo explícito: si el sistema indicara de inmediato «tipo de token incorrecto para cargar contenido multimedia», el problema se resolvería en un minuto. En cambio, hay que reconstruir la causa a partir de indicios indirectos.
Cómo obtener el token correcto
Para que la publicación de contenido multimedia en VK funcione de forma estable, se necesita un token de usuario obtenido mediante OAuth 2.1 con PKCE (Proof Key for Code Exchange, una extensión del protocolo de autorización que aumenta la seguridad del intercambio de tokens) en nombre de una persona que tenga permisos de administrador en la comunidad correspondiente. En la práctica, esto significa autorizarse en VKontakte como un usuario real, confirmar el conjunto necesario de permisos de acceso y asegurarse de que esa persona forma parte de la administración de la comunidad desde la que se realizarán las publicaciones.
Para configurar correctamente la aplicación, se necesitan los parámetros VK_CLIENT_ID y VK_REDIRECT_URI: el identificador de la aplicación de VK y la dirección a la que VK redirigirá al usuario después de una autorización exitosa. Sin un redirect URI configurado correctamente, la autorización no se completará y el token ni siquiera se obtendrá. Este es otro paso en el que conviene comprobar cuidadosamente que lo indicado en la configuración de la aplicación de VK coincide con lo configurado realmente en la integración.
Lista de comprobación antes de publicar contenido multimedia
Si la publicación de texto en VK funciona, pero el contenido multimedia no aparece, conviene revisar los siguientes puntos en orden:
Tipo de token. Asegurarse de que se utiliza precisamente el token de usuario del administrador de la comunidad y no el token de la propia comunidad: esta es, con mayor frecuencia, la causa del problema.
Permisos de autorización. Comprobar que durante la autorización se solicitó y confirmó un conjunto de permisos suficiente para cargar fotos y vídeos, y no únicamente para publicar textos.
Estado administrativo. Asegurarse de que el usuario cuyo token se utiliza sigue siendo administrador de la comunidad correspondiente en el momento de la publicación y no ha perdido ese estado tras un cambio en la composición de la administración.
Validez del token. Comprobar que el token no ha caducado. Los tokens de usuario de VK tienen su propio periodo de validez, independiente del del token de comunidad, y deben renovarse periódicamente mediante el mismo mecanismo OAuth.
Por qué conviene configurarlo una vez y olvidarse del problema
Toda la complejidad de esta configuración se concentra en una única acción inicial: completar correctamente la autorización con los permisos necesarios para el usuario administrador adecuado. Después, la publicación de fotos y vídeos en VK funciona con la misma transparencia que la publicación de texto, sin necesidad de repetir la autorización para cada publicación. Por eso conviene dedicar tiempo a este paso con antelación, en lugar de enfrentarse a fallos silenciosos en la publicación de contenido multimedia cuando el canal de VK ya se haya convertido en una fuente activa de tráfico y el coste de un error en una publicación concreta sea mucho mayor.