Credenciales de la API de X (Twitter)
Guía para obtener tokens, claves y conexiones
Conectar al API de X requiere que realices una serie de pasos para obtener las claves necesarias. A continuación te muestro cómo obtenerlas paso a paso.
Crear o abrir tu proyecto
-
1
Accede a https://console.x.com con tu usuario de X.
-
2
Si es la primera vez, X te muestra 'Construye con la X API': pulsa 'Comenzar a Construir'. En la ventana 'Crear proyecto' deja el nombre 'Default Project', escribe una descripción corta (por ejemplo 'Botize automation'), en 'Caso de uso' elige 'Making a bot' y pulsa 'Crear'.
-
3
Si ya tenías cuenta de desarrollador, haz clic en 'Proyectos' en el menú de la izquierda y comprueba que tienes un proyecto con el plan 'Pay Per Use' (normalmente 'Default Project'). No pulses 'Crear proyecto' junto a 'Ads': es 'Solo acceso MCP' y Botize no puede usarlo. Si ya lo creaste, no pasa nada: tu app tiene que estar en 'Default Project (Pay Per Use)'.
Crear tu app
-
1
Haz clic en 'Apps' en el menú de la izquierda y después en 'Crear App'. Escribe un nombre único (por ejemplo 'botize123'), deja marcado 'Default Project (Pay Per Use)' con 'Development' y pulsa 'Crear'.
-
2
X te muestra un 'Consumer Key', un 'Secret Key' y un 'Bearer Token' una sola vez. Copia el 'Consumer Key' (en Botize es el 'API Key') y el 'Secret Key' (el 'API Secret Key') y guárdalos en un lugar seguro. El 'Bearer Token' no lo necesitas. Pulsa 'Cerrar'.
-
3
En la lista de 'Apps', haz clic en el nombre de la app que acabas de crear para abrirla. Arriba, en 'Acceso a proyectos', debe aparecer 'Default Project (Pay Per Use)'. Si solo ves un proyecto 'Ads', esa app no sirve: crea otra con 'Crear App' dejando marcado 'Default Project (Pay Per Use)'.
Configurar acceso de lectura y escritura
Vamos a configurar tu acceso al API para poder tanto leer como escribir publicaciones y mensajes directos. Ten en cuenta que el API de X no es gratuita, funciona con créditos y deberás pagar a X de acuerdo al uso que hagas del API.
-
1
En tu app, dentro de 'Claves de OAuth 2.0', pulsa 'Configurar' junto a 'Configuración de autenticación de usuario' (en inglés: 'Set up' junto a 'User authentication settings'). Si ya estaba configurada, usa el botón 'Configuración' de arriba a la derecha.
-
2
En 'Permisos de la app' selecciona 'Leer, escribir y enviar mensajes directos' ('Read and write and Direct message').
-
3
En 'Tipo de App' selecciona 'Aplicación Web, Aplicación Automatizada o Bot' ('Web App, Automated App or Bot').
-
4
En 'URI de devolución de llamada / URL de redirección' escribe: https://botize.com/callback/twitter
-
5
En 'URL del sitio web' escribe: https://botize.com
-
6
Pulsa 'Guardar Cambios'. X te muestra un 'ID de Cliente' y un 'Client Secret' (OAuth 2.0): Botize no los usa. Pulsa 'Cerrar'.
Obtener el 'API Key' y el 'API Key Secret' (solo si no los guardaste)
-
1
Haz este bloque solo si no guardaste el 'Consumer Key' y el 'Secret Key' al crear la app. Abre tu app: se abre en la pestaña 'Keys & Tokens'. Si estás en otra pestaña, como 'Chat bots', vuelve a 'Keys & Tokens': Botize no usa bots.
-
2
En el apartado 'Claves OAuth 1.0' ('OAuth 1.0 Keys'), pulsa el botón 'Regenerar' que hay junto a 'Consumer Key'.
-
3
X te muestra tu 'API Key' y tu 'API Key Secret'. Guárdalos en un lugar seguro.
Obtener el 'Access Token' y el 'Access Token Secret'
-
1
En la pestaña 'Keys & Tokens' de tu app, apartado 'Claves OAuth 1.0', pulsa 'Generar' junto a 'Access Token'. No uses la pestaña 'Chat bots' ni sus botones 'Register chat keys' o 'Rotar token': Botize no usa bots. Debe poner 'Leer, escribir y enviar mensajes directos'; si pone 'Leer', vuelve al bloque de permisos y guarda. Cuidado: en 'Claves de OAuth 2.0' hay otra fila de token ('Token de acceso'; en inglés también se llama 'Access Token') con un botón 'Generar' negro. No uses esa, ni el 'ID de Cliente', el 'Client Secret' o el 'Bearer Token': Botize no los usa.
-
2
X te pregunta 'Regenerar Token de Acceso y Secreto' aunque sea la primera vez: pulsa 'Sí, regenerar'. Después te muestra tu 'Access Token' y tu 'Secreto del Token de Acceso' una sola vez. Guárdalos en un lugar seguro y pulsa 'Cerrar'.
-
3
Pega los cuatro valores en Botize: 'API Key', 'API Secret Key', 'Access token' y 'Access token secret', y pulsa 'Autorizar'.