Webhooks en Zapier

Bij bepaalde gebeurtenissen binnen Gripp (bijvoorbeeld als een offerte wordt geaccepteerd), kan Gripp via een zelf in te stellen webhook een seintje geven aan een extern softwarepakket. Zo is verregaande automatisering mogelijk.

Webhooks zijn in principe universeel, maar kunnen ook specifiek gebruikt worden voor het maken van een Zapier-koppeling. Met een kleine groep testgebruikers zijn we deze mogelijkheid op dit moment aan het testen. Meer informatie en voorbeeldcases zullen daarna gepubliceerd worden.

Beschikbare gebeurtenissen

Gripp kan op dit moment een call naar de ingestelde webhook uitvoeren bij het optreden van de volgende gebeurtenissen:

Gebeurtenis
Bedrijf - aangemaakt
Betaling - aangemaakt
Contactpersoon - aangemaakt
Factuur - aangemaakt
Factuur - verzonden
Inkoopfactuur - aangemaakt
Inkoopopdracht - aangemaakt
Inkoopbetaling - aangemaakt
Medewerker - aangemaakt
Offerte - aangemaakt
Offerte - afgewezen
Offerte - geaccepteerd
Opdracht - aangemaakt
Taak - aangemaakt
Taak - afgerond
Uur - aangemaakt

Het instellen van een webhook

Ga naar de instellingen, bewerk de pagina, en klik op het tabblad 'Webhooks'. Je ziet de triggers die gebruikt kunnen worden, en een URL waar een POST op moet worden gedaan. De POST-body bevat zoveel mogelijk nuttige informatie. Bij het accepteren van een offerte geven we bijvoorbeeld alle gegevens mee van die offerte. De opbouw en informatie is gelijk aan die van een losse API getone-call. Na het toevoegen kun je de 'test' link gebruiken om je link te testen. De ontvangende kant kan in de log's zien of de call succesvol is uitgevoerd.
Afbeelding

Het opzetten van een Zapier Zap

De mogelijkheid om te koppelen met Zapier bevindt zich momenteel in een testperiode en is gebaseerd op een invite-only mechanisme. Nadat de Zapier-koppeling publiekelijk beschikbaar is, zullen hier instructies voor het correct opzetten van een Zap verschijnen.

Voorbeelden met de API

De applicatie van Gripp bevat vele functionaliteiten, maar soms is het voor specifieke gevallen handig om gebruik te maken van webhooks om je eigen wensen in het systeem te verwerken. Zo zijn er al enkele voorbeeldscripts geschreven met de volgende functionaliteiten:
  • Geschreven uren automatisch fiatteren.
  • Projectleider automatisch markeren met ster in een nieuw project.
  • De omschrijving automatisch verwijderen van nieuwe facturen.
De voorbeeld scripts zijn hier te bekijken.