Freelo umí Webhooky, aneb zahákněte vaši aplikaci jako kapitán Hook

Právě jsme v rámci API spustili webhooky. Ty se hodí, když chcete, aby Freelo posílalo oznámení do vaší aplikace, hned jak se ve Freelu něco stane. Dříve to vyžadovalo dotazování našeho API v pravidelných intervalech. A to nebylo vůbec pohodlné.

S nově spuštěnými webhooky můžete místo toho nechat Freelo zavolat váš program, když u nás dojde ke změně. Například můžete chtít zapisovat do vašeho firemního reportu všechny nově vzniklé úkoly. Nebo vykázaný čas na nich. Freelo vždy pošle notifikaci a potřebná data na vámi zadané URL a to bez časové prodlevy.

V čem je to jiné než napojení přes API?

Ukázka napojení Freela s vaší aplikací pomocí API.
Ukázka napojení Freela s vaší aplikací pomocí Webhooků.

Jak nastavit nový webhook

Webhook naklikáte pomocí webového rozhraní přímo v nastavení. Stačí kliknout na Přidat Webhook. Dále zvolíte jaké typy informací nad jakými projekty vás zajímají a doplníte URL adresu, kam to máme z Freela posílat.

Vytvoření nového webhooku ve Freelu.

Po přidání webhooku se zobrazí na seznamu

Ukázka vytvořeného webhooku ve Freelu.

Otestujte si, jestli vše funguje

Pro otestování funkčnosti webhooků doporučujeme službu Webhook.site. Ta vám vygeneruje unikátní URL adresu, která zaznamenává všechny požadavky, která na ni přijdou a následně vám je přehledně zobrazí.

Ukázka otestování funkčnosti webhooku přes externí službu Webhook.site

Následně když uděláte tu požadovanou akci, tak už se o všem dozvíte. Takto třeba při založení úkolu.

Ukázka dat ve Freelu, které následně získáte i ve vašem webhooku ihned po odeslání formuláře.

A takto vidíte vše přehledně v nástroji Webhook.site. K vidění jsou všechny zaslaná data ve formátu JSON.

Ukázka získaných dat při odeslání formuláře z předchozího obrázku.

Připravili jsme pro vás ukázkový PHP skript na zpracování Webhooku, který najdete u nás na Githubu. Tento skript dělá to, že odešle upozorňovací e-mail, když někdo smaže úkol v projektu.

Pozor na přesměrování. Pokud třeba vaše stránka přesměrovává HTTP na HTTPS nebo subdoména www bez www, tak může webhook zkončit jen přesměrování namísto reálného vykonání akce.

Ukázka stavů, které již webhookem prošli.

Na co se Webhooky hodí?

Možností je opravdu hodně, ale pro inspiraci se podívejte na pár příkladů:

  1. Zapiš vzniklý výkaz práce do druhého, třeba docházkového, systému. Nebo třeba do Google Spredsheetu.
  2. Pošli upozornění pokud někdo smaže úkol v projektu. Nebo třeba jen když je to externista.
  3. Posílej upozornění na hotové úkoly do Slacku.
  • Líbilo? Pošli vzkaz v lahvi ostatním
Kategorie: Vše

Buď s námi v kontaktu. Posíláme přibližně jednou měsíčně souhrn nových článků. Nemusíš se bát, žádný spam neposíláme a můžeš se kdykoliv odhlásit.

Profilový obrázekKarel DytrychJsem zakladatel Freelo.cz a Váš Hosting. Snažím se zjednodušovat podnikání druhým. Jinak milovník sportu a zdravého životního stylu.

Odcházíš?

A co kdybychom zůstali v kontaktu? Posíláme jen občas souhrn nových článků. Žádný spam. Slibujeme

Na tvou další návštěvu se těší
Karel, Honza a Karel

Mrkni na další články autorů

Udělej si pohodlí a pokračuj ve čtení

Přidejte se k týmům jako Nikon, OEZ, Fotoškoda a komunikujte také lépe nad úkoly.

Vyzkoušet Freelo