Freelo API umožňuje propojit Freelo s dalšími nástroji a automatizovat přenos dat. V článku najdete svůj API klíč, odkaz na dokumentaci i příklady využití pro vlastní integrace.
API je zkratka pro Application Programming Interface — rozhraní, přes které spolu aplikace mluví.
K čemu se hodí Freelo API
Díky API můžete Freelo propojit s interními systémy, účetními programy nebo CRM. Konkrétní možnosti závisí na dostupných operacích obou služeb a oprávněních účtu. Po nastavení propojení můžete například:
- Získávat informace o projektech, úkolech a jejich komentářích.
- Zakládat úkoly a podúkoly do Freela.
- Komentovat existující úkoly.
- Propojovat štítky a nastavovat priority.
- Vypisovat seznamy úkolů, To-Do listů nebo projektů.
- Hromadně stahovat soubory.
- Sledovat aktivity nad projekty.
Podívejte se na celou dokumentaci Freelo API s ukázkami.
Kde najdu API klíč
API klíč slouží k propojení Freela s ostatními službami, například Fakturoidem, iDokladem, Vyfakturuj, Raynetem nebo SupportBoxem.
Svůj API klíč najdete v nastavení. Klikněte na svůj avatar v pravém horním rohu a vyberte Nastavení. V dolní části stránky najdete sekci API klíč. Klíč zkopírujte ikonou dvou překrytých listů vpravo u pole a použijte podle nápovědy k dané službě. Pro zkopírování stávajícího klíče není potřeba použít tlačítko Přegenerovat API klíč.
V této sekci najdete také přímo odkaz na API dokumentaci. Stačí kliknout na slovo dokumentace.
Možnosti a limity API
Záleží na vás, jestli potřebujete jednorázovou migraci, nebo pravidelnou synchronizaci – API zvládne obojí. Propojení lze připravit vlastním skriptem, pomocí AI nebo přes integrace jako Make.com nebo n8n.
Kdy co použít:
- Přímé API – máte vývojáře nebo technické znalosti a chcete plnou kontrolu nad integrací. Ideální pro vlastní skripty, interní systémy nebo hromadné operace.
- Make.com nebo n8n – no-code/low-code nástroje pro spojování různých služeb bez programování. Hodí se, když chcete propojit Freelo s dalšími nástroji (CRM, formuláře, tabulky…) a nechcete psát kód. Make je vhodný pro začátečníky, n8n dává větší flexibilitu.
- Webhooky – Freelo pošle notifikaci do vašeho systému, jakmile nastane určitá událost (nový úkol, komentář, změna stavu…). Vhodné, když chcete reagovat na dění ve Freelu v reálném čase. Webhooky se nejčastěji kombinují s Make nebo n8n jako spouštěč automatizace.
Přehled konkrétních věcí, které přes API lze a co zatím ne:
- Vlastní pole – plně nastavitelná přes API: zakládání, nastavení na projektech i přiřazení k úkolům. Viz dokumentace Custom Fields.
- Formuláře + vlastní pole – formuláře ve Freelu vlastní pole přímo nepodporují. Lze to ale obejít automatizací: nastavte webhook na nové úkoly v To-Do listu, do kterého chodí úkoly z formuláře. Poté přes Make.com, n8n nebo vlastní skript nastavte vlastní pole přes API na základě obsahu formuláře.
- Termín projektu – lze nastavit při založení i úpravě projektu pomocí pole
due_date. Upravit projekt může jeho kapitán nebo správce projektu. Podrobnosti najdete v API dokumentaci u projektů.
Praktické využití
API ocení hlavně týmy, které chtějí Freelo napojit na své stávající procesy:
- Propojení s CRM nebo helpdesk systémem – nové požadavky z jiného nástroje se automaticky promítnou jako úkoly ve Freelu, bez přepisování.
- Automatický přenos výkazů – data z Freela putují přímo do účetního softwaru nebo reportovacího nástroje.
- Vlastní dashboardy a reporty – z dat Freela sestavíte přehled v BI nástroji přesně podle potřeby (gantt, týdenní report úkolů daného týmu, přehled projektu s milníky, finanční report, podklady k fakturaci klientovi).
- Hromadné operace – zakládáte velké množství úkolů nebo projektů najednou přes skript, ne ručně po jednom.
- Notifikace do jiných systémů – při změně stavu úkolu nebo projektu odešlete automatické upozornění do Slacku, e-mailu apod.