Thinkindot® CMS puede publicar tus notas automáticamente en X (antes Twitter) en el momento en que las publicás en el sitio. Para que esta integración funcione, cada portal necesita contar con su propia App de X configurada en el X Developer Portal.
Esta guía cubre los pasos para crear esa App, obtener las credenciales necesarias y configurar la URL de retorno (callback) que Thinkindot® CMS utiliza para conectarse.
Tiempo estimado: 15 minutos (más el tiempo de aprobación de la cuenta de desarrollador, si es la primera vez).
Requisitos previos
Tener acceso a la cuenta de X institucional del portal (se recomienda no usar una cuenta personal).
Tener permisos para gestionar la configuración técnica del portal en Thinkindot® CMS.
Contar con un gestor de contraseñas para guardar las credenciales que se generan durante el proceso.
Paso 1: Crear una cuenta de desarrollador en X
Si el portal ya tiene una cuenta de desarrollador aprobada, puedes pasar directamente al Paso 2.
Ingresa a developer.x.com con la cuenta de X del portal.
Inicia el proceso de registro como desarrollador, haz click en Start Building.
Completa el formulario de Create Project. En el campo de caso de uso, selecciona la opción que se acerque a tu necesidad.
Envía la solicitud y espera la aprobación de X. Este proceso puede tomar algunas horas.
Nota: La aprobación puede demorar. Si es urgente, verifica el correo con el que registraste la cuenta. X suele pedir información adicional por esa vía.
Paso 2: Crear la App en el Developer Console
Ingresa a console.x.com con la cuenta de X del portal.
Opción Apps en el menú lateral izquierdo. Haz clic en Create App.
Completa los campos solicitados:
App name: usa un nombre que identifique el portal y el entorno, por ejemplo
nombre-del-portal-cms-prod.Description y use case: describe brevemente el uso (publicación automática de artículos).
Confirma la creación.
Paso 3: Guardar la API Key y el API Secret
Al confirmar la creación de la App, X muestra la API Key, el API Secret y un Bearer Token.
Copia los tres valores en el momento en que aparecen en pantalla.
Guárdalos en el gestor de contraseñas del equipo o en un lugar seguro.
Importante: X solo muestra estas credenciales una vez. Si cierras la pantalla sin guardarlas, deberás regenerarlas. Si ya creaste la App previamente y necesitas recuperar o rotar las keys, ve a Developer Console > Apps > [tu App] > Keys and tokens.
Paso 4: Activar la autenticación de usuario y configurar el Callback URL
Este es el paso que habilita la conexión entre X y Thinkindot® CMS.
Haz click dentro de la App recién creada para desplegar la configuración.
Ubica la sección User authentication settings y haz clic en Set up.
En App permissions, selecciona Read and write. Esta opción es la que permite que la App publique contenido en X.
En Type of App, selecciona Web App. Es una app server-side que puede guardar el secret de forma segura, como tu backend de Thinkindot.
En la sección App info, completa los campos de URLs:
Callback URI / Redirect URL:
https://twitter.thinkindot.com/login. Ingresa esa URL exacta, sin sin variaciones de protocolo, barras ni mayúsculas.Website URL: la URL pública del portal.
(Opcional pero recomendado) ingresa las URLs de Terms of service y Privacy policy.
Haz clic en Save.
Resultado esperado
La App queda configurada con autenticación de usuario activa. Las credenciales (API Key y API Secret) están listas para ser ingresadas en Thinkindot® CMS.
💡 ¿Qué es el Callback URL?
Es la dirección a la que X devuelve al usuario después de autorizar la App. Debe coincidir exactamente con el valor registrado en el portal de X, incluyendo mayúsculas, barras y protocolo. El valor correcto para todos los portales de Thinkindot® CMS es https://twitter.thinkindot.com/login.
Paso 4.1: Agregar créditos en la sección de facturación
Antes de conectar la App con Thinkindot® CMS, es necesario cargar créditos en la sección de facturación del Developer Portal. Sin créditos disponibles, X no procesa las llamadas a la API y la publicación automática no funcionará.
Dentro del Developer Portal, ve a la sección Billing.
Agrega un método de pago y carga el monto de créditos que necesites.
Confirma la carga.
Los créditos quedan disponibles en la cuenta y ya se pueden realizar llamadas a la API de X.
Paso 5: Ingresar las credenciales en Thinkindot® CMS
Una vez que tienes la API Key y el API Secret, el último paso es cargarlos en la configuración del portal.
Ingresa al backend de Thinkindot® CMS con tu usuario administrador.
En la barra de navegación superior, haz clic en el ícono de menú ≡.
Selecciona Integraciones.
En el listado de integraciones, haz clic en Twitter.com.
Asegúrate de estar en la solapa Exportación, son las credenciales para que el CMS publique contenido hacia X.
Ingresa la API KEY y el API SECRET en los campos correspondientes.
Resultado esperado
La integración queda activa. Las notas que se publiquen en el sitio se distribuirán automáticamente a X según la configuración del portal.
Nota: El flujo de integración con X en Thinkindot® CMS no cambia. Al hacer clic en Sign in with Twitter dentro de la solapa Exportación, el sistema completa automáticamente los cuatro campos (API KEY, API SECRET, TOKEN y TOKEN SECRET).
La diferencia a partir de ahora es que al haber creado y configurado tu propia app de X, tienes que modificar los valores de API Key y API Secret por los tuyos.
Si aún no integraste tu portal con X, consulta el artículo Integrar Twitter para ver el flujo completo paso a paso.
Errores frecuentes
Síntoma | Causa probable | Solución |
| La URL enviada no coincide exactamente con la registrada en X. | Verifica que el Callback URL en el Developer Portal sea |
Error | Secret copiado de forma incorrecta, o las credenciales fueron regeneradas. | Revisa que las credenciales en el CMS coincidan exactamente con las del Developer Portal. Si regeneraste las keys, actualiza también los valores en el CMS. |
La nota se publica en el sitio pero no llega a X | La integración no está activa o las credenciales no están guardadas. | Verifica que hiciste clic en Guardar después de ingresar las credenciales en el CMS. |
App suspendida | Aviso de X por incumplimiento de políticas. | Revisa el correo asociado a la cuenta de desarrollador. X suele detallar el motivo y ofrecer un canal de apelación. |
Buenas prácticas
Permisos mínimos necesarios: la opción Read and write es suficiente para publicar. No actives permisos adicionales (como acceso a mensajes directos) si no los vas a usar.
Cuenta institucional: registra la cuenta de desarrollador con el correo del portal, no con una cuenta personal. Esto garantiza que el acceso no quede atado a una persona.
Rotación de credenciales: si hay una sospecha de filtración o acceso no autorizado, regenera la API Key y el API Secret desde Developer Console > Apps > [tu App] > Keys and tokens, y actualiza los valores en el CMS.