Funkce
Otevřené API: CRM, které se dá ovládat zvenčí
Montážní firma má kolem CRM obvykle ještě e-mailing, účetnictví, konfigurátor na webu, Slack nebo Teams a nějakou tabulku, kterou nikdo nechce zrušit. Wue se proto dá ovládat zvenčí: firma si v nastavení vygeneruje API klíč a může zakládat zákazníky, hýbat zakázkami i generovat dokumenty, aniž by u toho někdo sedl k počítači.
Klíč z nastavení, žádné objednávání integrace
Klíč si vygeneruje ten, kdo může upravovat nastavení organizace. Dvě vlastnosti jsou důležité:
- Klíč nese roli a organizaci toho, kdo ho vytvořil. Volání tedy neumí víc než ten člověk — klíč od obchodníka neudělá administrátorskou operaci. Organizace je součástí klíče, ne adresy.
- Práva se vyhodnocují i přes API, včetně ostříhání nákupních cen a marží u rolí, které je nemají vidět.
API je obyčejné HTTP s klíčem v hlavičce. Nepotřebuje Make: volá se stejně dobře z prohlížeče, z Node.js, z curlu nebo z jiné automatizační platformy.
Na co si dát pozor: vygenerování nového klíče nezneplatní ten starý. Nezruší ho ani to, když se jeho autor mezitím přihlásí z jiného zařízení — běžná přihlášení se takhle navzájem odhlašují, service klíč je z toho vyjmutý schválně, aby scénáře nepadaly. Pro přístup, který se dá odvolat jedním kliknutím, je určený token MCP konektoru.
Co se dá přes API dělat
| Oblast | Operace |
|---|---|
| Zákazníci | zakládat, upravovat, hromadně upravovat jedním požadavkem |
| Zákazníci podle cizího ID | dohledat a upravit podle externího identifikátoru, takže se nemusí uchovávat naše ID |
| Zakázky | upravovat, včetně změny stavu; i podle externího identifikátoru |
| Komentáře | přidat komentář k zákazníkovi i k zakázce |
| Kontakty | přidat kontakt (telefonát, e-mail, schůzka) — objeví se i v kalendáři |
| Dokumenty | vygenerovat nabídku, rozpočet, náklady, obhlídku, předávací protokol i ujištění o shodě jako PDF |
| Exporty | vygenerovat rozpočet nebo nákladový rozpis v Excelu |
| Číselníky | přečíst státy a kraje, aby se adresy plnily správnými hodnotami |
| Kontrola klíče | ověřovací volání, kterým integrace potvrdí, že klíč platí |
U generování dokumentů platí důležitá věc: respektuje se vlastní šablona organizace. Automat tedy pošle zákazníkovi nabídku ve vašem znění a brandu, ne systémový výpis — viz sloty dokumentů a editor dokumentů.
K dispozici je i náhled ceny bez založení zakázky: zavoláte sestavu položek a vrátí se rozpad na řádky plus šest čísel — cena před slevou, sleva procentem, fixní sleva, cena bez DPH, DPH a cena celkem —, aniž by v CRM cokoli vzniklo. Tohle používá napojený konfigurátor — kalkulačka na webu pak počítá přesně jako váš ceník a nevyrábí odpadní zakázky. Podrobnosti u cenových nabídek.
Hotová aplikace pro Make.com
Pro Make.com je připravená aplikace s moduly a spouštěči, takže se scénář skládá klikáním:
- Sedm modulů: založit zákazníka, přidat komentář k zákazníkovi i k zakázce, přidat kontakt, nastavit externí identifikátor zákazníka i zakázky, změnit stav zakázky.
- Osm spouštěčů: nový zákazník, změna stavu zákazníka, změna vlastníka zákazníka, změna kontaktů, nová zakázka, změna stavu zakázky, změna vlastníka zakázky, přechod zakázky do realizace.
- Tři pomocné dotazy pro výběrová pole: státy, kraje a seznam zdrojů leadů.
Typické scénáře, které firmy staví: poptávka z webu → zákazník ve Wue → potvrzovací e-mail; výhra zakázky → zpráva do Slacku a záznam v účetnictví; změna stavu → SMS zákazníkovi. Celá příručka včetně příkladů je součástí dokumentace.
Odchozí notifikace: Wue zavolá vás
Druhý směr. Wue umí sama zavolat cizí systém, když se něco stane — osm událostí: založen zákazník, změna stavu zákazníka, změna kontaktů, změna vlastníka zákazníka, založena zakázka, přechod zakázky do realizace, změna stavu zakázky, změna vlastníka zakázky. Adresa odběratele se registruje pro každou událost zvlášť.
Buďme přesní, protože na tom záleží při návrhu integrace: je to jednoduché odeslání bez podpisu, bez logu doručení a bez opakování. Když odběratel v tu chvíli neběží, notifikace je pryč. Pro případy, kde se nic nesmí ztratit, se navrhuje opačný tok — vaše strana se periodicky doptá, nebo se použije příchozí webhook s logem běhů a opakováním.
Čísla pro návrh integrace
Co se obvykle ptá ten, kdo integraci staví:
| Parametr | Hodnota |
|---|---|
| Adresa a autorizace | verzovaná cesta /v1, klíč v hlavičce Authorization: Bearer … |
| Operace na adrese pro integrace | dvanáct: zákazník (založení, úprava, hromadná úprava, úprava podle externího ID), zakázka (úprava a úprava podle externího ID), státy, kraje, zdroje leadů, ověření klíče, zapnutí a vypnutí odběru události |
| Limit volání | ve výchozím nastavení 600 požadavků za 120 sekund, a to na uživatele, ne na IP adresu — kancelář za jednou IP si tedy rozpočet nedělí |
| Platnost klíče | bez vazby na přihlášení toho, kdo ho vydal |
| Odchozí události | osm, adresa odběratele se registruje pro každou zvlášť |
| Generování dokumentů | šest typů PDF (nabídka, rozpočet, náklady, obhlídka, předávací protokol, ujištění o shodě) a dva typy Excelu (rozpočet, nákladový rozpis) |
A jedna pojistka, o které je dobré vědět dopředu: když tentýž lead dorazí dvakrát — jednou ze scénáře a jednou z webového formuláře —, druhá karta nevznikne. Shoda se posuzuje v okně 15 minut podle e-mailu i telefonu (ten na posledních devíti číslicích, aby nerozhodoval formát) a případně podle jména. Identifikátory, které přinesl zahozený druhý lead, se doplní do první karty — do prázdných polí, nic už vyplněného nepřepíšou.
Co je dobré vědět předem
- Leady z webu je obvykle jednodušší poslat na příchozí webhook než budovat scénář — webhook má log, opakování a ochranu proti duplicitám.
- Konverzační přístup nad daty řeší MCP konektor.
- Všechna volání běží ve vaší organizaci; data firem jsou oddělená, viz CRM pro montážní firmu.
- Přehled všech integračních cest má stránka integrace a API.
Časté otázky
Potřebujeme programátora? Pro scénáře v Make obvykle ne. Pro vlastní integraci v kódu ano — API je ale standardní HTTP s klíčem v hlavičce.
Jde přes API vygenerovat naši vlastní smlouvu? Dokumenty se generují po slotech a vlastní šablona se respektuje. Dokumenty bez slotu se vytvářejí v aplikaci.
Dostane se integrace k nákupním cenám? Jen pokud je vidí role toho, kdo klíč vygeneroval.
Dá se klíč zneplatnit? Vygenerováním nového klíče ty starší nepřestanou platit. Pro odvolatelný přístup použijte MCP token.
Zkuste si napojení nasucho
Vygenerujte si API klíč v nastavení firmy a zkuste první volání nad zkušebními daty — třeba založení zákazníka nebo změnu stavu zakázky. Hotová aplikace pro Make.com vás ušetří psaní kódu.
Vyzkoušejte si to na svých cenách
Založíme vám účet, pomůžeme přenést ceník a první nabídku si uděláte sami. 14 dní, bez platební karty.