Freelo API umožňuje propojit Freelo s dalšími nástroji, které používáte – automaticky, bez ručního přenášení dat. Díky API rozhraní (Application Programming Interface) může váš vývojář nebo oblíbený no-code nástroj komunikovat s Freelem a přenášet data oběma směry.
K čemu se hodí Freelo API
Díky API můžete propojit jakýkoli systém, který API má, s Freelem. Nejčastěji jde o interní systémy, účetní programy, CRM apod. Propojení běží automaticky a můžete:
- 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 unikátní API klíč najdete v nastavení. Klikněte na svůj avatar v pravém horním rohu a vyber Nastavení. Úplně dole na stránce je sekce API klíč, který budete k propojení potřebovat. Zkopírujte ho a použijte podle nápovědy k dané službě.
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í. Napojit to lze na libovolný nástroj: přímo do jiného nástroje, přes 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 – přes API termín projektu nastavit momentálně nelze. Lze nastavovat pouze termíny úkolů a podúkolů.
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, poklady 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.