Freelo je online aplikace na řízení projektů. Pomáhá týmům organizovat a dokončovat práci s menším úsilím
StrojovnaAkademie

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

Newsletter odebírá 1000+ šéfů, kterým pomáhá zefektivňovat tým

Profilový obrázek
Karel 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.

Líbil se vám článek?

Nezmeškejte ten další!