API a webhooky Leadspickeru

Kterou cestu zvolit

Webhooky

Webhook pošle na vaši URL požadavek HTTP POST s daty ve formátu JSON, kdykoli na vybraných listech a sekvencích nastane zvolená událost.

1. Přidejte webhook

   Jděte do Nastavení → WebHooky a klikněte na Nový webhook. Dejte mu název, podle kterého ho později poznáte.

2. Zadejte cílovou URL

   Adresu, na kterou budou požadavky POST chodit.

3. Vyberte události

   Jednu nebo víc událostí z tabulky níže.

4. Vyberte cíle

   Listy a sekvence, které mají webhook spouštět. Prázdné pole znamená všechny.

5. Otestujte ho

   Otestovat pošle na URL ukázkovou událost a ukáže JSON, který Leadspicker pro každou událost odešle.

URL umí zavolat i sekvence ve zvoleném místě: krok Vlastní akce pošle data za každý kontakt, který k němu dojde, a v nastavení kroku je náhled těchto dat.

REST API a API klíče

Veřejné REST API pracuje se stejnými objekty jako rozhraní: s listy, sekvencemi, kontakty, sloupci a dalšími. Klíč vytvoříte v Nastavení → API klíče tlačítkem Vytvořit nový API klíč; pojmenujte ho podle místa, kde se bude používat, a uložte ho na bezpečné místo.

• Reference. Každý endpoint i s parametry a odpověďmi: API dokumentace.
• Changelog API. Nastavení → Changelog API vypisuje změny endpointů, polí a chování, takže si před úpravou kódu ověříte, co se pohnulo.
• Jeden klíč na jedno použití. S vlastním klíčem pro každou integraci můžete jeden smazat a ostatní nerozbít.

CLI a MCP: cesta pro agenty

Pokud volá AI agent nebo vy z terminálu, API klíč vůbec nepotřebujete. CLI je npm balíček @leadspicker/cli: potřebuje Node.js 22 nebo novější, přihlašuje se přes prohlížeč a každý endpoint API v něm má svůj příkaz. Začněte příkazem npx @leadspicker/cli login; podrobnosti jsou na stránce CLI.

MCP server na adrese https://app.leadspicker.com/mcp dává nástrojům jako Claude Code, Cursor nebo Codex stejné schopnosti v podobě nástrojů, které můžou volat, opět s přihlášením v prohlížeči. Viz MCP server.

n8n a další automatizační nástroje

n8n je automatizační nástroj, na který se Leadspicker napojuje nejčastěji. Nasměrujte webhook z Leadspickeru na webhookový spouštěč v n8n, aby odpověď nebo nový kontakt spustily workflow, a z workflow volejte REST API: přidávejte kontakty, měňte sloupce nebo čtěte výsledky. Ostatní automatizační platformy fungují stejně, pokud umějí přijmout požadavek POST a zavolat REST API; vlastní aplikaci Leadspickeru pro ně nenajdete.

Vlastní klíče AI poskytovatelů

V Nastavení → Vlastní AI poskytovatelé připojíte tlačítkem Přidat API klíč poskytovatele vlastní klíč poskytovatele, například OpenAI nebo Anthropic. Všechny modely toho poskytovatele pak budou k dispozici pro AI sloupce a chaty s asistentem na těchto modelech poběží na vašem klíči místo kreditů.

• Klíč se ukládá šifrovaně a může být sdílený s organizací, nebo soukromý.
• Ve výběru modelu u AI sloupce jsou modely na vlastních klíčích ve zvláštní skupině; účtuje je poskytovatel, ne kredity.
• Vyhledávání na webu v AI sloupci běží na straně Leadspickeru, takže stojí kredity, i když samotný model jede na vašem klíči.