Princip a přínosy
Signi je aplikace, služba, IT komponenta, která zajistí elektronické podpisy na dokumenty od vašeho okolí, od vašich zákazníků, dodavatelům či zaměstnanců. Signi lze využívat přes uživatelské rozhraní nebo lze ovládat přes tzv. rozhraní pro programy - API.
Vaše aplikace má obdobně také nějaké API, kterým jde na dálku ovládat, nebo alespoň nějaký export souborů, možnost čtení z databáze apod.
MAKE/ Integromat je pak “lepidlem” mezi aplikacemi, služba, která zajistí, že se obě aplikace domluví na spolupráci s tím, že v něm lze můžete nadefinovat scénáře jak spolu mají “mluvit”, …
…aby byl zautomatizován celý firemní proces.
Než začnete s integrací
Podepisování dokumentů vypadá jako triviální úloha. Pošle se dokument k podpisu a vrátí se podepsaný. Zkušenosti nicméně ukazují, že variabilita procesů spojených s podepisováním je docela veliká. Proto doporučujeme při přípravě na integraci se Signi alespoň zběžně proběhnout následující témata.
To nejdůležitější:
Budete potřebovat vytvořit dva integrační scénáře - jeden předává do Signi podklady, druhý naopak předává zpět výsledky podepisování.
Předávat jako podklady do Signi můžete buď hotové PDF/DOCX soubory nebo jen strukturovaná data pro vyplnění vzoru v Signi.
Získávat výsledky ze Signi zpět můžete tak, že si vytvoříte v Integromatu / MAKE tzv. webhooky a jejichž adresy předáte do Signi při předávání podkladů anebo si z výsledku volání uložíte contract_id tj. číslo dokumentu v Signi a periodicky se budete ptát na jejich stav.
Metody konektoru vs. přímé volání Signi API - Signi konektor pro MAKE/Integromat obsahuje základní metody v základní variantě. Pokud to vaši potřebám nestačí, vždy je v záloze přímé volání endpointů Signi API přes HTTP Request operátor. Jde tak využívat nové a pokročilé funkce.
Přímé volání end pointů Signi API z MAKE/Integromatu
Pokud se rozhodnete pro přímé volání end pointů v Signi API využíváte HTTP operátor MAKE/Integromatu. Obsah pro jeho parametry Příklady volání Signi API a Typické úlohy při integraci .
Příklad integračního scénáře “Google Form > Signi” v Integromatu
Podepsání dokumentu s využitím vzorů dokumentů v Signi je velmi rychlým způsobem integrace, kdy integrovaná aplikace obsahuje podklady pro vytvoření dokumentu, ale vlastní dokument vytvořit neumí, bylo by to moc složité či drahé. Ukázat si to jde na příkladu integračního scénáře “Google Form > Signi” pro MAKE/Integromat, který můžete stáhnout a využít jako vzor pro propojení vaší aplikace.
Využije se vzor dokumentu Signi Testovací smlouva 2022 přístupný v Signi na záložce Vzory.
Pro naplnění údajů do vzoru naplňte v Google Form formulář Signi API - Test Contract 2022.
Pro předání údajů do Signi API se použije integrační scénář Demo Integration - Google Forms > Signi pro MAKE/Integromat, který:
pošle údaje z Google Form formuláře coby příkladu integrované aplikace do Signi API,
z výsledku volání si naopak převezme číslo dokumentu v Signi contract_ID a url_to_sign_in_integrated_app, z které půjde dokument podepsat přímo v integrované aplikace a
všechny údaje odešle přes e-mailovou službu jako příklad zpracování výsledku v integrované aplikaci.
Příkladové Blue Printy integromat scénářů Signi pro Integromat/MAKE si můžete stáhnout níže.
1. Google Form formulář Signi API - Test Contract 2022 jako zdroj údajů pro podepisovaný dokument. Tlačítko Odeslat / Submit odesílá údaje k dalšímu zpracování. | 2. Integrační scénář v Integromatu | 3. Výsledný podepsaný dokumentu zaslaný na e-mailovou adresu z formuláře |
 |  |  |
Stažení a náhrání blueprintů integračních scénářů
Příkladové scénáře integrace se Signi najdete v této složce
Do vašeho prostředí si je naimportujete přes Import Blue Print
Příkladové scénáře mají v sobě API klíč pro workspace DEMO API, API klíč svého workspace si nastavíte v parametrech modulu Signi či HTTP request v integračním scénáři.
