Raynet API: přístup, limity a automatizace s AI (2026)

Raynet API je cesta, kterou propojíš své CRM se zbytkem světa: s n8n, Make, AI asistentem i vlastními skripty. Když jsem si ho před nedávnem prošel krok za krokem — od vygenerování klíče po první reálný dotaz — nejvíc mě překvapilo, jak málo na to stačí: tři údaje, jeden curl a žádné programování u běžných automatizací. V tomhle průvodci najdeš, co Raynet API umí, v jakém tarifu ho dostaneš, jaké má limity a jak přes něj postavit první automatizaci, i když nejsi vývojář.

Nejde o referenční dokumentaci pro programátory — tu Raynet má vlastní a je dobrá. Jde o praktický pohled pro obchodníky a marketéry, kteří chtějí data z CRM dostat tam, kde je tým opravdu používá, a naopak nechat AI, aby do CRM zapisovala.

01Co Raynet API umí a kdy se hodí

Raynet API (verze 2) běží na adrese https://app.raynet.cz/api/v2/ a přes HTTP ti dává přístup prakticky ke všemu, co vidíš v aplikaci: klienti (firmy), kontaktní osoby, obchodní případy, aktivity i leady. Umí číst i zapisovat, takže se hodí na oba směry:

• Čtení pro reporty a notifikace — každé ráno si stáhni otevřené dealy do tabulky, posílej změny stavů do Slacku nebo nech AI shrnout poslední aktivity u největších klientů.
• Zápis z venkovních systémů — poptávka z webu se sama zaznamená jako lead, e-mail z Fakturoidu přilinkuje doklad k klientovi, AI asistent zakládá následující kroky po schůzce.
• Úklid a hromadné operace — hromadné přejmenování, doplnění údajů z rejstříků, exporty pro datovou analytiku.

Součástí API je i filtrování seznamů (operátory jako [GE], [EQ], [NE], [IN]), stránkování a fulltext, takže nemusíš stahovat celou databázi, když tě zajímá jen poslední týden. Kompletní seznam endpointů pokrývá oficiální dokumentace Raynet API, kde je vše popsané v češtině včetně ukázkových volání.

Pozor na API se vztahují stejné zásady jako na samotné CRM — data klientů protékají cizím systémem (třeba execution historií v Make), takže u citlivých firem zvaž, co automatizace opravdu potřebuje vidět.

02V jakém tarifu API dostaneš a kolik stojí

Tady je nejčastější kámen úrazu: API klíče nejsou ve všech tarifech. Podle oficiální nápovědy Raynetu platí:

• START (399 Kč při roční platbě, 449 Kč měsíčně) — API klíče nepodporuje, automatizaci přes API nepostavíš
• PROFESSIONAL (799 Kč při roční platbě, 949 Kč měsíčně) — až 8 API klíčů, nejnižší tarif s plnohodnotným API
• ULTIMATE (999 Kč při roční platbě, 1 199 Kč měsíčně) — až 24 API klíčů

Ceny jsou za uživatele měsíčně bez DPH, ověřeno 6. 10. 2026 na oficiálním ceníku. Proč existuje limit počtu klíčů? Každý klíč se váže na konkrétního uživatele a dědí jeho oprávnění — když klíč něco pokazí, víš, čí to byl. Pro běžnou automatizaci ti stačí jeden až dva klíče: jeden pro čtení (reporty), jeden pro zápis (integrační procesy).

Pokud tě zajímá celkový rozpad tarifů a co v nich jiného je, máme ho zpracovaný v článku Raynet ceník 2026: tarify, funkce a jak začít.

03Jak vygenerovat API klíč a jak ho uchovat

Vygenerování klíče je administrátorská záležitost na dvě minuty:

1. Přihlas se jako administrátor a klikni vpravo nahoře na své jméno » Nastavení » API klíče.
2. Klikni na Nový API klíč a vyber uživatelský účet, pod kterým klíč poběží — tenhle účet určuje, co klíč smí.
3. Klíč si hned zkopíruj a ulož do správce hesel.

Ten poslední krok není formalita. API klíč spolu s přihlašovacím e-mailem a názvem instance umožňuje číst obchodní data bez dvoufaktorového ověření a bez jakéhokoli potvrzení. Klíč od CRM je jako klíč od kanceláře: kdokoli ho má, vstoupí. Praktická hygiena:

• Každá integrace ať má vlastní klíč, ať ho kdykoli můžeš samostatně zneplatnit.
• Klíč do zálohy, poznámek na ploše ani do e-mailu nepatří — jen do správce hesel.
• Když si nejsi jistý, kdo klíč má, zneplatni ho a vygeneruj nový; včasná rotace nic nestojí.

04Přihlášení k API: tři údaje, které musíš mít

Raynet používá basic authentication — přihlašuješ se uživatelským jménem (e-mailem) a API klíčem místo hesla. K tomu potřebuješ třetí údaj, název instance, který posíláš v hlavičce X-Instance-Name. Pro firmu na adrese firma.raynet.cz je to firma. Celé přihlášení vypadá takhle:

curl -u '[email protected]:api-klic' \
  -H 'X-Instance-Name: firma' \
  'https://app.raynet.cz/api/v2/company/?limit=1'

Alternativně jde místo názvu poslat ID instance v hlavičce X-Instance-Id, nebo použít bearer token z endpointu security/bearertoken, který už kontext instance obsahuje — to se hodí u složitějších integrací.

Ověřoval jsem chování API na živém endpointu: bez přihlašovacích údajů odpoví HTTP 401 s výzvou k basic authentication, a když v hlavičce pošleš neexistující název instance, dostaneš 404 „Instance not found". Drobnost, která ušetří hodiny ladění: 404 často neznamená špatný endpoint, ale špatný název instance. A pozor na pokusy o přihlášení — po 20 špatných pokusech Raynet zablokuje IP adresu na 60 minut.

05Limity: 24 000 volání denně a 4 souběžná spojení

Výchozí limit je 24 000 volání denně pro celý účet (okno se počítá od půlnoci do půlnoci v UTC). Každá odpověď navíc nese hlavičky, kterými si můžeš ověřit, kde jsi:

• X-Ratelimit-Limit — celkový denní limit instance
• X-Ratelimit-Remaining — kolik volání ti zbývá
• X-Ratelimit-Reset — unixový čas, kdy se limit vynuluje

Po vyčerpání limitu API vrátí HTTP 429 RequestLimitReached. Kromě denního limitu platí fair-use omezení 4 souběžná aktivní spojení na klienta — pokud potřebuješ vytížit víc, oficiální dokumentace doporučuje frontu. A když ti 24 000 volání přestane stačit (stane se to až při opravdu velkých integracích), limit se dá navýšit přes zákaznickou podporu Raynetu.

Do perspektivy: automatizace, která se každých 15 minut zeptá na změněné obchodní případy, spotřebuje zhruba 96 volání denně. Denní limit je tedy reálný problém jen u hromadných exportů, ne u běžného monitoringu.

06První dotaz do Raynet API v praxi

Nejjednodušší test, který ti potvrdí, že máš všechny údaje správně, je získat první firmu z adresáře:

curl -u '[email protected]:api-klic' \
  -H 'X-Instance-Name: firma' \
  'https://app.raynet.cz/api/v2/company/?limit=1'

Vrátí se JSON se seznamem klientů včetně položek jako id, name nebo owner. Na stejném principu pak stavíš reálné dotazy — třeba obchodní případy změněné za posledních 20 minut:

curl -g -u '[email protected]:api-klic' \
  -H 'X-Instance-Name: firma' \
  'https://app.raynet.cz/api/v2/businessCase/?rowInfo.lastModifiedAt[GE]=2026-10-06T09:00:00'

Operátor [GE] znamená „větší nebo rovno" a funguje i v dalších variantách ([EQ], [NE], [IN], [GT], [LT], [LE]). Obchodní případy mají navíc strojové stavy — B_ACTIVE (otevřené), E_WIN (vyhrané), F_LOST (prohrané), G_STORNO (stornované) — takže filtrovat „jen prohrané dealy minulého týdne" je jeden parametr status[NE]=B_ACTIVE, ne ruční procházení kanbanu.

Zápis je stejně přímočarý: POST na /api/v2/person/ s JSON tělem podle dokumentace vytvoří kontaktní osobu. Pár takových volání dáš dohromady a máš funkční integraci s webem.

07Automatizace bez kódu: Make, n8n i Zapier

Na API se nemusíš umět programovat — k tomu jsou vizuální automatizační nástroje. Konkrétní situace u Raynetu:

• Make.com nemá nativní aplikaci pro Raynet. Integrace se staví přes obecný HTTP modul s basic auth a hlavičkou X-Instance-Name. Zní to jako komplikace, ale je to výhoda: postup, který se naučíš, funguje u jakékoli služby s API.
• n8n má taky jen obecný HTTP Request uzel — credential typu Header Auth, testovací GET na /api/v2/company/?limit=1 a je hotovo. Pokud držíš CRM data raději na vlastním serveru, vyšel jsem postup v článku n8n v produkci: self-hosted AI workflow.
• Zapier má oficiální Raynet integraci přímo v katalogu, takže u něj začneš klikáním bez jediného API dotazu.

Hotová inspirace, jak taková automatizace vypadá: návod na notifikace o změně dealu do Slacku přes Make — Make se každých 15 minut zeptá API na změněné případy a ty nové pošle naformátované do kanálu. Druhý směr zvládneš stejným mechanismem: webhook z webu → Make → POST do /api/v2/person/. Který nástroj se pro tvůj tým hodí líp, porovnává článek Make.com vs Zapier.

08MCP server: Raynet přímo v ChatGPT nebo Claude

Nejnovější vrstva API není určená vývojářům, ale AI asistentům. Raynet má MCP server, který propojí CRM s ChatGPT, Claude nebo Google Antigravity — funkcí, která je podle oficiální nápovědy (aktualizováno 2. 10. 2026) aktuálně ve fázi testování.

Rozdíl oproti klasickému API: MCP klíč si generuje každý uživatel pro každý AI nástroj zvlášť (Nastavení » MCP klíče), a při vytvoření volíš, zda bude asistent umět jen číst, nebo číst a zapisovat. Pak se data z CRM stanou součástí běžného chatu:

• „Najdi společnost Raynet a ukaž mi její kontakty."
• „Kolik máme otevřených obchodních případů u této firmy?"
• „Založ nový lead s těmito údaji a naplánuj mi telefonát."

Pro obchodníka, který žije v ChatGPT, je to zkratka, která ušetří přepínání mezi okny. Limit 24 000 volání denně se přitom vztahuje na celý účet — API i MCP dohromady. Raynet u citlivých dat doporučuje AI nástroje, které splňují GDPR, a nastavení svěřit kolegovi s technickými znalostmi; s tím souhlasím. Detailní postupy propojení pro jednotlivé asistenty najdeš v oficiálním článku o MCP serveru.

09Časté otázky

10Závěr: od prvního dotazu k automatizaci

Raynet API je jedno z nejpřístupnějších CRM API na českém trhu: basic authentication, čitelná česká dokumentace, rozumné limity a žádný příplatek za API navíc. Překážka není technická, ale organizační — rozhodnout, která data se mají kam hýbat.

Pokud váháš, kde začít: vygeneruj klíč, spusť testovací dotaz na /api/v2/company/ a ověř si, že ti vrací data. Pak vyber jeden konkrétní úkon, který tým dělá ručně každý den — a ten zautomatizuj jako první. Další kroky i hotové scénáře najdeš v našem průvodci AI automatizacemi v Raynetu a v katalogu nástrojů na stránce Raynet.