Conecta tu tablero de Trello para tu página de comisiones
Si llevas tus comisiones en un tablero público de Trello, tu tienda puede mostrar ese mismo tablero como una página — reglas, tipos de comisión con su arte de ejemplo, quién va en la fila. Para eso hace falta una llave de acceso a la API de Trello: es gratis, tuya, y se saca en un par de minutos.
Es tu llave personal, de tu propia cuenta de Trello. Nadie más la ve ni la comparte — se guarda como un ajuste privado de tu tienda, igual que la contraseña de tu pasarela de pago. Si alguna vez quieres revocarla, se hace desde tu cuenta de Trello y deja de funcionar al instante.
1. Genera tu API Key
Entra a trello.com/power-ups/admin con la cuenta de Trello donde está tu tablero de comisiones.
Trello pide un «Power-Up» antes de darte la llave — es solo el contenedor que exige su sistema, no tienes que publicarlo ni configurarlo. Si no tienes uno, pulsa Nueva aplicación. Te va a pedir varios campos; ninguno afecta a tu tablero, solo identifican la aplicación ante Trello:
| Campo | Qué poner |
|---|---|
| Nombre de la aplicación | El de tu tienda. Se puede cambiar después. |
| Espacio de trabajo | El que ya viene seleccionado —el de tu tablero. |
| Correo electrónico | El tuyo. |
| Contacto de asistencia | El mismo correo sirve. |
| Autor | Tu nombre o el de la tienda. |
| URL del conector de iframe | Déjalo vacío e intenta Crear. |
El conector de iframe es para Power-Ups que agregan una pantalla dentro de Trello mismo —no es nuestro caso, solo queremos la llave. El texto de ayuda dice que si das una URL debe ser https, pero no dice que el campo sea obligatorio. Si Trello te deja crear la aplicación sin llenarlo, listo. Si te lo marca en rojo y no avanza, para ahí y dínoslo: hace falta un valor distinto y no vale la pena inventar uno sin saber qué acepta.
Pulsa Crear. Dentro de tu aplicación, ve a la pestaña API Key y pulsa Generate a new API Key. Copia el valor que aparece —lo vas a necesitar en el paso 2, pégalo donde lo puedas volver a encontrar.
Junto al API Key vas a ver también un Secret. No es lo mismo ni hace falta para esto —el Secret es para otra forma de autenticación que no usamos aquí—, así que puedes guardarlo o ignorarlo.
En esa misma pestaña, busca «Allowed Origins» y agrega el
dominio de tu tienda —por ejemplo
https://tu-tienda.nocturne-stud.io, sin nada después del
dominio. Sin esto, Trello rechaza la conexión del paso 2 con «Invalid
return_url», aunque la API Key esté bien: es una lista aparte de qué
sitios puede autorizar tu aplicación, y por defecto está vacía —«ninguno»
no es lo mismo que «sin restricción».
2. Conecta tu tienda con esa llave
Con la API Key copiada, entra a tu tienda y ve a Ajustes. Baja hasta el bloque Comisiones (Trello) y pégala en el campo API Key de Trello.
Pulsa Guardar arriba de la página —hace falta antes del siguiente paso, o el botón no va a encontrar la llave que acabas de pegar— y después pulsa Conectar con Trello.
Eso te manda a una pantalla de Trello pidiendo permiso para leer tus tableros. Pulsa Allow (o «Permitir») y regresas solo a tu tienda, ya conectada. No hay ningún token que copiar ni pegar en ningún lado —Trello se lo entrega directo a tu tienda.
El permiso que se pide es solo de lectura: tu tienda puede ver tus tableros, nunca escribir ni cambiar nada en ellos. Puedes revocarlo cuando quieras desde tu cuenta de Trello, o pulsando Desconectar en el mismo bloque de Ajustes.
Antes de darlo por hecho
- En el bloque Comisiones (Trello) de Ajustes, el estado debe decir Conectado en vez de No conectado.
- Si al pulsar Conectar con Trello te dice que falta la API Key, casi siempre es que no guardaste la página antes de pulsarlo —vuelve a pegarla y guarda primero.
- Si Trello responde con «Invalid return_url», falta el paso de Allowed Origins del paso 1 —vuelve a la pestaña API Key en Trello y agrega el dominio de tu tienda ahí.