Saltar a la navegación

Trello

Convierte las solicitudes de quienes llaman en tarjetas de Trello con una herramienta de webhook.

Tu recepcionista puede añadir una tarjeta a una lista de Trello cuando quien llama pide que le devuelvan la llamada, un presupuesto o cualquier otra cosa de la que tu equipo deba hacer seguimiento. Una herramienta de webhook crea la tarjeta mediante la API REST de Trello.

Antes de empezar

1

Obtén una clave de API

Ve al portal de administración de Power-Up, crea un Power-Up para tu espacio de trabajo (el nombre no importa), abre su pestaña Trello Auth y selecciona Generate a new API key.

2

Genera un token

Selecciona el enlace Token junto a tu clave de API o abre esta URL en un navegador con tu clave de API en lugar de API_KEY:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Selecciona Allow y copia el token. Puede leer y modificar todos los tableros a los que tengas acceso, así que valora generarlo desde una cuenta que solo sea miembro del tablero que necesitas.

3

Busca el ID de la lista

Abre el tablero en tu navegador, añade .json al final de su URL y carga la página. Busca el nombre de la lista; el valor de id que aparece junto a él es el ID de la lista.

Crea la herramienta de webhook

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

CampoValor
Nombrecreate_trello_card
Descripción”Crea una tarjeta para el equipo siempre que prometas a quien llama realizar un seguimiento o que quien llama pida algo que el equipo deba gestionar.”
MétodoPOST
URLhttps://api.trello.com/1/cards?idList=LIST_ID
Encabezados de solicitudAuthorization: OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"
Parámetros del cuerponame (string, obligatorio): “Título breve con el nombre de quien llama y lo que necesita; por ejemplo: Llamar de nuevo a Jane Doe sobre un presupuesto.”
desc (string, obligatorio): “El nombre, número de teléfono y detalles de la solicitud de quien llama.”
Asignar a agentesRecepcionista

Introduce ?idList=LIST_ID directamente en el campo URL, con el ID de tu lista. No añadas idList como parámetro de consulta: la IA rellena los parámetros de consulta, mientras que el texto de la URL se envía exactamente como está escrito.

Trello también acepta la clave y el token en la URL, como &key=API_KEY&token=TOKEN. También funciona, pero el encabezado evita que aparezcan en la URL. Si los incluyes en la URL, trata toda la URL como un secreto.

Selecciona Enable y, después, prueba tu recepcionista pidiendo que te devuelvan la llamada. La tarjeta aparecerá al final de la lista.

Solución de problemas

ProblemaQué comprobar
Trello devuelve 401Comprueba el encabezado: la clave y el token deben estar entre comillas dobles, separados por una coma y un espacio. Vuelve a generar el token si se ha revocado.
invalid value for idListEl ID de la lista en la URL es incorrecto. Usa el id de la lista, no el del tablero.
Trello devuelve 404 o no hay accesoEl usuario del token debe ser miembro del tablero.
La recepcionista nunca crea tarjetasHaz que la descripción de la herramienta indique las situaciones en las que debe crear una.