Integrace

mWork365 nemusí stát stranou od zbytku vašeho softwaru. Data z něj můžete číst i zapisovat z vlastního systému, nechat si posílat upozornění na dění v aplikaci a přidat do aplikace vlastní tlačítka, která spustí akci ve vaší službě.

Vše se nastavuje v Nastavení → Integrace; sekci vidí administrátor firmy.

K dispozici máte:

• Veřejné API — REST API pro čtení a zápis dat.
• Webhooky — upozornění na události, které v mWork365 nastaly.
• Make.com — hotové moduly pro propojení bez programování.
• Vlastní akční tlačítka — vaše tlačítko v aplikaci, které zavolá externí službu.
• CRM Raynet — hotové napojení na Raynet.

Jednotlivé možnosti se nevylučují — většina reálných propojení jich kombinuje několik.

Veřejné API

Dokumentace veřejného APIRychlý start, datový model, endpointy a chybové stavy →

Veřejné REST API slouží pro přímé propojení s vaším systémem — ERP, účetnictvím, CRM nebo vlastní aplikací. V nastavení si vytvoříte přístupové údaje (Client ID a Secret Key), vyměníte je za přístupový token a přes API pak čtete a zapisujete data.

Tip

Pro každý napojený systém si vytvořte vlastní dvojici přístupových údajů. Když potřebujete jednu zneplatnit, ostatní integrace to neovlivní.

Webhooky

Webhook je opak dotazování: místo abyste se mWork365 pravidelně ptali, co se změnilo, mWork365 se ozve vám. Jakmile nastane vybraná událost (nová zakázka, dokončený výjezd, změna zákazníka…), pošle na vaši URL požadavek s identifikátory dotčených záznamů. Podrobnosti si pak doberete přes API.

V nastavení u webhooku zadáte:

• Název — jen pro vaši přehlednost.
• Typ události — jednu nebo více událostí, které chcete odebírat.
• URL — adresa, kam se má doručovat.
• Signature secret — klíč pro ověření podpisu. Když ho necháte prázdný, vygeneruje se automaticky.

Seznam všech podporovaných událostí, tvar odesílaných dat a postup ověření podpisu najdete na stránce Webhooky v API referenci.

Automatizace přes Make.com

Pro Make.com existují hotové moduly mWork365 — nemusíte tedy nic programovat ani sami volat API. Ve scénáři poskládáte propojení z připravených kroků a Make.com se o běh postará.

Scénář může vést oběma směry:

• Z mWork365 ven — scénář nastartuje webhook z mWork365, jakmile něco nastane (vznikne zakázka, dokončí se výjezd), a data putují dál do účetnictví, tabulky nebo jiného systému.
• Do mWork365 — scénář spustí událost ve druhém systému (jeho vlastní webhook) nebo pravidelné dotazování a moduly mWork365 pak data zapíšou — založí zákazníka, aktualizují zakázku, doplní materiál.

Co si připravit: přístupové údaje pro volání API a webhook mířící na adresu, kterou vám Make.com vygeneruje.

Poznámka

Scénáře v Make.com pro zákazníky běžně stavíme — pokud si nevíte rady nebo chcete propojení nachystat na klíč, ozvěte se zákaznické podpoře.

Vlastní akční tlačítka

Vlastní akční tlačítko přidá do aplikace vaše vlastní tlačítko, které zavolá externí službu. Uživatel klikne u zákazníka na Odeslat do ERP nebo u zakázky na Vystavit fakturu, vaše služba dostane požadavek s tím, o který záznam jde, a hlášku z odpovědi aplikace rovnou ukáže.

Tlačítka se objevují v přehledech i na detailech záznamů — u zákazníků, zařízení, zakázek, výjezdů, požadavků, materiálu a skladů — a fungují ve webové i v mobilní aplikaci.

V nastavení u tlačítka zadáte:

• Název, popis a ikonu — jak bude tlačítko vypadat.
• Entitu a umístění — u které agendy se tlačítko objeví a jestli v přehledu, nebo na detailu záznamu.
• Metodu a URL — kam a jak se má volat.
• Viditelnost — jestli tlačítko uvidí technici a dispečeři.
• Signature secret — klíč pro podpis odchozích požadavků.
• Potvrzení a obnovení dat — jestli se před akcí zeptat a jestli po ní načíst data znovu.

Tlačítko nemusí mířit jen na vaši vlastní službu — častým řešením je nechat ho spustit scénář v Make.com. Do URL zadáte adresu webhooku daného scénáře a akci na jedno kliknutí tak poskládáte bez programování.

Tvar odesílaných dat, zpracování odpovědi, ověření podpisu i testování popisuje stránka Vlastní akční tlačítka v API referenci.

CRM Raynet

Napojení na CRM Raynet propojuje zákazníky a související data mezi mWork365 a Raynetem — obchod tak pracuje s toutéž kartou zákazníka jako servis.

Pro několik zákazníků už tohle propojení máme hotové a v provozu. Pokud ho zvažujete, ozvěte se nám — projdeme s vámi, co konkrétně se dá synchronizovat a co nastavení obnáší.