Usar Aligno

Integración con Zapier

Conecta Aligno con Zapier y el resto de tus herramientas reacciona por sí solo cuando un cliente comenta o da su aprobación, sin escribir código.

Qué hace

Aligno aparece públicamente en el directorio de apps de Zapier. Un Zap empieza con un disparador de Aligno (un comentario nuevo, una decisión de aprobación, una versión nueva) y lo envía a cualquiera de las más de 9000 apps que conecta Zapier: publicar en un canal, crear una tarea, añadir una fila a una hoja de cálculo, enviar una factura. Los Zaps también pueden escribir en Aligno: crear un proyecto, añadir una página web como elemento o activar un enlace para compartir.

Los eventos llegan a Zapier en cuanto ocurren. Aligno los entrega a través de una cola persistente que reintenta ante fallos temporales, así que un corte momentáneo no te hace perder una aprobación.

Conectar Aligno con Zapier

  1. En Aligno, abre Dashboard → Integrations, busca la tarjeta de Zapier y haz clic en Configure → Generate key.
  2. Copia la clave de inmediato. Solo se muestra una vez: Aligno guarda únicamente un hash, así que no se puede volver a mostrar. Si la pierdes, revócala y genera una nueva.
  3. En Zapier, crea un Zap y elige Aligno como app de disparo (o empieza desde la ficha del directorio).
  4. Cuando Zapier te pida conectar tu cuenta de Aligno, pega la clave de API. La conexión se etiqueta con el correo electrónico de tu cuenta.
  5. Elige un disparador, ejecuta el paso de prueba de Zapier (trae algunos ejemplos reales recientes), añade tu acción y activa el Zap.
Solo para el propietario, como todas las integraciones
Las claves de API las crea y revoca el propietario de la cuenta. La actividad de los miembros del equipo (comentarios, aprobaciones en trabajo compartido) sigue activando los Zaps del propietario. Consulta trabajo en equipo.

Disparadores

Cualquiera de estos puede iniciar un Zap:

New Comment
Un revisor deja un comentario o una respuesta nuevos.
Approval Received
Un revisor aprueba un elemento o solicita cambios.
New Asset
Se añade un elemento nuevo a un proyecto.
New Asset Version
Se sube una nueva versión de un elemento existente.
Comment Resolved
Un comentario se marca como resuelto.
New Project
Se crea un proyecto nuevo.

El disparador Approval Received solo se activa con decisiones reales (aprobado o cambios solicitados), nunca con el estado pendiente con el que empieza una versión nueva.

Acciones

Create Project
Crea un proyecto nuevo.
Create Webpage Asset
Añade una página web (por URL) como elemento nuevo de un proyecto para revisarla.
Share Asset
Activa (o reconfigura) el enlace público de revisión de un elemento y devuelve su URL para compartir.

Búsquedas

Find Project
Busca un proyecto por nombre (coincidencia parcial).
Find Asset
Busca elementos por nombre, opcionalmente dentro de un proyecto.
Find Asset Details
Busca un elemento por ID, con su versión actual y su último estado de aprobación.
Find Comments on Asset
Busca los comentarios de un elemento, opcionalmente filtrados por estado.

Gestionar las claves de API

  • Las claves están en la misma página Integrations. Cada una muestra su etiqueta, su prefijo, su fecha de creación y cuándo se usó por última vez.
  • Cada clave está limitada a tu propia cuenta: solo puede leer o modificar tus propios proyectos.
  • Revocar una clave desconecta al instante los Zaps creados con ella. Sus suscripciones se eliminan para que no se siga enviando nada después de cortarla. Para cambiar a una clave nueva, genera primero la nueva, vuelve a conectar tus Zaps y después revoca la antigua.

Más allá de Zapier: la API REST

La app de Zapier se basa en la API REST pública de Aligno, y tu clave también funciona ahí. La referencia interactiva está en /docs/api, y la especificación OpenAPI sin procesar, en /api/v1/openapi.json.

Solución de problemas

  • Falla la prueba de conexión. Comprueba que pegaste la clave completa (empieza por algn_live_) y que no se ha revocado. Si tienes dudas, genera una clave nueva.
  • Un Zap dejó de activarse. Primero comprueba que la clave sigue en tu página Integrations: las claves revocadas desconectan sus Zaps. Después comprueba que el Zap sigue activado y revisa su historial de ejecuciones en Zapier.
  • Los problemas de Zaps o flujos dentro de Zapier (errores del editor, problemas de mapeo, ejecuciones que fallan del lado de Zapier) conviene reportarlos al soporte de Zapier: allí pueden ver los detalles de las ejecuciones de tu Zap y enviarnos directamente los errores de la integración.
Más sobre automatización
La presentación general y la referencia completa de la API.