Funkce

Integrace CRM přes API: Wue nemusí být ostrov

Integrace CRM přes API je ve Wue standardní HTTP a JWT token — ne uzavřený konektor. Pracuje s ní Make (Integromat), ale stejné adresy si zavolá váš web, účetní systém nebo skript, který si napíše váš ajťák.

Vyzkoušet integrace zdarma

---

Co jde přes API

Token si vydá administrátor v nastavení organizace. Nese identitu a práva toho, kdo ho vydal — token obchodníka tedy neudělá nic, co by neudělal obchodník. Organizace je v tokenu, ne v adrese.

Konkrétní parametry pro toho, kdo integraci staví: vyhrazená adresa /v1/external/make s dvanácti operacemi, token v hlavičce Authorization: Bearer …, platnost a výchozí limit 600 požadavků za 120 sekund — počítaný na uživatele, ne na IP adresu. Podrobně na stránce otevřené API.

---

Webhooky z Wue (co vám Wue pošle)

Osm událostí; adresa odběratele se registruje pro každou zvlášť, zapnout i vypnout ji jde přes API.

• zákazník založen,
• změna stavu zákazníka,
• změna kontaktů zákazníka,
• změna vlastníka zákazníka,
• zakázka založena,
• zakázka převedena na realizaci,
• změna stavu zakázky,
• změna vlastníka zakázky.

Typické použití: změna stavu na „Výhra" spustí v účetnictví fakturu, změna vlastníka pošle zprávu do Slacku.

---

Příchozí leady (co pošlete vy do Wue)

Webový formulář, kiosek na prodejně, partnerský portál nebo e-mailing posílají poptávky na vlastní adresu webhooku s tokenem. Co je na tom udělané pořádně:

• UTM se u zákazníka uloží vždy — i když nesednou na žádné pravidlo. Surová kampaň se nesmí ztratit, jinak ji nejde zpětně dorovnat.
• Pravidla si spravuje marketing. Hvězdičkové vzory (ne regulární výrazy) nad utm_source, utm_medium, utm_campaign, utm_content a utm_term, nejvýš pět doplňkových podmínek, které musí platit současně, priorita od 0 do 10 000 — a při stejné prioritě vyhrává konkrétnější pravidlo. Vzor má nejvýš 255 znaků.
• Porovnávaných polí je sedm, ne jen pět UTM: kromě nich i přistávací stránka a odkazující web. U leadů z webu to často není doplněk, ale jediné, co dorazí — lead bez jakéhokoli utm_source se podle referreru nebo podle adresy přistání zařadit dá.
• Zkouška pravidla přijme celou adresu kampaně a ukáže, co z ní vyčetla. Překlep v názvu parametru se jinak projeví jen tím, že pravidlo „z nějakého důvodu" nesedne.
• Výchozí zdroj webhooku pro leady bez UTM — třeba formulář na webu, který UTM nenese.
• Vestavěný odhad jen u jednoznačných případů (identifikátory kliku od Googlu a Mety, sociální sítě, organic, referral, cpc). Když si není jistý, nechá prázdno: špatně zařazený lead vypadá v reportu jako pravda.
• Vlastní zdroje leadů si firma zakládá sama (klíč, název, zapnutí). Použitý zdroj nejde smazat, jen vypnout — jinak by u už zařazených leadů zůstal klíč bez názvu.
• Nic se neztratí tiše. Pokus o doručení se zaznamená i při neznámém tokenu nebo příliš velkém těle. Log běhů se drží 90 dní (jsou v něm osobní údaje z leadů), pokusy na neznámý token 14 dní — ty nepatří žádné firmě a dva týdny stačí na odhalení překlepu v adrese. Úklid běží každou noc v 01:30.
• Tvrdá čísla webhooku: tajná část adresy má 48 hex znaků, tělo se přečte až do 5 MB (aby se i nesmyslně velký pokus dal zapsat do logu, místo aby zmizel na chybě parseru) a endpoint zvládne 1200 volání za minutu. Výsledky v logu jsou tři: úspěch, chyba a návštěva adresy.
• Dvakrát poslaný lead nevyrobí dvě karty. Typicky když firma jede webhook a scénář v Make vedle sebe: kartu založí webhook a volání z API o pár sekund později už druhou nevyrobí. Okno je 15 minut, shoda se posuzuje podle e-mailu i telefonu (ten na posledních devíti číslicích, aby nerozhodoval formát) a identifikátory z druhého volání se doplní do první karty.

Pořadí rozhodování o zdroji má pět kroků: zdroj z přijatých dat → pravidla organizace → výchozí zdroj webhooku → vestavěný odhad → nic. Hodnoty, na které nesedlo nic, sbírá každou noc ve 02:00 sken do fronty k vyřízení, takže se nezapomenou.

Zvětšit

---

Hotové integrace

Šest hotových napojení, u kterých nemusíte stavět nic:

---

MCP konektor: Claude nad vašimi daty

Zaměstnanec si ve Wue vydá token a připojí Claude. Ten pak umí najít zákazníka, založit mu místo instalace, vybrat balíček z ceníku a připravit cenovou nabídku — a také zakládat a upravovat ceník (komponenty, součástky, služby, balíčky i jejich obsah). Operací je 21 a jeden dotaz vrátí nejvýš 25 řádků, aby se model nedusil daty a odpovídal z toho, co opravdu přečetl.

Jak je to zabezpečené:

• Token nese identitu toho, kdo ho vydal — model nevidí nic, co by neviděl on, včetně omezení na vlastní záznamy.
• Vydat token smí jen administrátor nebo manažer, a jen v organizaci s rozšířeným přístupem.
• Token jde zneplatnit. Plaintext se ukazuje jedinkrát.
• Zápis do ceníku se ověřuje proti právům, ne proti předpokladu, že token vydal administrátor.
• Konektor nemaže a nepřepíná stavy zakázek. Nová zakázka vzniká ve stavu „CN vytvořena", takže se zákazníkovi nic neodešle, dokud ji člověk neposune dál.
• Model dostává pokyn, že si ceny nemá domýšlet a před zápisem má rekapitulovat a čekat na potvrzení. Pokyn není záruka — výsledek je potřeba zkontrolovat.

---

Exporty

• Celý filtr zakázek nebo zákazníků do Excelu.
• Rozpočet a nákladový rozpad zakázky do Excelu.
• Export ceníku (komponenty, součástky, služby) do CSV nebo XML — obsahuje nákupní ceny, takže jen pro management.

---

Časté otázky

Jak se Wue propojí s ostatními systémy?

Přes Make (Integromat) nebo přímo přes API. Zakládání a úpravy zákazníků, úpravy zakázek a jejich stavů, generování PDF a Excelu pro externí systém. Wue zároveň umí odeslat webhook při změně stavu nebo vlastníka zákazníka a zakázky. Pokud váš systém poskytuje API, umíme data posílat i přijímat.

Jak dostaneme poptávky z webu rovnou do Wue?

Formulář nebo portál posílá data na vlastní adresu webhooku. UTM parametry kampaně se u zákazníka uloží vždy, i když nesednou na žádné pravidlo. Zdroj leadu se přiřadí podle pravidel, která si spravuje marketing, nebo podle výchozího zdroje webhooku; nejednoznačné případy zůstanou nezařazené, protože špatně zařazený lead vypadá v reportu jako pravda. Pokusy o doručení se evidují 14 dní, takže se lead neztratí ani při překlepu v adrese.

Co se stane s našimi daty, když Wue přestaneme používat?

Data jsou vaše. Ceník i zákazníky vyexportujete do Excelu, zakázky a zákazníky jde vytáhnout přes API a každou nabídku, rozpočet i protokol máte v PDF u zakázky. Export si můžete udělat kdykoli v průběhu předplatného, ne až na konci.

---

Probereme vaše systémy

Řekněte nám, co máte — web, účetnictví, portály — a navrhneme propojení.

Vyzkoušet integrace zdarma