# BizMachine Nápověda

Nápověda pro BizMachine Prospector a WebTracks

Vítejte v nápovědě BizMachine. Najdete zde návody a odpovědi na nejčastější otázky k produktům Prospector a WebTracks.

## Sekce nápovědy

| Sekce                                                              | Co zde najdete                                                      |
| ------------------------------------------------------------------ | ------------------------------------------------------------------- |
| [Začínáme](/zaciname/zaciname)                                     | Přihlášení, první kroky, přehled funkcí                             |
| [Hledání a filtrování](/hledani-a-filtrovani/hledani-a-filtrovani) | Sestavení segmentu, filtry, automatická upozornění                  |
| [Seznamy a export](/seznamy-a-export/seznamy-a-export)             | Štítky, workflow prospektingu, export kontaktů, vyloučení zákazníků |
| [Pokročilé funkce](/pokrocile-funkce/profily-a-data)               | Profily firem, firemní signály, AI Prioritizace                     |
| [API a integrace](/api-a-integrace/api-a-integrace)                | API klíče, endpointy, limity, CRM integrace                         |
| [AI konektor (MCP)](/ai-konektor-mcp/ai-konektor-mcp)              | Propojení ChatGPT a Claude s daty z BizMachine                      |
| [WebTracks](/webtracks/webtracks)                                  | Identifikace návštěvníků webu, práce s daty                         |
| [Bezpečnost a GDPR](/bezpecnost-a-gdpr/bezpecnost-a-gdpr)          | Ochrana dat, GDPR, zdroje kontaktů                                  |

## Nenašli jste odpověď?

Napište nám na <support@bizmachine.com> - rádi pomůžeme.


# Začínáme - úvod

Přehled základních funkcí a možností Prospectoru

Právě začínáte s Prospectorem? Tady najdete přehled toho, co všechno aplikace umí.

## V této sekci

* [Přihlášení do Prospectoru: postup a troubleshooting](/zaciname/prvni-prihlaseni)
* [Co nastavit hned na začátku: onboarding checklist](/zaciname/onboarding-checklist)
* [Prospector: přehled funkcí a možností](/zaciname/prospector-prehled-funkci-a-moznosti)


# Přihlášení do Prospectoru: postup a troubleshooting

Postup přihlášení přes magic link a řešení nejčastějších problémů: link nepřišel nebo expiroval, dosažen limit relací, neplatný e-mail nebo vypršení přístupu.

*Aktualizováno: 10. srpna 2026*

Prospector používá přihlášení přes magic link - jednorázový odkaz zaslaný na e-mail, bez hesla. Zadejte e-mail na přihlašovací stránce, klikněte na odkaz v e-mailu a jste přihlášeni na 90 dní. Tady najdete celý postup a řešení nejčastějších problémů.

***

### Přihlašujete se poprvé?

Pokud se přihlašujete poprvé, dostanete od BizMachine uvítací e-mail s přihlašovacím odkazem. Klikněte na odkaz v e-mailu - a jste přihlášeni.

![Uvítací e-mail od BizMachine s tlačítkem Vstoupit do Prospectoru](/files/MrhBfJ0n0ThkJn8d0CJU)

Link platí **24 hodin** od odeslání. Nestihli jste ho? Přejděte na [prospector.bizmachine.com/login](https://prospector.bizmachine.com/login), zadejte svůj pracovní e-mail a přijde nový.

***

### Jak se přihlásit

![Přihlašovací stránka Prospectoru - pole pro e-mail a tlačítko Přihlásit se](/files/4MRN8ctshy6Mqy30RARM)

1. Jděte na [prospector.bizmachine.com/login](https://prospector.bizmachine.com/login)
2. Zadejte svůj pracovní e-mail a klikněte na **Přihlásit se**
3. Otevřete doručenou poštu a klikněte na odkaz v e-mailu od BizMachine
4. Přihlášení platí **90 dní** a funguje současně až na **3 zařízeních**

***

### Link nepřišel nebo nefunguje

**E-mail nepřišel**

* Zkontrolujte složku Spam nebo Hromadné zprávy
* Počkejte pár minut - e-mail může mít krátké zpoždění
* Zkuste zadat e-mail znovu na přihlašovací stránce

**Link expiroval nebo je neplatný**

Přihlašovací link platí **24 hodin** a je jednorázový. Pokud jste ho otevřeli vícekrát nebo v jiném prohlížeči, může být označen jako použitý.

Jak na nový link: jděte na [prospector.bizmachine.com/login](https://prospector.bizmachine.com/login) a zadejte e-mail znovu.

***

### Co znamenají chybové hlášky při přihlašování

#### Dosažen limit relací

Prospector umožňuje být přihlášený na **max. 3 zařízeních současně**. Pokud se pokoušíte přihlásit na čtvrtém, zobrazí se dialog s chybou.

![Dialog Dosažen limit aktivních relací s tlačítkem Zavřít](/files/nFX8TNp5yngfuKYtg4CA)

Zavřete dialog. Pak uvidíte seznam aktivních přihlášení - u jednoho z nich klikněte na **Ukončit přihlášení**.

![Seznam aktivních přihlášení 3 z 3 s tlačítky Ukončit přihlášení](/files/ZMa6SQDEQV2oCQiGZUJy)

Po ukončení se počet sníží a tlačítko **Znovu se přihlásit** se rovnou aktivuje. Klikněte na něj.

![Aktivní přihlášení 2 z 3 s aktivním tlačítkem Znovu se přihlásit](/files/dS13NJboHdlc8MULFssx)

#### „Neplatné přihlášení do Prospectoru“

Tento e-mail dostanete, pokud zadaný e-mail neevidujeme mezi aktivními účty.

![E-mail od BizMachine s předmětem Neplatné přihlášení do Prospectoru](/files/TAGApwieiygvcvPhRcaq)

Nejčastější příčiny:

* přihlašujete se poprvé a přístup ještě nebyl nastaven
* změnila se vám pracovní adresa
* přihlašujete se na jiný e-mail, než ke kterému je přístup vázán

Co dělat: zkuste jiný e-mail, nebo napište na <support@bizmachine.com>.

#### „Platnost Vašeho účtu v Prospectoru vypršela“

Váš účet expiroval. Nemusí to znamenat, že vypršelo předplatné celé organizace - jde o vypršení konkrétního účtu.

![E-mail od BizMachine s předmětem Platnost Vašeho účtu v Prospectoru vypršela](/files/hx9mD74fhKoH55oL2zep)

Co dělat: napište na <support@bizmachine.com>. Obnovení přístupu řešíme obratem.

***

### Jak přidat nebo odebrat uživatele

Přístup do Prospectoru se spravuje na straně BizMachine - nelze ho nastavit přímo v aplikaci.

Pokud potřebujete přidat kolegu, odebrat odcházejícího zaměstnance nebo přesunout přístup na jinou adresu, napište na <support@bizmachine.com> s uvedením jména, e-mailu a firmy.

***

### Časté otázky

**Jak dlouho mi vydrží přihlášení?** 90 dní. Po uplynutí stačí znovu zadat e-mail a přihlásit se přes nový link.

**Mohu být přihlášený na více zařízeních?** Ano, až na 3 zařízeních současně - například na pracovním počítači, notebooku a telefonu.

**Proč mi link nefunguje, i když jsem ho otevřel hned?** Každý link je jednorázový. Pokud jste ho otevřeli vícekrát nebo v jiném prohlížeči, může být označen jako použitý. Jděte na přihlašovací stránku a nechte si poslat nový.

**Nevím, na jaký e-mail je přístup vázán** Napište na <support@bizmachine.com> - zjistíme to.

***

### Související články

* [Co nastavit hned na začátku: onboarding checklist](/zaciname/onboarding-checklist)
* [Prospector: přehled funkcí a možností](/zaciname/prospector-prehled-funkci-a-moznosti)


# Co nastavit hned na začátku: onboarding checklist

Krok za krokem: co udělat a nastavit v prvních dnech s Prospectorem, aby byl hned připravený na práci.

*Aktualizováno: 16. června 2026*

## Co nastavit hned na začátku: onboarding checklist

Prospector nabízí přes 70 filtrů pro vyhledávání firem, sledování signálů a vyhledávání kontaktů z veřejných zdrojů. Ne vše je ale potřeba nastavit najednou. Tenhle checklist vás provede tím nejdůležitějším: co udělat hned na začátku, aby měl Prospector od prvního dne smysl a přinášel výsledky.

***

### 1. Přihlaste se a ověřte přístup

* [ ] Přejděte na [prospector.bizmachine.com/login](https://prospector.bizmachine.com/login) a zadejte svůj pracovní e-mail.
* [ ] Otevřete doručenou poštu a klikněte na přihlašovací odkaz (magic link), heslo nepotřebujete.
* [ ] Přihlášení platí 90 dní a funguje až na 3 zařízeních zároveň.

***

### 2. Vytvořte první štítek

* [ ] V levém menu otevřete sekci **Štítky** a vytvořte nový štítek.
* [ ] Štítek je statický seznam firem, které si sami pojmenujete, třeba „Moji zákazníci", „Zajímavé firmy" nebo „Leady Q1". Název si zvolte podle toho, co vám dává smysl.
* [ ] Štítky lze sdílet s kolegy ze stejné organizace: jako prohlížeč (vidí seznam) nebo editor (může přidávat a odebírat firmy).

Jak štítky využít jako pipeline systém pro prospekting: [Štítky jako workflow systém](/seznamy-a-export/stitky-workflow)

***

### 3. Nahrajte svůj stávající seznam zákazníků

* [ ] Připravte si seznam IČO: buď jako soubor Excel nebo CSV (IČO v prvním sloupci), nebo je můžete jednoduše zkopírovat a vložit přímo do importu. Pokud IČO u svých firem nemáte, kontaktujte podporu na <support@bizmachine.com>, rádi pomůžeme seznam připravit.
* [ ] V sekci **Import / Export** klikněte na **Nový import** a soubor nahrajte.
* [ ] Prospector ověří záznamy a označí firmy, které už neexistují nebo mají chybné IČO.
* [ ] Ověřené firmy uložte do štítku (třeba „Zákazníci") - ten pak využijete pro sledování signálů nebo sdílení s kolegy.

***

### 4. Vytvořte první segment podle vašeho ICP

* [ ] Zkuste si říct, co mají společného vaši nejlepší zákazníci: obor, region, počet zaměstnanců, obrat. To je základ vašeho ICP (ideální zákaznický profil).
* [ ] V sekci **Vyhledávání** nastavte odpovídající kritéria (k dispozici je přes 70 filtrů).
* [ ] Výsledky uložte jako pojmenovaný segment, který se bude automaticky aktualizovat, kdykoli do databáze přibudou nové firmy splňující kritéria.
* [ ] Segment lze sdílet s kolegy stejně jako štítek.

***

### 5. Zapněte notifikace a sledujte signály

Prospector vás může upozornit na dvě různé věci. Nastavte obojí:

* [ ] **Upozornění na nové společnosti:** Prospector pošle e-mail, jakmile se v databázi objeví nová firma odpovídající vašim kritériím. Nastavíte přímo u uloženého segmentu (denně nebo týdně).
* [ ] **Upozornění na nové signály:** přidejte svůj štítek do sledování a dostávejte upozornění na důležité změny: nové inzeráty, změny ve vedení, výběrová řízení nebo otevření nových poboček.

Více o signálech a upozorněních: [Sledování firem: signály a automatická upozornění](/pokrocile-funkce/firemni-signaly-a-upozorneni)

***

### 6. Propojte svoje CRM

* [ ] Pokud používáte CRM, lze Prospector napojit tak, aby firemní data tekla přímo do vašeho CRM, bez zbytečného kopírování.
* [ ] Způsob integrace závisí na konkrétním CRM: pro některé existuje přímé napojení, pro jiné integrace přes Make.com, iFrame nebo API.
* [ ] Pro nastavení integrace kontaktujte podporu na <support@bizmachine.com>. Integrační specialista vám poradí s nejvhodnějším řešením.

Přehled možností: [CRM integrace](/api-a-integrace/crm-integrace)

***

### 7. Nainstalujte Prospector Go

* [ ] Prospector Go je rozšíření pro **Google Chrome** a **Microsoft Edge**.
* [ ] Když navštívíte web libovolné firmy, zobrazí vám základní informace z Prospectoru přímo v prohlížeči, aniž byste museli přepínat záložky.
* [ ] Z rozšíření lze firmu rovnou oštítkovat nebo otevřít její plný profil.

***

### Hotovo! Co dál?

Základní nastavení máte za sebou. Bližší popis funkcí najdete v těchto článcích:

* [Prospector: přehled funkcí a možností](/zaciname/prospector-prehled-funkci-a-moznosti) - co všechno Prospector umí a kde to najdete
* [Sledování firem: signály a automatická upozornění](/pokrocile-funkce/firemni-signaly-a-upozorneni) - jak fungují signály a jak nastavit e-mailová upozornění
* [AI Prioritizace](/pokrocile-funkce/ai-prioritizace) - nechte AI ohodnotit firmy v segmentu podle shody s vaším ideálním zákazníkem

***

### Jak poznám, že Prospector opravdu využívám?

Prospector funguje nejlépe jako součást pravidelné rutiny. Tady jsou znaky, že vám přináší hodnotu:

* **Každý měsíc máte seznam nových firem** - segment vám automaticky připravuje nové kandidáty odpovídající vašemu ICP.
* **Víte o důležitých změnách u zákazníků dřív, než vám zavolají** - upozornění na signály vám hlídají inzeráty, výběrová řízení nebo změny vedení.
* **Váš tým pracuje se stejnými daty** - sdílené štítky a segmenty zajistí, že obchod i CS vidí totéž.
* **Kontakty na rozhodovatele máte rychle po ruce** - filtrem Kategorie rolí najdete přímé kontakty na konkrétní osoby z veřejných zdrojů bez ručního hledání.
* **CRM je aktuální bez manuální práce** - firemní data se propisují automaticky, bez kopírování.


# Prospector: přehled funkcí a možností

Přehled všech funkcí a možností Prospectoru - přihlášení, firemní profil, štítky, segmenty, filtrování, export, import, notifikace a integrace.

*Aktualizováno: 30. července 2026*

## Prospector: přehled funkcí a možností

Prospector je živá databáze napojená na více než 100 veřejných zdrojů (obchodní rejstřík, LinkedIn, pracovní portály, registr smluv aj.). Pokrývá **11,7 milionů firem** z pěti středoevropských trhů (ČR, SK, PL, HU, DE) a přes **4 miliony ověřených osobních kontaktů**. Umožňuje vyhledávat firmy, sledovat změny u klientů a budovat cílené seznamy pro obchodní aktivity.

***

### 1. Přihlášení a základní nastavení

#### Jak se přihlásit

Po zřízení přístupu vám přijde **uvítací e-mail s přihlašovacím odkazem**. Stačí na něj kliknout - žádné heslo není potřeba.

Každé přihlášení **vydrží 90 dní** - nemusíte se přihlašovat pokaždé znovu.

> **Poznámka:** Platnost přihlášení závisí na délce vašeho předplatného (trial účty mají omezenou dobu přístupu). Přihlášení může také zaniknout, pokud si vymažete data prohlížeče nebo cookies.

**Kdy zadat e-mail ručně na přihlašovací stránce:**

* Nestihli jste se přihlásit do **24 hodin** od doručení odkazu (odkaz vyprší).
* Chcete Prospector otevřít na **novém zařízení**.
* Vypršelo 90 dní nebo zaniklo přihlášení z jiného důvodu.

Ve všech případech zadejte svou pracovní e-mailovou adresu na přihlašovací stránce a přijde vám nový odkaz.

> **Tip:** Prospector lze používat současně na **až 3 zařízeních**. Pokud překročíte limit, systém zobrazí upozornění - klikněte na **Zavřít** a v následujícím přehledu aktivních přihlášení klikněte na **Ukončit přihlášení** u zařízení, které již nepoužíváte. Poté klikněte na **Znovu se přihlásit**.

![Popup o dosažení limitu zařízení - přehled aktivních přihlášení](/files/o4vwOuIKzrVkmKuvF5UZ)

#### Nastavení jazyka

V nastavení profilu si můžete přepnout **jazyk rozhraní** podle potřeby.

***

### 2. Úvodní stránka - orientace v rozhraní

Po přihlášení uvidíte úvodní stránku s:

* **Dlaždicemi s nápovědou** - rychlý přehled základních akcí, které vás provedou nástrojem.
* **Naposledy zobrazené firmy** - rychlý přístup k profilům, které jste nedávno otevřeli.
* **Signály změn** - přehled aktuálního dění u firem, které sledujete.

![Úvodní stránka Prospectoru po přihlášení](/files/JobszBBQkZevKpSOTP5n)

***

### 3. Profil firmy

Kliknutím na název firmy (ve vyhledávání nebo v seznamu) se dostanete na její **detailní profil**. Profil je rozdělen do několika záložek:

#### Co najdete v profilu

| Záložka            | Obsah                                                                            |
| ------------------ | -------------------------------------------------------------------------------- |
| **Základní údaje** | Název, IČO, sídlo, web, sociální sítě, popis činnosti                            |
| **Kontakty**       | Obecné (recepce, info e-maily) i osobní (jméno, pozice, LinkedIn, datum ověření) |
| **Propojení**      | Kapitálové vztahy i propojení přes osoby ve vedení                               |
| **Signály**        | Nové tendry, změny managementu, mediální zmínky, nové pobočky                    |
| **Technologie**    | Pravděpodobné technologie odhadnuté z pracovních inzerátů                        |
| **Zaměstnanci**    | Pracovní nabídky z Job.cz, Práce.cz a Úřadu práce                                |
| **Finance**        | Účetní závěrky, veřejné smlouvy, role dodavatele/odběratele                      |
| **Vozidla**        | Počet a typy registrovaných aut; detail vozidla přes VIN kód                     |

> **Poznámka:** Technologická data jsou orientační. Vycházejí z pracovních inzerátů, veřejných zmínek a digitální stopy firmy (webové stránky a další zdroje), nejsou přímo ověřená.

![Profil firmy se záložkami v Prospectoru](/files/ekgna6B9jUC6EKboCQF4)

#### Indikátory aktivity

Každý profil obsahuje tři základní indikátory:

* **Aktivita** - digitální stopa firmy (zveřejňování výkazů, nové nabídky, účast v tendrech)
* **Růst** - signály růstu jako nábor zaměstnanců, nová vozidla
* **Dostupnost dat** - jak úplný profil je

Kromě základních indikátorů mohou být na profilu zobrazeny také:

* **Vlastní indikátory na míru** - připravené naším datovým týmem podle specifických potřeb vaší firmy
* **Indikátory AI Prioritizace** - funkce AI Prioritizace přiřazuje každé firmě hodnotu od 0 do 100 podle toho, jak odpovídá vašemu ideálnímu zákazníkovi. Hodnota se zobrazuje jako sloupec v tabulce a lze ji filtrovat i kombinovat s dalšími filtry. Funkce je aktuálně ve fázi testování s vybranými zákazníky - více informací vám poskytne váš obchodní zástupce.

![Indikátory aktivity na profilu firmy v Prospectoru](/files/7Reafw4LdYUJrRXtQftL)

#### Akce na profilu

* **Sdílení profilu** s kolegou (i bez jeho přístupu do Prospectoru)
* **Přidání poznámky** k firmě
* **Přiřazení štítku**
* Proklik na **obchodní rejstřík** nebo **registr skutečných vlastníků**

***

### 4. Štítky - správa vlastních seznamů

**Štítky** jsou statické seznamy firem, které si sami vytváříte. Slouží k organizaci vašeho portfolia.

#### Jak pracovat se štítky

1. **Vytvoření štítku:** Na profilu firmy nebo v seznamu výsledků klikněte na ikonu štítku a pojmenujte ho (např. „Zákazníci", „Neoslovovat", „Pipeline Q2").
2. **Přidávání firem:** Firmy přidávejte postupně při procházení nebo hromadně z výsledků vyhledávání.
3. **Zobrazení štítku:** V levém menu otevřete libovolný štítek - uvidíte všechny firmy v seznamu.

![Zobrazení štítku se seznamem firem v Prospectoru](/files/hG86sXGqGtAntnJUtavf)

#### Přizpůsobení sloupců

V zobrazení štítku si můžete **přidat nebo skrýt sloupce** podle toho, co potřebujete sledovat (počet vozidel, e-shopy, obrat apod.).

#### Sdílení štítků s kolegy

* Štítek lze sdílet s kolegy jako **čtenář** (vidí firmy) nebo **editor** (může přidávat/odebírat).
* Předejdete tomu, aby například dva kolegové oslovili stejnou firmu dvakrát.

#### Magické štítky

**Magické štítky** jsou speciální štítky připravované naším datovým týmem. Na základě analytiky ověřujeme obor činnosti firem a zachycujeme obchodní příležitosti, které byste sami mohli přehlédnout. Magické štítky se zobrazují přímo v Prospectoru vedle vašich vlastních štítků.

***

### 5. Vyhledávání a segmenty

#### Základní vyhledávání

Do vyhledávacího pole zadejte **název firmy, IČO, adresu nebo doménu e-shopu**.

#### Vyhledávání (segmenty)

Nejsilnější funkce Prospectoru. Firmy filtrujte podle více než **70 filtrů**:

**Geografické filtry**

* Kraj, okres, obec, městská část nebo přesná ulice

**Firemní parametry**

* Počet zaměstnanců, obrat, právní forma
* Odvětví (NACE kódy), vlastní kategorie z firmy.cz

**Obchodní indikátory**

* Aktivita firmy, účast v tendrech, otevřené pracovní nabídky
* Technologie (Microsoft 365, cloudové nástroje apod.)
* Počet a stáří vozidel, e-shopy

**Kontaktní filtry**

* Filtrování kontaktů podle role (vrcholový management, IT, marketing…)
* Dostupnost telefonu nebo e-mailu
* Minimální počet lidí v daném oddělení

**Kombinace s štítky**

* Přidejte firmy z existujícího štítku do výsledků, nebo naopak **vylučte** již známé zákazníky.

![Panel filtrů při vyhledávání v Prospectoru](/files/u5AA4l0BDiQZ6wJ54GUG)

> **Tip:** Počet výsledků se přepočítává v reálném čase, jak upravujete filtry.

#### Šablony vyhledávání

Nemusíte začínat od nuly. Prospector nabízí **přednastavené šablony** pro nejčastější případy (firmy s novými pracovními inzeráty, HR nábor, technologické firmy apod.).

#### Uložení jako segment

Výsledky vyhledávání uložte jako **dynamický segment** - na rozdíl od štítků se segment automaticky aktualizuje o nové firmy, které přibudou do databáze a splní vaše kritéria.

![Uložení segmentu v Prospectoru](/files/dupmOBdxkmVi9sPkRKPg)

**Notifikace na segmentu:**

* Nastavte **denní nebo týdenní e-mailový přehled** o nových firmách nebo signálech změn.
* Nové firmy splňující vaše kritéria uvidíte hned, jak přibudou do databáze.

**Sdílení a kopírování segmentů:**

* Segment sdílejte s kolegou.
* Zkopírujte segment a upravte jen část filtrů pro podobné vyhledávání.

***

### 6. Import vlastních dat

Máte vlastní seznam firem v Excelu? Nahrajte ho do Prospectoru a propojte s databází.

#### Postup importu

1. Připravte soubor **Excel (.xls/.xlsx) nebo CSV**.
2. **IČO nebo DIČ** musí být v **prvním sloupci prvního listu**.
3. V Prospectoru přejděte do sekce Import a nahrajte soubor.
4. Systém zobrazí počet **validních a nevalidních záznamů** - neplatné lze stáhnout jako přehled chyb.
5. Importované firmy **přiřaďte do štítku** pro snadnou správu.

> Zaniklé firmy systém automaticky označí.

![Obrazovka importu vlastních dat v Prospectoru](/files/hBvr951CFbJ7hM0KWLBc)

***

### 7. Export dat

#### Co lze exportovat

* Seznam firem z vyhledávání nebo segmentu
* Kontakty (e-mail, telefon, LinkedIn)

#### Limity exportu

Exportní limity se **obnovují vždy 1. dne v měsíci**. Aktuální spotřebu sledujete přímo v rozhraní.

![Přehled zbývajících exportních limitů v Prospectoru](/files/4mEc0qbbphqk1kbmGfxB)

> **Doporučení:** Před exportem firmy nejprve vyfiltrujte, abyste neplýtvali limitem na nepotřebná data. Exportovaný soubor obsahuje základní informace, nikoliv všechna data z profilu.

#### Tip při exportu

Exportované firmy lze zároveň rovnou uložit do **štítku**, takže vždy víte, co jste už stáhli.

***

### 8. Integrace s CRM a API

Exportovaná data lze přímo propojit s vašimi stávajícími nástroji. Prospector podporuje nativní integrace s:

* **Salesforce**
* **HubSpot**
* **Pipedrive**
* **Raynet**
* **Microsoft Dynamics**

Pro vlastní integrace nebo automatizované zpracování dat je k dispozici také **API přístup**. API klíč si vygenerujete v nastavení svého účtu - podrobný návod najdete v článku [Jak si vygeneruji API klíč?](https://help.bizmachine.com/article/61-jak-si-vygeneruji-api-klic).

***

### 9. Signály a notifikace

**Signály** jsou automaticky zachycené změny u firem. Zobrazují se na profilu firmy a lze na ně nastavit upozornění.

#### Typy signálů

* Nové pracovní inzeráty
* Nové nebo ukončené tendry
* Změny ve vedení (jednatelé, prokuristi)
* Nové pobočky nebo adresy
* Mediální zmínky
* Finanční výkazy

#### Filtrování signálů

Signály lze filtrovat v pokročilém vyhledávání podle:

* **Kategorie signálu** - konkrétní typ změny
* **Textového obsahu** - hledání specifických slov v signálu
* **Stáří signálu** - zobrazení pouze signálů ne starších než zvolený počet dní (max. 180 dní)

Výsledky lze řadit podle velikosti firmy, důležitosti signálu nebo data zveřejnění.

#### Jak nastavit notifikace

* Na profilu firmy nebo v rámci **štítku** zapněte sledování signálů.
* Na **segmentu** nastavte upozornění na nové firmy i na změny u stávajících.
* Notifikace chodí **e-mailem** (denně nebo týdně) s přehledem prvních tří změn a odkazem na detail.

![Nastavení notifikací na segmentu v Prospectoru](/files/FvkTZHgJzaA03Em132cX)

![Nastavení notifikací na segmentu v Prospectoru - detail](/files/r4s6Yf4yhShkoSEkdwGH)

***

### 10. Prospector Go - rozšíření do prohlížeče

Rozšíření **Prospector Go** je dostupné pro **Google Chrome** a **Microsoft Edge**. Instalaci a odkaz ke stažení vám pošle váš zákaznický tým.

#### Co umí rozšíření

* Při návštěvě webu jakékoli firmy zobrazí **základní informace z Prospectoru** přímo v prohlížeči.
* Firmu lze rovnou **označit štítkem** nebo prokliknout na její plný profil.
* Ušetříte čas při průzkumu.

![Prospector Go v prohlížeči při návštěvě webu firmy](/files/c0F0vhm1OhU80sKfFzcB)

***

### 11. Podpora

Pomoc je dostupná kdykoliv přímo v aplikaci:

* Klikněte na tlačítko **Pomoc** v pravém dolním rohu.
* Kontaktujte tým přes **chat, e-mail nebo telefon**.

![Tlačítko Pomoc v rozhraní Prospectoru](/files/hkmgGwtPWZfYtV2S0EuT)

Podpora pomůže s přihlášením, školicími dotazy i technickými záležitostmi.

***

### Rychlý přehled: Co dělat jako první

1. **Přihlaste se** přes link v e-mailu a ověřte, že vidíte úvodní stránku.
2. **Nainstalujte rozšíření Prospector Go** do prohlížeče.
3. **Vyhledejte pár firem**, které znáte, a projděte si jejich profily.
4. **Vytvořte první štítek** (například „Moji zákazníci") a přidejte do něj firmy z vašeho portfolia, ideálně importem přes IČO.
5. **Vyzkoušejte filtrování** - nastavte segment pro vaši cílovou skupinu a uložte ho.
6. **Zapněte notifikace** na segment nebo sledované firmy.

Nevíte si rady? Klikněte na tlačítko Pomoc - podpora odpoví přes chat, e-mail nebo telefon.


# Hledání a filtrování - úvod

Vyhledávání firem, pokročilé filtry a práce s výsledky

Prospector nabízí 70+ filtrů pro přesné zacílení na firmy, které odpovídají vašemu ideálnímu zákazníkovi. Tady najdete průvodce pokročilým filtrováním.

## V této sekci

* [Vyhledávání v Prospectoru: jak sestavit segment a pracovat s ním](/hledani-a-filtrovani/pokrocile-filtrovani)
* [Jak najít firmy podobné vašim nejlepším zákazníkům (lookalike)](/hledani-a-filtrovani/podobne-firmy-lookalike)
* [Vyhledávání kontaktů podle rolí](/hledani-a-filtrovani/kategorizace-roli-export)


# Vyhledávání v Prospectoru: jak sestavit segment a pracovat s ním

Jak pomocí filtrů najít firmy odpovídající vašemu ideálnímu zákazníkovi, uložit výsledky jako segment, sdílet ho s kolegy a nastavit automatická upozornění.

*Aktualizováno: 17. dubna 2026*

## Vyhledávání v Prospectoru: jak sestavit segment a pracovat s ním

Vyhledávání v Prospectoru vám umožní najít firmy, které přesně odpovídají vašemu ideálnímu zákazníkovi. Kombinací filtrů sestavíte segment, uložíte ho a necháte Prospector automaticky hlídat nové příchozí firmy. Žádné ruční procházení databáze.

*Tento článek popisuje skupiny filtrů a práci s výsledky vyhledávání. Jak vyhledat konkrétní rozhodovatele podle role popisuje* [*Vyhledávání kontaktů podle rolí*](/hledani-a-filtrovani/kategorizace-roli-export)*. Jak používat štítky jako workflow systém popisuje* [*Štítky jako workflow systém*](/seznamy-a-export/stitky-workflow)*. O AI prioritizaci se dozvíte více v* [*AI Prioritizace*](/pokrocile-funkce/ai-prioritizace)*.*

***

### Kde Vyhledávání najdete

V levém menu klikněte na **Vyhledávání**. Nové hledání zahájíte kliknutím na **+ Filtrovat**. Svá uložená a nasdílená hledání najdete v sekci **Segmenty**, která je samostatnou položkou v levém menu.

![Levé menu s Vyhledáváním a Segmenty](/files/YEKkkGXFDh8Pcdgs1Est)

***

### Jak přidat filtry a sestavit hledání

1. Klikněte na **+ Přidat filtr** a vyberte kategorii
2. Nastavte hodnoty, výsledky se aktualizují průběžně
3. Přidávejte další filtry pro zpřesnění

***

### Co dělat s výsledky

Se seznamem firem ve výsledcích můžete pracovat několika způsoby:

* **Procházet firmy:** každou firmu otevřete jako kompletní profil nebo rychlý detail, podle toho, kterou ikonu použijete
* **Zobrazit Kontakty nebo Signály:** přepněte pohled na kontakty nebo signály firem z výsledků a dále je profiltrujte
* **Nastavit sloupce:** přizpůsobte si, jaká data se v seznamu zobrazují
* **Uložit do štítku:** označte firmy štítkem pro pozdější práci
* **Export:** exportujte seznam firem
* **Uložit jako segment:** uložte hledání pro opakované použití a automatické aktualizace
* **Spustit AI Prioritizaci:** seřaďte firmy podle shody s vaší nabídkou pomocí AI *(funkce je dostupná v testovacím režimu)*

![Seznam výsledků s lištou akcí a ikonami pro otevření firmy](/files/Hlb7I588npK015zg5nRm)

***

### Jaké filtry jsou k dispozici?

#### Základní informace

Definujte velikost, věk a typ firmy.

| Filtr                | K čemu slouží                                               |
| -------------------- | ----------------------------------------------------------- |
| Počet zaměstnanců    | Malé (2-50), střední (51-500), velké (500+) firmy           |
| Obrat (mil. Kč)      | Minimální obrat odpovídající kupní síle pro vaši nabídku    |
| Typ organizace       | Veřejný sektor, banky, pojišťovny a další typy subjektů     |
| Právní forma         | S.r.o., a.s., OSVČ, zahraniční pobočky, zemědělská sdružení |
| Datum založení firmy | Nově založené firmy nebo stabilní subjekty s historií       |
| Adresa sídla         | Kraj, okres nebo konkrétní město a obec                     |

{% hint style="info" %}
Nově vzniklé firmy do 30 dnů od zápisu mají v databázi málo dat. Pro lepší výsledky filtrujte raději firmy starší 60-90 dní.
{% endhint %}

#### AI Indikátory

→ [AI Prioritizace](/pokrocile-funkce/ai-prioritizace)

#### Obchodní indikátory

Zaměřte se na skutečně fungující firmy.

| Filtr                      | K čemu slouží                                                            |
| -------------------------- | ------------------------------------------------------------------------ |
| Aktivita                   | Odfiltrujte neaktivní nebo schránkové firmy                              |
| Růst                       | Rychle rostoucí firmy; hodnotí nábor, vozidla, obrat i počet zaměstnanců |
| Dostupnost                 | Firmy s dobrou online přítomností a kontakty                             |
| Vyloučení rizikových firem | Odstraňte firmy s rizikovými signály z výsledků                          |

{% hint style="info" %}
**Rizikové firmy** zahrnují: bankrot, insolvenční řízení, likvidace, přerušená živnost, nespolehlivý plátce DPH, pravděpodobně bílý kůň, sídlo na adrese schránkových firem, riziko skrze propojenou společnost nebo pravděpodobně rizikový web.
{% endhint %}

#### Odvětví

Přesné zacílení na odvětví nebo typ nabídky.

| Filtr            | K čemu slouží                                                 |
| ---------------- | ------------------------------------------------------------- |
| NACE klasifikace | Klasifikace podle odvětví (výroba, služby, maloobchod...)     |
| Obor činnosti    | Přesnější alternativa k NACE, vychází z toho, co firma nabízí |
| Import / Export  | Firmy zapojené do mezinárodního obchodu                       |

{% hint style="info" %}
**NACE klasifikace** je oficiální kód přidělený při registraci firmy. Firma si ho vybírá sama a nemusí přesně odpovídat tomu, co reálně dělá. **Obor činnosti** vychází z toho, co firma o sobě říká na webu a dalších portálech, je přesnější, ale vyžaduje spárovaný web. Hodí se zejména pro firmy ze služeb, IT a obchodu.
{% endhint %}

#### Štítky

Pracujte se svými existujícími seznamy firem.

| Filtr                     | K čemu slouží                                                       |
| ------------------------- | ------------------------------------------------------------------- |
| Moje štítky               | Zahrňte firmy s konkrétním štítkem                                  |
| Moje štítky (vyloučit)    | Odstraňte stávající zákazníky nebo dříve kontaktované firmy         |
| Magické štítky            | Předpřipravené segmenty v Prospectoru (rodinné firmy, exportéři...) |
| Magické štítky (vyloučit) | Vyloučte firmy z předpřipraveného segmentu                          |
| Firmy s poznámkou         | Jen firmy, u kterých máte uloženou poznámku                         |

#### Kontakty a role

Zacilte přímo na rozhodovací úrovně.

| Filtr                      | K čemu slouží                                               |
| -------------------------- | ----------------------------------------------------------- |
| Firemní kontakty           | Dostupnost firemních kontaktních údajů                      |
| Sociální sítě a web        | Přítomnost firmy na LinkedInu, Facebooku nebo vlastním webu |
| Počet osob v oddělení      | Proxy pro velikost konkrétního týmu                         |
| Oddělení a role            | IT tým, obchod, marketing, HR; CEO, CFO, Head of Sales...   |
| Zdroj                      | Odkud kontakt pochází                                       |
| Typ osobního kontaktu      | Rozlišení osobního a firemního kontaktu                     |
| Poslední kontrola kontaktu | Jak aktuální jsou kontaktní údaje                           |

#### Klíčová slova

Fulltextové vyhledávání napříč údaji o firmě. Hledá ve čtyřech zdrojích: Název společnosti, Popis společnosti, Adresa sídla společnosti a URL adresa webové stránky. Podmínku lze nastavit jako „Obsahuje všechna slova" nebo „Obsahuje některé ze slov".

#### Finance

Pro detailní finanční profilování firem.

| Filtr                            | K čemu slouží                                                   |
| -------------------------------- | --------------------------------------------------------------- |
| Finanční výkazy                  | Firmy s dostupnými výkazy v databázi                            |
| Banky                            | Filtrování dle bankovního domu firmy                            |
| Růst obratu                      | Dynamicky rostoucí firmy                                        |
| Čistá marže (v %)                | Firmy s dostatkem prostředků na investice                       |
| Čistý zisk (mil. Kč)             | Absolutní ziskovost firmy                                       |
| EBIT marže (v %)                 | Provozní ziskovost                                              |
| Poměr přidané hodnoty k obratu   | Vyšší hodnota = konzultační, technologické nebo designové firmy |
| Náklady na zaměstnance           | Proxy pro velikost a strukturu mzdových nákladů                 |
| Poměr kapitálové intenzity       | Míra vázanosti majetku v podnikání                              |
| Základní kapitál (v tisících Kč) | Výše základního kapitálu zapsaného v obchodním rejstříku        |
| Aktiva celkem (mil. Kč)          | Alternativa k měření velikosti, když chybí data o obratu        |
| Plátce DPH                       | Ověřené firmy s obratem zpravidla nad 1 mil. Kč                 |

#### Vlastnická struktura

| Filtr              | K čemu slouží                                |
| ------------------ | -------------------------------------------- |
| Mezinárodní podíl  | Firmy s podílem zahraničního vlastníka       |
| Individuální podíl | Firmy vlastněné fyzickou osobou              |
| Vlastník znám      | Firmy s dohledatelnou vlastnickou strukturou |
| Počet vlastníků    | Firmy s jedním nebo více vlastníky           |

#### Provozovny

| Filtr                | K čemu slouží                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Adresa provozovny    | Kde firma fyzicky působí (i když sídlí jinde)                                                                                                |
| Počet provozoven     | Firmy s více pobočkami nebo prodejnami                                                                                                       |
| Kategorie provozovny | Typ provozovny dle zaměření: Obchody a obchůdky, Služby a řemesla, Velkoobchod a výroba, Auto-moto, Restaurační a pohostinské služby a další |

#### Vozidla

Pro automotive a leasingový segment.

| Filtr                                            | K čemu slouží                                                         |
| ------------------------------------------------ | --------------------------------------------------------------------- |
| Počet vozidel                                    | Firmy s velkou flotilou vhodné pro fleet management                   |
| Provozovatel / Vlastník                          | Rozlišení, zda firma vozidlo provozuje nebo vlastní                   |
| Datum začátku aktuálního provozování/vlastnictví | Od kdy firma vozidlo provozuje nebo vlastní                           |
| Datum prvního uvedení do provozu                 | Stáří vozidla                                                         |
| Stav při pořízení                                | Nové, ojeté                                                           |
| Kategorie vozidla                                | Osobní, nákladní, přípojné, motocykly a další                         |
| Značka a model                                   | Mono-brandové flotily vhodné pro servis nebo obměnu                   |
| Typ vozidla                                      | Upřesnění kategorie vozidla                                           |
| Pohon                                            | Elektromobilita, CNG, LPG, hybridní vozidla                           |
| Poslední známý nájezd                            | Vozidla blížící se vysokému nájezdu. Ideální moment pro novou nabídku |
| Příznaky vozidla                                 | Specifické vlastnosti nebo stavy vozidla                              |

#### Signály

Zachyťte firmy ve správném okamžiku.

| Filtr                       | K čemu slouží                                                                                                                                                                                   |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kategorie firemních signálů | Změna managementu, změna adresy, změny v bankovních účtech, výročí založení firmy, finanční závěrky, změny ve finančním zdraví, platební neschopnost, otevřené pozice, zmínka v médiích a další |
| Zpřesnění signálů           | Upřesnění výsledků, např. „marketing" u změny vedení                                                                                                                                            |
| Stáří signálu               | Jen čerstvé signály (posledních N dní)                                                                                                                                                          |

{% hint style="success" %}
**Příklad:** Sledujete tendry v oblasti IT? Filtr Signály → Tendr + zpřesnění „software" vám zobrazí firmy, které právě vypisují výběrové řízení.
{% endhint %}

Více: [Sledování firem: signály a automatická upozornění](/pokrocile-funkce/firemni-signaly-a-upozorneni)

#### Technologie

Zjistěte, jaký technologický stack firma používá.

| Filtr       | K čemu slouží                                                    |
| ----------- | ---------------------------------------------------------------- |
| Technologie | SAP, Shopify, Google Analytics, CNC stroje, Pohoda, Fakturoid... |

U firem se zastaralými technologiemi dává migrace smysl. Firmy s prémiovými systémy (SAP, Oracle) mají zpravidla vyšší rozpočet.

#### Pracovní nabídky

Inzeráty jsou přímý signál o potřebách a strategii firmy.

| Filtr                             | K čemu slouží                                                   |
| --------------------------------- | --------------------------------------------------------------- |
| Kategorie pracovních pozic        | Firmy hledající IT, obchod, marketing, HR, logistiku...         |
| Počet otevřených pracovních pozic | Firmy s velkým náborem pravděpodobně rostou nebo mění strategii |
| Název pracovní pozice             | Konkrétní role, např. „obchodní zástupce" nebo „CTO"            |
| Stáří pracovního inzerátu         | Jak dlouho firma danou pozici inzeruje                          |

{% hint style="success" %}
**Příklad:** Prodáváte HR software? Hledejte firmy, které aktuálně inzerují HR specialistu. To je přesný moment, kdy aktivně řeší HR agendu.
{% endhint %}

#### E-Commerce

Pro firmy prodávající online.

| Filtr                               | K čemu slouží                                                             |
| ----------------------------------- | ------------------------------------------------------------------------- |
| Počet e-shopů                       | Firmy s více e-shopy jsou pokročilejší hráči na trhu                      |
| Počet produktů                      | Rozsah sortimentu e-shopu                                                 |
| Organická návštěvnost z vyhledavačů | Firmy s vysokou návštěvností řeší SEO, UX, cloud                          |
| Pořadí v zemi                       | Top N e-shopů, pravděpodobně hledají mezinárodní expanzi nebo nová řešení |
| Hodnocení                           | Průměrné hodnocení e-shopu zákazníky                                      |
| Placená klíčová slova (GoogleAds)   | Firmy aktivně inzerující ve vyhledávání                                   |
| E-shop platforma                    | Shoptet, Shopsys, WooCommerce, Magento...                                 |
| Platební metody                     | Způsoby platby, které e-shop nabízí                                       |
| Doprava                             | Dopravci a způsoby doručení, které e-shop používá                         |

***

### Jak uložit segment

Jakmile přidáte alespoň jeden filtr, zobrazí se v liště za použitými filtry tlačítko **Uložit segment**. Klikněte na něj a pojmenujte hledání. Segment se uloží do sekce **Segmenty** v levém menu. Kdykoli ho otevřete, výsledky se automaticky aktualizují o firmy, které nově splňují vaše kritéria.

![Lišta s použitými filtry a tlačítkem Uložit segment](/files/JDi05RGLmuopOUBqMn9y)

Uložený segment lze dále spravovat přes menu **⋮** u jeho názvu:

* **Duplikovat:** vytvořte kopii segmentu jako základ pro nové hledání
* **Přejmenovat:** změňte název segmentu
* **Sdílet:** sdílejte segment s kolegy
* **Zobrazit detail:** otevřete nastavení segmentu
* **Smazat:** trvale odstraňte segment

![Menu ⋮ u názvu segmentu s možnostmi správy](/files/YdmiEt1pZnYDDczI6aMi)

***

### Jak sdílet segment s kolegy

Segment sdílíte dvěma způsoby: tlačítkem **Sdílet** vpravo nahoře při otevřeném segmentu, nebo přes menu **⋮** u názvu segmentu. Kolegové ze stejné organizace segment uvidí v sekci Segmenty a mohou s ním pracovat.

***

### Jak nastavit automatická upozornění na nové firmy

Na každém segmentu lze zapnout upozornění přes ikonu zvonečku u jeho názvu. Jsou k dispozici dva typy: **upozornění na nové společnosti** (když nová firma splní vaše filtry) a **upozornění na nové signály** (když se u firem v segmentu objeví sledovaný signál). U upozornění na nové signály je potřeba nastavit také konkrétní typy sledovaných signálů: klikněte na **Zobrazit vybrané signály** v záložce Upozornění.

![Dialog Segment Detail - záložka Upozornění](/files/c9wF2KnCzfBHNyLFfkZQ)

→ [Sledování firem: signály a automatická upozornění](/pokrocile-funkce/firemni-signaly-a-upozorneni)

***

### Tipy na kombinaci filtrů

* **Nové obchodní příležitosti:** Datum založení firmy 1-3 roky + Aktivita (aktivní) + váš obor → čerstvé firmy, které teprve budují dodavatelskou síť
* **Vyloučení stávajících zákazníků:** Moje štítky (vyloučit) → štítek „Moji zákazníci"
* **Správný moment k oslovení:** Signály → Změna managementu nebo Tendr + Zpřesnění signálů k upřesnění
* **Firmy s rozpočtem:** Obrat nad X + kladná EBIT marže (v %) + Firemní kontakty
* **Rostoucí firmy:** Růst (vysoký) + nábor na obchodní pozice


# Jak najít firmy podobné vašim nejlepším zákazníkům (lookalike)

Jak přes AI konektor (MCP) najít firmy podobné vašim nejlepším zákazníkům: asistent zjistí, co mají společné, a podle těch znaků najde v databázi BizMachine další firmy stejného profilu.

*Aktualizováno: 4. srpna 2026*

Firmy podobné vašim nejlepším zákazníkům najdete přes AI konektor (MCP) v několika krocích: dáte asistentovi seznam svých TOP zákazníků, necháte ho zjistit, co mají společné, a podle těch znaků najdete v databázi BizMachine další firmy stejného profilu. Není to slepé tlačítko „najdi podobné“, ale řízený postup, ve kterém u každé firmy vidíte, proč do výběru patří.

***

### Proč v BizMachine není tlačítko „najdi podobné“

Tlačítko, které z jedné firmy vyrobí seznam podobných, zní lákavě. Háček je v tom, co se děje pod ním. Algoritmus, který podobnost hledá, sám často spojí firmy podle povrchních znaků (stejný kód NACE, podobný obrat) a to podstatné pomine. Seznam vypadá hezky, ale půlka firem do vašeho profilu vlastně nepatří.

BizMachine proto jde jinou cestou. Nejdřív zjistíte, proč jsou vaši nejlepší zákazníci dobří, a teprve tyhle znaky použijete jako kompas pro hledání. Získáte tím dvě věci: přesnější výběr a u každé firmy důvod, proč v něm je. Když pak výsledek nesedí, víte přesně, který znak doladit.

Celé to zvládnete v běžné konverzaci s vaším AI asistentem. Stačí mít připojený [AI konektor (MCP)](/ai-konektor-mcp/ai-konektor-prehled).

### Než začnete

* **Připojený AI konektor (MCP).** Asistent (ChatGPT, Claude, Microsoft Copilot Studio nebo jiný nástroj s podporou MCP) musí být propojený s vaším BizMachine workspace. Návod najdete v článcích [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt), [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude) a [Jak připojit BizMachine v Microsoft Copilot Studiu](/ai-konektor-mcp/ai-konektor-copilot-studio).
* **Seznam nejlepších zákazníků.** Firmy, které pro vás opravdu nejlíp fungují a jsou si mezi sebou podobné. Tři až pět stačí.

{% hint style="info" %}
Pokud jsou vaši nejlepší zákazníci hodně různorodí (třeba malá výroba i velká banka), rozdělte je do dvou až tří skupin a každou zpracujte zvlášť. U smíchaného seznamu totiž asistent najde jako společné jen ty nejobecnější znaky, například zemi a velikostní rozmezí, a výběr pak vyjde moc široký.
{% endhint %}

### Krok 1: Připravte si seznam zákazníků

Seznam svých zákazníků můžete asistentovi předat třemi způsoby. Vyberte si klidně ten, který vám sedí nejvíc.

#### a) Vložením nebo nahráním seznamu

Nejjednodušší cesta. Názvy firem nebo jejich IČO prostě vložíte přímo do chatu, nebo nahrajete soubor (Excel, CSV). Funguje bez ohledu na to, co máte v Prospectoru nastavené.

{% hint style="info" %}
Doporučujeme zadávat **IČO**. Je jednoznačné a asistent firmu najde bez doptávání. U názvů si může vyžádat upřesnění, když existuje víc firem s podobným jménem.
{% endhint %}

#### b) Štítkem v Prospectoru

Pokud už máte zákazníky označené [štítkem](/seznamy-a-export/stitky-workflow) v Prospectoru, můžete na něj asistenta rovnou odkázat: „Vezmi firmy ze štítku Moji zákazníci.“ Konektor štítky čte, takže nemusíte nic vkládat ručně.

#### c) Z vašeho CRM

Když máte v asistentovi vedle BizMachine připojené i své CRM (například Pipedrive), můžete seznam vytáhnout rovnou odtud: „Vezmi mé zákazníky z CRM a najdi je v BizMachine.“ Záleží přitom na tom, jaké nástroje máte v asistentovi propojené.

{% hint style="warning" %}
Sdílené štítky se mezi kolegy nemusí vždy zobrazit správně. Pokud asistent štítek nevidí, použijte cestu a) a seznam vložte přímo do chatu.
{% endhint %}

### Krok 2: Nechte asistenta zjistit, co mají zákazníci společné

Teď asistenta prostě požádáte, ať si vaše zákazníky v BizMachine projde a popíše, co je spojuje. Z toho vznikne profil vašeho ideálního zákazníka, kompas pro další hledání.

Zkopírujte si tento dotaz a doplňte svůj seznam:

```
Tady je seznam mých nejlepších zákazníků: [vlož názvy nebo IČO].

Najdi každou firmu v BizMachine a projdi její profil. Pak mi řekni,
co mají tyhle firmy společného:
- obor a hlavní činnost
- velikost (počet zaměstnanců, obrat)
- region a typ organizace
- technologie, které používají
- obchodní indikátory (aktivita, růst, dostupnost)
- další indikátory

Z toho sestav profil jednoho ideálního zákazníka a vypiš
3 až 7 znaků, které ho nejlépe vystihují.
```

Asistent si o každé firmě načte ověřená data z BizMachine (ne to, co najde na webu nebo si domyslí) a vrátí vám souhrn. Přečtěte si ho v klidu. Tohle je totiž moment, kdy si ověříte, že profil odpovídá tomu, jak svoje zákazníky znáte. Když něco nesedí, napište mu to a nechte profil upravit.

### Krok 3: Najděte podobné firmy a dolaďte výběr

Když profil sedí, necháte asistenta najít firmy, které mu odpovídají. Pokračujte ve stejné konverzaci - profil pak zůstane v kontextu:

```
Na základě tohohle profilu najdi v BizMachine další firmy, které mu odpovídají.
Vynech firmy, které už mám v seznamu zákazníků.

Postupuj takto:
1. Nejdřív mi řekni, kolik takových firem v databázi je.
2. Pak ukaž vzorek 10 firem a u každé napiš, proč do výběru patří.
3. Když to bude sedět, připrav seznam 50 firem.
```

Tímhle postupem jdete od hrubého odhadu k hotovému seznamu. Nejdřív zjistíte velikost trhu (kolik firem profil vůbec splňuje), pak si na malém vzorku ověříte, že výběr dává smysl, a teprve potom si necháte připravit celý seznam. Vyhnete se tak tomu, že byste rovnou pracovali se stovkami firem, které byste nakonec vyřadili.

Projděte vzorek a podle něj výběr dolaďte:

* **Je jich moc, nebo jsou moc obecné?** Přidejte do profilu další znak: konkrétní region, technologii nebo [signál](/pokrocile-funkce/firemni-signaly-a-upozorneni) (třeba „jen firmy, které teď nabírají obchodníky“).
* **Firem je málo?** Uberte nejpřísnější podmínku, nebo rozšiřte region o další zemi.
* **Nezapomeňte vyloučit stávající zákazníky.** Aby vám ve výsledcích nezůstaly firmy, které už máte, řekněte asistentovi, ať je vynechá, nebo použijte filtr [Moje štítky (vyloučit)](/seznamy-a-export/vylouceni-zakazniku) v Prospectoru.

### Krok 4 (nepovinný): Seřaďte výběr podle priority pomocí AI Prioritizace

Hotový seznam z Kroku 3 můžete rovnou vzít a oslovit. Pokud ale chcete vědět, koho oslovit první, posune vás AI Prioritizace ještě o krok dál: každé firmě přidělí hodnotu 0 až 100 podle toho, jak dobře sedí na vaši nabídku, a u každé doplní důvod.

Prioritizace běží vždy na segmentu nebo štítku, takže postup je tento:

1. **Nechte asistenta sepsat nabídku.** Z profilu, který vznikl v Kroku 2, vám asistent rovnou napíše nabídku pro AI Prioritizaci, tedy popis vašeho produktu a ideálního zákazníka. Konektor ji uloží do vašeho workspace.
2. **Uložte lookalike výběr jako segment.** V Prospectoru si hledání uložte jako segment, nebo firmy označte štítkem. Na tomhle seznamu pak prioritizace poběží.
3. **Spusťte AI Prioritizaci na tom segmentu.** V Prospectoru klikněte na „Spustit AI Prioritizaci“ a vyberte nabídku z prvního bodu.
4. **Seřaďte firmy podle hodnoty.** Každá firma dostane hodnotu 0 až 100 i s vysvětlením. Začnete prostě od nejvyšších a hned víte, koho oslovit nejdřív.

Podrobnosti najdete v článku [AI Prioritizace](/pokrocile-funkce/ai-prioritizace), tipy na dobrou nabídku v článku [Jak napsat nabídku pro AI Prioritizaci](/pokrocile-funkce/ai-prioritizace-tipy).

{% hint style="info" %}
Nabídku konektor **sepíše**, ale samotné vyhodnocení spustíte v Prospectoru. Je to tak schválně: prioritizace pracuje s desítkami údajů o každé firmě a běží na celém segmentu najednou.
{% endhint %}

### Příklad: od tří zákazníků k seznamu padesáti

Řekněme, že prodáváte servis CNC strojů a vaši tři nejlepší zákazníci jsou strojírenské firmy v Moravskoslezském kraji s 50 až 250 zaměstnanci.

Asistent si je v BizMachine najde a zjistí, co mají společné: strojírenská výroba, střední velikost, vlastní výrobní provoz, technologie CNC a aktivní nábor do výroby. Z toho sestaví profil. Pak v databázi najde dalších padesát firem, které tomuhle profilu odpovídají, vynechá vaše tři zákazníky a u každé napíše, proč do výběru patří.

### Řešení problémů

| Problém                              | Příčina                                  | Řešení                                                                 |
| ------------------------------------ | ---------------------------------------- | ---------------------------------------------------------------------- |
| Mám zadat názvy, nebo IČO?           | Názvy mohou být víceznačné               | Zadejte IČO. Je jednoznačné, na rozdíl od názvu firmy.                 |
| Asistent nevidí můj štítek           | Sdílené štítky se nemusí vždy zobrazit   | Vložte seznam přímo do chatu nebo nahrajte soubor (cesta a v kroku 1). |
| Výsledky nesedí nebo jsou moc obecné | Profil je příliš široký                  | Přidejte konkrétnější znak: region, technologii nebo signál.           |
| Firem ve výsledku je málo            | Profil je příliš přísný                  | Uberte nejpřísnější podmínku nebo rozšiřte o další zemi.               |
| Asistent nabízí stažení tisíců firem | Konektor není určený pro hromadný export | Pro velké objemy použijte Prospector nebo Prospector API.              |

### Často kladené dotazy

**Kolik zákazníků mám zadat?** Neexistuje jedno správné číslo. Důležitější než počet je, aby si firmy byly podobné a opravdu pro vás fungovaly. Začít můžete klidně s pár firmami, tři až pět stačí. Víc dobře vybraných příkladů profil zostří. Jen pozor na firmu, která mezi ostatní nezapadá, ta umí výsledek pokřivit.

**Jak se to liší od AI Prioritizace?** AI Prioritizace seřadí firmy, které už v segmentu máte, podle toho, jak sedí na vaši nabídku. Tady jdete vlastně o krok zpět: ze svých zákazníků teprve odvozujete, jaký segment vůbec hledat. Jak obojí spojit, ukazuje Krok 4 výše.

**Funguje to i pro Slovensko, Polsko, Maďarsko a Německo?** Ano. Jedno MCP připojení zpřístupní všechny země, na které má váš účet právo. Hloubka dat se přitom mezi zeměmi liší.

**Pracuje asistent s aktuálními daty?** Ano. Konektor čte stejná data jako Prospector: **11,7 milionu firem v pěti zemích (k červnu 2026)**, průběžně ověřovaných ze 100+ veřejných zdrojů.

**Můžu si výsledek uložit jako segment?** Uložení vyhledávání jako segment zatím děláte v Prospectoru. Asistent vám seznam připraví, vy si ho pak v Prospectoru uložíte a necháte hlídat nové firmy.

***

### Co dál

* [AI konektor (MCP): co umí a k čemu slouží](/ai-konektor-mcp/ai-konektor-prehled)
* [Vyhledávání v Prospectoru: jak sestavit segment a pracovat s ním](/hledani-a-filtrovani/pokrocile-filtrovani)
* [AI Prioritizace](/pokrocile-funkce/ai-prioritizace)
* [Jak vyloučit existující zákazníky](/seznamy-a-export/vylouceni-zakazniku)


# Vyhledávání kontaktů podle rolí

Jak najít rozhodovatele v Prospectoru pomocí předpřipravených kategorií rolí - bez nutnosti znát přesné názvy pozic.

*Aktualizováno: 16. června 2026*

## Vyhledávání kontaktů podle rolí

Prospector vyhledává kontakty na osoby ve firmách z veřejných zdrojů. Místo zadávání konkrétních názvů pozic si vyberete kategorii - vrcholový management, vedení IT, HR - a rovnou uvidíte osoby v dané roli napříč všemi firmami ve vašem výběru.

### Jak fungují kategorie rolí

Kategorie jsou předpřipravené skupiny pozic ve stromové struktuře. Každá kategorie pokrývá všechny relevantní varianty, jak se daná role v praxi jmenuje - nemusíte vymýšlet, jak se konkrétní pozice u daného zákazníka jmenuje.

Na první úrovni jsou typy vedení a oddělení:

* Vrcholové vedení
* Finance
* Regionální vedení
* Nákup
* Marketing
* Obchod
* IT
* HR
* Provoz
* Výroba
* Ostatní

Rozvinutím šipky u každé kategorie se dostanete na konkrétnější podkategorie.

![Stromová struktura kategorií rolí v panelu filtrů Kontakty](/files/IAKEWQn9LtcmzgwiAEpX)

### Jak vyhledat kontakty podle role

1. Spusťte hledání v Prospectoru a sestavte segment firem, které vás zajímají.
2. V panelu filtrů přejděte do sekce **Kontakty**.
3. Klikněte na filtr **Kategorie rolí**.
4. Rozviňte stromovou strukturu a vyberte jednu nebo více kategorií.
5. V seznamu uvidíte osoby z vybraných firem, které odpovídají zvolené roli.

U každého záznamu najdete jméno, pozici, firmu a dostupné kontaktní údaje z veřejných zdrojů.

![Záložka Kontakty s aplikovaným filtrem Oddělení a role - seznam výsledků se sloupci Jméno, Role, Email, Telefon, LinkedIn](/files/CTBhCDY7ssyZ0xEJ4EFg)

### Filtrování podle typu kontaktu

Filtr **Typ kontaktu** doplňuje kategorii rolí: výsledky si klidně zúžíte jen na osoby, u kterých máte třeba rovnou e-mail nebo telefon.

Dostupné typy:

* **Telefon** - přímé telefonní číslo
* **E-mail** - pracovní e-mailová adresa
* **LinkedIn** - odkaz na LinkedIn profil

Kombinace obou filtrů dává nejpřesnější výsledky. Například "vedení IT + E-mail" zobrazí jen kontakty, na které můžete rovnou napsat.

Ve stejném panelu najdete i přepínač **Vynechat již exportované** - skryje kontakty, které jste z tohoto výběru již dříve stáhli, a pomůže vám neprocházet stejné záznamy dvakrát.

![Filtr Typ kontaktu s možnostmi Telefon, E-mail a LinkedIn](/files/3vXqbkmXOiyS3IMh2Hps)

### Časté dotazy

**Odkud pocházejí kontaktní údaje?** Všechno jsou veřejné zdroje - firemní weby, obchodní rejstříky, profesní sítě a další veřejně dostupné zdroje. Žádná soukromá databáze.

**Jsou kontakty aktuální?** Data se průběžně aktualizují. U každého záznamu uvidíte datum poslední verifikace. U starších kontaktů si aktuálnost klidně ještě ověřte.

**Co když v dané firmě nikdo z hledané kategorie není?** Ve výsledcích se objeví jen osoby, které Prospector ve veřejných zdrojích skutečně nalezl. Pokud daná osoba svůj kontakt veřejně nezveřejňuje, prostě tam nebude - to není chyba v datech.

**Mohu vybrat více kategorií najednou?** Ano. Výběr více kategorií zobrazí osoby z kterékoli z nich.

**Jaký je rozdíl mezi kategorií role a přímým hledáním podle názvu pozice?** Kategorie pokrývá skupinu příbuzných pozic najednou. Přímé hledání podle názvu pozice zachytí jen přesnou shodu. Pro přehled rozhodovatelů napříč firmami doporučujeme kategorii - pro konkrétní roli jako "CTO" stačí vyhledat přímo.

### Viz také

* [Vyhledávání v Prospectoru: jak sestavit segment a pracovat s ním](/hledani-a-filtrovani/pokrocile-filtrovani)
* [Jak fungují kredity a limity v Prospectoru](/seznamy-a-export/limity-a-kredity)
* [Štítky jako workflow systém](/seznamy-a-export/stitky-workflow)


# Seznamy a export - úvod

Kategorizace rolí, export kontaktů a automatická upozornění na změny

Seznamy vám umožňují organizovat firmy do skupin, sdílet je s kolegy a exportovat data. Tady najdete průvodce pokročilejšími funkcemi.

## V této sekci

* [Jak fungují kredity a limity v Prospectoru](/seznamy-a-export/limity-a-kredity)
* [Export selhal nebo nepřišel email: co dělat](/seznamy-a-export/export-limity-a-troubleshooting)
* [Štítky jako workflow systém: průvodce prospektingem](/seznamy-a-export/stitky-workflow)
* [Jak vyloučit existující zákazníky a předejít duplicitám](/seznamy-a-export/vylouceni-zakazniku)


# Jak fungují kredity a limity v Prospectoru

Tři typy kreditů (firemní data, kontakty, AI Prioritizace), měsíční limity podle tarifu, denní strop zobrazení profilů a jak dokoupit kredity navíc.

*Aktualizováno: 30. července 2026*

## Jak fungují kredity a limity v Prospectoru

Prospector pracuje se třemi oddělenými kreditovými limity: **firemní data**, **kontakty** a **AI Prioritizace**. Každý má vlastní měsíční výši. Tento článek vysvětluje, co se do každého limitu počítá, jaké jsou hodnoty podle tarifu a co dělat, když vám kredity nestačí.

***

### Typy kreditů

#### Kredity na firemní data

Jeden kredit z tohoto limitu se spotřebuje při každém exportu firmy do XLS nebo při každém API volání pro firemní data. Kredity na firemní data jsou zaměnitelné: nezáleží, jestli je využijete na export nebo API.

| Akce                            | Počítá se?                  |
| ------------------------------- | --------------------------- |
| Procházení firem ve vyhledávání | Ne                          |
| Otevření profilu firmy          | Ne                          |
| Export firmy do XLS             | Ano, 1 firma = 1 kredit     |
| API volání pro firemní data     | Ano, 1 volání = 1 kredit    |
| Opakovaný export stejné firmy   | Ano, každý export se počítá |

#### Kredity na kontakty

Samostatný limit pro export osobních kontaktů (jméno, pozice, e-mail, telefon). Jeden exportovaný kontakt = jeden kredit z tohoto limitu.

| Akce                                | Počítá se?                  |
| ----------------------------------- | --------------------------- |
| Zobrazení kontaktů na profilu firmy | Ne                          |
| Export kontaktu (osoby) do XLS      | Ano, 1 kontakt = 1 kredit   |
| Opakovaný export stejného kontaktu  | Ano, každý export se počítá |

#### Kredity na AI Prioritizaci

AI Prioritizace má vlastní samostatný limit kreditů. Jeden kredit se spotřebuje za každou ohodnocenou firmu při spuštění prioritizace.

| Akce                               | Počítá se?                    |
| ---------------------------------- | ----------------------------- |
| Spuštění AI Prioritizace           | Ano, 1 firma = 1 kredit       |
| Prohlížení výsledků prioritizace   | Ne                            |
| Opakované spuštění na stejné firmy | Ano, každé spuštění se počítá |

Aktuální výši limitu a počet zbývajících kreditů vidíte přímo v dialogu při každém spouštění prioritizace.

***

### Kolik kreditů máte k dispozici

Celkové měsíční limity organizace podle tarifu:

|                                    | Essential | Pro     | Custom       |
| ---------------------------------- | --------- | ------- | ------------ |
| Exporty společností (export + API) | 10 000    | 100 000 | Individuálně |
| Exporty kontaktů                   | 500       | 3 000   | Individuálně |

*Hodnoty platné k červnu 2026.*

Tyto limity platí pro celou organizaci. Každý uživatel má nastavený vlastní individuální limit v rámci této hodnoty - nastavuje ho tým BizMachine podle požadavku klienta. Kolega ve stejném workspace má svůj limit, který na vás nezávisí.

***

### Denní limit zobrazení profilů

Otevírání profilů firem kredity nespotřebovává, ale existuje denní strop:

* **Essential:** 200 profilů za den na uživatele *(k dubnu 2026)*
* **Pro:** 300 profilů za den na uživatele *(k dubnu 2026)*
* **Custom:** individuálně

***

### Kde vidíte stav kreditů

Aktuální čerpání obou limitů najdete v sekci **Import / Export** v levém menu. Vidíte přehled **Exporty společností** a **Exporty kontaktů** zvlášť: kolik máte celkem, kolik jste vyčerpali a kolik zbývá. Platí pro exporty z posledních 180 dní.

![Historie exportů s přehledem limitů společností a kontaktů](/files/nO6M13aim1K6U2dbMmst)

***

### Kdy se limity obnovují

Oba limity se obnovují vždy **1. dne v měsíci** na plnou hodnotu. Nevyčerpané kredity z předchozího měsíce nepřecházejí.

***

### Tip: nejdřív filtrujte, pak exportujte

Kredity se spotřebují až při exportu, ne při procházení výsledků. Před exportem si proto výsledky zúžte pomocí filtrů, zkontrolujte je a exportujte jen to, co opravdu potřebujete.

Příklad: máte 500 výsledků, ale potřebujete jen firmy z Prahy s obratem nad 50 mil. Kč. Přidejte filtry, zúžte na 40 firem, pak exportujte. Spotřebujete 40 kreditů místo 500.

***

### Jak si označit exportované firmy

Před exportem si firmy uložte do štítku, například `Exportováno 2026-05`. Budete přesně vědět, co jste kdy stahovali, a při příštím hledání tento štítek nastavíte jako vylučovací filtr.

Pokud budete potřebovat stejný seznam znovu, importujte štítek zpět do Prospectoru přes **Import / Export → Nový import** a seznam máte k dispozici, aniž byste museli znovu hledat.

Podrobněji o práci se štítky: [Štítky jako workflow systém](/seznamy-a-export/stitky-workflow).

***

### Jak dokoupit kredity navíc

Ke svému tarifu si můžete přikoupit další kredity na firemní data i kontakty. Napište nám na <support@bizmachine.com> a přikoupení vyřídíme.

***

### Časté otázky

**Jsou limity na firemní data a kontakty oddělené?** Ano, každý limit se čerpá nezávisle.

**Mohu firemní kredity použít na API i export?** Ano, kredity na firemní data jsou zaměnitelné: platí pro export i API volání.

**Počítá se kredit, i když stejnou firmu exportuji podruhé?** Ano, každý export se počítá samostatně bez ohledu na předchozí stahování.

**Co se stane, když kredity vyčerpám?** Další export z daného limitu nebude možný, dokud se limity neobnoví. Procházet firmy a pracovat ve vyhledávání můžete i nadále.

**Mohu nevyčerpané kredity převést do dalšího měsíce?** Ne. Limity se obnoví vždy 1. v měsíci na plnou hodnotu a nevyčerpané kredity nepřecházejí.

**Kde vidím historii svých exportů?** V sekci Exporty v levém menu. Vidíte přehled všech provedených exportů včetně data a počtu záznamů.

***

### Související články

* [Export selhal nebo nepřišel email: co dělat](/seznamy-a-export/export-limity-a-troubleshooting)
* [Štítky jako workflow systém](/seznamy-a-export/stitky-workflow)


# Export selhal nebo nepřišel email: co dělat

Postup pro případ, kdy export kontaktů nebo firem selže, soubor nepřijde na email nebo dosáhnete měsíčního limitu. Konkrétní kroky troubleshootingu.

*Aktualizováno: 17. dubna 2026*

## Export selhal nebo nepřišel email: co dělat

Export v Prospectoru nefunguje ze dvou důvodů: vyčerpaný měsíční limit nebo technické selhání. Tento článek vás provede řešením obou scénářů krok za krokem.

***

### Dva důvody, proč export nefunguje

Než začnete hledat chybu, zjistěte, co se stalo:

1. **Dosáhli jste měsíčního limitu.** Prospector vám zobrazí upozornění přímo v aplikaci a export se nezahájí. Řešení: zkontrolujte stav limitu, případně požádejte o navýšení.
2. **Export se technicky nezdařil.** Soubor se nespustil nebo email s odkazem na stažení nedorazil. Řešení: zkontrolujte historii exportů a v případě potřeby kontaktujte podporu.

***

### Dosáhli jste limitu: co se stane a jak dál

#### Co uvidíte v aplikaci

Pokud jste vyčerpali měsíční limit na firemní data nebo kontakty, Prospector vám zobrazí upozornění při pokusu o export. Export se znovu rozběhne, až se limity obnoví nebo si přikoupíte další kredity.

Limity se obnovují vždy **1. dne v měsíci**. Nevyčerpané kredity nepřecházejí do dalšího měsíce.

#### Jak zkontrolovat aktuální stav limitu

Nejrychlejší způsob: stav limitu vidíte přímo v exportním dialogu. Při spuštění exportu se zobrazí řádek **Měsíční limit exportů** s aktuálním čerpáním, například 10 000/10 000 (k dubnu 2026).

![Exportní dialog s přehledem měsíčního limitu](/files/NRX74lgQBGxNQwtFRvaS)

Podrobnější přehled najdete v sekci **Import / Export** v levém menu, záložka **Historie exportů**. Vidíte přehled **Exporty společností** a **Exporty kontaktů** zvlášť: celkový limit, počet vyčerpaných kreditů a zbývající zůstatek. Stav se vztahuje na exporty z posledních 180 dní.

Podrobnosti o tom, co se do limitu počítá, najdete v článku [Jak fungují kredity a limity v Prospectoru](/seznamy-a-export/limity-a-kredity).

#### Jak požádat o navýšení limitu

Ke svému tarifu si můžete přikoupit další kredity. Napište na <support@bizmachine.com> a uveďte:

* název organizace,
* o kolik kreditů máte zájem (firemní data, kontakty, nebo obojí),
* ideálně i důvod navýšení (pomůže nám rychleji reagovat).

***

### Export se technicky nezdařil: postup krok za krokem

Pokud jste měli dost kreditů, ale soubor se přesto nestáhl nebo email nedorazil, projděte si tyto kroky:

#### 1. Zkontrolujte historii exportů

V sekci **Import / Export** v levém menu otevřete záložku **Historie exportů**. Vidíte všechny provedené exporty včetně stavu. Pokud export proběhl, stav bude **OK** (zelený). Soubor stáhnete kliknutím na ikonu šipky dolů v daném řádku, aniž byste spotřebovali další kredity.

![Historie exportů s tlačítkem pro stažení a přehledem limitů](/files/wu0P5rBcERNtTPxpe02y)

#### 2. Email nepřišel: zkontrolujte spam

Email s odkazem na stažení chodí z adresy Prospectoru. Zkontrolujte složku Spam nebo Hromadné. Pokud email nenajdete ani tam, pokračujte na krok 3.

> **Tip:** Způsob doručení si volíte při spuštění exportu. Pokud chcete příště soubor stáhnout přímo bez emailu, zvolte možnost **Stáhnout z 'Historie exportů'**.
>
> <img src="/files/POFdW3Xr4MKNXmAmAjWO" alt="Volba způsobu exportu: stažení z historie nebo email" data-size="original">

#### 3. Stáhněte soubor přímo z aplikace

Na email nemusíte čekat. Soubor je dostupný přímo v historii exportů. V sekci **Import / Export** otevřete záložku **Historie exportů**, najděte export ve stavu **OK** a klikněte na ikonu šipky dolů v daném řádku.

#### 4. Export se nezobrazuje nebo je stále ve stavu "Zpracovává se"

Toto je nejčastější příčina, proč si zákazníci myslí, že export selhal. Stránka Historie exportů se **neaktualizuje automaticky** - export může být hotový, ale vy ho nevidíte, dokud stránku ručně neobnovíte.

**Postup:**

1. Počkejte 1-2 minuty od spuštění exportu.
2. Stiskněte **F5** nebo tlačítko Obnovit v prohlížeči.
3. Stav exportu by se měl změnit na **OK** (zelený) a soubor bude připravený ke stažení.

Při větším počtu výsledků (stovky nebo tisíce firem) může generování trvat i několik minut. Pokud export zůstává ve stavu **Zpracovává se** i po 10 minutách a opakovaném obnovení stránky, přejděte na krok 5.

#### 5. Problém přetrvává: kontaktujte podporu

Pokud export stále nefunguje, napište na <support@bizmachine.com>. Uveďte přibližnou dobu, kdy jste export spustili, a co jste exportovali (firmy nebo kontakty). Pomůže nám to rychleji najít příčinu.

***

### Tipy, jak předejít vyčerpání limitu

Kredity se spotřebují až při exportu, ne při procházení výsledků. Před spuštěním exportu:

* Pomocí filtrů si zúžte výběr na to, co skutečně potřebujete.
* Zkontrolujte počet výsledků před exportem.
* Exportujte po menších dávkách, pokud nepotřebujete vše najednou.

Příklad: místo exportu 500 firem přidejte filtry (kraj, obrat, obor), zúžte na 40 firem a exportujte jen ty. Spotřebujete 40 kreditů místo 500.

***

### Časté otázky

**Počítá se kredit, i když export selže?** Ne. Kredit se odečte pouze z úspěšně dokončeného exportu. Pokud export technicky selhal, limit se nečerpá.

**Mohu stáhnout stejný export víckrát?** Ano. Opakované stažení ze sekce Historie exportů žádné kredity nestrhuje. Platí to pro exporty dostupné v historii (posledních 180 dní).

**Jak dlouho trvá, než export dorazí na email?** Obvykle do pár minut. Při větším počtu výsledků může generování trvat déle. Soubor je mezitím dostupný v historii exportů.

**Export mi chodil dřív, teď ne. Co se změnilo?** Nejpravděpodobnější příčiny: vyčerpaný měsíční limit nebo email zachycený spamovým filtrem. Zkontrolujte stav limitu v sekci Import / Export a složku Spam.

**Jaký je rozdíl mezi exportem společností a exportem kontaktů?** Export společností obsahuje obecné firemní kontakty: telefon na recepci, email ve tvaru <info@firma.cz> a podobně. Pokud potřebujete přímé kontakty na konkrétní osoby (jméno, pozice, přímý email nebo telefon rozhodovatele), vyhledejte je přes filtr Kategorie rolí. Jak na to popisuje článek [Vyhledávání kontaktů podle rolí](/hledani-a-filtrovani/kategorizace-roli-export).

***

### Související články

* [Jak fungují kredity a limity v Prospectoru](/seznamy-a-export/limity-a-kredity)
* [Vyhledávání kontaktů podle rolí](/hledani-a-filtrovani/kategorizace-roli-export)


# Štítky jako workflow systém: průvodce prospektingem

Jak používat štítky v Prospectoru jako pipeline systém: naplnění štítku, konvence pojmenování, filtrování s vyloučením a správa životního cyklu.

*Aktualizováno: 17. dubna 2026*

## Štítky jako workflow systém: průvodce prospektingem

Štítky v Prospectoru slouží jako nástroj pro řízení celého oslovovacího cyklu: od prvního hledání přes oslovení až po zápis do CRM. Tady se dozvíte, jak štítky naplnit, jak je pojmenovat a jak je použít jako vylučovací filtry pro čisté hledání.

*Jak štítky technicky fungují (přidání, odebrání, sdílení) najdete přímo v Prospectoru přes nápovědu. Jak vyloučit existující zákazníky ze hledání popisuje* [*Jak vyloučit existující zákazníky a předejít duplicitám*](/seznamy-a-export/vylouceni-zakazniku)*.*

***

### Jak štítek naplnit

Než štítek začnete používat ve workflow, musíte ho naplnit firmami. Jsou tři způsoby podle toho, kde data máte.

![Seznam štítků v Prospectoru s příklady pipeline štítků](/files/1QlvB5aKnGphwJmN6iv9)

#### Z výsledků vyhledávání

Nejběžnější způsob. Otevřete Vyhledávání, sestavte dotaz, označte firmy (nebo vyberte všechny výsledky) a přes tlačítko **Štítky → Přidat** je přiřaďte do štítku. Nový štítek vytvoříte přímo v tomto dialogu.

![Výběr firem v hledání a tlačítko Štítky v dolní liště](/files/cRPhXPLN4Qm4bv0N2Elz)

Štítek je vždy statický výběr k okamžiku přidání. Zachytíte firmy, které splňují kritéria právě teď. Na rozdíl od segmentu se automaticky neaktualizuje. To se hodí pro konkrétní kampaň nebo vlnu oslovování: přesně víte, co jste kdy oslovali.

Vhodné pro: průběžné přidávání firem i jednorázové zmrazení výsledků pro kampaň.

#### Import ze souboru

Pokud máte existující seznam firem (export z CRM, Excel od kolegy, seznam z kampaně), nahrajte ho přímo do Prospectoru. V levém menu otevřete **Import / Export → Nový import**. Nahrajte soubor .csv nebo .xls (IČ v prvním sloupci prvního listu), nebo použijte záložku **Vložit data** a zadejte seznam IČ přímo do textového pole. Po dokončení importu klikněte na **+ Zkopírovat do štítku** a firmy přiřaďte do nového nebo existujícího štítku.

Vhodné pro: jednorázový import existujícího seznamu zákazníků, blacklistu nebo cílové skupiny.

{% hint style="info" %}
Import páruje firmy podle IČ. Při exportu z CRM ověřte, že soubor IČ obsahuje a že je v prvním sloupci prvního listu.
{% endhint %}

#### Z profilu konkrétní firmy

Na profilu libovolné firmy přidáte štítek přes ikonu **+** u sekce Štítky. Použijte, když narazíte na zajímavou firmu při procházení a chcete ji zařadit do pipeline.

Vhodné pro: ad hoc přidávání firem mimo hledání.

***

### Jak pojmenovat štítky: navrhovaná taxonomie

Konzistentní pojmenování štítků je základ, zvlášť v týmu, kde více obchodníků pracuje se sdílenými seznamy. Tady je navrhovaná taxonomie:

#### Štítky pro sledování fází oslovování

| Štítek       | Kdy přidat                                                |
| ------------ | --------------------------------------------------------- |
| `K zavolání` | Firma prošla segmentací, čeká na první kontakt            |
| `Osloveno`   | Proběhl první kontakt (hovor, email, LinkedIn)            |
| `Zájem`      | Firma reagovala pozitivně, pokračuje jednání              |
| `Bez zájmu`  | Odmítnutí nebo bez reakce po N pokusech                   |
| `V CRM`      | Zápis do CRM hotový, Prospector slouží jen pro monitoring |

#### Štítky pro správu seznamů

| Štítek                | K čemu slouží                                        |
| --------------------- | ---------------------------------------------------- |
| `Zákazníci`           | Stávající zákazníci - primárně jako vylučovací filtr |
| `Exportováno [datum]` | Označení vln exportu, např. `Exportováno 2026-03`    |

#### Koordinace v týmu

Někteří obchodníci používají štítek se svým jménem, například `Jana K.` nebo `Petr N.` Štítek nasdílí kolegům, kteří pak hned vidí, že o tuto firmu se už někdo zajímá, a nepřekrývají se.

Je to jednoduchá konvence bez nutnosti dalšího nastavení. Stačí se domluvit, že každý má svůj jmenný štítek a přidává do něj firmy, které aktivně oslovuje.

{% hint style="info" %}
Dohodněte se na taxonomii jako tým a štítky sdílejte. Každý obchodník může mít vlastní soukromé štítky, ale fáze pipeline by měly být sdílené. Jinak se koordinace rozpadá. Sdílení štítků se nastavuje přes menu **⋮** u názvu štítku.
{% endhint %}

***

### End-to-end workflow: od segmentu po CRM

Takhle může vypadat celý cyklus jedné prospektingové vlny:

**1. Sestavte segment** Ve Vyhledávání definujte cílovou skupinu. Uložte jako segment pro opakované použití.

**2. Označte firmy k oslovení** Z výsledků segmentu vyberte firmy (nebo celou stránku) a přidejte štítek `K zavolání`. Štítek teď slouží jako váš pracovní seznam.

**3. Pracujte ze štítku** Otevřete štítek `K zavolání`. Procházejte firmy jednu po druhé. Po každém kontaktu přesuňte firmu: odeberete `K zavolání` a přidáte `Osloveno`, `Zájem` nebo `Bez zájmu`.

**4. Exportujte do CRM** Firmy se zájmem exportujte nebo přesuňte do CRM. Označte je štítkem `V CRM` pro případ, že je budete v Prospectoru dál sledovat (signály, změny managementu). Pokud máte nastavenou přímou integraci, přesun probíhá automaticky, viz [CRM integrace](/api-a-integrace/crm-integrace).

**5. Příští vlna** Spusťte segment znovu. Nové firmy, které mezitím přibyly, přidejte do `K zavolání`. Firmy z předchozích vln jsou označené, vylučovací filtr je automaticky odfiltruje.

***

### Jak použít štítky jako vylučovací filtry

Tohle je jeden z nejužitečnějších způsobů, jak štítky použít: odfiltrovat ze hledání firmy, které už nechcete oslovovat.

Ve Vyhledávání přidejte filtr **Moje štítky (vyloučit)** a vyberte štítek. Výsledky pak automaticky vynechají všechny firmy v tomto štítku.

Typická použití:

* **Vyloučení stávajících zákazníků:** naplňte štítek `Zákazníci` importem z CRM, pak ho vylučujte ze všech nových hledání
* **Vyloučení dříve oslovených firem:** štítek `Osloveno` jako vylučovací filtr při příští kampani
* **Koordinace v týmu:** pokud každý obchodník přidává firmy do sdíleného štítku `V pipeline`, ostatní je automaticky přeskočí

Podrobný postup pro import zákaznického seznamu a nastavení vylučovacího filtru najdete v článku [Jak vyloučit existující zákazníky a předejít duplicitám](/seznamy-a-export/vylouceni-zakazniku).

***

### Jak udržet štítky přehledné

Štítky se časem hromadí. Pár pravidel, jak udržet přehled:

* **Staré vlny nemusíte mazat.** Štítek `Exportováno 2026-03` je užitečná historická vrstva. Stačí ho přejmenovat tak, aby bylo jasné, že už není aktivní, například přidejte prefix `_` nebo datum.
* **Čistěte `K zavolání` pravidelně.** Firmy, u kterých jste se nerozhodli po 30-60 dnech, přesuňte do `Bez zájmu` nebo odstraňte. Přeplněný štítek ztrácí smysl.
* **Revize sdílených štítků.** Jednou za čtvrtletí projděte sdílené štítky s týmem. Sjednoťte pojmenování, odstraňte duplicity.
* **Nepoužívejte štítky jako historický záznam.** Pro dlouhodobé sledování firem (zákazníci, klíčové účty) jsou štítky vhodné. Pro historii všech oslovení v posledních 2 letech spíš ne. To patří do CRM.

***

### Časté otázky

**Jak se liší štítek od segmentu?** Štítek je statický výběr firem v okamžiku přidání. Segment se automaticky aktualizuje, když nové firmy splní vaše kritéria.

**Vidí moje štítky kolegové?** Jen pokud je nasdílíte. Sdílení nastavíte přes menu ⋮ u názvu štítku.

**Může být firma ve více štítcích najednou?** Ano, firma může mít libovolný počet štítků.

**Kolik štítků celkem mohu mít?** Každý uživatel může mít až 100 štítků (k dubnu 2026).

**Co se stane, když štítek smažu?** Firmám zmizí pouze štítek, žádná data se neztratí. Pokud jste štítek použili jako filtr v segmentu, budete muset segment aktualizovat.

**Počet firem ve štítku se změnil, proč?** Prospector zobrazuje pouze platné společnosti. Pokud se počet snížil, některé firmy ze štítku pravděpodobně ukončily činnost nebo zanikly.


# Jak vyloučit existující zákazníky a předejít duplicitám

Jak importovat zákaznický seznam do Prospectoru, nastavit vylučovací filtr a zajistit, aby váš tým neoslovoval firmy, které už máte v CRM.

*Aktualizováno: 17. dubna 2026*

## Jak vyloučit existující zákazníky a předejít duplicitám

Pokud hledáte nové firmy k oslovení, nechcete ve výsledcích vidět ty, které už máte v CRM. Tento článek ukazuje, jak zákaznický seznam dostat do Prospectoru a nastavit filtr, který je ze hledání automaticky odstraní.

*Obecný přehled práce se štítky a workflow prospektingu najdete v* [*Štítky jako workflow systém*](/seznamy-a-export/stitky-workflow)*. Filtr Moje štítky (vyloučit) je součástí Vyhledávání, viz* [*Vyhledávání v Prospectoru*](/hledani-a-filtrovani/pokrocile-filtrovani)*.*

***

### Jak vyloučení zákazníků ze hledání funguje

Zákazníky označíte štítkem (například `Zákazníci`) a ve Vyhledávání použijete filtr **Moje štítky (vyloučit)**. Prospector pak z výsledků všechny firmy v tomto štítku automaticky vynechá.

Štítek naplníte jedním ze dvou způsobů: ručním importem ze souboru nebo automaticky přes CRM integraci.

***

### Ruční import: zákazníci bez CRM integrace

Pokud nemáte nastavenou přímou CRM integraci, stačí zákaznický seznam naimportovat ze souboru.

**1. Exportujte zákazníky z CRM**

Z vašeho CRM stáhněte seznam firem, které nechcete oslovovat. Soubor musí obsahovat **IČ** - podle nich Prospector firmy páruje.

**2. Importujte seznam do Prospectoru**

V levém menu otevřete **Import / Export** a klikněte na **Nový import**. Máte dvě možnosti:

* **Nahrát soubory**: nahrajte soubor .csv nebo .xls. IČ musí být v prvním sloupci prvního listu.
* **Vložit data**: vložte seznam IČ přímo do textového pole, jednotlivé položky oddělte oddělovačem.

![Levé menu s rozbalenými možnostmi Import / Export](/files/XVW74qvbb0tPZ7guieDm)

Po dokončení importu uvidíte počet importovaných záznamů.

**3. Zkopírujte výsledek do štítku**

![Výsledek importu s tlačítkem + Zkopírovat do štítku](/files/UNFrA0UrRlnV9xAFJP0V)

V okně s výsledkem importu klikněte na **+ Zkopírovat do štítku** a vytvořte nový štítek, doporučujeme název `Zákazníci` nebo `Klienti`. Všechny importované firmy se přiřadí do tohoto štítku.

**4. Nastavte vylučovací filtr**

Ve Vyhledávání přidejte filtr **Moje štítky (vyloučit)** a vyberte štítek `Zákazníci`. Od teď výsledky zákazníky automaticky vynechají.

{% hint style="info" %}
Zákaznická základna se mění. Opakujte import pravidelně, třeba jednou měsíčně, aby byl štítek aktuální. Stávající firmy v štítku zůstanou, přibudou jen nové.
{% endhint %}

***

### Automatické vyloučení přes CRM integraci

Pokud máte nastavenou integraci s CRM, zákazníci se do Prospectoru propisují automaticky a ruční import odpadá.

#### Pipedrive

Firmy evidované v Pipedrive dostávají v Prospectoru automaticky štítek **`In Pipedrive`**. Stačí ho nastavit jako vylučovací filtr a Prospector bude vždy pracovat jen s firmami, které v Pipedrive nemáte.

Ve Vyhledávání: filtr **Moje štítky (vyloučit)** → `In Pipedrive`.

#### Raynet

Přímá integrace s Raynetem synchronizuje firemní data obousměrně. Zákazníci z Raynetu se v Prospectoru označí příslušným štítkem. Postup nastavení najdete v dokumentaci Raynetu.

#### Ostatní CRM (HubSpot, Salesforce a další)

Přes Make.com nebo API můžete nastavit, aby se firmám z vašeho CRM štítek přiřazoval automaticky. Ozvěte se integračnímu týmu BizMachine, nastavení vyřešíme společně.

Přehled všech integračních možností: [CRM integrace](/api-a-integrace/crm-integrace).

***

### Koordinace v týmu: jak předejít překryvu obchodníků

I po vyloučení zákazníků se může stát, že dva obchodníci osloví stejnou firmu. Jeden ji má v pipeline, druhý to neví. Řešení jsou sdílené štítky.

**Sdílený štítek pro aktivní pipeline**

Každý obchodník přidává firmy, které aktivně oslovuje, do sdíleného štítku `V pipeline`. Ostatní tento štítek nastaví jako vylučovací filtr a firmy kolegů automaticky přeskočí.

**Jmenné štítky**

Alternativa pro menší týmy: každý obchodník má štítek se svým jménem (např. `Jana K.`), který nasdílí ostatním. Kdokoli na firmu narazí, hned vidí, že ji má kolega v práci.

Oba přístupy jsou podrobněji popsány v [Štítky jako workflow systém](/seznamy-a-export/stitky-workflow).

***

### Shrnutí: doporučený postup

1. Exportujte zákazníky z CRM do souboru .csv nebo .xls s IČ v prvním sloupci
2. Importujte do Prospectoru jako štítek `Zákazníci`
3. Ve Vyhledávání nastavte filtr **Moje štítky (vyloučit) → Zákazníci**
4. Pro týmovou koordinaci přidejte sdílený štítek `V pipeline`
5. Zákaznický štítek aktualizujte pravidelně (nebo řešte přes CRM integraci)

***

### Časté otázky

**Musím zákaznický seznam importovat znovu po každé aktualizaci?** Ano, doporučujeme jednou měsíčně. Stávající firmy v štítku zůstanou, přibudou jen nové.

**Mám Pipedrive - musím ručně importovat zákazníky?** Ne. Firmy z Pipedrive dostávají automaticky štítek `In Pipedrive`. Stačí ho nastavit jako vylučovací filtr ve Vyhledávání.

**Funguje vylučovací filtr i pro kolegy v týmu?** Ano, pokud použijete sdílený štítek. Každý člen týmu pak nastaví filtr na stejný štítek a výsledky se vyloučí pro všechny.

**Co se stane, když stejnou firmu importuji znovu?** Nic, Prospector duplicitu ignoruje. Firma v štítku zůstane jednou.

**Počet ID se liší od Importováno, proč?** Import obsahoval neplatná IČ nebo se nám je nepodařilo identifikovat. Případně soubor obsahuje duplicity. Pro podrobnou kontrolu klikněte na **Stáhnout stav importu** v okně výsledku.


# Pokročilé funkce - úvod

Vozidla, AI Prioritizace, sledování firem a export kontaktů

Nástroje pro aktivní práci s daty - sledování signálů, AI Prioritizace firem, práce s vozidly a export kontaktů s kategorizací rolí.

## V této sekci

* [Detailní profil vozidel](/pokrocile-funkce/detailni-profil-vozidel)
* [Sledování firem: signály a automatická upozornění](/pokrocile-funkce/firemni-signaly-a-upozorneni)
* [AI Prioritizace](/pokrocile-funkce/ai-prioritizace)
* [Jak napsat nabídku pro AI Prioritizaci](/pokrocile-funkce/ai-prioritizace-tipy)
* [Jak často data o firmách aktualizujete?](/pokrocile-funkce/aktualizace-dat)
* [Vyhledávání kontaktů podle rolí](/hledani-a-filtrovani/kategorizace-roli-export)


# Detailní profil vozidel

*Aktualizováno: 24. března 2026*

## Detailní profil vozidel

> Zobrazte si provozní historii specifického vozidla

### **Do Prospectoru jsme pro vás nově přidali detailní profil vozidel, který vám pomůže:**

* Zjistit aktuální stav a aktuálního firemního provozovatele a majitele + detailní technické

  parametry ke konkrétnímu vozidlu přes VIN - např. pro nabídku servisu novému

  provozovateli.
* Zjistit, kam konkrétní zkoumaná společnost prodává svá vozidla pro vlastní budoucí

  nabídku výkupu.
* Zjistit, od koho zkoumaná společnost ojetá či zánovní vozidla naopak nakupuje pro budoucí

  nabídku ojetin či zánovních vozidel.
* Objevit běžnou délku financování vozidel pro plánování vlastního oslovení společnosti při

  výročí financování.
* Objevit přeprodejce vozidel, který vozidla v krátké periodě přeprodává na další subjekt v ČR

  nebo rovnou exportuje do zahraničí.

### Příklad detailního profilu:

![](/files/3tiUJgzJrd39o7t5RV1I)

### Pro koho bude profil vozidla užitečný?

● Prodejce nových vozidel dealerství

● Prodejce ojetin dealerství či autobazaru

● Výkupčí autobazaru

● Zástupce oficiálního zastoupení značky (importér)

● Obchodník v leasingové společnosti

● Prodejce ojetin po operativním leasingu v leasingové společnosti

### Kde v Prospectoru najdete profil vozidla?

Na profil vozidla se uživatel dostane dvěma způsoby.

1. Vyhledáním VIN kódu v hlavním vyhledávacím poli

![](/files/PeprKlToAvKPBorTriYY)

2. kliknutím na VIN kód v seznamu vozidel na profilu firmy

![](/files/vOMjXedqUvrJsdhXD7RO)

Nezobrazují se Vám tyto možnosti? Dejte nám vědět na <support@bizmachine.com> nebo pomocí chatu přímo v Prospectoru.


# Sledování firem: signály a automatická upozornění

Jak fungují firemní signály v Prospectoru, kde je najdete a jak nastavit automatická e-mailová upozornění na změny u sledovaných firem.

*Aktualizováno: 30. července 2026*

## Sledování firem: signály a automatická upozornění

Firemní signály jsou automaticky zachycené změny a události u firem v databázi Prospectoru. Umožňují sledovat aktuální dění u stávajících zákazníků i potenciálních klientů - a reagovat na obchodní příležitosti dříve než konkurence.

### Co jsou firemní signály

Prospector průběžně monitoruje přes **45 typů signálů**, které zachycují klíčové změny u firem:

* Nové nebo ukončené pracovní inzeráty
* Nové nebo ukončené tendry (veřejné zakázky)
* Změny ve vedení - příchod nebo odchod jednatele, prokuristy
* Nové pobočky nebo změna adresy
* Mediální zmínky
* Zveřejnění finančních výkazů

{% hint style="info" %}
Kategorie signálů se průběžně rozšiřují.
{% endhint %}

### Kde signály najdete

#### Na profilu firmy

Na každém firemním profilu je záložka **Signály** s chronologickým přehledem zachycených změn. Přehled zahrnuje vše od nových pracovních inzerátů po změny v kapitálové struktuře.

![Záložka Signály na profilu firmy](/files/Ju810tW3cUOHgB3nzouE)

#### Ve vyhledávání

V **pokročilém vyhledávání** najdete kategorii **Firemní signály** se třemi filtry:

| Filtr                    | Popis                                                  |
| ------------------------ | ------------------------------------------------------ |
| **Kategorie signálu**    | Výběr konkrétního typu změny                           |
| **Hledání slov v textu** | Prohledá celý text signálu, nejen název.               |
| **Stáří signálu**        | Jen signály ne starší než zvolený počet dní (max. 180) |

![Filtry Firemní signály v pokročilém vyhledávání](/files/DHHauGHnOkPfkYGCbaKG)

Výsledky se zobrazují na záložce **Signály** a lze je řadit podle:

* Velikosti firmy (výchozí)
* Důležitosti signálu
* Data zveřejnění

![Výsledky vyhledávání na záložce Signály](/files/0Vyg0IbRRqEbdKYPRcRr)

{% hint style="success" %}
**Příklad:** Chcete oslovit firmy, kde se změnil někdo v marketingovém vedení? Nastavte kategorii „Změna managementu" a do textového vyhledávání napište „marketing". Dostanete firmy s čerstvou personální změnou na marketingové pozici.
{% endhint %}

### Automatická upozornění

Namísto ručního procházení Prospectoru si nastavíte sledování jednou a všechny důležité změny vám pak přijdou přímo do e-mailové schránky.

#### Dva typy upozornění

Na každém uloženém **segmentu** lze nastavit:

**1. Upozornění na nové firmy** Systém vás informuje, když do segmentu přibude firma, která dosud nesplňovala vaše filtry.

**2. Upozornění na firemní signály** Systém vás informuje, když se u firem ve sledovaném segmentu objeví specifický typ signálu - například nový tendr nebo změna jednatele.

{% hint style="info" %}
Notifikace aktivujete přes **Akce** v pravém horním rohu při zobrazení segmentu.
{% endhint %}

#### Frekvence doručování

| Frekvence | Kdy                 |
| --------- | ------------------- |
| **Denně** | Dopoledne každý den |
| **Týdně** | Každé pondělí       |

Každý e-mail obsahuje přehled prvních tří změn a přímý odkaz na detail v Prospectoru.

![Ukázka e-mailového upozornění](/files/WoKAsAQF5o1AQXQP1qpD)

### Jak nastavit upozornění

#### Upozornění na segmentu

1. V pokročilém vyhledávání nastavte filtry pro vaši cílovou skupinu.
2. Uložte výsledky jako **segment**.
3. V pravém horním rohu klikněte na **Akce** → **Nastavit upozornění**.
4. Zvolte typ upozornění - nové firmy, signály, nebo obojí.
5. Nastavte frekvenci - denně nebo týdně.

![Nastavení upozornění na segmentu - krok 1](/files/FvkTZHgJzaA03Em132cX)

![Nastavení upozornění na segmentu - krok 2](/files/r4s6Yf4yhShkoSEkdwGH)

#### Sledování konkrétních firem

* Na **profilu firmy** zapněte sledování signálů přímo na stránce.
* V rámci **štítku** nastavte sledování pro celý seznam firem najednou.

### Kdy upozornění využít

* **Nové obchodní příležitosti** - okamžitě víte o firmě, která nově splňuje vaše kritéria.
* **Sledování konkurence** - zachytíte personální nebo organizační změny.
* **Péče o klíčové klienty** - dostanete přehled každé důležité změny u firem ve vašem portfoliu.
* **Prioritizace práce** - místo ručního procházení přijdou relevantní podněty přímo k vám.

{% hint style="success" %}
**Příklad:** Prodáváte HR software. Vytvoříte segment výrobních firem s 50+ zaměstnanci, které aktuálně hledají HR specialistu. Nastavíte týdenní upozornění. Každé pondělí přijde e-mail s firmami, které nově začaly nabírat na HR pozici - a vy je oslovíte ve správný moment.
{% endhint %}


# AI Prioritizace

AI agent vyhodnotí firmy ve vašem segmentu podle vaší nabídky a přidělí jim skóre 0-100.

*Aktualizováno: 6. srpna 2026*

## AI Prioritizace

AI agent v Prospectoru vyhodnotí firmy ve vašem segmentu nebo štítku a přidělí každé skóre 0-100 podle toho, jak dobře odpovídá vaší nabídce. Výsledky si můžete seřadit, filtrovat a použít třeba při plánování obchodních aktivit.

### Kdy AI prioritizaci využijete

**Prioritizace velkého segmentu.** Máte segment tisíců firem a potřebujete vědět, kde začít. Agent vám ukáže, které firmy mají největší potenciál pro vaši nabídku.

**Porovnání více produktů.** Prodáváte několik produktů nebo služeb? Pro každý z nich si vytvořte samostatnou nabídku. Pro každý produkt uvidíte samostatné skóre. Snadno porovnáte, co se ke které firmě hodí.

**Příprava na schůzku.** U každé firmy si rozklikněte detail skóre. Uvidíte zdůvodnění, proč agent firmu hodnotí právě takto. Tyto informace využijete při přípravě na obchodní jednání.

### Jak spustit prioritizaci

#### 1. Připravte si seznam firem

Vytvořte segment pomocí filtrů nebo uložte firmy pod štítek. AI prioritizaci spustíte na segmentu nebo štítku.

#### 2. Klikněte na „Spustit AI Prioritizaci"

Tlačítko najdete v horní liště nad výsledky, vedle tlačítka Export.

<div data-with-frame="true"><figure><img src="/files/FxzQqf3gIoWFt2Y922K3" alt="Tlačítko Prioritizovat s AI v horní liště nad výsledky"><figcaption></figcaption></figure></div>

#### 3. Vyberte nebo vytvořte nabídku

Vyberte existující nabídku, nebo vytvořte novou. Nabídka popisuje váš produkt a ideálního zákazníka.

Při vytváření nové nabídky nastavte také viditelnost. Výchozí nastavení je **Pouze já** - nabídku uvidíte jen vy. Pokud ji chcete sdílet s celým týmem, přepněte viditelnost na **Všichni v mé organizaci**.

Jak napsat dobrou nabídku se dozvíte v článku [Jak napsat nabídku pro AI Prioritizaci](/pokrocile-funkce/ai-prioritizace-tipy).

<figure><img src="/files/ypnTzyKcWKnB3zQ55xN1" alt="Dialog pro výběr nebo vytvoření nabídky pro AI Prioritizaci"><figcaption></figcaption></figure>

#### 4. Zvolte rozsah

Vyberte, kolik firem chcete skórovat:

* **Prvních 5** pro rychlý test a ladění nabídky
* **Všechny výsledky** pro celý segment
* **Vybrané firmy** pokud jste předem zaškrtli konkrétní řádky
* **Vlastní počet** pro libovolný rozsah

#### 5. Spusťte a vyčkejte

Klikněte na „Spustit AI Prioritizaci". Výpočet trvá několik minut podle počtu firem. Běžící výpočet uvidíte v centru úloh. Mezitím můžete v Prospectoru klidně pracovat na jiných úkolech.

#### 6. Prohlédněte si výsledky

Po dokončení se v tabulce objeví nový sloupec se skóre. Firmy se seřadí od nejvyššího skóre.

<figure><img src="/files/M7gPo6ezsqDPOKndvCS5" alt="Výsledky AI Prioritizace - tabulka s novým sloupcem skóre seřazeným od nejvyššího"><figcaption></figcaption></figure>

### Jak číst výsledky

Každá firma dostane skóre od 0 do 100. Čím vyšší číslo, tím lépe firma odpovídá vaší nabídce.

Klikněte na skóre u konkrétní firmy. Otevře se detail, kde uvidíte:

* **Celkové skóre** a jeho vizuální zobrazení
* **Zdůvodnění po jednotlivých dimenzích**, například shoda odvětví, technická potřeba, finanční kondice nebo růstová dynamika
* **Textové vysvětlení**, proč agent firmu hodnotí právě takto

<figure><img src="/files/AfpaECUiT75LKvDzX415" alt="Detail skóre firmy s vysvětlením po jednotlivých dimenzích"><figcaption></figcaption></figure>

Každá dimenze má vlastní popis. Díky tomu přesně vidíte, co agent vzal v úvahu a kde firma vyniká nebo zaostává.

### Filtrování podle Prioritizace

Po dokončení se AI Prioritizace automaticky objeví jako filtrační atribut v sekci „AI indikátory".

<figure><img src="/files/O3igacgMQDgE1eJ82BX9" alt="Filtrování podle AI Prioritizace v sekci AI indikátory"><figcaption></figcaption></figure>

Můžete:

* **Seřadit firmy** od nejvyššího po nejnižší skóre (nebo naopak)
* **Filtrovat podle rozsahu** skóre, například jen firmy s vysokým skóre
* **Kombinovat s dalšími filtry** a vytvořit cílený seznam pro konkrétní obchodní aktivitu

### S jakými daty agent pracuje

Agent při vyhodnocování pracuje s těmito daty o každé firmě:

* Popis činnosti, vlastní kategorie a klíčová slova
* Finanční ukazatele (obrat, zisk, počet zaměstnanců a detaily finančních výkazů)
* Počet poboček, e-shopů a provozoven a jejich hodnocení
* Otevřené pracovní pozice za posledních 180 dní
* Plný detail posledních 20 pracovních inzerátů
* Firemní signály za posledních 90 dní
* Nové osoby a role v týmu dle LinkedIn profilů za 180 dní
* Strukturu vlastníků a propojených firem
* Rozložení poboček podle regionů
* Technologie ve vybraných kategoriích (CRM, ERP, e-commerce a další)
* Souhrn registrací vozidel podle značek a typů vozidel po měsících

Agent tyto informace porovnává s popisem vaší nabídky a hodnotí, jak dobře firma odpovídá vašemu ideálnímu zákazníkovi.

{% hint style="info" %}
Chcete dosáhnout přesnějších výsledků? Přečtěte si [Jak napsat nabídku pro AI Prioritizaci](/pokrocile-funkce/ai-prioritizace-tipy).
{% endhint %}

### Jak získat data z AI Prioritizace?

* Export všech firem s AI Prioritizací do Excelu můžete získat přímo z tabulky společností kliknutím na tlačítko Export a dále Export AI Prioritizace.
* Pro jednotlivé firmy přes API endpoint `indicators`


# Jak napsat nabídku pro AI Prioritizaci

Tipy, jak popsat váš produkt a ideálního zákazníka, aby AI agent přesněji vyhodnotil firmy.

*Aktualizováno: 9. června 2026*

## Jak napsat nabídku pro AI Prioritizaci

Kvalita vaší nabídky přímo ovlivňuje přesnost prioritizace. Čím lépe popíšete svůj produkt a ideálního zákazníka, tím užitečnější výsledky dostanete.

### 3 části dobré nabídky

Nabídka pro AI agenta se skládá ze tří částí:

#### 1. Co prodáváte a jaký problém řešíte

Popište svůj produkt nebo službu. Zaměřte se na to, v čem je specifický a jaký problém zákazníkům řeší.

> *„Nabízíme software pro zákaznickou podporu na více kanálech. Umožňuje řešit zákaznické situace z jednoho místa, přes telefon, web chat i sociální sítě."*

#### 2. Kdo je váš ideální zákazník

Uveďte velikost firmy, odvětví, region a další podmínky, které by měl váš ideální zákazník splňovat.

> *„Středně velká česká firma v energeticky náročném odvětví, která má několik výrobních prostor po celé zemi."*

#### 3. Kdo naopak není dobrý kandidát

Vyjmenujte obory nebo typy firem, o kterých víte, že u nich neuspějete. Agent díky tomu sníží skóre firem, kde nemá smysl se snažit.

> *„Nechceme státní sektor ani firmy vlastněné ze zahraničí."*

<figure><img src="/files/daDkjxXTupvJ6pAmYLq7" alt="Formulář pro vytvoření nebo úpravu nabídky pro AI Prioritizaci"><figcaption></figcaption></figure>

### Příklady nabídek

#### Senzory pro monitorování tepla

> *„Nabízím senzory pro monitorování úniků tepla ve výrobních halách. Nejvíce je využijí firmy v prostředí, kde je stálá teplota provozu důležitá. Středně velká česká firma v energeticky náročném odvětví s několika výrobními prostory. Nechci státní sektor nebo firmy vlastněné ze zahraničí."*

#### Software pro zákaznickou podporu

> *„Jsme dodavatelem softwaru pro zákaznickou podporu na více kanálech. Nejlépe funguje ve firmách, které mají stovky až tisíce zákaznických případů za měsíc a potřebují routing mezi více support agentů. Typicky B2C nebo otevřený B2B trh. Produkty nejsou triviální, spíše software, elektronika, finanční nebo pojišťovací služby."*

#### Sales intelligence platforma

> *„Nabízíme sales intelligence platformu pro B2B obchodní týmy, které působí na velkém, dynamickém trhu s tisíci potenciálními zákazníky. Typicky firmy, které nepracují v pevných dodavatelských řetězcích, ale potřebují aktivně rozdělit trh na segmenty a určit priority."*

### Otestujte nejdřív na malém vzorku

Začněte s 5 až 10 firmami. Projděte si zdůvodnění u každé z nich a podívejte se, jestli agent bere v potaz to, co je pro vás důležité.

Pokud výsledky ještě neodpovídají vašim očekáváním:

1. **Upřesněte popis produktu.** Přidejte konkrétní detaily, které odliší váš produkt od obecné kategorie.
2. **Zpřesněte popis zákazníka.** Doplňte podmínky, které musí firma splňovat (velikost, odvětví, technologie).
3. **Rozšiřte vyloučení.** Přidejte obory nebo typy firem, kde víte, že neuspějete.

Až budete spokojeni s výsledky na malém vzorku, spusťte prioritizaci na celý segment.

{% hint style="info" %}
K nabídce se můžete kdykoli vrátit a upravit ji. Změna nabídky ale neaktualizuje skóre u firem, které už byly vyhodnoceny. Prioritizaci je třeba spustit znovu.
{% endhint %}

### Časté dotazy

#### Jak často se skóre aktualizuje?

Skóre se neaktualizuje automaticky. Spusťte AI Prioritizaci znovu, když se změní vaše nabídka nebo když chcete pracovat s aktuálnějšími daty. Doporučujeme to zejména pokud se vaše prioritizace opírá o rychle se měnící data (pracovní pozice, technologie, signály, změny v managementu).

#### Proč mají všechny firmy podobné skóre?

Vaše nabídka je pravděpodobně moc obecná. Když agent nedostane specifické podmínky, nedokáže firmy od sebe rozlišit. Přidejte konkrétnější popis produktu, zpřesněte profil ideálního zákazníka a doplňte vyloučení.

#### Čím se AI Prioritizace liší od filtrování?

Filtrování a AI Prioritizace se doplňují. Nejprve použijte filtry a zúžte seznam firem na dobře definovaný segment (odvětví, region, velikost, finanční výsledky). Pak spusťte AI Prioritizaci na tomto segmentu. Na menším a přesněji definovaném segmentu dosáhnete lepších výsledků a můžete snadněji ladit nabídku.

#### Jaké jsou limity?

Každý uživatel má vlastní měsíční limit kreditů. Aktuální stav vidíte přímo v dialogu při spouštění prioritizace. Možnosti navýšení zjistíte u svého obchodního zástupce.

#### Uvidí výsledky AI Prioritizace i kolegové?

Záleží na nastavení viditelnosti nabídky. Výchozí nastavení je **Pouze já** - nabídku a její výsledky uvidíte jen vy. Pokud chcete sdílet nabídku s celým týmem, přepněte viditelnost na **Všichni v mé organizaci** při vytváření nebo úpravě nabídky.

#### Můžu si výsledky exportovat?

Export výsledků zatím není k dispozici. Pracujeme na něm a plánujeme ho přidat v některé z příštích verzí.


# Jak často data o firmách aktualizujete?

*Aktualizováno: 13. února 2026*

## Jak často data o firmách aktualizujete?

Každý zdroj informací aktualizujeme na jiné bázi. Některá data aktualizujeme denně, další týdně nebo měsíčně. Pokud Vás zajímají konkrétní data, ozvěte se prosím našemu supportímu týmu.


# API a integrace - úvod

API endpointy, hromadné volání a CRM integrace

Propojte Prospector s vaším CRM nebo dalšími nástroji pomocí API. Tady najdete technickou dokumentaci a integrační průvodce.

## V této sekci

* [Přehled API endpointů](/api-a-integrace/api-endpointy)
  * [Endpoint metrics: přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics)
  * [Endpoint aggregated-data: profil firmy](/api-a-integrace/api-endpointy/endpoint-aggregated-data)
  * [Endpoint suggest: vyhledávání firem](/api-a-integrace/api-endpointy/endpoint-suggest)
  * [Endpoint contacts: kontakty na firmu a osoby](/api-a-integrace/api-endpointy/endpoint-contacts)
  * [Endpoint events: obchodní události firmy](/api-a-integrace/api-endpointy/endpoint-events)
  * [Endpoint eshops: e-shopy provozované firmou](/api-a-integrace/api-endpointy/endpoint-eshops)
* [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani)
* [CRM integrace](/api-a-integrace/crm-integrace) - Pipedrive, Salesforce, MS Dynamics, Raynet
* [Jak nastavit integraci Raynetu s Prospectorem](/api-a-integrace/raynet-integrace)
* [Jak nechat AI asistenta číst BizMachine nápovědu](/api-a-integrace/bizmachine-napoveda-ai)
* [Co je to integrační účet?](/api-a-integrace/integracni-ucet)
* [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice)
* [Jaké jsou moje API limity?](/api-a-integrace/api-limity)


# Přehled API endpointů

Orientační přehled BizMachine API endpointů - které verze použít, jak se liší typy volání a kde najít detailní specifikaci.

*Aktualizováno: 30. července 2026*

## Přehled API endpointů

Kompletní technická specifikace endpointů (parametry, formát odpovědí, příklady) je v [API dokumentaci](http://developers.bizmachine.com/). Tento článek vám pomůže se v endpointech rychle zorientovat - který použít, v jaké verzi a na co si dát pozor.

### Přehledová tabulka endpointů

BizMachine API obsahuje endpointy ve dvou verzích (v3 a v4). Ne každý endpoint je dostupný v obou verzích a některé se ve formátu odpovědi liší. Tabulka níže shrnuje doporučenou verzi pro každý endpoint.

| Endpoint                                                                   | Verze  | Typ volání   | Co vrací                                                                                     |
| -------------------------------------------------------------------------- | ------ | ------------ | -------------------------------------------------------------------------------------------- |
| [aggregated-data](/api-a-integrace/api-endpointy/endpoint-aggregated-data) | **v4** | jednofirmové | Základní info, kontakty, indikátory, NACE, souhrn metrik                                     |
| [metrics](/api-a-integrace/api-endpointy/endpoint-metrics)                 | **v3** | jednofirmové | 55 metrik s víceletými časovými řadami (finance, vozový park, zaměstnanci, veřejné zakázky)  |
| [suggest](/api-a-integrace/api-endpointy/endpoint-suggest)                 | **v4** | vyhledávání  | Vyhledání firmy podle názvu, IČO, DIČ nebo domény - vrátí IČO pro použití v dalších voláních |
| `owners`                                                                   | **v4** | jednofirmové | Vlastnická struktura s historií a podíly                                                     |
| `connected-companies`                                                      | **v3** | jednofirmové | Propojené firmy (mateřské, dceřiné, přes statutáry)                                          |
| `risks`                                                                    | **v4** | jednofirmové | Rizikové signály (insolvence, exekuce, daňové nedoplatky)                                    |
| [contacts](/api-a-integrace/api-endpointy/endpoint-contacts)               | **v4** | jednofirmové | Telefon, e-mail, web, LinkedIn profily klíčových osob                                        |
| `financials`                                                               | **v3** | kolekce      | Detailní účetní výkazy (rozvaha, výsledovka) po řádcích                                      |
| `vehicles`                                                                 | **v4** | kolekce      | Vozidla s vlastnickými řetězci, stránkováno po 250                                           |
| [events](/api-a-integrace/api-endpointy/endpoint-events)                   | **v3** | kolekce      | Firemní události (změny v rejstříku, podání)                                                 |
| `contracts`                                                                | **v3** | kolekce      | Veřejné zakázky z Registru smluv                                                             |
| `subsidies`                                                                | **v3** | kolekce      | Přijaté dotace                                                                               |
| `indicators`                                                               | **v3** | jednofirmové | Detailní BizMachine indikátory (aktivita, růst, dosažitelnost)                               |
| `statutories`                                                              | **v3** | kolekce      | Statutární zástupci (aktuální i historičtí)                                                  |
| `job-postings`                                                             | **v3** | kolekce      | Aktuální pracovní nabídky                                                                    |
| `locations`                                                                | **v3** | kolekce      | Provozovny a sídla                                                                           |
| `bank-accounts`                                                            | **v4** | jednofirmové | Registrované bankovní účty                                                                   |
| [eshops](/api-a-integrace/api-endpointy/endpoint-eshops)                   | **v3** | kolekce      | Informace o eshopech                                                                         |

> **Tip:** Endpoint `metrics` je pravděpodobně nejhodnotnější jednotlivý endpoint pro firemní analýzu - kombinuje finanční data, vozový park, zaměstnanost i veřejné zakázky v jednom volání s víceletou historií. Viz [Endpoint metrics - přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics).

> **Poznámka:** Tabulka pokrývá datové endpointy pro čtení firemních údajů. Kompletní seznam včetně endpointů pro správu štítků, vyhledávání a dalších operací najdete v [API dokumentaci](http://developers.bizmachine.com/).

### Dva typy volání

API rozlišuje dva vzory volání. Typ závisí na konkrétním endpointu:

#### Jednofirmové endpointy

IČO se předává přímo v URL cestě:

```
GET /{dataset}/v4/companies/{ico}/aggregated-data
GET /{dataset}/v3/companies/{ico}/metrics
```

#### Kolekční endpointy

IČO se předává jako query parametr. Výsledky mohou být stránkované:

```
GET /{dataset}/v3/events?Company.NationalIn={ico}
GET /{dataset}/v3/financials/reports?Company.NationalIn={ico}
```

> **Pozor, vozidla jsou výjimka:** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (například `cz-company-12345678`). Pokud použijete špatný parametr, API nevrátí chybu - vrátí nefiltrované výsledky. Podrobnosti v [API dokumentaci](http://developers.bizmachine.com/).

### Dostupné datové sady

BizMachine API pokrývá pět trhů. Dataset se předává přímo v URL:

| Dataset | Trh             |
| ------- | --------------- |
| `cz`    | Česká republika |
| `sk`    | Slovensko       |
| `hu`    | Maďarsko        |
| `pl`    | Polsko          |
| `de`    | Německo         |

> **Poznámka:** Šíře dostupných dat se mezi zeměmi liší. Nejbohatší datové pokrytí nabízíme pro Českou republiku a Slovensko.

### Jazyk odpovědí

Jazyk dat v odpovědích lze ovlivnit hlavičkou `Accept-Language`. Výchozí jazyk je angličtina.

| Hodnota | Jazyk                |
| ------- | -------------------- |
| `EN`    | Angličtina (výchozí) |
| `CS`    | Čeština              |
| `SK`    | Slovenština          |

### Autentizace

Každý API dotaz musí obsahovat hlavičku s vaším API klíčem:

```
X-Api-Key: {VÁŠ_API_KLÍČ}
```

Jak API klíč vygenerovat: [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice)

### Na co si dát pozor

Několik věcí, které při integraci ušetří čas:

* **v3 vs v4** - ne každý endpoint funguje v obou verzích. Tabulka výše ukazuje doporučenou verzi. Pokud endpoint ve zvolené verzi neexistuje, API vrátí `UnsupportedApiVersion`.
* **Stránkování** - kolekční endpointy vracejí max 250 záznamů na stránku. K dalším stránkám se dostanete parametrem `Offset` (ne `Page`). Viz [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani).
* **Neznámé parametry** - API tiše ignoruje neznámé query parametry a vrátí nefiltrované výsledky. Pokud dostáváte neočekávaně velký počet záznamů, zkontrolujte správnost názvů parametrů.
* **Metriky vs aggregated-data** - `aggregated-data` obsahuje souhrn \~25 metrik (poslední hodnoty). Samostatný endpoint `metrics` vrací 55 metrik s kompletní víceletou historií. Podrobnosti viz [Endpoint metrics - přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics).

### Další informace

* [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice)
* [Co je to integrační účet?](/api-a-integrace/integracni-ucet)
* [Jaké jsou moje API limity?](/api-a-integrace/api-limity)
* [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani)
* [Endpoint metrics - přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics)
* [Kompletní API dokumentace](http://developers.bizmachine.com/)


# Endpoint metrics - přehled metrik

Přehled endpointu metrics - 55 metrik s víceletou historií v jednom API volání. Finance, vozový park, zaměstnanost, veřejné zakázky a další.

*Aktualizováno: 30. července 2026*

## Endpoint metrics - přehled metrik

Endpoint `metrics` (`/{dataset}/v3/companies/{ico}/metrics`) vrací v jednom volání 55 metrik s víceletými časovými řadami. Pokrývá finanční výsledky, vozový park, zaměstnanost, veřejné zakázky, dotace i skupinové údaje.

Pro detailní specifikaci (parametry, autentizace, formát odpovědi) viz [API dokumentaci](http://developers.bizmachine.com/).

### Proč je tento endpoint důležitý

Endpoint `metrics` je nejkomplexnější zdroj dat o firmě v jednom API volání. Na rozdíl od ostatních endpointů, které vracejí jen aktuální stav, `metrics` obsahuje **historické časové řady** - typicky 5-8 let finančních dat, 14 měsíců pracovních nabídek nebo 11 let veřejných zakázek.

#### Metrics vs aggregated-data

Endpoint `aggregated-data` obsahuje souhrn přibližně 25 metrik, ale pouze **poslední známou hodnotu** pro každou metriku. Endpoint `metrics` je nadmnožina - vrací stejné metriky plus desítky dalších, a to včetně kompletní historie.

|                      | aggregated-data   | metrics                    |
| -------------------- | ----------------- | -------------------------- |
| Počet metrik         | \~25              | 55                         |
| Historické hodnoty   | ne (jen poslední) | ano (víceleté řady)        |
| Finanční trendy      | ne                | ano (až 8 let)             |
| Vozový park          | základní          | 14+ metrik s detailem      |
| Nábor a zaměstnanost | základní          | měsíční trendy (14 měsíců) |
| Veřejné zakázky      | ne                | roční řady (až 11 let)     |

> **Doporučení:** Pro jakoukoliv analýzu, kde potřebujete trendy nebo srovnání v čase, vždy použijte endpoint `metrics`.

### Přehled dostupných metrik

Níže je přehled metrik podle kategorie. Dostupnost konkrétních metrik závisí na firmě - ne každá firma má všechna data.

#### Finanční výsledky (až 8 let historie)

| Metrika             | Co obsahuje                                                         |
| ------------------- | ------------------------------------------------------------------- |
| `revenue`           | Tržby (přesná hodnota nebo pásmo, podle dostupnosti účetní závěrky) |
| `ebitda`            | EBITDA                                                              |
| `ebit`              | EBIT (mezinárodní definice - viz poznámka níže)                     |
| `netProfit`         | Čistý zisk                                                          |
| `assetsTotal`       | Celková aktiva                                                      |
| `costOfGoodsSold`   | Náklady na prodané zboží                                            |
| `personnelCost`     | Osobní náklady                                                      |
| `registeredCapital` | Základní kapitál                                                    |

#### Finanční poměrové ukazatele

| Metrika                 | Co obsahuje                           |
| ----------------------- | ------------------------------------- |
| `revenueGrowth`         | Meziroční růst tržeb                  |
| `ebitMargin`            | EBIT marže                            |
| `netProfitMargin`       | Marže čistého zisku                   |
| `capitalIntensityRatio` | Kapitálová náročnost (aktiva / tržby) |
| `valueAddedRatio`       | Podíl přidané hodnoty                 |
| `revenuePerEmployee`    | Tržby na zaměstnance                  |

#### Vozový park (14+ metrik)

| Metrika                            | Co obsahuje                                       |
| ---------------------------------- | ------------------------------------------------- |
| `vehiclesOperatedTotal`            | Celkový počet provozovaných vozidel               |
| `vehiclesOwnedTotal`               | Celkový počet vlastněných vozidel                 |
| `vehiclesOperatedPassenger`        | Provozované osobní automobily                     |
| `vehiclesOperatedUtility`          | Provozovaná užitková vozidla                      |
| `vehiclesOperatedElectric`         | Provozovaná elektrická vozidla                    |
| `vehiclesOperatedPremium`          | Provozovaná prémiová vozidla                      |
| `vehiclesRegistered12Months`       | Nově registrovaná vozidla za posledních 12 měsíců |
| `vehiclesRegistered12MonthsChange` | Meziroční změna registrací                        |
| `vehiclesTopBrand`                 | Nejčastější značka ve flotile                     |

> **Tip pro analýzu financování:** Rozdíl `vehiclesOperatedTotal` − `vehiclesOwnedTotal` indikuje počet vozidel na leasing nebo úvěr. Pokud firma provozuje 228 vozidel, ale vlastní jen 40, zbylých 188 je pravděpodobně financovaných.

#### Zaměstnanost

| Metrika                           | Co obsahuje                                    |
| --------------------------------- | ---------------------------------------------- |
| `employees`                       | Počet zaměstnanců (přesná hodnota nebo pásmo)  |
| `employees12MonthsAvgGrowth`      | Průměrný růst za 12 měsíců                     |
| `employees24MonthsAvgGrowth`      | Průměrný růst za 24 měsíců                     |
| `whiteCollar`                     | Podíl kancelářských pracovníků (0-1)           |
| `personnelMonthlyCostPerEmployee` | Průměrné měsíční osobní náklady na zaměstnance |

#### Nábor (14měsíční časová řada)

| Metrika                                | Co obsahuje                                       |
| -------------------------------------- | ------------------------------------------------- |
| `openJobCountCurrentTotal`             | Aktuální počet otevřených pozic                   |
| `openJobCount12MonthsAverage`          | Průměr za 12 měsíců                               |
| `openJobCountCurrentTo12MonthsAverage` | Poměr aktuální/průměr - ukazuje náborový momentum |
| `openJobCountMonthly`                  | Měsíční trend (14 období)                         |

> **Interpretace náborového momenta:** Poměr > 1.0 znamená, že firma nabírá rychleji než obvykle (růst). Poměr < 0.5 značí výrazné zpomalení náboru.

#### Veřejné zakázky (až 11 let historie)

| Metrika                               | Co obsahuje                           |
| ------------------------------------- | ------------------------------------- |
| `publicContractsSupplierLast12Months` | Objem zakázek za posledních 12 měsíců |
| `publicContractsSupplierYearly`       | Roční časová řada                     |

#### Dotace

| Metrika                          | Co obsahuje                 |
| -------------------------------- | --------------------------- |
| `subsidiesRecipientLast12Months` | Přijaté dotace za 12 měsíců |
| `subsidiesRecipientYearly`       | Roční časová řada           |

#### Skupina a vlastnictví

| Metrika                                 | Co obsahuje                       |
| --------------------------------------- | --------------------------------- |
| `connectedCompaniesCount`               | Počet propojených firem           |
| `connectedCompaniesAggregatedRevenues`  | Celkové tržby skupiny             |
| `connectedCompaniesAggregatedEmployees` | Celkový počet zaměstnanců skupiny |
| `foreignOwnershipShare`                 | Podíl zahraničního vlastnictví    |
| `privateOwnershipShare`                 | Podíl soukromého vlastnictví      |
| `publicOwnershipShare`                  | Podíl veřejného vlastnictví       |
| `ownerAge`                              | Věk vlastníka (fyzická osoba)     |

#### Ostatní

| Metrika                     | Co obsahuje                            |
| --------------------------- | -------------------------------------- |
| `isExporter`                | Příznak exportéra                      |
| `isImporter`                | Příznak importéra                      |
| `locationCount`             | Počet provozoven                       |
| `businessCardsCount`        | Počet záznamů v katalozích             |
| `eshopCount`                | Počet e-shopů                          |
| `riskCount`                 | Počet aktivních rizikových signálů     |
| `latestFinancialsAvailable` | Rok posledních dostupných účetních dat |

### Na co si dát pozor

#### EBIT - mezinárodní vs česká definice

Metrika `ebit` v tomto endpointu používá **mezinárodní definici**: čistý zisk + úrokové náklady + daň z příjmu. Čeští analytici ale obvykle pod "EBIT" rozumí **Provozní výsledek hospodaření (Provozní VH)**, který vylučuje celý finanční výsledek, nejen úroky.

U firem s významnými neúrokovými finančními položkami (kurzové rozdíly, meziodnikové půjčky, investiční výnosy) se tyto dvě hodnoty mohou výrazně lišit - někdy i s opačným znaménkem. Pokud potřebujete český Provozní VH, najdete ho v endpointu `financials` jako řádek výkazu.

#### Metriky nemusí být u každé firmy kompletní

Některé metriky se vztahují jen k určitým typům firem (vozový park, zemědělství). API vrací jen metriky, pro které má data - nepočítejte s tím, že každá firma bude mít všech 55 metrik.

#### Metrika `revenue` může mít dva typy

Pokud má firma zveřejněnou účetní závěrku, `revenue` obsahuje přesnou hodnotu. Pokud ne, obsahuje pouze odhad v pásmu (např. "10-25 mil. Kč"). Kód by měl počítat s oběma variantami.

### Často kladené dotazy

**Kolik API volání spotřebuji?** Jedno volání na jednu firmu - všech 55 metrik přijde v jedné odpovědi.

**Jak často se metriky aktualizují?** Záleží na datovém zdroji. Finanční data se aktualizují po zveřejnění účetních závěrek, údaje o vozovém parku a zaměstnancích průběžně. Viz [Jak často data aktualizujete?](/pokrocile-funkce/aktualizace-dat)

**Potřebuji ještě endpoint aggregated-data?** Ano - `aggregated-data` obsahuje základní informace o firmě (název, IČO, NACE, kontakty, indikátory), které v `metrics` nejsou. Pro kompletní pohled na firmu je ideální kombinace obou endpointů.

### Další informace

* [Přehled API endpointů](/api-a-integrace/api-endpointy)
* [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani)
* [Kompletní API dokumentace](http://developers.bizmachine.com/)


# Endpoint aggregated-data - profil firmy

Kompletní profil firmy v jednom API volání - identifikace, adresa, všeobecné kontakty firmy, NACE, indikátory a souhrn 25 metrik.

*Aktualizováno: 30. července 2026*

## Endpoint: aggregated-data

```
GET /{dataset}/v4/companies/{nationalIn}/aggregated-data
```

Základní endpoint pro data o firmě. Vrací kompletní profil - identifikaci, adresu, všeobecné kontakty firmy, NACE, indikátory a souhrn 25 metrik (pouze poslední hodnoty, bez časových řad).

***

### Jaké informace tento endpoint obsahuje

`aggregated-data` vám v jednom volání dá odpověď na základní otázky o firmě:

* **Kdo to je?** Název, IČO, DIČ, právní forma, datum vzniku, status (aktivní / v likvidaci…), popis firmy
* **Kde sídlí?** Adresa s GPS souřadnicemi, hierarchie lokalit (obec → okres → kraj)
* **Jaké jsou všeobecné kontakty?** Web, e-mail, telefon, LinkedIn, Facebook
* **Jak velká je?** Pásmo počtu zaměstnanců, tržby, aktiva, EBIT
* **Jak roste?** Skóre aktivity, růstu a dostupnosti (0-100)
* **Čím se zabývá?** Primární NACE kód + ostatní kategorie
* **Má rizika?** Počet rizikových signálů (insolvence, exekuce…)

#### Kdy tento endpoint použít

* Potřebujete základní profil firmy před obchodní schůzkou nebo analýzou
* Obohacujete záznamy v CRM (enrich) - název, adresa, odvětví, velikost
* Jako první volání v pipeline: zjistíte co firma je, pak se rozhodnete co dál volat
* Potřebujete rychlý přehled metrik bez historických časových řad

#### Kdy použít jiný endpoint

| Potřebujete                      | Použijte místo toho |
| -------------------------------- | ------------------- |
| Historii metrik (víceleté řady)  | `metrics` (v3)      |
| Detailní rizikové signály        | `risks` (v4)        |
| Vlastnickou strukturu s historií | `owners` (v4)       |
| Detailní indikátory s drivery    | `indicators` (v3)   |
| Detailní finanční výkazy         | `financials` (v3)   |

#### Dostupnost

Endpoint je dostupný pro všechny datasety: **cz, sk, hu, pl, de**.

***

### Technické informace

{% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v4/companies/{nationalIn}/aggregated-data" method="get" %}
[api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

#### Na co si dát pozor

* `employees` nemá přesnou hodnotu - jen pásmo v `category`. Přesný počet zaměstnanců není v tomto endpointu dostupný.
* `contacts.website` má pole `.value` (ne `.url`) - stejný vzor jako `email` a `phoneNumber`.
* `contacts` = všeobecné kontakty firmy (web, e-mail, telefon, LinkedIn, Facebook) - **ne osobní kontakty** na konkrétní osoby.
* `indicators.*` může být `null` na úrovni celého objektu (nejen `.value`) - vždy ověřte, že objekt existuje, než přistoupíte k `.value`.
* `selfDeclaredCategories` může mít 400+ položek → velký payload.
* `risks` je `null` pokud firma nemá rizika (ne prázdné pole).
* Endpoint obsahuje souhrn \~25 metrik bez historie. Pro kompletních 64 metrik s víceletými řadami použijte `metrics` (v3).

***

### Instrukce pro AI agenty

Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat.

```
## BizMachine API: aggregated-data endpoint

Purpose: Returns a complete company profile in a single API call — identity, address,
company contacts, NACE codes, key metrics (latest values only), and business indicators.

When to use:
- You have a company's national identifier (IČO) and need a full profile
- You are enriching CRM records (name, address, industry, size, contacts)
- As the entry point in a pipeline before deciding which other endpoints to call
- You need a quick metrics overview without historical time series

When NOT to use:
- Historical metrics (multi-year time series) → use /metrics (v3)
- Detailed risk signals → use /risks (v4)

URL:
  GET https://api.bizmachine.com/{dataset}/v4/companies/{nationalIn}/aggregated-data

Required:
  - Path: dataset — "cz", "sk", "hu", "pl" or "de"
  - Path: nationalIn — company national ID / IČO (e.g. "27082440")
  - Header: X-Api-Key: {api_key}

Optional:
  - Header: Accept-Language: CS  (for Czech field names and values)

Key response fields:
  data.basicInfo.nationalIn          — company ID (IČO)
  data.basicInfo.name                — company name
  data.basicInfo.vatIn               — VAT number
  data.basicInfo.health.code         — company status ("inbusiness", "dissolved", ...)
  data.basicInfo.establishedAt       — founding date (ISO 8601)
  data.basicInfo.legalForm.name      — legal form
  data.basicInfo.selfDescription     — company description
  data.address.text                  — full address
  data.address.city                  — city
  data.address.postalCode            — postal code
  data.address.coordinates           — GPS (latitude, longitude)
  data.contacts.website.value        — company website
  data.contacts.email.value          — company email
  data.contacts.phoneNumber.value    — company phone
  data.contacts.linkedIn.value       — LinkedIn profile URL
  data.contacts.facebook.value       — Facebook profile URL
  data.metrics.revenue               — revenue {value, currency} or band in category
  data.metrics.employees             — headcount: band ONLY in category.name (value is always null)
  data.metrics.ebit                  — EBIT {value, currency}
  data.metrics.ebitda                — EBITDA {value, currency}
  data.metrics.assetsTotal           — total assets {value, currency}
  data.metrics.revenueGrowth         — revenue growth (ratio)
  data.metrics.personnelCost         — personnel costs {value, currency}
  data.metrics.locationCount         — number of operating locations
  data.metrics.openJobCountCurrentTotal — current open job positions
  data.metrics.riskCount             — number of risks (null if none)
  data.indicators.activity.value     — activity score (0–100)
  data.indicators.growth.value       — growth score (0–100)
  data.indicators.reachability.value — reachability score (0–100)
  data.nace.primary.code             — primary NACE code
  data.nace.primary.name             — NACE category name
  meta.prospector.link               — link to company profile in Prospector UI

Gotchas:
  - data.metrics.employees.value is ALWAYS null — exact headcount unavailable, band only
  - data.contacts.website.value — field is .value (not .url), consistent with email and phone
  - data.contacts = company contacts (web, email, phone, LinkedIn, Facebook) — NOT personal contacts
  - data.indicators.* can be null at the object level (not just .value) — always null-check the parent object before accessing .value
  - data.basicInfo.selfDeclaredCategories can have 400+ items → large payload
  - data.risks is null when no risks present (not an empty array)
  - data.metrics contains more fields than listed above — for full 64 metrics with history → combine with /metrics (v3)

Typical workflow (CRM enrichment):
  1. Call aggregated-data → get basic profile + metrics
  2. Call /metrics (v3) → get historical time series
  = complete profile in 2 API calls
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Endpoint suggest - vyhledávání firem

Vyhledávání firem podle názvu nebo domény - získání IČO pro použití v dalších API voláních.

*Aktualizováno: 30. července 2026*

## Endpoint: suggest (vyhledávání firem)

```
GET /{dataset}/v4/companies/suggest
```

Vyhledá firmy podle **názvu**, **IČO**, **DIČ** nebo **webové domény**. Pro každou nalezenou firmu vrátí základní identifikaci - název, IČO, město a web. Výchozí vyhledávání prohledává všechna tato pole zároveň - stačí jeden parametr `Query`.

***

### Kdy tento endpoint použít

* Znáte název firmy nebo doménu a potřebujete zjistit IČO
* Stavíte vyhledávací pole, kde uživatel začne psát název, IČO, DIČ nebo web firmy a dostane okamžité návrhy
* Jako první krok v pipeline před voláním `aggregated-data`, `metrics` nebo jiných endpointů

#### Podle čeho lze vyhledávat

Výchozí vyhledávání (bez `FieldsToSearch`) prohledává **všechna pole zároveň**. Není nutné žádné dodatečné nastavení:

| Příklad dotazu         | Co se hledá                                     |
| ---------------------- | ----------------------------------------------- |
| `Query=BizMachine`     | Název firmy (funguje i na část: `Query=BizMac`) |
| `Query=27082440`       | IČO firmy                                       |
| `Query=CZ27082440`     | DIČ firmy                                       |
| `Query=bizmachine.com` | Webová doména - najde firmu i bez shody v názvu |

#### Kdy použít jiný endpoint

| Potřebujete                          | Použijte místo toho    |
| ------------------------------------ | ---------------------- |
| Znáte IČO a chcete data o firmě      | `aggregated-data` (v4) |
| Hromadný dotaz na více firem zároveň | Kolekční endpointy     |

***

### Technické informace

{% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v4/companies/suggest" method="get" %}
[api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

#### Na co si dát pozor

* Vyhledávání funguje i na část názvu - `Query=BizMac` najde BizMachine s.r.o. Výsledky jsou řazeny podle relevance, ne abecedně - vždy ověřte název a město.
* Bez parametru `FieldsToSearch` query prohledává všechna pole zároveň (název, IČO, DIČ, web a další).
* Parametrem `Limit` určíte počet výsledků na jeden dotaz (1-200, výchozí hodnota je 5).

***

### Instrukce pro AI agenty

Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat.

```
## BizMachine API: suggest endpoint (company search / lookup)

Purpose: Search for companies by name or domain and retrieve their national identifier (IČO / nationalIn)
for use with other BizMachine API endpoints.

When to use:
- You have a company name and need its IČO
- You have a domain/website and need the company's IČO
- You are implementing autocomplete over company data
- As the first step in a pipeline before calling aggregated-data, metrics, contacts, etc.

When NOT to use:
- You already know the IČO → call the target endpoint directly
- Bulk search by filters (region, NACE, size) → use collection endpoints

URL:
  GET https://api.bizmachine.com/{dataset}/v4/companies/suggest

Required:
  - Path: dataset — "cz", "sk", "hu", "pl", "de"
  - Query: Query — search string (company name, IČO, DIČ, or domain)
  - Header: X-Api-Key: {api_key}

Optional:
  - Query: Limit — number of results (1–200, default 5)

Key response fields:
  data[0].nationalIn             — company IČO → use as {nationalIn} in other endpoints
  data[0].uniqueId               — unique ID (format: "cz-company-27082440")
  data[0].name                   — company name
  data[0].city                   — city (use to verify correct company)
  data[0].contacts.website.url   — company website

Search behavior:
  - Default search (no FieldsToSearch) queries all fields simultaneously (name, IČO, DIČ, website, and more)
  - Partial name match works: "BizMac" will find "BizMachine s.r.o."
  - Domain search works without any extra parameters: Query=bizmachine.com finds "BizMachine s.r.o."
  - Use Limit to control number of results (1–200, default 5)

Gotchas:
  - data[0] is the most relevant result but always verify via name + city
  - Relevance ranking is not purely alphabetical — short queries may return larger companies first

Typical workflow (name to IČO):
  1. suggest?Query={company_name}&Limit=1  → get nationalIn from data[0].nationalIn
  2. /{dataset}/v4/companies/{nationalIn}/aggregated-data  → get company profile

Typical workflow (domain to IČO):
  1. suggest?Query={domain}&Limit=1  → get nationalIn from data[0].nationalIn
  2. Call target endpoint with nationalIn
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Endpoint contacts - kontakty na firmu a osoby

Kontakty na firmu a osoby - telefony, e-maily, LinkedIn profily. Vrací firemní i osobní kontakty.

*Aktualizováno: 30. července 2026*

```
GET /{dataset}/v4/companies/{nationalIn}/contacts
```

Kontakty na firmu i konkrétní osoby - telefony, e-maily, LinkedIn profily, weby. Vrací firemní kontakty (přiřazené přímo firmě) i osobní kontakty (přiřazené konkrétní osobě s rolí).

***

## Jaké informace tento endpoint obsahuje

Každý kontakt v odpovědi obsahuje:

* **Typ** - Phone, Email, Website, SocialMedia (LinkedIn, Facebook…), Fax
* **Hodnotu** - `value` (raw, např. `00420123456789`) a `valueFormatted` (naformátovaná, čitelná, např. `+420 123 456 789`)
* **Jistotu** - `confidence` (0-1): jak jistí jsme si správností kontaktu
* **Zdroje** - odkud kontakt pochází (firemní web, Firmy.cz, LinkedIn…) a kdy byl naposledy ověřen
* **Osobu** - u osobních kontaktů je přítomen `person` objekt s jménem, rolemi a oddělením

### Firemní vs. osobní kontakty

| Typ kontaktu              | `person` objekt | `isPersonal` |
| ------------------------- | --------------- | ------------ |
| Firemní (přiřazený firmě) | chybí           | `false`      |
| Osobní (přiřazený osobě)  | přítomen        | `true`       |

Firemní kontakty jsou obecné (recepce, info e-mail, web firmy). Osobní kontakty jsou navázány na konkrétní osobu s pozicí ve firmě. Kontakt s nejasnou osobní vazbou (např. `pepa@firma.cz`) může být přiřazen zároveň jako firemní i jako osobní.

### Kdy tento endpoint použít

* Potřebujete e-mail nebo telefon na konkrétní osobu v cílové firmě
* Exportujete kontakty do CRM nebo nástroje pro outreach (Clay, Make.com, N8N)
* Hledáte LinkedIn profil konkrétní osoby ve firmě

### Kdy použít jiný endpoint

| Potřebujete                                                          | Použijte místo toho                                                                          |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Stačí vám jeden kontakt firmy od každého typu (web, e-mail, telefon) | `aggregated-data` (v4), sekce `data.contacts` - vrací jeden nejlepší kontakt od každého typu |
| Přehled klíčových osob bez kontaktů                                  | `owners` (v4), `statutories` (v3)                                                            |

### Dostupnost

Endpoint je dostupný pro všechny datasety: **cz, sk, hu, pl, de**.

Dostupný jako single request (pro jednu firmu podle IČO) i jako collection request (pro více firem najednou).

***

## Technické informace

{% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v4/companies/{nationalIn}/contacts" method="get" %}
[api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

### Na co si dát pozor

* `person` objekt je nullable - kontakty bez navázané osoby ho vůbec nemají (chybí klíč, nejde o null). Vždy ověřte přítomnost klíče `person`, než přistupujete k `person.name` nebo `person.roles`.
* `isPersonal: true` v `contact` objektu = osobní kontakt. Lze použít jako rychlý filtr.
* `confidence` je desetinné číslo v rozsahu 0.00-1.00 (nikoliv procenta). Hodnota 0.85 = 85% jistota.
* Výchozí `Limit` je 200 - velké firmy mají stovky kontaktů. Filtrujte typem nebo používejte stránkování.
* `value` je raw formát (`00420XXXXXXXXX`), `valueFormatted` je čitelný (`+420 XXX XXX XXX`).
* Pro SocialMedia kontakty je k dispozici `socialMediaType.code` (např. `"linkedin"`).

***

## Instrukce pro AI agenty

Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat.

```
## BizMachine API: contacts endpoint

Purpose: Returns contacts for a company — company-level contacts (phone, email, website)
and personal contacts linked to specific people with roles and departments.

When to use:
- You need an email or phone for a specific person at a company
- You are enriching CRM records with personal contact details (decision-makers)
- You need LinkedIn profiles of people at a target company

When NOT to use:
- You need general company contacts (web, company email) → use aggregated-data (data.contacts)
- You need a list of key people without contact details → use owners (v4)

URL:
  GET https://api.bizmachine.com/{dataset}/v4/companies/{nationalIn}/contacts

Required:
  - Path: dataset — "cz", "sk", "hu", "pl", "de"
  - Path: nationalIn — company national ID / IČO (e.g. "05450641")
  - Header: X-Api-Key: {api_key}

Optional:
  - Query: Types — Phone, Fax, Email, Website, Other, SocialMedia
  - Query: IsPrimary — true/false
  - Query: Limit — default 200, max 250
  - Query: Offset — pagination

Key response fields (per item in data[]):
  data[i].data.company.nationalIn             — company IČO
  data[i].data.person                         — ABSENT for company contacts, present for personal
  data[i].data.person.name.text               — full name (e.g. "Jan Novák")
  data[i].data.person.name.firstName          — first name
  data[i].data.person.name.lastName           — last name
  data[i].data.person.roles[0].text           — job title / role
  data[i].data.person.departments[0].code     — department code
  data[i].data.contact.type                   — Phone / Email / Website / SocialMedia / Fax / Other
  data[i].data.contact.value                  — raw contact value
  data[i].data.contact.valueFormatted         — human-readable value
  data[i].data.contact.isPrimary              — boolean
  data[i].data.contact.isPersonal             — true = personal contact, false = company contact
  data[i].data.contact.confidence             — 0–1
  data[i].data.contact.sources[0].url         — source URL
  data[i].data.contact.sources[0].lastCheckedAt — last verification timestamp (ISO 8601)
  data[i].data.contact.socialMediaType.code   — "linkedin", "facebook", etc. (SocialMedia only)

Gotchas:
  - data[i].data.person is ABSENT (key missing, not null) for company contacts — use key existence check
  - confidence is 0–1 (not 0–100) — 0.85 = 85% confidence
  - Default Limit is 200 — large companies may have hundreds of contacts; use Types filter or pagination
  - value is raw format; use valueFormatted for display
  - socialMediaType only present on SocialMedia type contacts

Typical workflow:
  1. suggest → get nationalIn
  2. contacts?Types=Email → get email contacts
  3. contacts?Types=SocialMedia → get LinkedIn profiles
  4. Filter by isPersonal=true for personal contacts only
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Endpoint events - obchodní události firmy

Obchodní události firmy - smlouvy, tendry, zmínky v médiích a další signály aktivity.

*Aktualizováno: 30. července 2026*

```
GET /{dataset}/v3/events
```

Obchodní události firmy - vyhraná výběrová řízení, publikované smlouvy, mediální zmínky a další signály aktivity. Vhodné pro monitoring cílových firem nebo jako trigger pro automatizované akce v CRM.

***

## Jaké informace tento endpoint obsahuje

Každá událost obsahuje:

* **Předmět a text** - krátký popis (`subject`) a plný text události (`text`)
* **Kategorii** - typ události (viz přehled níže)
* **Datum** - kdy událost proběhla (`startedAt`) a kdy byla publikována (`publishedAt`)
* **Zdroj** - URL původního zdroje (registr smluv, média…)
* **Entity** - firmy zapojené do události (s IČO a názvem)
* **Závažnost** - `severity` (integer; 0, 1 nebo 2 - vyšší = závažnější)

### Kategorie událostí

> Dostupné kategorie se liší napříč trhy. Aktuální přehled najdete v pokročilém filtrování v Prospectoru, nebo se obraťte na <support@bizmachine.com>.

* Smlouvy publikované v registru smluv
* Vyhraná výběrová řízení (tendry)
* Mediální zmínky
* Publikace finančních zpráv (účetní závěrky, výroční zprávy)
* Výročí firem
* Nové nebo ukončené pracovní inzeráty
* Změny ve vedení (příchod nebo odchod jednatele, prokuristy)
* Změny vlastníků a statutárních zástupců
* Nové pobočky nebo změna adresy

Kompletní seznam kategorií dostupný v Prospectoru v pokročilém filtrování - sekce [Signály](https://help.bizmachine.com/pokrocile-funkce/firemni-signaly-a-upozorneni). Kategorie se průběžně rozšiřují.

### Kdy tento endpoint použít

* Monitorujete obchodní aktivitu cílových firem (nové smlouvy, zakázky)
* Hledáte trigger pro oslovení (firma právě vyhrála zakázku)
* Sledujete změny ve vlastnické struktuře nebo vedení cílových firem
* Monitorujete nábor (firma začala nebo ukončila inzerci pracovních míst)
* Stavíte alert systém nad změnami ve firmách

### Kdy použít jiný endpoint

| Potřebujete                            | Použijte místo toho |
| -------------------------------------- | ------------------- |
| Rizikové signály (insolvence, exekuce) | `risks` (v4)        |
| Celkový stav vlastnické struktury      | `owners` (v4)       |
| Pravidelné sledování vývoje metrik     | `metrics` (v3)      |

### Dostupnost

Endpoint je dostupný pro datasety: **cz, sk, pl, de**. Dostupné kategorie signálů se pro každý dataset liší.

***

## Technické informace

{% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v3/events" method="get" %}
[api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

### Na co si dát pozor

* `startedAt` = datum události, `publishedAt` = datum zveřejnění (může být pozdější), `updatedAt` = datum poslední aktualizace záznamu.
* `summary` není přítomno u všech kategorií - např. u Vyhraný tendr klíč v odpovědi chybí. Vždy ověřte přítomnost klíče.

***

## Instrukce pro AI agenty

Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat.

```
## BizMachine API: events endpoint

Purpose: Returns business events for a company — won tenders, published contracts, media mentions,
and other activity signals. Useful for company monitoring and sales triggers.

When to use:
- You want to monitor business activity of target companies (new contracts, tenders)
- You need a trigger signal for outreach (company just won a tender, appeared in media)
- You are building an alert system for changes in target companies

When NOT to use:
- You need risk signals (insolvency, enforcement) → use risks (v4)
- You need ownership changes → use owners (v4)

URL:
  GET https://api.bizmachine.com/{dataset}/v3/events

Required:
  - Path: dataset — "cz", "sk", "pl", "de" (event categories differ per dataset)
  - Header: X-Api-Key: {api_key}

Optional:
  - Query: Company.NationalIn — filter by IČO
  - Query: Category.Code — contract-publication / tender-won / media / fin-report-publ / company-anniversary
  - Query: Company.Role — role of the company in the event
  - Query: Company.OnlyFollowed — true/false, only followed companies
  - Query: Source.Code — filter by source code
  - Query: Started.From / Started.To — date range (e.g. 2026-04-27T00:00:00Z)
  - Query: Updated.From / Updated.To — filter by update date
  - Query: Limit — default 200, max 250
  - Query: Offset — pagination

Key response fields (per item in data[]):
  data[i].data.uniqueId                — event ID
  data[i].data.subject                 — short description
  data[i].data.summary                 — summary (not present for all categories)
  data[i].data.text                    — full text
  data[i].data.url                     — source URL
  data[i].data.publishedAt             — publication timestamp (ISO 8601)
  data[i].data.startedAt               — event timestamp (ISO 8601)
  data[i].data.updatedAt               — last update timestamp (ISO 8601)
  data[i].data.categories[0].code      — event category code
  data[i].data.categories[0].name      — event category name
  data[i].data.severity                — severity integer (0, 1 or 2 — higher = more significant)
  data[i].data.entities[0].nationalIn  — IČO of company involved
  data[i].data.entities[0].name        — name of company involved
  data[i].data.entities[0].type        — entity type ("Company")

Gotchas:
  - startedAt is the event date, publishedAt is when it was published (can be later), updatedAt is when the record was last updated
  - summary is not present for all categories (e.g. tender-won, media, fin-report-publ); always check key presence

Event categories (list may change):
  - contract-publication  — government contract registry (company as supplier)
  - tender-won            — won public tender
  - media                 — media mention
  - fin-report-publ       — financial report publication (annual report, financial statements)
  - company-anniversary   — company anniversary

Typical workflow (sales trigger monitoring):
  1. events?Company.NationalIn={nationalIn}&Category.Code=tender-won → check for recent wins
  2. events?Company.NationalIn={nationalIn}&Started.From=2026-01-01 → get recent activity
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Endpoint eshops - e-shopy provozované firmou

E-shopy provozované firmou - URL, status, platební metody, dopravci, hodnocení a metriky návštěvnosti.

*Aktualizováno: 30. července 2026*

```
GET /{dataset}/v3/eshops
```

E-shopy provozované firmou - URL, status, platební metody, dopravci, hodnocení zákazníků a metriky návštěvnosti. Data pocházejí ze srovnávačů (Heuréka, Zboží.cz) a dalších zdrojů.

***

## Jaké informace tento endpoint obsahuje

Pro každý e-shop vrátí:

* **Identifikaci** - název, URL, status (Active/Inactive), datum vzniku, popis
* **Platební metody** - seznam akceptovaných plateb (karta, bankovní převod, dobírka, PayPal…)
* **Dopravce** - dostupné přepravní metody (PPL, DPD, Zásilkovna, Česká pošta…)
* **Hodnocení** - celkový počet recenzí a průměrná hodnota z Heuréky / Zboží.cz
* **Metriky návštěvnosti** - odhadovaná návštěvnost, pořadí v zemi, počet produktů, placená klíčová slova
* **Technologie** - rozpoznaný tech stack e-shopu (pokud je dostupný)

### Kdy tento endpoint použít

* Zjišťujete, zda cílová firma provozuje e-shop a jaký je jeho stav
* Potřebujete přímou URL e-shopu (ne korporátní web firmy)
* Chcete signály tržní síly - hodnocení, návštěvnost, počet produktů
* Analyzujete e-commerce segment pro prospecting nebo market intelligence

### Kdy použít jiný endpoint

| Potřebujete                                      | Použijte místo toho                                                                                 |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Chcete jen zjistit, zda firma e-shop má (ano/ne) | `aggregated-data` (v4) - pole `data.metrics.eshopCount`                                             |
| Chcete jen zjistit webovou stránku firmy         | `aggregated-data` (v4) - `data.contacts.website.value` nebo `suggest` (v4) - `contacts.website.url` |

### Dostupnost

Endpoint je dostupný pro všechny datasety: **cz, sk, hu, pl, de**.

***

## Technické informace

{% openapi src="/files/XsgqAcv6XJjIzqRU0Ubr" path="/{dataset}/v3/eshops" method="get" %}
[api-spec.temp.json](https://2865951599-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9IXbHwc2ctAHDxOoCdoX%2Fuploads%2Fgit-blob-de88966fec10805d50f17dc1d05ba0ecb23e8eb2%2Fapi-spec.temp.json?alt=media)
{% endopenapi %}

### Na co si dát pozor

* `data[i].data.metrics.*.timeline[0]` = nejnovější hodnota metriky. Metriky jsou časové řady - vždy indexujte do `timeline`.
* `data[i].data.sources[i].metrics` jsou ploché hodnoty (ne timeline) - jiná struktura než metriky na úrovni e-shopu.
* `technologies` může být prázdné pole - ne všechny e-shopy mají rozpoznané technologie.
* Jedna firma může mít více e-shopů - iterujte přes všechny záznamy v `data[]`.
* `countryRank`: nižší číslo = větší e-shop (rank 1 = největší v zemi).

***

## Instrukce pro AI agenty

Zkopírujte tento blok a předejte ho agentovi - popisuje, jak endpoint správně používat.

```
## BizMachine API: eshops endpoint

Purpose: Returns e-shop data for a company — URL, status, payment options, delivery options,
customer ratings, and traffic metrics from comparison portals (Heuréka, Zboží.cz).

When to use:
- You want to check if a company has an e-shop and what its URL and status is
- You need customer rating signals or traffic estimates
- You are prospecting in the e-commerce segment

When NOT to use:
- You only need to know if a company has an eshop (yes/no) → use aggregated-data (data.metrics.eshopCount)
- You need the company's website → use aggregated-data (data.contacts.website.value) or suggest (v4, contacts.website.url)
- You are searching for companies by segment → use collection endpoints

URL:
  GET https://api.bizmachine.com/{dataset}/v3/eshops

Required:
  - Path: dataset — "cz", "sk", "hu", "pl", "de"
  - Header: X-Api-Key: {api_key}

Optional:
  - Query: Company.NationalIn — filter by IČO (e.g. "05450641")
  - Query: Limit — default 200, max 250
  - Query: Offset — pagination

Key response fields (per item in data[]):
  data[i].data.uniqueId                                   — eshop ID
  data[i].data.company.nationalIn                         — company IČO
  data[i].data.name                                       — eshop name
  data[i].data.url                                        — eshop URL
  data[i].data.status                                     — "Active" or "Inactive"
  data[i].data.establishedAt                              — launch date
  data[i].data.description                                — eshop description
  data[i].data.paymentOptions[i].name                     — accepted payment method
  data[i].data.deliveryOptions[i].name                    — delivery carrier
  data[i].data.metrics.countryRank.timeline[0].value      — country rank (lower = larger)
  data[i].data.metrics.trafficEstimate.timeline[0].value  — estimated monthly visitors
  data[i].data.metrics.productCount.timeline[0].value     — number of products
  data[i].data.metrics.ratingCountTotal.timeline[0].value — total customer reviews
  data[i].data.metrics.paidKeywords.timeline[0].value     — paid keywords count
  data[i].data.sources[i].code                            — source portal ("cz-heureka", "cz-zbozicz")
  data[i].data.sources[i].metrics.ratingValue             — avg rating from source (0–1)
  data[i].data.sources[i].metrics.ratingCountTotal        — review count from source
  data[i].data.sources[i].metrics.deliveryDurationDays    — avg delivery duration (days)
  data[i].data.sources[i].attributes[i].code              — badges (e.g. "cz-heureka_blue_badge")
  data[i].data.technologies                               — detected tech stack (may be empty array)

Gotchas:
  - metrics.*.timeline[0] = most recent value — always index into timeline array
  - sources[i].metrics are flat values, NOT timeline — different structure from top-level metrics
  - technologies may be empty array — not all eshops have detected tech stack
  - One company may have multiple eshops — always iterate all data[] items
  - countryRank: lower = larger eshop (rank 1 = #1 in country)

Typical workflow:
  1. suggest or aggregated-data → get nationalIn
  2. eshops?Company.NationalIn={nationalIn} → check eshop existence + get URL + ratings
  3. Check status = "Active" before using the eshop URL
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Hromadné (BULK) API volání

Jak stránkovat výsledky, filtrovat podle štítků nebo časového období a na co si dát pozor při hromadném volání BizMachine API.

*Aktualizováno: 30. července 2026*

## Hromadné (BULK) API volání

Vybrané API endpointy (kolekční endpointy) podporují hromadné volání - můžete jedním dotazem získat data pro více firem najednou. Kompletní přehled endpointů a parametrů najdete v [API dokumentaci](http://developers.bizmachine.com/).

### Stránkování výsledků

API vrací maximálně **250 záznamů na stránku**. K dalším stránkám se dostanete parametrem `Offset`:

```
GET /cz/v3/events?Company.NationalIn=12345678&Offset=0      (1. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Offset=250    (2. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Offset=500    (3. stránka)
```

Celkový počet záznamů najdete v odpovědi v poli `paging.totalItems`. Stránkujte, dokud nezpracujete všechny záznamy.

> **Pozor:** Používejte parametr `Offset`, ne `Page`. Parametr `Page` API tiše ignoruje a vrací stále první stránku - výsledkem jsou duplicitní data bez jakékoliv chybové hlášky.

### Nejčastěji používané parametry

#### Tag.UID - filtrování podle štítku

API vrátí data pouze pro firmy v zadaném štítku (seznamu). Štítek můžete vytvořit přímo v Prospectoru jako "Seznam firem", nebo ho spravovat kompletně přes API.

Typický postup: přes API nahrajte seznam firem do štítku a pak provolejte libovolný datový endpoint s parametrem `Tag.UID` - dostanete data jen pro tyto firmy.

#### Updated.From, Updated.To - inkrementální aktualizace

API vrátí pouze záznamy změněné ve sledovaném období. Typicky stačí jednorázově naimportovat všechna data a pak pravidelně dotazovat jen přírůstek za poslední období.

### Na co si dát pozor

* **Neznámé parametry API tiše ignoruje.** Pokud použijete špatný název parametru (překlep, nesprávný formát), API nevrátí chybu - vrátí nefiltrované výsledky. Když dostáváte neočekávaně velký počet záznamů, zkontrolujte názvy parametrů.
* **Vozidla používají jiný identifikátor.** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (např. `cz-company-12345678`). Podrobnosti viz [Přehled API endpointů](/api-a-integrace/api-endpointy).
* **Limit 250 na stránku platí pro všechny kolekční endpointy.** Tato hodnota (`maxPageSize`) je uvedena v odpovědi v sekci `paging`.

### Další informace

* [Přehled API endpointů](/api-a-integrace/api-endpointy)
* [Jaké jsou moje API limity?](/api-a-integrace/api-limity)
* [API dokumentace](http://developers.bizmachine.com/)


# CRM integrace

Přehled možností napojení BizMachine Prospectoru na CRM systémy - nativní integrace Raynet, integrace Pipedrive přes Make.com, iFrame pro Salesforce a Dynamics a další CRM.

*Aktualizováno: 30. července 2026*

## CRM integrace

BizMachine Prospector lze propojit s CRM systémem prostřednictvím Prospector API. Jako integrační platformu používáme Make.com - nejčastěji pro Pipedrive, HubSpot ale je možné napojit i další CRM. Pro Raynet je k dispozici nativní integrace bez potřeby dalšího nástroje. Alternativou je Prospector iFrame, který se typicky používá v Salesforce nebo MS Dynamics.

***

### Raynet - nativní integrace

Raynet CRM obsahuje přímou integraci s BizMachine Prospectorem bez potřeby dalšího nástroje. Integrace umožňuje automatickou aktualizaci firemních dat na kartách Klientů, zobrazení plného Prospector profilu a přenos firem ze Prospectoru na základě štítku.

Podrobný návod k aktivaci, přehled synchronizovaných polí a nastavení automatického přenosu: [Jak nastavit integraci Raynetu s Prospectorem](/api-a-integrace/raynet-integrace)

***

### Pipedrive - integrace přes Make.com

Integrace Pipedrive s BizMachine Prospectorem probíhá přes platformu Make.com - s konfigurací vám rádi pomůžeme.

![Make.com scénář propojující Pipedrive s BizMachine API](/files/PXa4afjhiv7Kj3d22kbj)

#### 1. Obohacení firemních dat

Obchodník zadá pouze IČO - všechna vybraná BizMachine pole se doplní automaticky. Klient si sám zvolí, která data chce mít v Pipedrive k dispozici - typicky jde o základní firemní údaje (adresa, IČO, DIČ, telefon, email, web), základní metriky (obrat, počet zaměstnanců, aktiva), ukazatele rizika, popis činnosti, přímý odkaz na profil v Prospectoru.

Obohacení lze spustit dvěma způsoby:

* **Okamžitá akce** - spustí se automaticky při vytvoření nové organizace v Pipedrive. Data jsou k dispozici okamžitě.
* **Naplánovaná akce** - scénář pravidelně (např. 2× denně) prochází definovaný Pipedrive filtr a doplňuje nebo aktualizuje data.

#### 2. Vytvoření organizací v Pipedrive

Organizace označená štítkem **„To Pipedrive"** v Prospectoru se automaticky vytvoří v Pipedrive. Přiřadit štítek lze jednotlivě nebo hromadně po vyfiltrování segmentu (lokalita, obrat, NACE, počet zaměstnanců…).

![Štítek „To Pipedrive" na kartě firmy v Prospectoru](/files/TY8AMQCGVIXlRHkt9Ud9)

#### 3. Označení organizací z Pipedrive štítkem v Prospectoru

Firmy evidované v Pipedrive se automaticky přiřadí do štítku **„In Pipedrive"** v Prospectoru. To usnadňuje jejich odfiltrování při prospektingu a další práci s nimi přímo v Prospectoru. Volitelně lze rozlišovat i podle přiřazeného obchodního zástupce.

![Štítek „In Pipedrive" na kartě firmy v Prospectoru](/files/FZrvFiBvuW0UMtWVjzEQ)

#### 4. Přiřazení organizací osobám v Pipedrive

Při přenosu organizace z Prospectoru do Pipedrive lze automaticky přiřadit organizaci konkrétní osobě (kontaktu) v Pipedrive.

#### 5. Automatické zakládání dealů

Na základě definované podmínky lze automaticky založit deal v Pipedrive a přiřadit jej příslušnému obchodníkovi. Podmínkou může být přiřazení štítku, vytvoření organizace nebo **signál zaznamenaný na konkrétní firmě** v Prospectoru.

***

### Salesforce, Dynamics, HubSpot a další CRM

Integrace realizujeme i do dalších CRM systémů - Salesforce, Microsoft Dynamics, HubSpot a dalších. Rozsah a způsob napojení závisí na konkrétním CRM a požadavcích klienta.

Máte zájem o integraci s jiným CRM? Kontaktujte nás a probereme možnosti.

***

### Prospector iFrame

Alternativou k importu dat je zobrazení celého Prospector profilu přímo v CRM prostřednictvím iFrame - jako samostatná záložka na kartě firmy. Obchodník tak má přístup k aktuálním datům bez nutnosti přepínat do jiného nástroje.

iFrame lze integrovat do libovolného CRM systému, typicky do Salesforce nebo Microsoft Dynamics.

![Prospector iFrame zobrazený v Salesforce CRM](/files/a86dEugzmS63vdoHe87Y)

![Prospector iFrame zobrazený v Microsoft Dynamics 365](/files/q3EOzt26fKs8EOVm2LdS)

***

### Jak začít s integrací?

1. Kontaktujte svého obchodního zástupce nebo podporu na <support@bizmachine.com>
2. Domluvte hovor s integračním specialistou


# Jak nastavit integraci Raynetu s Prospectorem

Návod, jak aktivovat nativní integraci Raynetu s Prospectorem, přehled synchronizovaných polí, nastavení automatického přenosu Klientů a řešení potíží.

*Aktualizováno: 30. června 2026*

## Jak nastavit integraci Raynetu s Prospectorem

Raynet CRM obsahuje přímou integraci s Prospectorem - nevyžaduje žádný integrační nástroj třetí strany. Integraci můžete nastavit přímo v Raynetu.

Tento průvodce vás provede aktivací integrace, přehledem synchronizovaných dat a nastavením automatického přenosu Klientů.

Po aktivaci integrace se na kartách Klientů zobrazí Index aktivity, záložka s plným profilem firmy z Prospectoru, možnost obohatit Klienta o firemní data a štítky z Prospectoru.

***

### Co budete k aktivaci potřebovat

* **Přístup do Raynetu s rolí administrátora** - aktivaci integrace provádí pouze administrátor.
* **Prospector API klíč** - vygenerujete v Prospectoru v Nastavení » API. Jak na to: [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice)
* **Aktivovaný API endpoint Prospectoru** - endpoint aktivujeme na vyžádání; kontaktujte <support@bizmachine.com>

***

### Část 1 - Aktivace integrace

#### 1. Domluvte aktivaci API endpointu

Integrace využívá Prospector API - pro její fungování musí mít váš účet aktivovaný příslušný API endpoint. Kontaktujte nás na <support@bizmachine.com>, abychom vám ho nastavili. Současně s tímto krokem doporučujeme ze <support@bizmachine.com> nechat vytvořit v Prospectoru [integrační účet](/api-a-integrace/integracni-ucet), aby byla integrace oddělená od uživatelských přístupů.

#### 2. Otevřete nastavení Raynetu

V Raynetu v pravém horním rohu klikněte na své jméno a vyberte **Nastavení**.

#### 3. Přejděte na nastavení Prospectoru

V levém menu otevřete **Rozšíření** » **Informace o firmách** » **Prospector** » **Aktivovat**.

![Levé menu v Nastavení Raynetu s otevřenou cestou Rozšíření - Informace o firmách - Prospector](/files/XXndM5rai9Wwm4OeXT6H)

#### 4. Zadejte API klíč a aktivujte

Do pole zadejte váš Prospector API klíč a klikněte na **Aktivovat**.

![Nastavení Prospector v Raynetu s polem pro zadání Prospector API klíče a tlačítkem Aktivovat](/files/GEA7wJFk3E4yy2dbQuJI)

#### 5. Integrace je aktivní

Po aktivaci jsou k dispozici:

* Index aktivity na kartě Klienta
* záložka **Údaje z Prospectoru** na kartě Klienta
* panel **Prospector** s automaticky synchronizovanými poli
* akce **Aktualizovat z Prospectoru** na detailní kartě i v seznamovém pohledu Klientů
* akce **Hromadná aktualizace** všech Klientů
* synchronizované štítky z Prospectoru

***

### Co integrace umí

#### Index aktivity

V pravém panelu na kartě Klienta se zobrazuje Index aktivity firmy. Po najetí na panel se v tooltipu zobrazí kritéria, ze kterých index vychází.

![Pravý panel na kartě Klienta v Raynetu s Indexem aktivity a tooltipem zobrazujícím kritéria](/files/aqABvMOFXKU7G6oL6JUw)

#### Záložka Údaje z Prospectoru

Po kliknutí na panel Indexu aktivity se otevře samostatná záložka **Údaje z Prospectoru** se všemi dostupnými informacemi o firmě. Jedná se o náhled celého firemního Prospector profilu.

![Záložka Údaje z Prospectoru na kartě Klienta v Raynetu s plným profilem firmy z Prospectoru](/files/qV3p7QjAzvqkKr7A6VMi)

#### Panel Prospector se synchronizovanými poli

Po zapnutí integrace se na kartě **Custom fields** automaticky vytvoří volitelná pole seskupená do panelu **Prospector**. Tato pole lze využít k filtrování Klientů. Data v těchto polích není možné editovat přímo v Raynetu - aktualizují se výhradně z Prospectoru.

![Panel Prospector na kartě Klienta v Raynetu se synchronizovanými Prospector poli](/files/mZXiP6FeD5WABwGriMKe)

**Základní atributy firmy**

Tato data se synchronizují do standardních polí karty Klienta:

* Primární adresa (ulice, město, PSČ, souřadnice, země)
* Primární kontakt (e-mail, telefon, web)
* Facebook, LinkedIn, Twitter
* Název, právní forma, počet zaměstnanců, obor
* IČ, DIČ, datum založení, plátce DPH, spisová značka
* Štítky - přenesou se všechny štítky, které má firma v Prospectoru. Každý dostane prefix **BP:** pro snazší identifikaci.

**Pole panelu Prospector**

Volitelná pole v panelu **Prospector** jsou filtrovatelná:

* Datum zániku
* Institucionální sektor
* Justice (odkaz na justice.cz)
* Aktiva celkem, Aktiva měna, Aktiva rok
* Zdraví
* Počet propojených společností
* Prospector (odkaz přímo na profil firmy v Prospectoru)
* Prospector kategorie
* Vlastní popis činnosti
* Obrat, Obrat měna, Obrat rok
* Rizika
* Počet e-shopů
* Počet poboček
* Počet osobních kontaktů

#### Vyhledávání při zakládání nového Klienta

Při zakládání nového Klienta probíhá automatické vyhledání firmy v Prospectoru podle zadaného IČ - v poli IČ je to znázorněno animací. Pokud se data z Prospectoru liší od hodnot z našeptávače, zobrazí se panel s rozdíly a výběrem, která data pro uložení použít.

#### Filtr Aktualizováni z Prospectoru

V seznamovém pohledu Klientů je k dispozici chytrý filtr **Aktualizováni z Prospectoru** - zobrazí Klienty vytvořené nebo aktualizované s daty z Prospectoru (nebo naopak bez nich).

![Seznamový pohled Klientů v Raynetu s chytrým filtrem Aktualizováni z Prospectoru](/files/7kEGXMSyFgoDX4KMNHbR)

***

### Kdy se data aktualizují

> Aby mohla být firma v Raynetu aktualizována nebo spárována s Prospectorem, musí mít vyplněné minimálně **IČO** a **Země** (Česká republika, Slovensko nebo Polsko). Bez těchto údajů obohacení ani spárování proběhnout nemůže.

Synchronizovaná pole se aktualizují v těchto situacích:

* **Vytvoření Klienta** - data se stáhnou automaticky při uložení nového záznamu.
* **Akce Aktualizovat z Prospectoru** na detailní kartě Klienta - ruční aktualizace jednoho záznamu (vpravo nahoře **...** » **Aktualizovat z Prospectoru**).
* **Akce Aktualizovat z Prospectoru** v seznamovém pohledu Klientů - aktualizace vybraných záznamů (označte firmy v seznamu » **Editovat** » **Aktualizovat z Prospectoru**).
* **Hromadná aktualizace** v Nastavení rozšíření - dostupné pro všechny Klienty nebo jen pro ty, kteří dosud nebyli aktualizováni z Prospectoru.
* Přidáním již existujícího klienta do štítku **Pošli do Raynet** v Prospectoru (je třeba, aby byl nastavený automatický přenos klientů - viz [Část 2](#část-2---nastavení-automatického-přenosu-klientů)).

#### Hromadná aktualizace

Pro jednorázovou aktualizaci většího počtu Klientů přejděte na **Nastavení » Rozšíření » Informace o firmách » Prospector » Jednorázové aktualizace**. Máte na výběr:

* **Aktualizovat všechny Klienty** - aktualizuje všechny záznamy bez ohledu na to, zda již data z Prospectoru mají.
* **Aktualizovat Klienty bez dat z Prospectoru** - aktualizuje pouze záznamy, které dosud nebyly obohaceny daty z Prospectoru.

![Nastavení jednorázové hromadné aktualizace Klientů z Prospectoru v Raynetu](/files/Lg3NnBAZU9dbH1CtgFcn)

***

### Část 2 - Nastavení automatického přenosu Klientů

Automatický přenos je volitelná funkce. Umožňuje přenést firmy z Prospectoru do Raynetu jako nové Klienty na základě přiřazení štítku v Prospectoru.

Nastavení najdete ve stejné sekci jako aktivaci: **Nastavení » Rozšíření » Informace o firmách » Prospector**.

![Nastavení automatického přenosu Klientů z Prospectoru v nastavení Raynetu](/files/JMtssLPitMINwd5tpdMN)

Před nastavením přenosu je potřeba v Prospectoru vytvořit dva štítky - jeden pro firmy určené k přenosu a jeden pro firmy, které již přeneseny byly. Pojmenování je libovolné, v tomto návodu používáme názvy **Pošli do Raynet** a **V Raynet**. Po vytvoření se štítky zobrazí v rozbalovacích nabídkách níže.

Vyplňte tato pole:

**Vlastník nových záznamů** - vyberte uživatele, pod kterým budou vznikat nově vytvořené záznamy Klientů (s jeho nastavenou úrovní bezpečnosti).

**K přenosu** - vyberte Prospector štítek, který identifikuje firmy určené k přenosu. Do Raynetu se automaticky přenese každá firma, kterou tímto štítkem v Prospectoru označíte. Štítek vyberte zvlášť pro české, slovenské a polské firmy.

**Přeneseno** - vyberte Prospector štítek, kterým se budou v Prospectoru automaticky označovat firmy, které se již do Raynetu přenesly. Štítek vyberte zvlášť pro české, slovenské a polské firmy.

> Pokud firma v Raynetu ještě neexistuje, při přenosu se automaticky založí jako nový Klient a obohatí o data z Prospectoru. Pokud Klient v Raynetu již existuje, přenos pouze aktualizuje jeho data na nejnovější hodnoty z Prospectoru.

***

### Řešení potíží

**Data se nezobrazují na kartě Klienta.** Ověřte, že jste API klíč zadali správně a klikli na Aktivovat. Zkuste v Prospectoru vygenerovat nový klíč a v nastavení Raynetu ho aktualizovat.

**Raynet hlásí chybu při uložení API klíče.** Zkontrolujte, že kopírujete celý klíč bez mezer na začátku nebo konci.

**Firma označená štítkem se nepřenesla do Raynetu.** Ověřte, že máte v sekci **K přenosu** vybrán štítek pro správnou zemi firmy (CZ, SK nebo PL). Název štítku musí přesně odpovídat štítku v Prospectoru.

**Záložka Údaje z Prospectoru se nenačítá.** Zkontrolujte, zda je API klíč stále platný. Pokud problém přetrvává, kontaktujte podporu na <support@bizmachine.com>.

***

### Co dál

* [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice)
* [Co je to integrační účet?](/api-a-integrace/integracni-ucet)
* [CRM integrace - přehled](/api-a-integrace/crm-integrace)
* [Jak fungují štítky v Prospectoru](/seznamy-a-export/stitky-workflow)


# Jak nechat AI asistenta číst BizMachine nápovědu

Jak připojit BizMachine nápovědu jako zdroj pro AI asistenty - Claude, Cursor a další MCP klienti.

*Aktualizováno: 30. července 2026*

> **Hledáte BizMachine MCP pro napojení firemních dat do AI workflow?** Tento článek je o něčem jiném - popisuje, jak AI asistent může číst BizMachine nápovědu. Pro napojení firemních dat (firmy, kontakty, události) do AI agentů přejděte do sekce [AI konektor - přehled](https://help.bizmachine.com/ai-konektor-mcp/ai-konektor-prehled).

BizMachine nápověda je dostupná pro AI asistenty přímo - mohou v ní vyhledávat a číst články, aniž byste cokoliv kopírovali. Hodí se například při buildování integrace, kdy chcete, aby AI asistent znal aktuální dokumentaci BizMachine API.

Technicky jde o veřejný MCP server na adrese `https://help.bizmachine.com/~gitbook/mcp`. Nevyžaduje žádný API klíč.

***

## Konfigurace

### Claude na webu (claude.ai)

Dostupné na všech plánech. Free plán je omezen na jeden konektor.

V nastavení najděte sekci **Custom Connectors** a přidejte URL: `https://help.bizmachine.com/~gitbook/mcp`

### Claude Desktop

Dostupné zdarma. Konfiguraci najdete v nastavení aplikace v sekci pro MCP nebo integraci externích nástrojů.

### Cursor / Windsurf, Claude Code a další MCP klienti

Konfigurace je obdobná - viz dokumentaci vašeho nástroje pro přidání vzdáleného MCP serveru přes Streamable HTTP.

> **Technická poznámka:** Server vyžaduje Streamable HTTP transport. Nástroje vyžadující stdio nebo starší SSE protokol nejsou podporovány.

***

## Dostupné nástroje

| Nástroj               | Co dělá                                      |
| --------------------- | -------------------------------------------- |
| `searchDocumentation` | Vyhledá stránky v nápovědě podle dotazu      |
| `getPage`             | Načte konkrétní stránku podle URL nebo cesty |

***

## Instrukce pro AI agenty

```
## BizMachine Help MCP server

DISAMBIGUATION: This is the MCP server for BizMachine help documentation
(help.bizmachine.com). It is NOT the BizMachine data MCP for pulling company
data (firmographics, contacts, events) into agentic workflows. For data access,
see: https://help.bizmachine.com/ai-konektor-mcp/ai-konektor-prehled

Purpose: Read and search BizMachine help articles directly.
No API key required — publicly accessible.

Endpoint:
  https://help.bizmachine.com/~gitbook/mcp

Available tools:
  searchDocumentation(query) — search across all BizMachine help articles
  getPage(path)              — retrieve a specific help page

When to use:
  - You need to look up BizMachine API endpoint details
  - You are building an integration and need current documentation
  - You need to answer questions about BizMachine products or features
```

***

Potřebujete pomoc? Ozvěte se na <support@bizmachine.com>


# Co je to integrační účet?

*Aktualizováno: 24. března 2026*

## Co je to integrační účet?

Integrační (servisní) účet je Prospector účet vystavený na organizaci, který má nastavené vyšší API limity.

Vygenerovaný API klíč pro integrace se vždy váže ke konkrétnímu účtu. Proto zakládáme organizacím integrační účty, na které je API klíč vázaný a má nastavené potřebné API limity. Tento účet doporučujeme vystavit na organizační (obecný) e-mail, aby případné personální změny nezpůsobily deaktivaci účtu a následné vypnutí integrace.

Integrační účet se nepočítá do celkového počtu zakoupených Prospector licencí, jelikož jeho účel je pouze správa integrací. Tento účet má zpravidla menší limit na počet zobrazených firem v Prospectoru.

Pokud máte již integrační účet založený, API klíč vždy generujte s použitím tohoto účtu podle následujícího návodu: "[Jak si vygeneruji API klíč?](https://bizmachine.helpscoutdocs.com/article/61-jak-si-vygeneruji-api-klic)".

![](/files/8PtuunvKDSwrMLkAMewC)


# Jak si vygeneruji API klíč?

*Aktualizováno: 24. března 2026*

## Jak si vygeneruji API klíč?

API klíč si můžete vygenerovat přímo v Prospectoru. Stačí jít do [uživatelského nastavení](https://prospector.bizmachine.com/cz/account-settings) - ikonka Profilu (v právém horním rohu) -> Nastavení -> API. (Pokud v nastavení sekci “API” nevidíte kontaktujte prosím <support@bizmachine.com>)

Zde můžete kliknout na tlačítko **“Vygeneruj API klíč”**. Po kliknutí se zobrazí nově vygenerovaný API klíč.

**POZOR: API klíč si zkopírujte a pečlivě uložte na bezpečné místo, po opuštění stránky již nebude možné tento API klíč znovu zobrazit.**

![Sekce API v nastavení účtu s tlačítkem Vygeneruj API klíč a prázdnou tabulkou klíčů](/files/pJ6aDGlYd4rYCAn3yEUZ)

Jakmile API klíč vygenerujete a uložíte si ho, uvidíte ho v tabulce dole, kde ho můžete snadno identifikovat pomocí prvních 8 znaků. **API klíč zde můžete i deaktivovat** pomocí tlačítka “**Zruš platnost**”.

**Na jednom účtu můžete mít až 10 aktivních API klíčů zároveň.**

![Tabulka vygenerovaných API klíčů s prvními 8 znaky, datem vygenerování a tlačítkem Zruš platnost](/files/PXk40nCy9MxWEDO6p8LB)


# Jaké jsou moje API limity?

*Aktualizováno: 30. července 2026*

### Jaké jsou mé API limity?

API limity se odvíjí od počtu kreditů, které jsou individuální - jejich přesný počet najdete ve své smlouvě.

Kredity lze použít dvěma způsoby:

* **Export firem** z Prospectoru
* **API volání** endpointů (povolené endpointy naleznete ve smlouvě)

Po domluvě kredity rádi přesuneme na API volání, nebo rozdělíme - část na export a část na API. Kontaktujte nás na <support@bizmachine.com>.

### Kolik API limitů jsem již vyčerpal a kolik mi zbývá?

Celkový limit a zbývající měsíční limit API volání naleznete v response header každého API volání. Případně můžete kontaktovat <support@bizmachine.com>, a my Vám obratem Vaše API limity rádi sdělíme.

![Response header s hodnotami Celkový Limit, Zbývající Limit a Datum resetu měsíčního limitu](/files/fxFpDcJ7z91wixOpSO4b)


# AI konektor (MCP) - úvod

Připojte BizMachine k ChatGPT, Claude a dalším AI nástrojům přes konektor (MCP).

Propojte svého AI asistenta přímo s vaším BizMachine workspace. Asistent pak pracuje s ověřenými firemními daty, vašimi štítky a AI Prioritizací, ne s obecnými odpověďmi z webu.

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

## V této sekci

* [Co konektor umí a k čemu slouží](/ai-konektor-mcp/ai-konektor-prehled)
* [Příklady použití AI konektoru](/ai-konektor-mcp/ai-konektor-prompty)
* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)
* [Jak připojit BizMachine v Microsoft Copilot Studiu](/ai-konektor-mcp/ai-konektor-copilot-studio)


# Co konektor umí a k čemu slouží

Přehled, co BizMachine AI konektor (MCP) umí: jaká data a funkce zpřístupní vašemu AI asistentovi, na co stále potřebujete Prospector nebo API a které nástroje konektor podporuje.

*Aktualizováno: 3. srpna 2026*

## AI konektor (MCP): co umí a k čemu slouží

BizMachine AI konektor (MCP) propojí vašeho AI asistenta přímo s vaším BizMachine workspace. Asistent pak pracuje s ověřenými firemními daty z databáze BizMachine, s vašimi štítky a AI Prioritizací, ne s tím, co najde na webu nebo si domyslí. Funguje v ChatGPT, Claude a dalších nástrojích, které podporují MCP.

Tato stránka shrnuje, co konektor umí, na co stále potřebujete Prospector nebo API a jak se připojit.

***

### Co je AI konektor (MCP)?

MCP (Model Context Protocol) je otevřený standard, kterým AI nástroje komunikují s externími zdroji dat. AI konektor je tedy most mezi vaším asistentem a daty v BizMachine workspace.

Pracujete s ním přirozeně, jazykem. Zeptáte se na firmu, segment nebo signál a asistent si odpověď načte přímo z vašeho workspace. Jsou to stejná data, se kterými pracujete v Prospectoru. Konektor k nim dává asistentovi přístup hlavně pro čtení. Umí ale i pár zápisů: založit štítek a měnit, které firmy do něj patří, nebo sepsat a upravit nabídku pro AI Prioritizaci.

### Jak konektor připojím?

* **Adresa MCP serveru (endpoint):** `https://api.bizmachine.com/mcp`
* **Přihlášení:** OAuth 2.0, účtem Microsoft nebo Google. Přihlásíte se jednou a klient se příště připojí sám.
* **Jedno připojení, všechny vaše země.** Konektor zpřístupní každý dataset, na který má váš účet právo (Česko, Slovensko, Polsko, Maďarsko, Německo).

Otestovali jsme claude.ai, ChatGPT a Claude Code. Máme také návod pro Microsoft Copilot Studio. Konektor funguje i s dalšími klienty, kteří podporují MCP přes OAuth.

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

Návody krok za krokem:

* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)
* [Jak připojit BizMachine v Microsoft Copilot Studiu](/ai-konektor-mcp/ai-konektor-copilot-studio)

### K čemu konektor využijete?

* **Příprava na schůzku.** „Připrav mě na zítřejší schůzku s Kofolou.“ Brífink z ověřených dat za pár minut místo ručního dohledávání.
* **Najít firmy větou.** „Najdi výrobní firmy v Praze, které sedí na naši nabídku.“ Segment zúžíte popisem, ne klikáním ve filtrech.
* **Hodnota podle vaší nabídky (ICP).** „Které firmy z mého segmentu se nejlíp hodí na naši nabídku?“ Vaše nabídky pro AI Prioritizaci platí i v asistentovi. Hodnota 0 až 100 s důvody, ne dohady.
* **Porovnat firmy vedle sebe.** „Porovnej Kofolu, Mattoni a Plzeňský Prazdroj. Kdo roste a nabírá?“ Několik firem na jeden dotaz.
* **Aktuální signály a změny.** „Co se za poslední měsíc změnilo u mých TOP účtů?“ Asistent projede vaše segmenty a štítky a vrátí jen to podstatné.
* **Velikost trhu a validace ICP.** „Kolik firem v Česku a Polsku splňuje tato kritéria? Ukaž vzorek.“ Odhad velikosti trhu i přes hranice.

Konkrétní prompty na tyhle i další úlohy, připravené ke zkopírování, najdete v článku [Prompty a příklady použití](/ai-konektor-mcp/ai-konektor-prompty).

### Co konektor umí dnes?

Konektor pracuje s firemními daty. K dispozici máte:

* **Vyhledání firmy** podle názvu, IČO, DIČ, webové adresy, sídla nebo názvu e-shopu.
* **Profil firmy ve třech úrovních:** rychlý souhrn pro porovnání, plný profil do hloubky a detail jedné oblasti (finance, signály, technologie, e-shopy).
* **Vyhledávání a segmentaci** podle filtrů: obor, region, velikost, obrat, obchodní indikátory, AI Prioritizace, štítky, technologie, e-shopy (platforma, návštěvnost, počet recenzí, platební metody, způsoby dopravy a jejich vývoj) i signály. Ve třech režimech: počet, vzorek a seznam.
* **Firemní signály:** nábor, insolvence, změny ve vedení, mediální zmínky a další.
* **Obchodní indikátory** Aktivita, Růst a Oslovitelnost (na škále 0 až 100).
* **AI Prioritizace, čtení hodnoty:** hodnota 0 až 100 podle vaší nabídky (ICP), s vysvětlením, proč firma takto vyšla.
* **AI Prioritizace, sepsání nabídky:** asistent novou nabídku (ICP) napíše nebo upraví. Vyhodnocení pak spustíte v Prospectoru.
* **Štítky:** čtení magických i vašich vlastních štítků a firem, které do nich patří. Asistent umí i založit nový štítek a měnit jeho obsah, tedy přidávat a odebírat firmy.

Konektor pokrývá **11,7 milionu firem v pěti zemích (k červnu 2026)**, průběžně dohledávaných a ověřovaných ze 100+ veřejných zdrojů. Je to stejný datový základ jako v Prospectoru.

### Na co zatím použijete Prospector

Konektor průběžně doplňujeme. Tohle je aktuální stav k 23. červenci 2026. Některá data a funkce jsou zatím dostupné jen v Prospectoru nebo v Prospector API:

**Data, například:**

* **Veřejné zakázky a objemy veřejných peněz** (tendry).
* **Detail a historie pracovních pozic** (nábor).
* **Kontakty na konkrétní osoby.** Profil firmy v konektoru obsahuje firemní kontaktní kanály (web, e-mail, telefon), ne jména a kontakty konkrétních lidí.
* **Vozový park, pobočky, dotace** a podrobná data o vlastnictví, rizicích a financích po řádcích.

**Funkce, například:**

* **Spuštění samotné AI Prioritizace.** Nabídku konektor sepíše, vyhodnocení spustíte v Prospectoru.
* **Uložení vyhledávání jako segment** a správa segmentů.
* **Správa štítků:** přejmenování štítku, změna jeho barvy či popisu, smazání a sdílení s kolegy. (Založit štítek a měnit, které firmy do něj patří, konektor umí.)
* **Sledování signálů s automatickým e-mailem.**
* **Hromadný export a import dat.**

> Konektor rozšiřujeme každý týden, někdy i denně. Co je dnes jen v Prospectoru, může být v konektoru za pár týdnů. Aktuální rozsah vám potvrdí váš kontakt v BizMachine.

### Je připojení bezpečné?

Konektor je navržený tak, aby asistentovi zpřístupnil jen to, co dává smysl:

* **Data na úrovni firmy, ne profily osob.** Osobní údaje vznikají na veřejném zdroji. BizMachine je odtud dohledává a ověřuje. Konektor přitom zpřístupňuje firemní data, ne záznamy o konkrétních lidech.
* **Žádné hromadné stahování.** Režimy počet a vzorek jsou úsporné, seznam je stránkovaný. Kdo potřebuje objem, použije Prospector API s patřičnými kontrolami.
* **Hlavně pro čtení.** Zápisů je málo: práce se štítky (založení štítku, přidání a odebrání firem) a sepsání nebo úprava nabídky pro AI Prioritizaci. Vyhodnocení i další změny děláte v Prospectoru.

### Časté dotazy

**Potřebuji účet v BizMachine?** Ano. Přihlašujete se stejným účtem jako do Prospectoru a konektor pracuje se stejnými daty: s firmami ze zemí, na které má váš účet právo, a navíc s vašimi štítky a AI Prioritizací.

**Vidí asistent moje štítky a AI Prioritizaci?** Ano. Konektor pracuje ve vašem workspace, takže asistent vidí vaše štítky i nabídky nastavené pro AI Prioritizaci.

**Umí mi asistent napsat nabídku pro AI Prioritizaci?** Ano. Asistent novou nabídku (ICP) sepíše nebo upraví, vyhodnocení pak spustíte v Prospectoru a konektor výsledky přečte.

**Funguje to i pro Slovensko, Polsko, Maďarsko a Německo?** Ano. Jedno připojení zpřístupní všechny datasety, na které má váš účet právo. Hloubka dat a pokrytí se mezi zeměmi liší.

**Stahuje AI konektor data hromadně?** Konektor se standardním uživatelským přístupem není určen pro stahování tisíců záznamů. Je určený pro práci s jednotlivými firmami a s prioritizovanými segmenty v konverzaci. Pro hromadný export slouží Prospector a Prospector API. Vyšší limity konektoru umíme nastavit individuálně, podle domluvených podmínek.

**Který AI nástroj mám použít?** Otestovali jsme claude.ai, ChatGPT a Claude Code. Návody máme pro [ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt), [Claude](/ai-konektor-mcp/ai-konektor-claude) a [Microsoft Copilot Studio](/ai-konektor-mcp/ai-konektor-copilot-studio).

***

### Co dál

* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)
* [Jak připojit BizMachine v Microsoft Copilot Studiu](/ai-konektor-mcp/ai-konektor-copilot-studio)


# Příklady použití AI konektoru

Konkrétní prompty pro BizMachine AI konektor (MCP): od přípravy na schůzku a vyhledání firem po prioritizaci celého segmentu podle vaší nabídky. Připravené k vyzkoušení v ChatGPT nebo Claude.

*Aktualizováno: 3. srpna 2026*

Konektor zvládne spoustu různých úloh. Dali jsme proto dohromady řadu příkladů, jak ho využít v praxi a kde začít. U každého promptu doplníte svoje hodnoty a asistent si data načte přímo z vašeho workspace v BizMachine.

Prompty jsou rozdělené podle úrovně: začněte základními a postupně přidávejte složitější. Na konci najdete prompty pro ty, kdo vedou tým.

***

### Než začnete

* **Konektor musíte mít připojený.** Návod máme pro [Claude](/ai-konektor-mcp/ai-konektor-claude), [ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt) i [Microsoft Copilot Studio](/ai-konektor-mcp/ai-konektor-copilot-studio).
* **Text v hranatých závorkách nahraďte svými hodnotami.** `[obor]`, `[kraj]`, `[firma]`, `[částka]`, `[název štítku]`.
* **Buďte konkrétní.** Čím přesnější zadání, tím lepší odpověď. Doplňte obor, region, velikost nebo obrat.
* **Prompty můžete řetězit.** Výsledek jednoho promptu použijte jako vstup pro další.
* Prompty jsou šablony, ne přesná znění. Klidně je přeformulujte vlastními slovy.

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

### Základní prompty: začněte tady

**1. Příprava na schůzku.**

> „Připrav mě na schůzku s firmou \[firma]. Dej mi krátký brífink: co dělají, jak jsou velcí, jak na tom jsou finančně a jestli se u nich poslední dobou něco děje."

Brífink z ověřených dat za pár minut místo ručního dohledávání.

**2. Vyhledání firem přímo v konverzaci.**

> „Najdi \[obor] firmy v \[kraj] s obratem nad \[částka]. Kolik jich je?"

Segment zúžíte popisem, ne klikáním ve filtrech. Asistent vrátí počet, takže hned vidíte velikost.

### Prompty pro každodenní práci

**3. Filtr podle růstu a aktivity.**

> „Z firem v oboru \[obor] v \[kraj] vyber ty, které rostou a aktivně nabírají. Seřaď je podle růstu."

**4. Firmy podle technologií.**

> „Z firem v oboru \[obor] ukaž, u kterých BizMachine uvádí, že používají cloud (AWS, Azure, Google Cloud), a jak jsou jednotlivé technologie zastoupené."

**5. Cílení podle e-shopů.**

> „Ukaž e-shopy na \[platforma] s návštěvností nad \[počet] měsíčně, které nabízejí \[platební metoda]."

**6. Signály a změny u konkrétních firem.**

> „Co se u těchto firem za poslední tři měsíce změnilo: \[firma 1, firma 2, firma 3]? Zajímá mě nábor, změny ve vedení a podobné."

**7. Práce s vašimi štítky.**

> „Vezmi firmy z mého štítku \[název štítku] a zjisti, kolik z nich roste a kolik má aktuálně nějaký signál."

**8. Uložení výsledku filtrování do štítku.**

> „Najdi \[obor] firmy v \[kraj] (\[velikost] zaměstnanců) s nejvyšším růstovým potenciálem a ulož je do štítku \[název štítku]."

Asistent štítek rovnou založí v Prospectoru. Nic nepřepisujete ani neexportujete.

### Pokročilé prompty

**9. Porovnání firem vedle sebe.**

> „Porovnej vedle sebe firmy \[firma A], \[firma B] a \[firma C]. Kdo je největší, kdo nejvíc roste a kdo nejlíp sedí na naši nabídku?"

**10. Prioritizace celého segmentu podle vaší nabídky (ICP).**

> „Z mého segmentu \[název nebo štítek] vyber 20 firem, které podle naší AI Prioritizace nejlíp sedí na naši nabídku. U každé napiš hodnotu a hlavní důvod, proč vyšla takhle."

**11. Vytažení firem z webu do štítku.**

> „Projdi tuhle stránku \[URL], najdi prvních \[počet] firem v BizMachine a ulož je do nového štítku \[název štítku]."

Funguje v asistentovi, který umí číst webové stránky (claude.ai, ChatGPT). Konektor firmy dohledá a založí štítek.

**12. Velká analýza napříč zeměmi na jeden dotaz.**

> „Porovnej, kolik firem v oboru \[obor] s obratem nad \[částka] je v Česku, Polsku a Německu, a dej mi to do tabulky. U českých firem se podívej, kolik jich používá cloud (AWS, Azure, Google Cloud). A pak z mého štítku \[název štítku] vyber ty, co se na tohle hodí nejvíc."

### Prompty pro vedení týmu

Pokud rozhodujete o směru obchodu, konektor odpoví na strategické otázky za pár vteřin.

**Velikost trhu a validace ICP.**

> „Kolik firem v Česku podniká v oboru \[obor], má 50 až 250 zaměstnanců a obrat nad \[částka]? Ukaž mi vzorek deseti firem, ať vidím, koho tím myslíš."

**Srovnání trhů napříč zeměmi.**

> „Porovnej, kolik firem v oboru \[obor] s obratem nad \[částka] je v Česku, na Slovensku, v Polsku a v Německu. Udělej z toho tabulku."

**Co se děje na klíčových účtech.**

> „Co se u našich nejdůležitějších účtů za poslední tři měsíce změnilo: \[seznam firem]? Zajímá mě nábor, změny ve vedení a finanční zdraví."

Největší hodnotu z konektoru dostanete přes AI Prioritizaci, tedy porovnání firem podle vaší konkrétní nabídky (prompt 10 výše). Pokud nabídku v Prospectoru ještě nemáte nastavenou, je to nejlepší první krok.

### Časté dotazy

**Musím konektor nejdřív připojit?** Ano. Prompty fungují až po připojení. Návod máme pro [Claude](/ai-konektor-mcp/ai-konektor-claude), [ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt) i [Microsoft Copilot Studio](/ai-konektor-mcp/ai-konektor-copilot-studio).

**Fungují prompty v ChatGPT i v Claude?** Ano. Otestovali jsme claude.ai, ChatGPT a Claude Code. Konektor funguje i s dalšími klienty, kteří podporují MCP přes OAuth.

**Musím prompt napsat přesně takto?** Ne. Prompty jsou šablony. Přeformulujte je vlastními slovy, důležité je doplnit obor, region, velikost nebo obrat.

**Proč asistent někdy odpoví bez dat nebo si data domyslí?** Nejčastěji jde o slabý model nebo bezplatný účet. Nenapojujte konektor na bezplatné účty ani slabé modely. Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.

**Můžu prompty řetězit?** Ano. Výsledek jednoho promptu použijete jako vstup pro další, třeba nejdřív najdete segment a pak ho necháte seřadit podle AI Prioritizace.

***

### Co dál

* [Co konektor umí a k čemu slouží](/ai-konektor-mcp/ai-konektor-prehled)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)
* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)
* [Jak připojit BizMachine v Microsoft Copilot Studiu](/ai-konektor-mcp/ai-konektor-copilot-studio)


# Jak připojit BizMachine k ChatGPT

Návod, jak ve workspace ChatGPT vytvořit aplikaci BizMachine (krok pro administrátora) a jak ji připojit ke svému účtu (krok pro uživatele), včetně přihlášení a prvního dotazu.

*Aktualizováno: 3. srpna 2026*

## Jak připojit BizMachine k ChatGPT

Tento návod vás provede připojením BizMachine k ChatGPT přes AI konektor (MCP). Po připojení se ChatGPT ptá přímo vašeho BizMachine workspace. Pracuje s ověřenými firemními daty, s vašimi štítky a AI Prioritizací. Ne s tím, co si model najde na webu nebo domyslí.

Pokud hledáte návod pro osobní ChatGPT Plus bez firemního workspace, přeskočte přímo na sekci **Postup pro připojení k osobnímu ChatGPT** níže.

Připojení má dva kroky:

1. **Administrátor** jednou vytvoří aplikaci BizMachine pro celý workspace.
2. **Každý uživatel** si pak aplikaci připojí ke svému účtu a přihlásí se k BizMachine.

> Co konektor umí a co zatím ne, najdete v [přehledu možností konektoru](/ai-konektor-mcp/ai-konektor-prehled).

***

### Co budete potřebovat

* **Účet ChatGPT.** Doporučujeme plán **Business** se silným modelem. Testovali jsme s modelem GPT-5.5.
* **Účet BizMachine** s přístupem do workspace, ke kterému se chcete připojit.
* Pro krok 1 (vytvoření aplikace) roli **administrátora** vašeho ChatGPT workspace.

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

***

### Část 1 - pro administrátora: vytvořte aplikaci BizMachine

Tento krok stačí udělat jednou. Aplikaci pak vidí celý váš ChatGPT workspace a jednotliví uživatelé si ji už jen připojí (Část 2).

#### 1. Otevřete správu aplikací

Přihlaste se do administrace workspace na [chatgpt.com/admin](https://chatgpt.com/admin) a otevřete sekci **Apps**. Vpravo nahoře klikněte na **Create**.

![Sekce Apps v administraci ChatGPT s vyhledáváním a tlačítkem Create vpravo nahoře](/files/eEPEdJi6DX1vtn3tY3rR)

#### 2. Vyplňte údaje aplikace

Otevře se okno **New App**. Vyplňte tato pole:

| Pole                        | Hodnota                                                                                       |
| --------------------------- | --------------------------------------------------------------------------------------------- |
| **Name**                    | `BizMachine`                                                                                  |
| **Description** (volitelné) | `B2B company data, signals, AI prioritization, segments`                                      |
| **Connection**              | záložka **Server URL** (adresa MCP serveru), do pole zadejte `https://api.bizmachine.com/mcp` |
| **Authentication**          | `OAuth`                                                                                       |

Dole zaškrtněte **I understand and want to continue**.

ChatGPT zobrazí upozornění, že vlastní MCP servery představují riziko. To je standardní hláška u každého vlastního konektoru. BizMachine je váš ověřený zdroj dat, takže můžete pokračovat.

![Vyplněné okno New App: název BizMachine, popis, Server URL api.bizmachine.com/mcp, ověření OAuth a zaškrtnuté potvrzení](/files/sR3pc2Fzk9AX1OprXnrD)

#### 3. Nahrajte logo a aplikaci vytvořte

Nahrání loga je nepovinné, ale doporučujeme ho. Tým díky němu aplikaci v seznamu hned pozná. U pole **Icon** klikněte na **+** a nahrajte logo BizMachine.

Logo BizMachine máte rovnou tady. Klikněte na obrázek pravým tlačítkem, zvolte „Uložit obrázek jako…“ a uložený soubor nahrajte u pole **Icon**. Je to malé PNG, které jako ikona v ChatGPT stačí.

![Logo BizMachine k uložení](/files/STr7B3dxaT2oTJ1LJ7jl)

> ChatGPT logo sám nenačte, proto ho administrátor nahrává ručně.

Nakonec klikněte na **Create**.

![Okno New App s nahraným logem BizMachine u pole Icon a zvýrazněným tlačítkem Create](/files/JUEEop6jBXQ0GcbIHz4T)

Aplikace BizMachine je teď připravená pro celý workspace. Uživatelé pokračují Částí 2.

***

### Část 2 - pro uživatele: připojte BizMachine ke svému účtu

Tuto část dělá každý uživatel sám. Předpokladem je, že administrátor už vytvořil aplikaci (Část 1).

#### 1. Otevřete Nastavení a sekci Apps

V ChatGPT otevřete **Settings** (Nastavení) na [chatgpt.com/#settings](https://chatgpt.com/#settings) a vlevo vyberte **Apps** (přímý odkaz: [chatgpt.com/#settings/Connectors](https://chatgpt.com/#settings/Connectors)). V seznamu povolených aplikací klikněte vpravo nahoře na **Add more**.

![Nastavení ChatGPT, sekce Apps se seznamem povolených aplikací a tlačítkem Add more vpravo nahoře](/files/aJ27Prh5ZfKPyR46KeWC)

#### 2. Vyberte BizMachine

V nabídce vyberte **BizMachine**. Má označení **INTERNAL**, protože jde o interní aplikaci vašeho workspace. Klikněte na **Connect**.

![Detail aplikace BizMachine s označením INTERNAL, popisem a tlačítkem Connect](/files/FLdRpd1F3gxBwDyuRJo2)

#### 3. Potvrďte připojení

ChatGPT ukáže, jaká oprávnění aplikace má a jak se nakládá s daty. Klikněte na **Continue to BizMachine**.

![Okno Connect BizMachine s přehledem oprávnění a tlačítkem Continue to BizMachine](/files/VyeSyB8WxnvV0wE1kTnL)

#### 4. Přihlaste se k BizMachine

Otevře se přihlášení k BizMachine. Přihlaste se účtem **Microsoft**, nebo **Google**. Použijte stejný účet, kterým se přihlašujete do BizMachine.

![Přihlašovací obrazovka BizMachine s možností přihlášení přes Microsoft nebo Google](/files/vQd0wwYGyYEJHLoYWTNg)

Při prvním přihlášení vás můžeme požádat, abyste doplnili jméno a e-mail. Po potvrzení je BizMachine připojený k vašemu účtu.

***

### Část 3 - jak BizMachine v chatu použít

#### 1. Zapněte BizMachine pro konverzaci

V chatu klikněte na **+** vedle pole pro zprávu, dál na **More** a vyberte **BizMachine**.

![Otevřená nabídka nástrojů v chatu ChatGPT s vybranou položkou BizMachine v sekci More](/files/lXfA2E39fliAtk0LYNRc)

#### 2. Zeptejte se

Pod polem pro zprávu se objeví štítek **BizMachine**. Teď se můžete ptát na firmy, segmenty nebo signály. ChatGPT si data načte přímo z vašeho workspace.

![Pole pro zprávu v ChatGPT s aktivním štítkem BizMachine a napsaným dotazem na výrobní firmy ve Středočeském kraji](/files/R13ySkfYSZcsxZTknI8p)

Příklad dotazu:

> Najdi energeticky náročné středně velké výrobní firmy ve Středočeském kraji, které mají mezinárodního vlastníka.

***

### Ověření, že vše funguje

Napište jednoduchý dotaz se zapnutým konektorem, třeba:

> Najdi v BizMachine firmu Kofola a shrň, co se u ní za poslední kvartál změnilo.

Pokud ChatGPT v odpovědi zavolá nástroj BizMachine a vrátí strukturovaná data (signály, finance, technologie), je vše připojené správně. Pokud odpoví obecně, aniž by nástroj zavolal, není konektor pro danou konverzaci zapnutý (viz Řešení potíží).

***

### Postup pro připojení k osobnímu ChatGPT

Plus účet nepotřebuje firemní workspace ani administrátora. Aplikaci BizMachine si vytvoříte sami.

#### 1. Povolte Developer mode

V ChatGPT otevřete **Settings** » **Apps** » **Advanced settings**. Zapněte přepínač **Developer mode**.

> ChatGPT zobrazí varování „Elevated Risk" - toto varování se zobrazuje automaticky pro každý custom konektor.

![Nastavení Advanced settings v ChatGPT s přepínačem Developer mode a upozorněním Elevated Risk](/files/b9vbz2AJtfkNfCRr4LSF)

#### 2. Vytvořte aplikaci BizMachine

Vraťte se do sekce **Apps** a klikněte na **Create app**.

![Sekce Advanced settings s tlačítkem Create app](/files/KtW6na3tKB60gTMh0Zj4)

#### 3. Vyplňte údaje aplikace a nahrajte logo

Postup je totožný s kroky 2 a 3 v Části 1 tohoto návodu - vyplňte název, Server URL a OAuth, volitelně nahrajte logo.

#### 4. Přihlaste se k BizMachine

Zobrazí se okno **Add BizMachine to ChatGPT**. Klikněte na **Sign in with BizMachine** a přihlaste se svým účtem Microsoft nebo Google - stejným, kterým se přihlašujete do BizMachine.

![Okno Add BizMachine to ChatGPT s tlačítkem Sign in with BizMachine](/files/jCNezuxrMCRfyTqUfzqT)

#### 5. BizMachine je připravený v chatu

Po přihlášení se BizMachine zobrazí v nabídce nástrojů. Práce s konektorem je pak shodná s Částí 3 tohoto návodu.

![Nabídka nástrojů v chatu ChatGPT s aktivní položkou BizMachine](/files/wAGK0LWlllFNDLoVRliG)

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

***

### Řešení potíží

**V Add more nevidím BizMachine.** Aplikaci musí nejdřív vytvořit administrátor (Část 1). Pokud ji vytvořil teď, načtěte stránku znovu.

**ChatGPT odpovídá obecně a data z BizMachine nepoužil.** Zkontrolujte, že je konektor pro danou konverzaci zapnutý (**+** -> **More** -> **BizMachine**). Pomůže i výslovná instrukce, například „použij BizMachine“. Nenapojujte konektor na bezplatné účty ani slabé modely. Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.

**ChatGPT po čase žádá nové přihlášení.** Přihlášení k BizMachine se po čase obnovuje. Potvrďte přihlášení znovu (Část 2, krok 4).

**Připojil jsem se na bezplatném účtu a výsledky nejsou spolehlivé.** Nenapojujte konektor na bezplatné účty ani slabé modely. Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.

***

### Co dál

* [Co konektor umí a co zatím ne](/ai-konektor-mcp/ai-konektor-prehled)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)


# Jak připojit BizMachine v Claude

Návod, jak v Claude přidat konektor BizMachine pro celou organizaci (krok pro administrátora) a jak ho připojit ke svému účtu (krok pro uživatele), včetně přihlášení, oprávnění nástrojů a prvního dota

*Aktualizováno: 3. srpna 2026*

## Jak připojit BizMachine v Claude

Tento návod vás provede připojením BizMachine k Claude (claude.ai) přes AI konektor (MCP). Po připojení se Claude ptá přímo vašeho BizMachine workspace. Pracuje s ověřenými firemními daty, s vašimi štítky a AI Prioritizací, ne s tím, co model najde na webu nebo si domyslí.

Připojení má dva kroky:

1. **Administrátor** jednou přidá konektor BizMachine do organizace.
2. **Každý uživatel** si konektor připojí ke svému účtu a přihlásí se k BizMachine.

> Co konektor umí a co zatím ne, najdete v [přehledu možností konektoru](/ai-konektor-mcp/ai-konektor-prehled).

***

### Co budete potřebovat

* **Účet Claude.** Krok 1 (přidání konektoru pro celou organizaci) vyžaduje plán s administrací organizace, tedy **Claude Team nebo Enterprise**, a roli administrátora.
* **Účet BizMachine** s přístupem do workspace, ke kterému se chcete připojit.
* Doporučujeme výkonný model. Testovali jsme se Sonnet 4.6.

{% hint style="warning" %}
**Nenapojujte konektor na bezplatné účty ani slabé modely.** Technicky se připojí, ale slabý model neumí pracovat s MCP serverem a data si pravděpodobně vymyslí. Takové napojení není ze strany BizMachine podporované.
{% endhint %}

> **Individuální účet Claude Pro?** Konektor si přidáte sami v **Settings** -> **Connectors** -> **Add** (vpravo nahoře) -> **Add custom connector**. Pokračujte krokem 2 v Části 1. Zbytek návodu zůstává stejný.

***

### Část 1 - pro administrátora: přidejte konektor BizMachine

Tento krok stačí udělat jednou. Konektor se pak nabídne všem členům organizace a každý si ho už jen připojí (Část 2).

#### 1. Otevřete konektory organizace

Klikněte vpravo nahoře na svůj avatar a vyberte **Organization settings**, pak otevřete **Connectors** (přímý odkaz: [claude.ai/admin-settings/connectors](https://claude.ai/admin-settings/connectors)). Klikněte na **+ Add**, vyberte **Custom** a pak **Web**.

![Nabídka Add v nastavení konektorů Claude s vybranou volbou Custom a Web](/files/kXy8C1y7nWWYZAOA6F2Q)

#### 2. Vyplňte údaje a konektor přidejte

V okně **Add custom connector** vyplňte:

| Pole             | Hodnota                          |
| ---------------- | -------------------------------- |
| **Název**        | `BizMachine`                     |
| **Adresa (URL)** | `https://api.bizmachine.com/mcp` |

Claude upozorní, že máte používat jen konektory od zdrojů, kterým důvěřujete. BizMachine je váš ověřený zdroj dat, takže pokračujte. Klikněte na **Add**.

![Okno Add custom connector s názvem BizMachine a adresou api.bizmachine.com/mcp a zvýrazněným tlačítkem Add](/files/ZyRgLa76OouhKsXH3uHK)

Konektor BizMachine je teď v organizaci. Uživatelé pokračují Částí 2.

***

### Část 2 - pro uživatele: připojte BizMachine ke svému účtu

Tuto část dělá každý uživatel sám. Předpokladem je, že administrátor už konektor přidal (Část 1).

#### 1. Najděte BizMachine v konektorech

V levém menu otevřete **Customize** a vyberte **Connectors** (přímý odkaz: [claude.ai/customize/connectors](https://claude.ai/customize/connectors)). V sekci **Not connected** najděte **BizMachine** a klikněte na něj. Vpravo se ukáže „You are not connected to BizMachine yet.“ a tlačítko **Connect**.

![Sekce Connectors v Customize: BizMachine v části Not connected a tlačítko Connect vpravo, s očíslovanými kroky 1 až 4](/files/fKFicupSEaglsCrz03cV)

#### 2. Přihlaste se k BizMachine

Po kliknutí na **Connect** se otevře přihlášení k BizMachine přes OAuth 2.0. Přihlaste se účtem **Microsoft**, nebo **Google**. Použijte stejný účet, kterým se přihlašujete do BizMachine.

![Přihlašovací obrazovka BizMachine s možností přihlášení přes Microsoft nebo Google](/files/vQd0wwYGyYEJHLoYWTNg)

Při prvním přihlášení vás můžeme požádat, abyste doplnili jméno a e-mail. Po potvrzení je BizMachine připojený k vašemu účtu.

#### 3. Nastavte oprávnění nástrojů (doporučeno)

Po připojení můžete určit, kdy smí Claude nástroje BizMachine použít. Doporučené nastavení:

* **Read-only tools** (čtení dat) nastavte na **Always allow**. Dotazy na firmy a segmenty pak běží hladce, bez potvrzování.

![Oprávnění konektoru BizMachine: sekce Read-only tools nastavená na Always allow](/files/I1QgGkpxS2PcnR6QbDsH)

* **Write/delete tools** (zápis) nechte na **Needs approval**. Claude se před jakoukoli změnou, například před sepsáním nabídky pro AI Prioritizaci, nejdřív zeptá.

![Oprávnění konektoru BizMachine: sekce Write/delete tools nastavená na Needs approval](/files/rTKyTi8a2n0gj69fK0YE)

***

### Část 3 - jak BizMachine v chatu použít

#### 1. Otevřete nabídku nástrojů

V chatu klikněte na **+** vlevo dole vedle pole pro zprávu.

![Pole pro zprávu v Claude s tlačítkem plus vlevo dole](/files/BYh3qUUWrXEdQaHhyg9I)

#### 2. Zapněte BizMachine

V nabídce **Connectors** zapněte přepínač u **BizMachine**.

![Nabídka nástrojů v Claude s vybranou položkou Connectors a zapnutým přepínačem u BizMachine](/files/ba2pTDHHQ9wKlgJypDer)

#### 3. Zeptejte se

Teď se můžete ptát na firmy, segmenty nebo signály. Claude si data načte přímo z vašeho workspace.

![Pole pro zprávu v Claude s napsaným dotazem na výrobní firmy ve Středočeském kraji](/files/XkJdxrU2vXuEpZYvf561)

Příklad dotazu:

> Najdi energeticky náročné středně velké výrobní firmy ve Středočeském kraji, které mají mezinárodního vlastníka.

***

### Ověření, že vše funguje

Napište jednoduchý dotaz se zapnutým konektorem, třeba:

> Najdi v BizMachine firmu Kofola a shrň, co se u ní za poslední kvartál změnilo.

Pokud Claude použije nástroj BizMachine a vrátí strukturovaná data (signály, finance, technologie), je vše připojené správně. Pokud Claude odpoví obecně, aniž by nástroj použil, není konektor pro danou konverzaci zapnutý (viz Řešení potíží).

***

### Řešení potíží

**V Connectors nevidím BizMachine.** Konektor musí nejdřív přidat administrátor organizace (Část 1). Pokud ho přidal teď, načtěte stránku znovu.

**Claude se ptá na povolení u každého dotazu.** Nastavte **Read-only tools** na **Always allow** (Část 2, krok 3). Čtení dat pak poběží bez potvrzování.

**Claude odpovídá obecně a data z BizMachine nepoužil.** Zkontrolujte, že je konektor pro danou konverzaci zapnutý (**+** -> **Connectors** -> **BizMachine**). Pomůže i výslovná instrukce, například „použij BizMachine“.

**Claude po čase žádá nové přihlášení.** Přihlášení k BizMachine se po čase obnovuje. Potvrďte přihlášení znovu (Část 2, krok 2).

***

### Co dál

* [Co konektor umí a co zatím ne](/ai-konektor-mcp/ai-konektor-prehled)
* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)


# Jak připojit BizMachine v Microsoft Copilot Studiu

Návod, jak v Microsoft Copilot Studiu vytvořit nástroj BizMachine a přidat ho k agentovi přes MCP konektor.

*Aktualizováno: 30. července 2026*

## Jak připojit BizMachine v Microsoft Copilot Studiu

Tento návod vás provede připojením BizMachine k agentovi v Microsoft Copilot. Po připojení může agent vyhledávat firmy, načítat firemní data a pracovat s vaším BizMachine workspace přímo v průběhu konverzace.

Připojení má dva kroky:

1. **Vytvoříte nástroj BizMachine** - jednou pro celé prostředí Copilot Studia.
2. **Přidáte nástroj k agentovi** - pro každého agenta, který má BizMachine používat.

> Co konektor umí a co zatím ne, najdete v [přehledu možností konektoru](/ai-konektor-mcp/ai-konektor-prehled).

***

### Co budete potřebovat

* **Přístup do Microsoft Copilot Studia** - licence Microsoft 365 nebo Power Platform s Copilot Studiem.
* **Účet BizMachine** s přístupem do workspace, ke kterému se chcete připojit. Přihlášení probíhá přes Microsoft nebo Google - použijte stejný účet jako v BizMachine.

***

### Část 1 - Vytvořte BizMachine konektor

Tento krok stačí udělat jednou. Nástroj pak bude dostupný pro všechny agenty ve vašem prostředí Copilot Studia.

#### 1. Otevřete sekci Nástroje

V levém menu Copilot Studia klikněte na **Nástroje** a pak na **+ Nový nástroj**.

#### 2. Vyberte typ nástroje

V nabídce typů nástrojů vyberte **Model Context Protocol**.

![Nabídka typů nástrojů v Copilot Studiu s vybranou volbou Model Context Protocol](/files/w4NMaiAZuTqgZi2ry7Qk)

#### 3. Vyplňte údaje serveru

V dialogu **Model Context Protocol** vyplňte tato pole:

| Pole                   | Hodnota                                         |
| ---------------------- | ----------------------------------------------- |
| **Název serveru**      | `BizMachine`                                    |
| **Popis serveru**      | libovolný popis, např. `BizMachine AI konektor` |
| **Adresa URL serveru** | `https://api.bizmachine.com/mcp`                |

V sekci **Ověřování** zvolte **OAuth 2.0** a **Typ** vyberte **Dynamické zjištování**. Následně klikněte na **Vytvoření**.

![Formulář pro přidání MCP serveru s vyplněným názvem BizMachine, popisem a adresou https://api.bizmachine.com/mcp](/files/8pPJexyJGKDLGxt8r0Gb)

#### 4. Konektor je připraven

Nyní se tento konektor zobrazí mezi ostatními nástroji.

***

### Část 2 - Přidejte nástroj k agentovi

Tento krok opakujte pro každého agenta, který má BizMachine používat.

#### 1. Otevřete nabídku nástroje

V seznamu nástrojů klikněte na **...** u BizMachine a vyberte **Přidat k agentovi**.

![Seznam nástrojů v Copilot Studiu s konektorem BizMachine a zvýrazněným tlačítkem se třemi tečkami](/files/EzEKW1dd5J6UilqKnkJJ)

#### 2. Vyberte agenta

Ze seznamu vyberte agenta, ke kterému chcete BizMachine přidat, a potvrďte kliknutím na **Přidat**.

#### 3. Vyberte BizMachine z nabídky nástrojů

V dialogu **Přidat nástroj** přepněte filtr na **Model Context Protocol** a vyberte **BizMachine** a následně zvolte **Přidat**.

![Dialog Přidat nástroj s filtrem Model Context Protocol a vybraným konektorem BizMachine](/files/zOW7DOOWy7Vj1mW0unR8)

#### 4. Zkontrolujte nastavení nástroje

Nyní uvidíte konektor BizMachine mezi dostupnými nástroji. Po otevření nástroje můžete provést dodatečná nastavení. Doporučujeme v sekci **Přístupové údaje, které se mají použít** zvolit **Přihlašovací údaje koncového uživatele** - díky tomu se každý uživatel Copilot propojí se svým vlastním Prospector účtem.

![Detail nástroje BizMachine v Copilot Studiu s nastavením přístupových údajů koncového uživatele](/files/5ruOnNFEeFomEzWuBFU3)

***

### Část 3 - Publikování agenta a přidání do kanálu

#### 1. Publikování

Aby byl agent dostupný v Microsoft 365 Copilot Chatu nebo jiném kanálu, je potřeba ho publikovat. Publikování agenta je možné pouze v rámci placené licence.

![Záhlaví agenta v Copilot Studiu se zvýrazněným tlačítkem Publikování](/files/mx6kUHQeOAs7Cl9zD6iQ)

#### 2. Přiřaďte kanál

V nabídce agenta vyberte **Kanály** a zvolte, kde má být agent dostupný.

![Nabídka agenta v Copilot Studiu s vybranou položkou Kanály](/files/So2FJtaKhxHdxW0jsDzS)

#### 3. Vyberte kanál Microsoft 365 a Microsoft Teams

Vyberte v sekci **Kanály Microsoftu** položku **Microsoft 365 a Microsoft Teams**.

![Výběr kanálu v Copilot Studiu se zvýrazněnou položkou Microsoft 365 a Microsoft Teams](/files/1a4BnYViDNfxhNyOivUP)

Následně v nastavení můžete zvolit, komu má být agent dostupný v Microsoft 365 a Microsoft Teams a jaké práva uživatelé mohou mít. Poté klikněte na **Přidat kanál**.

#### 4. Přidejte agenta v Microsoft 365 Copilot Chatu

Přejděte do Microsoft 365 Copilot Chatu. V nabídce agentů najděte **BizMachine MCP Konektor** a klikněte na **Přidat**.

![Karta BizMachine MCP Konektor v Microsoft 365 Copilot Chatu se zvýrazněným tlačítkem Přidat](/files/VxJ3qDueIguwYuBiVWVE)

#### 5. Napište zprávu agentovi

Po napsání zprávy agentovi bude uživatel vyzván k vytvoření připojení. Agent zobrazí odkaz **Otevřít správce připojení**.

![Zpráva agenta BizMachine MCP Konektor s výzvou k otevření správce připojení](/files/7T85FN6bEXTVJb6ywOxO)

#### 6. Vytvořte připojení

V detailu BizMachine připojení klikněte na **Připojit**.

![Správce připojení se seznamem konektorů, BizMachine ve stavu Nepřipojeno s tlačítkem Připojit](/files/JIRsz9ZOMlLvQ1dQrMXT)

Vytvořte připojení pomocí vašeho účtu **Google** nebo **Microsoft** - musí být stejný jako přihlašovací e-mail do Prospectoru.

![Detail BizMachine nástroje s rozbalovací nabídkou Propojení a volbou Vytvořit nové připojení](/files/3iXVQ0IysYKxKSWT75Nm)

Následně zvolte **Vytvořit** a **Odeslat**.

#### 7. Vše připraveno

Nyní se můžete vrátit do agenta. Vše je připraveno.

***

### Řešení potíží

**Agent hlásí „Nejprve vás připojím - otevřete správce připojení".** Vaše přihlášení k BizMachine vypršelo nebo nebylo dokončeno. Otevřete odkaz **Správce připojení** přímo ze zprávy agenta, najděte BizMachine a klikněte na **Připojit**. Přihlaste se znovu a pak se vraťte do konverzace a klikněte na **Opakovat**.

**Připojení se nedaří vytvořit ani po opakovaném pokusu.** Zkontrolujte, že má uživatel v administraci Microsoft 365 nastavenou správnou licenci. Podmínky se mohou průběžně měnit, ale často pomůže přidat uživateli licenci **Microsoft Power Automate Free**.

***

### Co dál

* [Co konektor umí a co zatím ne](/ai-konektor-mcp/ai-konektor-prehled)
* [Jak připojit BizMachine v Claude](/ai-konektor-mcp/ai-konektor-claude)
* [Jak připojit BizMachine k ChatGPT](/ai-konektor-mcp/ai-konektor-chatgpt)


# WebTracks - úvod

Identifikace návštěvníků webu a práce s daty

WebTracks identifikuje firmy, které navštěvují váš web. Propojte data o návštěvnících s Prospectorem a získejte přehled o tom, kdo se o vás zajímá.

## V této sekci

* [WebTracks: přehled funkcí a možností](/webtracks/webtracks-prehled-funkci-a-moznosti)


# WebTracks: přehled funkcí a možností

Přehled všeho, co WebTracks umí - identifikace firem navštěvujících váš web, práce se segmenty, upozornění, propojení s Prospectorem, redukce šumu a integrace s CRM.

*Aktualizováno: 30. července 2026*

## WebTracks: přehled funkcí a možností

WebTracks identifikuje firmy, které navštěvují váš web - bez cookies, bez formulářů. Anonymní návštěvníci se promění v konkrétní seznam firem, které se o vás právě zajímají. Tento článek popisuje, jak WebTracks funguje, co v něm najdete a jak s ním pracovat.

***

### Jak WebTracks identifikuje firmy

WebTracks používá **IP adresu a digitální stopu** návštěvníka - nikoliv cookies. Díky tomu funguje i v prostředí, kde uživatelé odmítají sledování, a nevyžaduje souhlas s cookies.

Nástroje tohoto typu identifikují obecně **10-30 % návštěvníků** webu. Záleží hlavně na tom, odkud návštěvníci přicházejí - firmy s vlastní firemní IP adresou se identifikují lépe než zaměstnanci na sdílené síti poskytovatele. U webů s převážně B2B návštěvností ze západní Evropy nebo USA může identifikace přesáhnout i 50 %.

WebTracks optimalizuje pro co největší záchyt firem, proto zobrazuje **firmy z celého světa** - neomezuje se jen na české firmy s IČO. Pro podrobný profil konkrétní firmy včetně IČO, kontaktů a dalších dat doporučujeme přejít do Prospectoru.

> **Poznámka:** Protože WebTracks optimalizuje záchyt, mohou se u některých firem objevit nepřesná nebo starší data. Pro aktuální a detailní informace k firmám používejte Prospector.

***

### Instalace tracking kódu

Než začnete vidět návštěvníky, musíte na svůj web přidat **tracking kód** vygenerovaný pro vaši doménu.

#### Postup instalace

1. BizMachine vám vygeneruje tracking kód přímo pro vaši doménu.
2. Vy ho nasadíte na stránky, kde chcete identifikovat návštěvníky - typicky celý web.
3. Instalaci obstará správce webu nebo agentura - jde o pár minut práce.
4. Doporučený způsob nasazení je přes **Google Tag Manager**; funguje také s WordPressem, SolidPixels a dalšími CMS.

Po nasazení kódu se první návštěvníci zobrazí **do několika hodin**.

> **Tip:** Kód neovlivňuje rychlost ani funkčnost webu.

***

### Přehled identifikovaných firem

Po přihlášení do administrace WebTracks vidíte **seznam firem**, které váš web navštívily.

#### Co zobrazuje přehled

| Informace                   | Co to znamená                          |
| --------------------------- | -------------------------------------- |
| **Název firmy**             | Identifikovaná společnost              |
| **Počet návštěv**           | Kolikrát firma váš web navštívila      |
| **Navštívené stránky**      | Které URL si prohlížela                |
| **Délka návštěvy**          | Jak dlouho firma na stránkách strávila |
| **Datum poslední návštěvy** | Kdy naposledy firma web otevřela       |
| **Lokalita**                | Přibližná poloha odvozená z IP         |

***

### Segmenty - prioritní skupiny návštěvníků

Ze všech identifikovaných firem si vytvoříte **segmenty** - filtrované skupiny firem podle kritérií, která vás zajímají.

#### K čemu segmenty slouží

* Oddělte relevantní B2B firmy od zbytku návštěvnosti.
* Sledujte firmy z konkrétního odvětví nebo regionu.
* Zaměřte se na nejžhavější leady - například firmy, které navštívily ceník nebo stránku kontaktů.

Segmenty fungují jako živé filtry - automaticky se doplňují o nové firmy, které splní vaše podmínky.

#### Tip: engaged visitors

Nastavte si segment „engaged visitors" - firmy, které na vašem webu strávily **více než 60 sekund**. Tito návštěvníci mají zjevně zájem a stojí za oslovení jako první.

***

### Upozornění v reálném čase

Na každý segment nastavíte **upozornění** - e-mail přijde, jakmile firma ze segmentu navštíví váš web.

#### Typy upozornění

* **Okamžité** - e-mail ihned po návštěvě (vhodné pro menší objemy a prioritní segmenty)
* **Denní přehled** - souhrn za uplynulý den

Obchodní tým tak ví o zajímavém potenciálním zákazníkovi ještě předtím, než stačí odejít ke konkurenci.

***

### Propojení s Prospectorem

WebTracks a Prospector se doplňují. Firmy identifikované ve WebTracks se přenesou do Prospectoru jako **systémové štítky** - automaticky, několikrát denně.

#### Dostupné systémové štítky

* **Webtracks - Všichni návštěvníci** - kompletní seznam firem, které kdy navštívily váš web
* **Webtracks - Návštěvníci za posledních 48 hod.** - firmy aktuálně v pohybu

V detailu štítku vidíte ke každé firmě i informace z WebTracks: kolikrát web navštívila, jaké stránky prohlížela a jak dlouho tam strávila.

#### Co to umožňuje

* Otevřete si plný firemní profil - kontakty, obrat, signály, vlastní indikátory.
* Firmy z WebTracks přidáte do segmentu v Prospectoru a doplníte je dalšími filtry (velikost firmy, odvětví, region).
* Obchodní tým pak dostane hotový seznam leadů k oslovení.

***

### Redukce šumu

Ne každá návštěva webu je obchodně zajímavá. WebTracks nabízí nástroje, jak šum co nejvíce omezit.

#### Jak nastavit sledování strategicky

Hned při spuštění si promyslete:

* Které **konkrétní stránky nebo sekce** webu jsou pro vás ze zákaznického pohledu nejcennější?
* Chcete WebTracks omezit jen na **určité země**?
* Co chcete sledovat vy sami a co obchodní tým?

Čím přesněji nastavíte sledování od začátku, tím méně šumu budete řešit zpětně.

#### Blacklist

Pokud se šum přece jen objeví, začněte budovat **Blacklist** - mažte firmy, které vám v přehledu nepřinášejí hodnotu. Typicky jde o:

* vlastní zaměstnance a kolegy
* konkurenci a partnery
* roboty, crawlery a monitorovací nástroje
* agentury nebo školy

BizMachine má k dispozici **předpřipravený seznam klíčových slov pro Blacklist** - zeptejte se svého zákaznického týmu.

***

### Integrace s CRM a dalšími nástroji

#### Podporované CRM systémy

WebTracks lze propojit s:

* **Salesforce**
* **HubSpot**
* **Pipedrive**

#### Google Analytics

WebTracks funguje i s Google Analytics - data o firmách lze propojit s vaší webovou analytikou.

***

### GDPR a bezpečnost dat

WebTracks je navržen pro B2B prostředí a splňuje požadavky GDPR.

* Identifikuje **firmy, ne osoby** - nepracuje s osobními údaji návštěvníků.
* Nepoužívá cookies a nevyžaduje souhlas se sledováním.
* Veškerá data jsou uložena na serverech v **EU**.

***

### Pro koho je WebTracks nejužitečnější

#### Obchodní tým

Víte o firmách, které se zajímají o vaše produkty nebo služby, ještě předtím, než se samy ozvou. Místo studeného oslovování kontaktujete firmy, u nichž máte konkrétní důvod - navštívily váš web, prohlížely ceník nebo se vracejí opakovaně.

#### Marketingový tým

Anonymní provoz na webu se promění v konkrétní data: které firmy přicházejí, z jakých kanálů, na které stránky. Kampaně ladíte podle toho, koho skutečně přitahují - a ověříte, zda odpovídají vašemu ideálnímu zákazníkovi.

#### Account management

Sledujte, kdy stávající zákazníci navštíví specifické stránky (ceník vyšší verze, nové produkty). Je to přirozený signál pro cross-sell nebo up-sell rozhovor.

***

### Rychlý přehled: co dělat jako první

1. **Nasaďte tracking kód** na svůj web (váš správce webu nebo agentura).
2. **Počkejte pár hodin** - první firmy se začnou zobrazovat samy.
3. **Vytvořte základní segment** - například firmy z vašeho cílového odvětví nebo ty, které navštívily klíčové stránky.
4. **Zapněte upozornění** na tento segment.
5. **Otevřete Prospector** a zkontrolujte štítky Webtracks - u zajímavých firem najděte kontaktní osobu a předejte obchodníkovi.

Potřebujete pomoc se spuštěním? Obraťte se na váš zákaznický tým.


# Bezpečnost a GDPR - úvod

GDPR compliance, ochrana osobních údajů a transparentnost zdrojů dat

BizMachine bere ochranu dat vážně. Tady najdete informace o tom, jak Prospector dodržuje GDPR, odkud pocházejí kontaktní údaje a jak s nimi můžete pracovat.

## V této sekci

* [GDPR a používání dat z Prospectoru](/bezpecnost-a-gdpr/gdpr-pouziti-dat) - právní základ, vaše odpovědnost, podklady pro právníka
* [Odkud máte kontakty?](/bezpecnost-a-gdpr/zdroje-kontaktu) - jak funguje agregátor kontaktů v Prospectoru


# GDPR a používání dat z Prospectoru

Odkud pocházejí data v Prospectoru, jak je můžete zpracovávat a jaké podklady připravit pro právníka nebo DPO.

*Aktualizováno: 30. července 2026*

GDPR chrání osobní údaje fyzických osob. V B2B to platí úplně stejně. Nejde přitom jen o ochranu soukromí. GDPR také zajišťuje, aby informace o lidech byly správné a aktuální, a dává každému (mimo jiné) právo na opravu nepřesných údajů nebo na jejich výmaz.

BizMachine staví své produkty tak, abyste mohli pracovat s daty a zároveň respektovat tato pravidla. Tato stránka vysvětluje, odkud osobní údaje v Prospectoru pocházejí a jak s nimi můžete pracovat.

## Odkud pocházejí osobní údaje o fyzických osobách

Platforma BizMachine obsahuje data z veřejných zdrojů, ale i vlastní analytiku, signály, microsegmenty a další datové vrstvy o právnických osobách, které nejsou veřejně dostupné. Pokud jde ale o **osobní údaje** - tedy data, která identifikují či mohou identifikovat konkrétní fyzickou osobu - ta pocházejí pouze z veřejně dostupných zdrojů. Zejména:

* Veřejné rejstříky (obchodní rejstřík, živnostenský rejstřík)
* Webové stránky firem
* Online seznamy firem a katalogy
* Profesní sociální sítě (LinkedIn)
* Mapové služby
* Pracovní inzeráty

BizMachine tyto roztříštěné informace propojuje, strukturuje a pravidelně ověřuje proti původním zdrojům. Data, která ze zdroje zmizí (třeba když firma smaže kontakt z webu nebo internetového katalogu), se následně odstraní i z Prospectoru.

## Můžu data z Prospectoru použít na oslovení firem?

Pro oslovení firem je nutné zvážit dvě samostatné otázky: jestli můžete osobní údaje *zpracovávat* (to řeší GDPR) a jestli můžete danou osobu *oslovit* (to řeší anti-spam legislativa). GDPR výslovně uvádí, že zpracování osobních údajů pro účely přímého marketingu lze považovat za zpracování prováděné v oprávněném zájmu (Recitál 47). To ale neznamená, že můžete automaticky poslat email nebo zavolat - pravidla pro samotné oslovení se řídí anti-spam legislativou a liší se podle země a kanálu. Doporučujeme jak GDPR, tak anti-spam legislativu prokonzultovat s vaším právním týmem pro váš konkrétní případ.

### Co zajišťuje BizMachine

Právním základem pro zpracování osobních údajů v BizMachine je **oprávněný zájem** (čl. 6 odst. 1 písm. f) GDPR). Konkrétně to znamená:

* Provedli jsme posouzení oprávněných zájmů (tzv. LIA - Legitimate Interest Assessment), na základě kterého jsme vyhodnotili, že naše zpracování lze založit na čl. 6 odst. 1 písm. f) GDPR. Toto posouzení pravidelně aktualizujeme.
* Osobní údaje v Prospectoru pocházejí výlučně z veřejně dostupných zdrojů a týkají se podnikatelské činnosti - ne soukromého života osob.
* Prospector neobsahuje žádné citlivé údaje (zvláštní kategorie osobních údajů).
* Jak se o zpracování dozvědí dotčené osoby? BizMachine to popisuje ve veřejně dostupných [Zásadách zpracování osobních údajů](https://www.bizmachine.com/zasady-zpracovani-osobnich-udaju).
* Data procházejí dvoufázovým procesem (vyhledání a ověření). BizMachine pravidelně kontroluje údaje proti původním zdrojům, jak často závisí na frekvenci aktualizace zdroje. Údaje, které se nepodaří ověřit nebo které ze zdroje zmizely, se odstraňují.

  Stoprocentní přesnost v reálném čase zaručit nelze, ale děláme maximum pro to, aby data v Prospectoru byla aktuální a správná. To je ostatně i požadavek GDPR na přesnost údajů (čl. 5 odst. 1 písm. d)).

**Proč je důležité, že jde o veřejně dostupná data?** Oprávněný zájem není automatický - vyžaduje posouzení, zda zájem správce převáží nad zájmy nebo základními právy dané fyzické osoby. A právě tady hraje roli povaha dat. Pokud jsou údaje veřejně dostupné - třeba v obchodním rejstříku nebo na firemním webu - jejich další zpracování nepředstavuje výrazný zásah do soukromí, protože tato informace je již běžně dostupná z veřejných zdrojů. Dopad na soukromí je výrazně menší, než kdyby šlo o data neveřejná. Navíc osoba, která působí jako jednatel, obchodní ředitel nebo jiný zástupce firmy, může rozumně očekávat, že její profesní údaje budou v obchodním styku zpracovávány. Tyto dva faktory - veřejná dostupnost a profesní kontext - posilují pozici oprávněného zájmu jako právního základu pro práci s B2B daty.

### Co je vaše odpovědnost

Tady je důležité rozlišovat několik věcí:

**1. Zpracování dat (GDPR)**

Když si data z Prospectoru uložíte do CRM nebo podle nich segmentujete trh, ještě to automaticky neznamená, že zpracováváte osobní údaje. Záleží na tom, o jaká data jde:

| Typ dat                                       | Příklad                                                             | Osobní údaje?                                           |
| --------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------- |
| Právnická osoba (bez vazby na fyzickou osobu) | Název firmy, IČO, sídlo, obrat, <info@firma.cz>, telefon na recepci | Ne - GDPR se nevztahuje (ale anti-spam legislativa ano) |
| OSVČ / živnostník                             | Jméno, IČO, adresa provozovny                                       | Ano                                                     |
| Statutární zástupci a vlastníci               | Jednatel, člen představenstva, společníci                           | Ano                                                     |
| Kontakty na konkrétní osoby ve firmě          | Jméno, email, telefon, funkce                                       | Ano                                                     |

Pokud zpracováváte osobní údaje, stáváte se z pohledu GDPR správcem údajů a potřebujete vlastní právní základ. V B2B je to nejčastěji **oprávněný zájem** (čl. 6 odst. 1 písm. f) GDPR) - pracujete s obchodními údaji v kontextu podnikatelské činnosti, ne se soukromými daty. Stačí jednoduché interní posouzení (LIA) - nemusí to být právní elaborát, ale mělo by existovat písemně.

Důležité - dvě věci, které BizMachine nemůže udělat za vás:

* **Souhlas osob v databázi.** BizMachine nezískává souhlas osob se zpracováním ani s oslovením - právním základem BizMachine je oprávněný zájem, ne souhlas. Pokud pro vaše zpracování nebo oslovení potřebujete souhlas, musíte ho získat sami.
* **Informační povinnost.** Když se stanete správcem osobních údajů (třeba tím, že si data uložíte do CRM), máte povinnost dotčené osoby informovat o tom, kdo jste, proč jejich údaje zpracováváte a jaká mají práva (čl. 14 GDPR). Pokud plánujete kontakty oslovit (v souladu s anti-spam legislativou), je tuto povinnost nutné splnit nejpozději při prvním kontaktu.

  Ale pozor: informovat byste měli v přiměřené lhůtě od získání dat, nejpozději do jednoho měsíce. To je další důvod, proč nemá smysl stahovat si velké seznamy kontaktů „do zásoby“ - čím déle data leží v CRM bez toho, abyste s nimi pracovali, tím víc roste vaše nesplněná informační povinnost. BizMachine tuto povinnost plní za sebe zejména prostřednictvím svých Zásad zpracování osobních údajů, ale za vaše zpracování ji splnit nemůže.

**Přesnost a aktuálnost údajů: vy se staráte, BizMachine pomáhá**

GDPR požaduje, aby osobní údaje byly přesné a aktuální (čl. 5 odst. 1 písm. d). Pokud si kontakty uložíte do CRM, je vaší odpovědností je udržovat aktuální a mazat zastaralé údaje. BizMachine vám to usnadňuje:

* **Zdroj a datum verifikace u každého kontaktu.** U každého osobního kontaktu v Prospectoru vidíte, odkud údaj pochází (konkrétní URL) a kdy byl naposledy ověřen. Email a telefon mohou mít různé zdroje i různá data poslední verifikace.

![Detail kontaktu v Prospectoru se zdrojem a datem poslední verifikace](/files/hKlCWT6Zr8QYUSJmhNp3)

* **Export vždy obsahuje zdroj a datum.** Když si stáhnete kontakty do XLSX, export automaticky obsahuje zdrojovou URL a datum posledního ověření. Díky tomu můžete kdykoli doložit, že kontakt pochází z veřejně dostupného zdroje a jak čerstvý je.

![XLSX export z Prospectoru - u každého emailového kontaktu je vidět zdroj a datum posledního ověření](/files/uQAkEIj4F49lE0xnfwT2)

Stejnou strukturu (zdroj + datum ověření) mají i sloupce pro telefon a LinkedIn.

* **API poskytuje totéž.** Endpoint pro osobní kontakty vrací zdrojovou URL a datum poslední verifikace (zvlášť pro email a telefon, pokud pocházejí z různých zdrojů). Na tom můžete postavit automatizovaný proces, který zastaralé kontakty z CRM sám vyřadí.

```json
{
  "company": {
    "name": "Firma s.r.o."
  },
  "person": {
    "name": { "firstName": "Jan", "lastName": "Novák" },
    "roles": [{ "text": "Obchodní ředitel" }]
  },
  "contact": {
    "type": "Email",
    "value": "jan.novak@firma.cz",
    "isPersonal": true,
    "updatedAt": "2026-02-20T18:07:32+00:00",
    "confidence": 0.7,
    "sources": [
      {
        "name": "Firma.cz",
        "url": "https://www.firma.cz/tym",
        "lastCheckedAt": "2026-02-20T18:07:32+00:00"
      }
    ]
  }
}
```

* **Kontakty, které ze zdroje zmizí, BizMachine automaticky ve stanovených lhůtách odstraní.**

Z praxe: některé outbound týmy si kontakt z Prospectoru ověří ještě jednou přímo před telefonátem - podívají se na zdrojovou URL a zkontrolují, jestli je kontakt stále dostupný. Teprve po navázání kontaktu s danou osobou si údaje přenesou do CRM. Pro ně ani den stará data nejsou dost čerstvá a tenhle postup jim dává jistotu.

**2. Samotné oslovení (anti-spam legislativa)**

To, jestli můžete někomu poslat email nebo zavolat, neřeší GDPR, ale pravidla pro nevyžádanou obchodní komunikaci. V ČR je to především zákon č. 480/2004 Sb., v dalších zemích platí obdobné předpisy vycházející z evropské ePrivacy směrnice. Pravidla se liší podle země a kanálu (email, telefon) - proto doporučujeme konzultaci s vaším právním týmem pro váš konkrétní případ.

### Prakticky: co byste měli zvážit při oslovení

* Zdokumentujte si, na jakém právním základu dle GDPR osobní údaje zpracováváte - stačí stručný interní záznam.
* Ověřte si, jaká pravidla pro oslovení platí ve vaší zemi a pro váš kanál (email, telefon). V některých zemích je potřeba předchozí souhlas, jinde stačí možnost odmítnutí.
* Nestahujte hromadně velké seznamy kontaktů. Kontaktní údaje se mění v řádu týdnů - lidé mění pozice, firmy mění emaily. Kdo si jednou stáhne tisíce kontaktů do CRM a pak je měsíce neaktualizuje, sedí na zastaralých datech. Z pohledu GDPR je to problém - zpracováváte nepřesné osobní údaje.
* Oslovujte relevantně - správná firma, správný člověk, správný důvod.
* Informujte kontaktovanou osobu, odkud máte její údaje; buďte transparentní, že se jedná o obchodní nabídku a že údaje pocházejí z veřejně dostupných zdrojů.
* Pokud někdo řekne „nemám zájem, nekontaktujte mě“ - respektujte to a zařaďte si ho do interního unsubscribe seznamu.
* Neprodávejte hned, ale nejdřív přinášejte hodnotu. Místo „domluvme si schůzku“ na první kontakt raději sdílejte užitečný obsah - třeba zajímavý článek, relevantní data z trhu nebo pozvánku na webinář. Budujte vztah postupně. Takový přístup je nejen efektivnější, ale i bližší tomu, jak chtějí být lidé oslovováni.

### Co říct právníkovi nebo DPO

Pokud váš právní tým posuzuje, jestli můžete data z BizMachine použít, tady jsou klíčové informace:

1. **Osobní údaje pocházejí z veřejně dostupných zdrojů.** Veškeré osobní údaje v Prospectoru pocházejí z veřejných rejstříků, webů firem, LinkedIn a dalších otevřených zdrojů. Platforma navíc obsahuje vlastní analytiku a datové vrstvy o firmách, ty ale nejsou osobními údaji. Z pohledu GDPR je klíčové, že osobní údaje v Prospectoru si může dohledat kdokoli.
2. **BizMachine má vlastní LIA (Legitimate Interest Assessment).** Posouzení oprávněných zájmů bylo zpracováno právním týmem a pravidelně se reviduje. Je k dispozici na vyžádání.
3. **Údaje se týkají podnikatelské činnosti, ne soukromého života.** Jde o obchodní kontakty, firemní údaje, role ve firmě - tedy informace, které osoby samy zveřejnily v profesním kontextu.
4. **Zpracování obchodních údajů na základě oprávněného zájmu je běžná praxe.** Oprávněný zájem pro zpracování veřejně dostupných B2B dat je v EU i ČR běžně používaný právní základ. Samotné oslovení pak spadá pod pravidla pro obchodní komunikaci (anti-spam legislativa), ne pod GDPR.
5. **Data jsou pravidelně ověřována a zastaralá data se mažou.** GDPR požaduje, aby osobní údaje byly přesné a aktuální. BizMachine údaje pravidelně kontroluje proti původním zdrojům a neověřitelné nebo zaniklé údaje odstraňuje. Když informace zmizí ze zdroje, zmizí i z Prospectoru.

{% hint style="info" %}
BizMachine neposkytuje právní poradenství. Výše uvedené informace shrnují, jak BizMachine pracuje s daty, a mohou sloužit jako podklad pro vaše vlastní právní posouzení. Pokud si nejste jistí, doporučujeme konzultaci s vaším právním týmem.
{% endhint %}

## Co když někdo z databáze uplatní svá práva dle GDPR?

Může se stát, že osoba, jejíž údaje jsou v Prospectoru, požádá o přístup ke svým údajům, jejich opravu nebo výmaz. Takové žádosti řeší BizMachine:

* **Žádost o výmaz:** BizMachine údaje odstraní.
* **Žádost o opravu:** BizMachine prověří, kde nepřesnost vznikla. Pokud je chyba na původním zdroji (třeba v online katalogu), nejrychlejší cestou je oprava přímo tam. BizMachine údaj při další synchronizaci převezme. Ve výjimečných případech je možný i ruční zásah na naší straně. Vždy se snažíme najít řešení.
* **Námitka proti zpracování:** BizMachine žádost posoudí a pokud neprokáže převažující oprávněný zájem, zpracování ukončí.

Výše uvedená i další práva dle GDPR lze uplatnit prostřednictvím tohoto kontaktu: **<osobniudaje@bizmachine.com>**

## Další informace

* [Zásady zpracování osobních údajů](https://www.bizmachine.com/zasady-zpracovani-osobnich-udaju) - úplné informace pro subjekty údajů
* [Odkud máte kontakty?](/bezpecnost-a-gdpr/zdroje-kontaktu) - jak funguje agregátor kontaktů v Prospectoru
* Otázky k GDPR: **<osobniudaje@bizmachine.com>**

Pokud si v čemkoli nejste jistí, ozvěte se - rádi pomůžeme.


# Odkud máte kontakty?

Jak funguje agregátor kontaktů v Prospectoru - odkud údaje pocházejí, jak se ověřují a co znamená datum poslední kontroly.

*Aktualizováno: 30. července 2026*

## Odkud máte kontakty?

Kontaktní údaje v Prospectoru pocházejí z veřejně dostupných zdrojů. BizMachine je automaticky vyhledává, propojuje a pravidelně ověřuje. Tady se dozvíte, jak to celé funguje.

### Kde kontakty hledáme

BizMachine prochází veřejně dostupné zdroje a vyhledává v nich kontaktní informace:

* Webové stránky firem (sekce „kontakt", „tým", „o nás")
* Veřejné rejstříky (obchodní rejstřík, živnostenský rejstřík)
* Online seznamy firem a katalogy
* Profesní sociální sítě (LinkedIn)
* Mapové služby
* Pracovní inzeráty

V každém zdroji BizMachine dohledá veřejně dostupné údaje (telefony, emaily, jména, funkce) a přiřadí je ke správné firmě.

### Kontakty na profilu firmy

Na profilu firmy v Prospectoru najdete kontaktní údaje v pravém panelu. Zobrazují se telefony a emaily, které se v různých zdrojích vyskytují nejčastěji.

![Profil firmy v Prospectoru s kontaktním panelem vpravo](/files/i4yTpZCXXa6dEXcVqbrc)

Kliknutím na „Více kontaktů" se dostanete do Agregátoru kontaktů, kde vidíte všechny nalezené kontakty ze všech zdrojů.

### Jak se kontakty ověřují

U každého kontaktu vidíte, odkud pochází a kdy byl naposledy ověřen. Ikony u kontaktu ukazují zdroj - web, LinkedIn, katalog. Po najetí myší se zobrazí datum poslední kontroly.

![Detail kontaktu s datem poslední kontroly a ikonou zdroje](/files/c7nsqWOA2vAgEzvfrVim)

**Co to znamená v praxi:**

* **Datum poslední kontroly** říká, kdy BizMachine naposledy ověřil, že se kontakt na daném zdroji stále nachází.
* **Různé kontakty mohou mít různá data.** Email a telefon mohou pocházet z různých zdrojů a mít jiné datum ověření.
* **Když kontakt ze zdroje zmizí** - třeba když firma smaže telefonní číslo z webu - BizMachine ho při další kontrole odstraní i z Prospectoru.

Jak často se kontroly opakují, závisí na typu zdroje. Údaje z webových stránek firem se kontrolují častěji než třeba údaje z katalogů.

### Osobní kontakty

Kromě firemních kontaktů (obecné emaily a telefony) Prospector dohledá i konkrétní osoby ve firmě. Z veřejně dostupných zdrojů propojí jméno, funkci a kontaktní údaje do karty osoby.

![Tabulka osobních kontaktů - jméno, pozice, kontaktní údaje, datum poslední kontroly a zdroj](/files/kD5TRsUygvkIUgQBGMZI)

U každé osoby vidíte:

* **Jméno a funkci** ve firmě
* **Dostupné kontakty** - email, telefon, LinkedIn profil
* **Datum poslední kontroly** pro každý kontaktní údaj zvlášť
* **Zdroj** - odkud údaj pochází (firemní web, LinkedIn, katalog)

Jedna osoba může mít kontakty z více zdrojů. Třeba email z firemního webu a LinkedIn profil ze sociální sítě - každý s vlastním datem ověření.

### Co s tím dál

* **Export obsahuje zdroj a datum.** Když si kontakty stáhnete do XLSX, uvidíte u každého údaje zdrojovou URL a datum poslední kontroly.
* **API vrací totéž.** Endpoint pro osobní kontakty vrací zdrojovou URL a datum ověření - můžete na tom postavit automatizovaný proces v CRM.
* **Právní stránka** (jak kontakty zpracovávat, co říct právníkovi a jak to celé souvisí s GDPR) je podrobně popsaná v článku [GDPR a používání dat z Prospectoru](/bezpecnost-a-gdpr/gdpr-pouziti-dat).