Integrácia je adresa (webhook URL), na ktorú môže iný systém poslať požiadavku. frego z nej v projekte založí úlohu. Hodí sa napríklad na hlásenia chýb z webu, formulár pre klienta alebo chyby zo Sentry.
Nová integrácia
- V projekte otvor v menu Integrácie.
- Klikni na Pridať integráciu a pomenuj ju.
- Vyber Typ: Generická alebo Sentry.
- Nastav, aké úlohy má zakladať: názov, prioritu, tag a stĺpec, do ktorého pôjdu.
- Skopíruj Webhook URL a vlož ju do druhého systému.
V jednom projekte môžeš mať integrácií viac, každú s vlastným nastavením a vlastnou adresou. Keď niektorú práve nepotrebuješ, vypneš ju prepínačom.
Generická integrácia
Druhý systém pošle na adresu POST s JSON telom. Povinné je len pole description. Voliteľne môže poslať aj title, priority (high, medium alebo low) a tag, ktoré prepíšu tvoje predvolené nastavenie. Pribaliť môže aj obrázok, ktorý sa k úlohe pridá ako príloha.
V poli description stačí obyčajný text. Môže v ňom byť aj jednoduché HTML: odseky, zoznamy, odkazy a obrázky. Všetko ostatné vrátane skriptov frego z popisu odstráni.
Sentry
Pri type Sentry ti frego priamo v integrácii ukáže postup, ako ju v Sentry napojiť. Z chyby doplní názov, popis a prioritu úlohy. Keď sa tá istá chyba objaví znova, novú úlohu nezaloží.
Kto sa to dozvie
Keď integrácia založí úlohu, všetci členovia projektu dostanú notifikáciu.
FREE alebo PRO
Integrácie nastavuje vlastník projektu a sú súčasť PRO. Keď PRO skončí, integrácie, ktoré už máš, zakladajú úlohy ďalej. Nové však nepridáš a existujúce neupravíš.
PozorAdresa integrácie funguje ako heslo. Ak sa dostane do nesprávnych rúk, klikni na Regenerovať token. Stará adresa prestane fungovať a novú musíš nastaviť v druhom systéme.