Make.com integrace

Funkční (uživatelská) dokumentace integrace systému Mango do platformy Make.com. Referenční přehled hotových modulů + kuchařka s příklady. Dokument se postupně rozšiřuje — některé části teprve přibudou.

1. Úvod

Co je Mango Custom App pro Make

Mango Custom App je propojení systému Mango (správa zákazníků, služeb a fakturace pro poskytovatele internetu a energií) s automatizační platformou Make.com. Díky ní můžete se zákaznickými daty v Mango pracovat přímo z automatizovaných scénářů v Make — bez programování, klikáním.

V praxi to znamená, že si v Make poskládáte „scénář“ (posloupnost kroků), který sám něco udělá: například při vyplnění webového formuláře založí zákazníka v Mango, jednou denně vyexportuje seznam zákazníků do tabulky, nebo zareaguje na událost, která v Mango nastane.

K čemu slouží

• Hromadné a opakované úkony nad zákazníky (založení, úprava, vyhledání) bez ručního klikání v Mango.
• Propojení Mango s dalšími nástroji přes Make — e-maily, tabulky, formuláře, CRM, chat, stovky dalších aplikací.
• Reakce na události v Mango — Mango umí při určité akci „zavolat“ váš scénář v Make, který pak pokračuje dál.

Pro koho je dokumentace určena

Pro uživatele, kteří staví scénáře v Make a chtějí v nich používat data z Mango. Nepředpokládá programátorské znalosti — stačí základní orientace v Make (co je scénář, modul a propojení).

Co aplikace umí dnes

Aktuálně aplikace pokrývá tyto oblasti:

• Zákazníci — vyhledání, načtení, založení, úprava i smazání
• Služby zákazníka — přehled, detail i správa životního cyklu (aktivace, připojení, pozastavení, ukončení) a vazba služeb na zařízení; parametry zákazníka a zařízení — přehled a detail
• Faktury, platby a daňové doklady — čtení záznamů (například pro export do účetnictví)
• Procesy a jejich úkoly — čtení, zakládání a úprava
• Časové výkazy a přílohy procesů — evidence práce, nahrání a stažení souborů
• Sledování událostí z Mango — workflow, procesy, zákazníci, zařízení a služby (5 spouštěčů) — pokročilé

Aplikace je nasazená v produkčním prostředí Mango. Moduly se v produkci zpřístupňují postupně — aktuální nabídka v Make se proto může od přehledu níže mírně lišit; o zpřístupňování dalších oblastí vás informuje OG Soft.

Podrobný přehled všech modulů je v kapitole 5; co teprve přibude, shrnuje kapitola Co se připravuje.

2. Než začnete

Co potřebujete

• Účet v Make (zóna eu2) s přístupem k aplikaci Mango. Aplikaci do svého účtu přidáte přes pozvánkový odkaz, který vám předá OG Soft.
• Účet v Mango s oprávněním pracovat se zákazníky.
• API token z Mango (návod níže) — tím se scénář k Mango přihlásí.

Jak získat API token z Mango

Token je „heslo“ pro automatizaci. Vygenerujete si ho přímo v Mango:

1. Přihlaste se do Mango.
2. Otevřete Profil → API tokens.
3. Klikněte Add token (Přidat token) a token si zkopírujte.

⚠️ Token zkopírujte hned a uložte bezpečně — zachází se s ním jako s heslem. Kdokoli s tímto tokenem může pracovat s vašimi daty v Mango.

Co je „lokace“ (CT)

Mango eviduje data po lokacích — každá lokace má své číslo, kterému se říká CT (location ID). Lokaci při vytváření připojení nezadáváte — výchozí lokace je daná vaším API tokenem (přiřazuje se tokenu přímo v Mango) a Make si ji zjistí automaticky. U jednotlivých modulů lze lokaci v případě potřeby přepsat v pokročilém nastavení.

3. Připojení k Mango (connection)

Aby modul mohl s Mango komunikovat, vytvoříte v Make připojení (connection). Stačí ho vytvořit jednou a pak ho používají všechny moduly Mango ve scénáři.

Aplikace nabízí dva typy připojení — u každého modulu si vyberete, který použít. Mango User Credentials používá osobní token přihlášeného uživatele (pro interaktivní a osobní scénáře). Mango Location Credentials používá systémový token vázaný na lokaci (pro provozní integrace bez konkrétního přihlášeného uživatele).

Oba typy připojení fungují se všemi moduly. Spouštěče událostí (kapitola 5) používají připojení User Credentials.

Připojení User Credentials — vytvoření krok za krokem

1. V Make scénáři přidejte libovolný modul Mango (např. Get Customer).
2. U položky Connection klikněte na Create a connection.
3. Vyplňte dvě pole:
4. Environment — prostředí Mango. Production = ostrá data, Test = testovací prostředí pro zkoušení. (Výchozí: Production.)
5. API Token — token zkopírovaný z Mango (Profil → API tokens).
6. Klikněte Save.

Make si při uložení ověří, že je token platný, a automaticky k němu z Mango načte výchozí lokaci (CT), na kterou je token vázaný. Pokud je vše v pořádku, připojení se uloží a je připravené k použití.

💡 Adresu serveru Mango nezadáváte — Make si ji zvolí automaticky podle pole Environment (Production / Test).

Připojení Location Credentials (systémový token lokace)

Vhodné pro provozní a integrační scénáře, které běží samostatně, bez vazby na konkrétního přihlášeného uživatele. Vyplníte tato pole:

• Environment — prostředí Mango (Production nebo Test).
• API Token — token lokace z Mango (Lokace → API tokens → Add token). Token je vázaný na konkrétní lokaci, proto lokaci (CT) nezadáváte — určuje ji token.
• Login ID — číselné ID uživatele (typicky systémového nebo integračního), pod kterým se operace provádějí. Najdete ho ve správě uživatelů v Mango.

Protože lokaci určuje token, pokročilé pole pro přepis lokace (CT) u tohoto typu připojení nemá efekt.

Když připojení nefunguje

• „Authentication failed. Check your API token.“ (chyba 401) — token je neplatný, vypršel, nebo byl zkopírován neúplně. Vygenerujte v Mango nový a vložte ho znovu.
• Chyba 401 u modulů, přestože je token platný — token nejspíš nemá v Mango přiřazenou lokaci (CT). Přiřaďte tokenu lokaci v Mango, nebo lokaci u modulu vyplňte v pokročilém nastavení.

4. Jak přidat modul Mango do scénáře

Obecný postup je u všech modulů stejný:

1. V Make vytvořte nebo otevřete scénář.
2. Klikněte na + a vyhledejte aplikaci Mango.
3. Vyberte modul podle toho, co chcete udělat (např. Create Customer).
4. Zvolte připojení (connection) vytvořené v kapitole 3.
5. Vyplňte pole modulu. Méně častá pole jsou schovaná pod Show advanced settings.
6. Modul si vyzkoušejte tlačítkem Run once — Make modul jednou spustí a ukáže výsledek.

💡 Pole, která nevyplníte, se většinou neodešlou (u úprav to znamená „neměnit“). U povinných polí Make nedovolí scénář spustit, dokud je nevyplníte.

5. Přehled modulů

Aplikace dělí moduly do skupin podle oblasti. U čtení platí obecný vzor List → Get: nejdřív najdete záznam v seznamu (List), pak si načtete jeho detail (Get).

Zákazníci (Customers)

List Customers — Hledání zákazníků

Co dělá: Vrátí seznam zákazníků z Mango. Umí fulltextové hledání i filtrování.

Klíčová pole:

• Search — text, který se hledá ve jméně, příjmení a názvu firmy (nepovinné).
• Active only — vrátí jen aktivní zákazníky (nepovinné).
• Limit — maximální počet vrácených záznamů (výchozí 10).
• Pokročilé: filtr na konkrétní Customer IDs, Location IDs (lokace), skupiny zákazníků a zařízení.

Co dostanete: seznam zákazníků; u každého základní údaje (ID, login, jméno/firma, adresa, IČO/DIČ, stav aktivace) a kontakty (telefony, e-maily).

Na co pozor: počet výsledků řídíte polem Limit. Hodí se jako první krok scénáře, na který navazují další moduly (např. Get Customer pro detail).

Get Customer — Načtení zákazníka

Co dělá: Načte detail jednoho konkrétního zákazníka.

Klíčová pole:

• Customer — zákazník, kterého chcete načíst. U pole je vyhledávací tlačítko — můžete zákazníka najít podle jména, loginu nebo firmy, nemusíte znát jeho ID.

Co dostanete: kompletní údaje o zákazníkovi (stejná sada polí jako u List Customers).

Create Customer — Založení zákazníka

Co dělá: Založí v Mango nového zákazníka.

Pole jsou rozdělená do skupin:

• Login & contact — Login a Password (povinné), telefony, e-maily (alespoň jeden e-mail je obvykle vyžadován) a nastavení, jak zákazníka informovat (e-mail / pošta / SMS, marketingový souhlas).
• Personal details — Type (typ osoby: fyzická / podnikatel / firma), jméno a příjmení, případně název firmy a IČO/DIČ.
• Address — ulice, číslo, město, PSČ.
• Location (povinné) — lokace (CT), pod kterou zákazník vznikne. Výchozí lokace z připojení je předvybraná.
• Billing Plans — tarify/ceníky. Nabídka se automaticky přizpůsobí vybrané lokaci.

Co dostanete: údaje nově založeného zákazníka (včetně jeho nového ID).

Na co pozor: povinné je Login, Password, typ osoby a Location. Podle typu osoby Mango vyžaduje jméno (fyzická osoba) nebo název firmy (firma). Když nějaké povinné údaje chybí, Mango založení odmítne s chybou.

Update Customer — Úprava zákazníka

Co dělá: Upraví existujícího zákazníka. Jde o částečnou úpravu — odešlou se jen pole, která vyplníte; ostatní zůstanou beze změny.

Klíčová pole:

• Customer (povinné) — výběr zákazníka (stejné vyhledávací tlačítko jako u Get Customer).
• Dále stejné skupiny jako u zakládání (kontakt, osobní údaje, adresa) — vše nepovinné.
• Pokročilé: Active State — stav zákazníka (aktivní / neaktivní / smazaný).

Na co pozor:

• Prázdné pole = „neměnit“. Chcete-li něco vymazat, je potřeba do pole vložit prázdnou hodnotu vědomě.
• Lokaci (CT) zákazníka nelze měnit.
• Nastavení Active State na hodnotu „smazaný“ slouží jako náhrada za smazání, když zákazníka nelze běžně smazat (viz Delete Customer).

Delete Customer — Smazání zákazníka

Co dělá: Smaže zákazníka z Mango.

Klíčová pole:

• Customer ID (povinné) — ID zákazníka ke smazání.

Co dostanete: potvrzení o smazání (příznak úspěchu a ID smazaného zákazníka).

Na co pozor: smazání selže, pokud má zákazník aktivní služby, neuhrazené pohledávky nebo otevřené procesy. V takovém případě nejdřív ukončete jeho služby, nebo místo smazání použijte Update Customer a nastavte Active State na „smazaný“.

Služby zákazníka (Customer Services)

Přehled a detail služeb, které má zákazník aktivované (tarify, jednorázové i opakované služby). Platí obecný vzor List → Get: nejdřív najděte záznam v seznamu, pak si načtěte jeho detail.

List Customer Services — vrátí seznam služeb; filtry: zákazník, druh služby, stav.

Get Customer Service — detail jedné služby podle ID (platnost od/do, stav, parametry).

Activate Customer Service — Co dělá: aktivuje (založí) novou službu zákazníkovi. Klíčová pole: zákazník (povinné), definice služby z nabídky (povinné), datum zahájení a fakturace (povinné); volitelně tarif, cena, parametry služby. Co dostanete: údaje nově založené služby.

Pause Customer Service — Co dělá: pozastaví (zablokuje) aktivní službu. Klíčová pole: ID služby (povinné), datum účinnosti; volitelně blokace fakturace, poznámka.

Unpause Customer Service — Co dělá: obnoví (odblokuje) pozastavenou službu. Klíčová pole: ID služby (povinné), datum účinnosti.

Finish Customer Service — Co dělá: ukončí (zruší) službu zákazníka. Klíčová pole: ID služby (povinné), datum ukončení. Na co pozor: ukončení služeb zákazníka je nutné předtím, než lze zákazníka smazat (viz Delete Customer).

Connect Customer Service — Co dělá: připojí připravenou, dosud nepřipojenou službu (stav „Nepřipojeno“) — služba se tím stane aktivní. Klíčová pole: ID služby (povinné); volitelně datum účinnosti. Na co pozor: vyžaduje odpovídající oprávnění v Mango a službu připravenou k připojení, jinak Mango požadavek odmítne.

Attach Service to Device — Co dělá: naváže službu zákazníka na zařízení. Klíčová pole: ID zařízení a ID služby (povinné). Na co pozor: opakované navázání téže dvojice ničemu nevadí (vrátí existující vazbu); navázání základní služby ale automaticky odpojí případnou jinou základní službu, která už na zařízení byla.

Detach Service from Device — Co dělá: zruší vazbu mezi službou zákazníka a zařízením. Klíčová pole: ID zařízení a ID služby (povinné). Na co pozor: pokud vazba neexistuje, modul skončí chybou; služby závislé na odpojované službě se odpojí spolu s ní.

Parametry zákazníka (Customer Params)

Doplňkové parametry (vlastní pole) zákazníka, často s časovou platností (od/do).

List Customer Params — vrátí aktuálně platné parametry zákazníka; volitelně filtr podle názvu nebo data platnosti.

Get Customer Param History — celá historie platnosti jednoho parametru (včetně plánovaných a expirovaných).

Set Customer Param — vytvoří nebo upraví parametr (upsert) podle názvu; u časově platných může vložit nový interval místo přepsání.

Delete Customer Param — smaže parametr (celý pár zákazník + název). Časově platné parametry smazat nelze.

Zařízení (Devices)

Evidence zařízení vázaných na zákazníky.

List Devices — seznam zařízení; filtry: zákazník, typ, stav, lokace.

Get Device — detail zařízení podle ID včetně parametrů.

Vazbu mezi službou zákazníka a zařízením spravují moduly Attach Service to Device a Detach Service from Device (najdete je v části Služby zákazníka).

Faktury (Invoices)

Čtení vystavených faktur — hodí se pro export do účetnictví nebo kontrolu úhrad.

List Invoices — seznam faktur; vyžaduje aspoň jeden filtr (zákazník, období, stav).

Get Invoice — detail faktury podle ID včetně položek.

Daňové doklady (Internal Tax Documents)

Čtení interních daňových dokladů.

List Internal Tax Documents — seznam dokladů; vyžaduje aspoň jeden filtr (zákazník, období).

Get Internal Tax Document — detail dokladu podle ID.

Platby (Payments)

Čtení přijatých plateb — například pro párování úhrad ve scénáři.

List Payments — seznam plateb; vyžaduje aspoň jeden filtr (zákazník, období, platební účet).

Get Payment — detail platby podle ID.

Procesy (Processes)

Čtení procesů (úkolů/tiketů) vedených v Mango.

List Processes — seznam procesů; filtry: zákazník, typ, stav, období.

Get Process — detail procesu podle ID včetně navázaných úkolů a příloh.

Create Process — Co dělá: založí nový proces (úkol/zakázku údržby). Klíčová pole: typ úkolu (povinné), název (povinné); volitelně priorita, popis, zákazník nebo místo (premise), parametry. Na co pozor: některé typy úkolů vyžadují navíc zákazníka nebo místo. Zakládání procesů je teď na straně Mango dočasně omezené (řešíme s vývojem Mango); úprav existujících procesů (Update Process) se to netýká.

Update Process — Co dělá: upraví existující proces (částečná úprava — odešlou se jen vyplněná pole). Klíčová pole: proces (povinné) a dále stav (State Change — proces tím dokončíte nebo potvrdíte), priorita, popis, řešitel, parametry. Na co pozor: změna stavu může v Mango spustit navazující workflow (a tím i Watch Workflow Hook).

Úkoly procesů (Process Jobs)

Jednotlivé úkoly uvnitř procesu — čtení i zakládání a úprava.

List Process Jobs — seznam úkolů procesu; filtry: proces, stav, období.

Get Process Job — detail úkolu podle ID.

Create Process Job — Co dělá: založí nový úkol v procesu. Klíčová pole: proces (povinné), popis, termín, řešitel; volitelně opakování. Na co pozor: úkoly se neruší mazáním, ale změnou stavu.

Update Process Job — Co dělá: upraví úkol (částečná úprava — odešlou se jen vyplněná pole). Klíčová pole: úkol (povinné), stav, řešitel, notifikace, opakování.

Přílohy procesů (Process Attachments)

Práce se soubory navázanými na proces — nahrání a stažení.

Upload Process Attachment — Co dělá: nahraje soubor jako přílohu k procesu. Klíčová pole: proces (povinné), soubor (povinné — namapujte z výstupu předchozího modulu), volitelně název a popis. Na co pozor: soubor se nezadává ručně, mapuje se z předchozího modulu (např. příloha z e-mailu).

Download Process Attachment — Co dělá: stáhne přílohu procesu jako soubor. Klíčová pole: proces; příloha — vyhledávací tlačítko, vyberete ji podle názvu. Co dostanete: soubor (obsah i název) připravený k použití v dalším modulu (uložení na Disk, odeslání e-mailem).

Časové výkazy – práce (Time Tracking Works)

Evidence odpracovaného času — výkazy práce.

List Time Tracking Works — seznam výkazů; filtry: zákazník, proces, stav, období, pracovník.

Get Time Tracking Work — detail výkazu podle ID.

Create Time Tracking Work — Co dělá: založí nový výkaz práce. Klíčová pole: typ a vazba na zákazníka, proces nebo úkol.

Update Time Tracking Work — Co dělá: upraví výkaz (částečná úprava).

Delete Time Tracking Work — Co dělá: smaže výkaz práce.

Časové výkazy – aktivity (Time Tracking Activities)

Jednotlivé aktivity (časové úseky) uvnitř výkazu práce.

List Time Tracking Activities — seznam aktivit; filtry: výkaz, pracovník, období.

Get Time Tracking Activity — detail aktivity podle ID.

Create Time Tracking Activity — Co dělá: přidá aktivitu k výkazu práce. Klíčová pole: výkaz (povinné), pracovník, trvání.

Update Time Tracking Activity — Co dělá: upraví aktivitu (trvání, poznámky).

Delete Time Tracking Activity — Co dělá: smaže aktivitu (dle oprávnění jen vlastní).

Události z Mango (pokročilé)

Spouštěče fungují ve dvou režimech. Čtyři spouštěče událostí (Watch Process, Customer, Device a Service Events) se o napojení na Mango postarají samy — webhook si v Mango zaregistrují při aktivaci scénáře a při jeho vypnutí ho zase odregistrují. Watch Workflow Hook je naopak pasivní adresa, kterou je potřeba vložit do workflow v Mango (nastavení zajišťuje OG Soft).

Události přicházejí jen do aktivního (zapnutého) scénáře — když je scénář vypnutý, události se nedoručují a po opětovném zapnutí se zpětně nedoženou. Spouštěče pokrývají procesy, zákazníky, zařízení a služby zákazníků; na ostatní dění v Mango lze reagovat přes Watch Workflow Hook a workflow v Mango.

Watch Workflow Hook — Sledování událostí workflow

Co dělá: Spustí scénář ve chvíli, kdy Mango workflow zavolá tento webhook (akcí CALL_WEBHOOK v Mango). Tím lze na dění v Mango reagovat v reálném čase.

Co dostanete: informace o události — typ objektu, akce, ID objektu, lokace (CT), a navíc dvě pole pro ověření pravosti: _verified (zda je podpis platný) a _ts (čas události).

Na co pozor (důležité):

• Tento modul je spouštěč (trigger) — stojí na začátku scénáře.
• Z bezpečnostních důvodů ve scénáři hned za spouštěč zařaďte filtr _verified = true. Tím zajistíte, že scénář zpracuje jen ověřené (pravé) události a zahodí podvržené.
• Nastavení webhooku (propojení s Mango, bezpečnostní klíč) provádí OG Soft při zprovoznění — bez něj spouštěč nic nepřijme.

Watch Process Events — Sledování událostí procesů

Co dělá: Spustí scénář, když se v Mango proces (úkol/zakázka údržby) vytvoří, upraví, změní stav, dokončí nebo potvrdí. Webhook se sám zaregistruje při aktivaci scénáře a odregistruje při jeho vypnutí.

Co dostanete: odkaz na událost — typ objektu, akce, ID, lokace (CT). Podrobnosti procesu si pak načtěte modulem Get Process.

Na co pozor: stejně jako u Watch Workflow Hook zařaďte hned za spouštěč filtr _verified = true. Samotné zprovoznění (bezpečnostní klíč) zajišťuje OG Soft.

Aplikace nabízí ještě tři obdobné spouštěče — Watch Customer Events, Watch Device Events a Watch Service Events. Fungují stejně jako Watch Process Events: samy se zaregistrují v Mango při zapnutí scénáře, u každého zvolíte Akci (kterou událost sledovat, nebo všechny — zúžení šetří operace, protože nechtěné události se vůbec nedoručí) a Rozsah (Lokalita, Partner, nebo Všechny; partnerský a globální rozsah vyžadují odpovídající oprávnění). Payload nese jen odkaz na událost (typ objektu, akce, ID, lokace) — detail dotáhnete odpovídajícím modulem Get. Bezpečnostní filtr _verified = true a nastavení klíče (OG Soft) platí stejně. Liší se jen sledovanou entitou:

Watch Customer Events — Sledování událostí zákazníků

Spustí scénář při vytvoření, úpravě nebo smazání zákazníka. Detail zákazníka dotáhnete modulem Get Customer.

Watch Device Events — Sledování událostí zařízení

Spustí scénář při vytvoření, úpravě nebo smazání zařízení v evidenci. Detail zařízení dotáhnete modulem Get Device. Síťové události zařízení (výpadky, dohled/monitoring) tento spouštěč nezachytává — jejich podpora v aplikaci bude ještě upravena.

Watch Service Events — Sledování událostí služeb

Spustí scénář při vytvoření, úpravě, smazání, pozastavení nebo obnovení služby zákazníka. Detail služby dotáhnete modulem Get Customer Service.

6. Kuchařka — příklady (recepty)

Konkrétní mini-scénáře, na kterých si použití vyzkoušíte. Postupy jsou stručné; podrobnější návody a obrázky doplníme.

Recept 1: Vyhledání zákazníka podle jména

Cíl: najít zákazníka a získat jeho detail.

1. Přidejte modul List Customers.
2. Do pole Search zadejte jméno nebo firmu (např. „Novák“).
3. Zapněte Active only, ať se neukazují zrušení zákazníci.
4. Spusťte Run once — uvidíte seznam odpovídajících zákazníků.

Chcete-li jen jednoho konkrétního zákazníka, použijte rovnou modul Get Customer s jeho vyhledávacím tlačítkem.

Recept 2: Založení nového zákazníka

Cíl: založit zákazníka (např. z údajů z formuláře).

1. Přidejte modul Create Customer.
2. Vyplňte Login a Password.
3. Zadejte alespoň jeden e-mail.
4. Ve skupině Personal details vyberte Type a doplňte jméno/firmu podle typu.
5. Ponechte předvybranou Location (nebo vyberte jinou) a případně zvolte Billing Plans.
6. Spusťte Run once — v Mango vznikne nový zákazník a modul vrátí jeho ID.

V reálném scénáři pole nevyplňujete ručně, ale „mapujete“ je z předchozího modulu (např. z odpovědi formuláře).

Recept 3 (pokročilý): Reakce na událost z Mango workflow

Cíl: spustit scénář, když v Mango nastane určitá událost.

1. Jako první modul scénáře přidejte Watch Workflow Hook.
2. Hned za něj přidejte Filter s podmínkou _verified = true.
3. Za filtr zařaďte, co se má stát (např. poslat e-mail, zapsat řádek do tabulky).
4. Scénář aktivujte. Zprovoznění napojení na straně Mango zajistí OG Soft.
5. Stejným způsobem (najít přes List → načíst přes Get → navázat akci) postavíte scénáře i nad dalšími oblastmi — například stáhnout přílohu z procesu modulem Download Process Attachment, zaevidovat odpracovaný čas modulem Create Time Tracking Work nebo vyexportovat faktury modulem List Invoices.

Recept 4: Systémové připojení přes Location Credentials

Cíl: připravit provozní scénář, který běží samostatně, bez osobního účtu.

6. V Mango si připravte token lokace (Lokace → API tokens → Add token) a zjistěte Login ID systémového uživatele.
7. V libovolném modulu Mango u položky Connection zvolte Create a connection a typ Mango Location Credentials.
8. Vyplňte Environment, API Token (token lokace) a Login ID. Lokaci (CT) nezadáváte — určuje ji token.
9. Připojení uložte a dál ho používejte v modulech scénáře; spouštěče událostí zůstávají na User Credentials.

Kdy zvolit tento typ: pro trvale běžící integrace (například noční synchronizace nebo příjem událostí), kde scénář nechcete vázat na konkrétního přihlášeného uživatele.

7. Časté otázky a řešení potíží (FAQ)

Modul hlásí „Authentication failed“ (401). Token v připojení je neplatný nebo vypršel. Vygenerujte v Mango nový token a aktualizujte připojení. Pokud je token platný, nejspíš nemá v Mango přiřazenou lokaci (CT) — přiřaďte mu ji, nebo lokaci vyplňte v pokročilém nastavení modulu.

Založení zákazníka skončí chybou (400 / 422). Nejčastěji chybí povinný údaj — login, heslo, typ osoby, lokace, jméno/firma podle typu, nebo alespoň jeden kontaktní kanál (e-mail). Doplňte chybějící pole.

Smazání zákazníka selže. Zákazník má pravděpodobně aktivní služby, dluhy nebo otevřené procesy. Nejdřív je vyřešte, nebo místo smazání nastavte přes Update Customer stav „smazaný“.

Modul hlásí „Rate limit exceeded“ (429). Příliš mnoho požadavků za krátkou dobu. Make operaci sám zopakuje; u velkých dávek zvažte zpomalení scénáře.

Spouštěč Watch Workflow Hook nic nepřijímá. Scénář musí být aktivní a webhook musí být na straně Mango propojený (zajišťuje OG Soft). Zkontrolujte také, že filtr _verified = true neodfiltrovává vše kvůli špatně nastavenému klíči.

Kde se nastavuje lokace (CT)? Lokace je vázaná na API token. U připojení User Credentials ji Make zjistí automaticky z tokenu; u Location Credentials ji určuje token lokace. Potřebujete-li u konkrétního modulu pracovat s jinou lokací, přepište ji v pokročilém nastavení modulu (funguje jen s User Credentials).

Vypnul jsem scénář — doženou se zmeškané události? Ne. Události se doručují jen aktivnímu scénáři; co přišlo v době, kdy byl scénář vypnutý, se zpětně nedoručí.

Seznam (faktury, platby, daňové doklady) nevrací nic nebo hlásí chybu. Tyto seznamy vyžadují aspoň jeden filtr — zadejte například zákazníka nebo období.

8. Co se připravuje

Aplikace je nasazená v produkci a pokrývá všechny plánované oblasti, včetně pěti spouštěčů událostí a obou typů připojení (User i Location Credentials). Moduly se v produkčním prostředí zpřístupňují postupně. Připravujeme podrobnější návody s obrázky; upravovat se ještě bude podpora síťových událostí zařízení. Další rozšíření budeme doplňovat podle potřeb nasazení.

Tato kapitola se bude průběžně doplňovat podle toho, jak budou jednotlivé části hotové.

9. Podpora

S nasazením, připojením i tvorbou scénářů pomůže OG Soft:

• E-mail: [email protected]
• Podpora: +420 468 000 111 (8:00 - 16:00 v pracovní dny)
• Hotline: +420 468 002 775 (7:00–22:00 každý den)