Integrace je adresa (webhook URL), na kterou může jiný systém poslat požadavek. frego z ní v projektu založí úkol. Hodí se například na hlášení chyb z webu, formulář pro klienta nebo chyby ze Sentry.
Nová integrace
- V projektu otevři v menu Integrace.
- Klikni na Přidat integraci a pojmenuj ji.
- Vyber Typ: Obecná nebo Sentry.
- Nastav, jaké úkoly má zakládat: název, prioritu, tag a sloupec, do kterého půjdou.
- Zkopíruj Webhook URL a vlož ji do druhého systému.
V jednom projektu můžeš mít integrací víc, každou s vlastním nastavením a vlastní adresou. Když některou právě nepotřebuješ, vypneš ji přepínačem.
Obecná integrace
Druhý systém pošle na adresu POST s JSON tělem. Povinné je jen pole description. Volitelně může poslat i title, priority (high, medium nebo low) a tag, které přepíšou tvoje výchozí nastavení. Přibalit může i obrázek, který se k úkolu přidá jako příloha.
V poli description stačí obyčejný text. Může v něm být i jednoduché HTML: odstavce, seznamy, odkazy a obrázky. Všechno ostatní včetně skriptů frego z popisu odstraní.
Sentry
U typu Sentry ti frego přímo v integraci ukáže postup, jak ji v Sentry napojit. Z chyby doplní název, popis a prioritu úkolu. Když se stejná chyba objeví znovu, nový úkol nezaloží.
Kdo se to dozví
Když integrace založí úkol, všichni členové projektu dostanou notifikaci.
FREE nebo PRO
Integrace nastavuje vlastník projektu a jsou součástí PRO. Když PRO skončí, integrace, které už máš, zakládají úkoly dál. Nové ale nepřidáš a existující neupravíš.
PozorAdresa integrace funguje jako heslo. Pokud se dostane do nesprávných rukou, klikni na Regenerovat token. Stará adresa přestane fungovat a novou musíš nastavit v druhém systému.