Aligno gebruiken

Zapier-koppeling

Koppel Aligno aan Zapier en de rest van je tools komt vanzelf in actie zodra een klant reageert of akkoord geeft — zonder code.

Wat het doet

Aligno staat openbaar vermeld in de app-directory van Zapier. Een Zap start vanuit een Aligno-trigger — een nieuwe opmerking, een beslissing over akkoord, een nieuwe versie — en stuurt die door naar een van de 9.000+ apps die Zapier koppelt: een bericht in een kanaal plaatsen, een taak aanmaken, een rij aan een spreadsheet toevoegen, een factuur versturen. Zaps kunnen ook terugschrijven naar Aligno: een project aanmaken, een webpagina als asset toevoegen of een deellink aanzetten.

Events komen direct in Zapier binnen. Aligno levert ze af via een betrouwbare wachtrij die het bij tijdelijke storingen opnieuw probeert, zodat een hapering nooit een akkoord kost.

Aligno koppelen aan Zapier

  1. Open in Aligno Dashboard → Integrations, zoek de Zapier-kaart en klik op Configure → Generate key.
  2. Kopieer de sleutel meteen. Hij wordt precies één keer getoond — Aligno bewaart alleen een hash, dus hij kan niet opnieuw worden weergegeven. Kwijt? Trek hem in en maak een nieuwe aan.
  3. Maak in Zapier een Zap aan en kies Aligno als trigger-app (of begin vanuit de vermelding in de directory).
  4. Vraagt Zapier je om je Aligno-account te koppelen, plak dan de API-sleutel. De koppeling krijgt het e-mailadres van je account als label.
  5. Kies een trigger, draai de teststap van Zapier (die haalt een paar recente, echte voorbeelden op), voeg je actie toe en zet de Zap aan.
Alleen voor de eigenaar, zoals alle koppelingen
API-sleutels worden aangemaakt en ingetrokken door de eigenaar van het account. Activiteit van teamleden (opmerkingen, akkoord op gedeeld werk) start nog steeds de Zaps van de eigenaar — zie samenwerken in je team.

Triggers

Elk van deze triggers kan een Zap starten:

New Comment
Een reviewer plaatst een nieuwe opmerking of reactie.
Approval Received
Een reviewer geeft akkoord op een asset of vraagt wijzigingen aan.
New Asset
Er wordt een nieuw asset aan een project toegevoegd.
New Asset Version
Er wordt een nieuwe versie van een bestaand asset geüpload.
Comment Resolved
Een opmerking wordt als opgelost gemarkeerd.
New Project
Er wordt een nieuw project aangemaakt.

De trigger Approval Received gaat alleen af bij echte beslissingen — akkoord of wijzigingen aangevraagd — en nooit op de openstaande status waarmee een nieuwe versie begint.

Acties

Create Project
Maakt een nieuw project aan.
Create Webpage Asset
Voegt een webpagina (via URL) toe als nieuw asset in een project, klaar voor review.
Share Asset
Zet de openbare reviewlink van een asset aan (of stelt hem opnieuw in) en geeft de deel-URL terug.

Zoekacties

Find Project
Zoekt een project op naam (gedeeltelijke overeenkomst).
Find Asset
Zoekt assets op naam, optioneel binnen één project.
Find Asset Details
Zoekt een asset op ID, inclusief de huidige versie en de laatste goedkeuringsstatus.
Find Comments on Asset
Zoekt opmerkingen bij een asset, optioneel gefilterd op status.

API-sleutels beheren

  • Sleutels staan op dezelfde Integrations-pagina. Bij elke sleutel zie je het label, het voorvoegsel, de aanmaakdatum en wanneer hij voor het laatst is gebruikt.
  • Elke sleutel is beperkt tot je eigen account — hij kan alleen je eigen projecten lezen of wijzigen.
  • Een sleutel intrekken verbreekt direct de Zaps die ermee zijn gemaakt. Hun abonnementen worden verwijderd, zodat er niets meer binnenkomt nadat je de sleutel hebt ingetrokken. Wil je overstappen op een nieuwe sleutel? Maak eerst de nieuwe aan, koppel je Zaps opnieuw en trek daarna de oude in.

Meer dan Zapier: de REST API

De Zapier-app is gebouwd op de openbare REST API van Aligno, en je sleutel werkt daar ook. De interactieve referentie vind je op /docs/api, de ruwe OpenAPI-specificatie op /api/v1/openapi.json.

Problemen oplossen

  • De verbindingstest mislukt. Controleer of de sleutel volledig is geplakt (hij begint met algn_live_) en niet is ingetrokken. Twijfel je, maak dan een nieuwe sleutel aan.
  • Een Zap gaat niet meer af. Controleer eerst of de sleutel nog op je Integrations-pagina staat — ingetrokken sleutels verbreken hun Zaps. Kijk daarna of de Zap nog aanstaat en bekijk de run-geschiedenis in Zapier.
  • Problemen met een Zap of workflow binnen Zapier (fouten in de editor, problemen met het koppelen van velden, runs die aan de kant van Zapier mislukken) meld je het best via de support van Zapier — zij kunnen de details van je Zap-runs inzien en bugs in de koppeling direct aan ons doorspelen.
Meer over automatisering
Het marketingoverzicht en de volledige API-referentie.