Integrační centrum a API

V moderním obchodním prostředí podniky často provozují mnoho různých softwarových systémů pro specifické účely. Může jít o software pro řízení prodeje, účetní systémy, marketingové nástroje nebo interní aplikace vyvinuté na zakázku. Každý z těchto systémů obsahuje cenná data a hraje klíčovou roli v provozu podniku.

Největší výzvou není nedostatek dat, ale skutečnost, že tato data existují izolovaně na mnoha různých platformách. Zaměstnanci musí přepínat mezi systémy, ručně zadávat stejné informace mnohokrát a nemají ucelený pohled na zákazníka. To nejenže plýtvá časem, ale také zvyšuje riziko chyb a promarněných obchodních příležitostí.

Integration Hub & API od GTG CRM je navržen tak, aby tento problém zásadně řešil. Místo toho, aby podniky vyžadovaly nahrazení celých stávajících systémů, toto řešení vytváří mosty, které systémy propojují. Data mohou volně proudit mezi platformami, procesy jsou automatizovány a co je nejdůležitější, AI Agent se může podílet na zpracování, aby se zvýšila provozní efektivita.

Tento dokument vás krok za krokem provede úspěšnou implementací integrace, od vytváření aplikací a konfigurace přístupových práv, až po použití API pro čtení a zápis dat, nastavení webhooků pro příjem automatických událostí a nakonec integraci s AI Agentem pro vytváření plně automatizovaných inteligentních zpracovatelských procesů.

Přehled hlavních funkcí

Integration Hub & API poskytuje komplexní sadu nástrojů, které umožňují podnikům připojit GTG CRM k jakékoli aplikaci prostřednictvím standardního protokolu RESTful API. Systém správy API Tokenů s podrobným mechanismem oprávnění podle scope zajišťuje vysokou bezpečnost a umožňuje přesné řízení přístupu každé integrované aplikace.

AI Agent Integration je klíčový rozdíl, který umožňuje podnikům využívat umělou inteligenci k automatizaci zpracování dat a provádění složitých úkolů bez nutnosti programování. Podniky mohou spravovat více AI Agentů s různými rolemi, přičemž každý Agent je trénován pro konkrétní účel použití.

Obousměrná synchronizace dat mezi GTG CRM a externími systémy zajišťuje, že podniky mají vždy jednotný pohled na informace o zákaznících. Komplexní dokumentace API s příklady curl commandů usnadňuje vývojářům integraci a ladění. Podniky mohou získávat seznam kontaktů, úkolů, obchodů a aktualizovat informace v reálném čase.

Webhook endpoint umožňuje automatické přijímání dat z externích systémů bez nutnosti neustálého dotazování. Při kombinaci Webhooků s Automation a AI Agentem mohou podniky vytvářet plně automatizované procesy zpracování událostí. Integrovaný Website Builder v rámci ekosystému umožňuje vytvářet webové stránky přímo z GTG CRM s plnou podporou SEO a automatickým Sitemap.

Návod k použití krok za krokem

Krok 1: Vytvoření integrační aplikace

Prvním krokem k zahájení integrace je vytvoření nové aplikace v GTG CRM. Přejděte do nabídky "Integrace & API" a klikněte na tlačítko "Vytvořit novou aplikaci". Zadejte smysluplný název aplikace pro snadnou správu v budoucnu, například "Integrace prodejního systému" nebo "Mobilní aplikace". Po zadání názvu klikněte na "Vytvořit" pro dokončení.

Krok 2: Konfigurace přístupových práv

Systém oprávnění podle scope umožňuje přesné řízení toho, co aplikace může dělat s daty CRM. Po vytvoření aplikace vyberte právě vytvořenou aplikaci a přejděte na záložku "Přístupová práva" nebo "Scopes". Zde uvidíte seznam oprávnění, která lze udělit.

Pokud aplikace potřebuje pouze číst kontaktní informace, vyberte scope "contacts.read". Pokud potřebujete vytvářet a aktualizovat kontakty, přidejte scope "contacts.write". Aby aplikace mohla číst informace o AI agentech v systému, udělte oprávnění "agents.read". Pokud chcete, aby aplikace mohla požadovat od AI agenta provedení úkolu, musíte udělit oprávnění "agents.execute". Po výběru požadovaných oprávnění klikněte na uložit pro aktualizaci konfigurace.

Krok 3: Vytvoření API tokenu

Token je ověřovací klíč, který umožňuje externím aplikacím bezpečně volat API GTG CRM. Na stránce s detailem aplikace najděte sekci "API Token" a klikněte na "Vytvořit token" nebo "Generate Token". Token se zobrazí pouze jednou ve formátu začínajícím na "gtg_". Ihned si jej zkopírujte a uložte na bezpečné místo. Tento token je třeba použít v hlavičce Authorization všech API požadavků.

Důležitá poznámka: Pokud přidáte nová oprávnění pro aplikaci po vytvoření tokenu, starý token tato nová oprávnění automaticky nezíská. Budete muset vygenerovat nový token, abyste měli plná nakonfigurovaná přístupová práva.

Krok 4: Testování připojení API

Poté, co máte token, je dalším krokem ověření, zda integrace funguje správně. Nejjednodušší způsob je použít příkaz curl z terminálu. Následující příklad ukazuje, jak získat seznam kontaktů z GTG CRM.

curl -X GET https://api.gtgcrm.com/v1/integration/contacts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Pokud je připojení úspěšné a token má dostatečná oprávnění, obdržíte odpověď ve formátu JSON obsahující seznam kontaktů s plnými informacemi, jako je ID, jméno, email, telefonní číslo a další datové pole.

{
  "data": [
    {
      "id": "contact_123",
      "name": "Nguyễn Văn A",
      "email": "nguyenvana@example.com",
      "phone": "0901234567"
    }
  ]
}

Krok 5: Integrace s vaším systémem

Po úspěšném testování můžete API integrovat do vaší reálné aplikace. Níže je uveden příklad s Node.js, jedním z nejpopulárnějších jazyků pro backend vývoj. Tento kód ilustruje, jak získat seznam kontaktů a vytvořit nový kontakt v GTG CRM.

const axios = require('axios');

const API_URL = 'https://api.gtgcrm.com/v1/integration';
const API_TOKEN = 'your_api_token_here';

async function getContacts() {
  const response = await axios.get(`${API_URL}/contacts`, {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  });
  return response.data;
}

async function createContact(contactData) {
  const response = await axios.post(`${API_URL}/contacts`, contactData, {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });
  return response.data;
}

Podobně můžete k integraci použít jakýkoli jiný programovací jazyk, jako je Python, PHP, Java nebo C#. Obecným pravidlem je vždy posílat token v hlavičce Authorization s formátem "Bearer YOUR_TOKEN" a používat Content-Type "application/json" pro požadavky POST nebo PUT.

Krok 6: Využití AI agentů v reálných procesech

Abyste plně pochopili hodnotu Integration Hub, podívejme se na reálný obchodní scénář. Když nový zákazník dokončí registraci na prodejním webu společnosti, namísto toho, aby zaměstnanec ručně vytvářel profil v CRM a posílal uvítací email, celý proces může být automatizován.

Pracovní postup je následující. Nejprve zákazník vyplní registrační formulář na prodejním webu. Backend webu okamžitě zavolá API GTG CRM k vytvoření nového kontaktu s úplnými informacemi o zákazníkovi, jako je jméno, e-mail, telefonní číslo a zdroj zákazníka.

curl -X POST https://api.gtgcrm.com/v1/integration/contacts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Trần Thị B",
    "email": "tranthib@example.com",
    "phone": "0987654321",
    "source": "Website"
  }'

Jakmile je kontakt v GTG CRM vytvořen, AI Agent automaticky rozpozná, že se jedná o nového zákazníka z webu. Agent analyzuje informace o zákazníkovi k odeslání personalizovaného uvítacího e-mailu, nikoli obecné šablony. Současně Agent vytvoří úkol sledování pro obchodního zástupce s požadavkem zavolat do 24 hodin a poskytnout zákazníkovi poradenství.

Výhody tohoto automatizovaného procesu jsou zřejmé. Zákazník obdrží uvítací e-mail ihned po registraci, což vytváří profesionální dojem a zvyšuje důvěru. Není nutná manuální manipulace ze strany zaměstnanců, což šetří čas a minimalizuje chyby. E-maily jsou personalizované na základě informací o zákazníkovi, nikoli obecný obsah. Obchodní zástupci jsou informováni a mají konkrétní úkoly k následnému jednání, což zajišťuje, že nepřijdou o žádnou příležitost. Všechny tyto faktory společně pomáhají zvýšit míru konverze z potenciálního zákazníka na skutečného zákazníka.

Krok 7: Nastavení Webhooku pro automatické přijímání dat

Webhook je technologie, která umožňuje externím systémům aktivně zasílat data do GTG CRM, když dojde k události, namísto neustálého dotazování (polling). Chcete-li začít, přejděte na stránku „Integrace & API“ a vyberte kartu „Webhook“, poté klikněte na „Vytvořit nový Webhook“ a pojmenujte webhook smysluplným názvem.

Po vytvoření systém poskytne dvě důležité informace. URL Webhooku je koncový bod, kam externí systém odešle data prostřednictvím HTTP POST. Signing Secret je tajný klíč použitý k ověření, že požadavek skutečně pochází z autorizovaného systému, nikoli z falešného zdroje.

Velmi důležité upozornění je, že Signing Secret se zobrazí pouze jednou při vytváření webhooku. Okamžitě si jej zkopírujte a uložte do bezpečného systému pro správu tajemství vaší společnosti. Pokud o toto tajemství přijdete, budete muset vytvořit nový webhook.

Chcete-li otestovat, zda webhook funguje správně, odešlete testovací událost pomocí příkazu curl. Požadavek musí obsahovat hlavičku Content-Type jako application/json a hlavičku X-Webhook-Signature s podpisovým tajemstvím pro ověření.

curl -X POST "YOUR_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Signature: YOUR_SIGNING_SECRET" \
  -d '{
    "event": "order.completed",
    "eventId": "evt_123456",
    "data": {
      "orderId": "ORD-001",
      "customerName": "Nguyễn Văn A",
      "amount": 500000
    }
  }'

Pokud webhook funguje správně, tato událost se objeví v seznamu přijatých událostí.

Skutečná síla Integration Hubu je plně využita při kombinaci Webhooků s automatizací a AI Agenty. To umožňuje společnostem vytvářet inteligentní procesy zpracování, které automaticky reagují na události z externích systémů bez nutnosti manuálního zásahu.

Pro nastavení procesu přejděte do menu „Automatizace“ v GTG CRM a klikněte na „Vytvořit nový proces“.

Nejdůležitější částí je konfigurace spouštěče (triggeru), aby proces věděl, kdy se má aktivovat. Vyberte modul „Externí integrace“, objekt „Webhook“ a akci „Přijmout data“. To znamená, že pokaždé, když webhook přijme událost z externího systému, tento proces se automaticky spustí.

Po konfiguraci spouštěče přidejte do procesu úkol AI Agent. Klikněte na Přidat úkol, vyberte modul „AI“ a poté „Úkol AI Agent“. Zde zadáte pokyny pro AI Agenta, jak má zpracovat data přijatá z webhooku.

Část pro psaní promptu pro AI Agenta je místo, kde firma prezentuje svou obchodní logiku. Například můžete napsat: „Když událost je order.completed, vytvořte dokument zaznamenávající čas přijetí události a informace o objednávce. Poté odešlete děkovný e-mail zákazníkovi a informujte obchodní tým.“

Po dokončení konfigurace přepněte stav procesu na „Aktivní“. Od nynějška, kdykoli externí systém odešle událost do webhooku, AI Agent automaticky provede úkoly podle pokynů.

Když je odeslána událost, můžete sledovat proces zpracování v historii provádění procesu. AI Agent zaznamená výsledky zpracování, aby je firma mohla zkontrolovat a auditovat.

Vytvořený dokument dle požadavku:

Skutečný případ studie: MM3.vn automatizuje marketingový obsah

MM3 je společnost provozující web mm3.vn, která využila Integration Hub v kombinaci s AI Agent k plné automatizaci procesu tvorby obsahu – od přijímání tržních dat, generování AI obrázků, psaní analytických článků, publikování na web, až po automatické zveřejňování na sociálních sítích a SEO. Výsledek: snížení počtu 2-3 zaměstnanců pro obsah na 0, neomezený počet článků.

📖 Přečtěte si podrobný případ studie MM3.vn →

Klíčové výhody používání Integration Hub

Úspora času je nejzřejmější a nejpřímější výhodou. Automatizace synchronizace dat mezi systémy zcela eliminuje manuální zadávání dat, což je jak časově náročné, tak náchylné k chybám. Zaměstnanci se tak mohou soustředit na činnosti s vyšší přidanou hodnotou namísto opakujících se úkolů.

Využití stávající infrastruktury je pro firmy, které investovaly do softwarových systémů, významnou výhodou. Místo nahrazování celé stávající technologie stačí připojit GTG CRM k doplnění možností AI a automatizace. To minimalizuje riziko přerušení obchodních operací a chrání již provedené technologické investice.

Zvýšení prodejní efektivity díky AI Agent, který dokáže zákazníky obsluhovat dvacet čtyři hodin denně, sedm dní v týdnu, bez nutnosti odpočinku. Každá příležitost je včas sledována a zpracována, žádný potenciální zákazník není ztracen kvůli tomu, že zaměstnanec je zaneprázdněn nebo mimo pracovní dobu.

Flexibilní škálovatelnost je silnou stránkou architektury API. Podniky mohou snadno přidávat nové funkce nebo se propojovat s více systémy, jak rostou obchodní potřeby. Bez uzamčení do rigidní platformy se podniky mohou přizpůsobovat a rozšiřovat vlastním tempem.

Bezpečnostní kontrola je zajištěna podrobným systémem správy oprávnění s rozsahy (scopes) a tokeny. Podniky mohou přesně udělovat oprávnění každé integrované aplikaci, čímž zajišťují, že citlivá data jsou přístupná pouze autorizovaným systémům.

Obousměrné webhooky rozšiřují možnosti integrace daleko za tradiční API řešení. Podniky nejenže mohou aktivně volat API podle potřeby, ale také v reálném čase automaticky přijímat data ze systémů třetích stran.

Automatizace obsahu je jedinečná schopnost GTG CRM. Při kombinaci Webhooků s automatizací a AI agenty mohou podniky automaticky generovat články, obrázky a příspěvky na sociální sítě z nezpracovaných dat. To je zvláště užitečné pro podniky v oblasti obsahu nebo marketingu.

Automatické SEO prostřednictvím Website Builderu s integrovanými Sitemap a Google Search Console zajišťuje, že veškerý nový obsah je vyhledávači rychle detekován a indexován, což generuje přirozený provoz pro podniky.

Důležité poznámky při implementaci

Bezpečnost tokenů je nejvyšší prioritou. API tokeny uděluje přístup k důležitým firemním datům, proto by nikdy neměly být sdíleny s cizími osobami ani commitovány do zdrojového kódu. Tokeny by měly být uloženy v proměnných prostředí nebo ve specializovaném systému pro správu tajných klíčů. Pokud máte podezření, že token unikl, okamžitě jej zrušte a vygenerujte nový.

Obnovení tokenu při změně oprávnění je povinné pravidlo, které je třeba si pamatovat. Pokaždé, když přidáte nový rozsah pro aplikaci, stávající token automaticky nezíská nová oprávnění. Podniky musí token znovu vygenerovat, aby nový token zahrnoval všechna nakonfigurovaná oprávnění. Zapomenutí tohoto kroku často vede k těžko laditelným chybám "Permission Denied".

Zabezpečení webhooků pomocí podepisovacího tajemství je podobné zabezpečení tokenů. Toto tajemství se zobrazí pouze jednou při vytváření webhooku, proto je třeba jej okamžitě uložit. Externí systém odesílající událost musí toto tajemství zahrnout do hlavičky, aby GTG CRM ověřilo platnost požadavku.

Omezení rychlosti (rate limiting) je mechanismus pro ochranu systému před přetížením. API mají omezený počet požadavků během určitého časového období. Integrované aplikace by měly implementovat logiku opakování s exponenciálním zpožděním (exponential backoff) a vyhýbat se příliš častému volání API v krátkém čase. Pokud dojde k překročení limitu rychlosti, požadavek bude odmítnut s HTTP stavovým kódem 429.

Validace dat před jejich odesláním do API pomáhá předcházet zbytečným chybám. Na straně klienta zkontrolujte formát e-mailu, délku řetězce a další datová omezení před voláním API. To pomáhá šetřit API kvóty a zlepšuje uživatelskou zkušenost.

Monitorování a logování jsou nezbytné pro včasné odhalení problémů s integrací. Sledujte logy a historii provádění automatizace, abyste se ujistili, že webhooky přijímají správná data, AI agenti zpracovávají podle očekávání a žádné chyby nejsou opomenuty. GTG CRM poskytuje monitorovací panel, aby podniky mohly sledovat stav integrace.

Výzvy pro AI agenty (prompty) by měly být napsány jasně a konkrétně. Čím podrobnější bude popis zpracování každého typu události, tím přesnější budou výsledky zpracování AI. Místo napsání "zpracovat událost" napište "když je událost order.completed, vytvořte dokument zaznamenávající čas a informace o objednávce, poté odešlete děkovný e-mail zákazníkovi pomocí šablony A a nakonec vytvořte úkol pro obchodní tým s termínem 24 hodin".

Závěr

Integration Hub & API GTG CRM je komplexní integrační řešení, které pomáhá podnikům propojit stávající systémy s moderní technologií umělé inteligence bez nutnosti měnit celou technologickou infrastrukturu. Prostřednictvím podrobných kroků od vytváření aplikací, konfigurace oprávnění, nastavení webhooků až po jejich kombinaci s AI agenty mohou podniky vytvářet inteligentní automatizační procesy a výrazně šetřit provozní zdroje.

Případová studie MM3 jasně prokázala potenciál tohoto řešení nejen v automatizaci jednoduchých úloh, ale také ve vytváření celých hodnotových řetězců od surových dat až po publikovaný obsah a automatické SEO. Důležité je, že toto řešení nevyžaduje hluboké programovací znalosti ani velký technický tým, stačí základní porozumění API a schopnost psát pokyny v přirozeném jazyce pro AI Agenta.

Díky podrobnému systému oprávnění, vícevrstvému zabezpečení a flexibilní škálovatelnosti je Integration Hub vhodný pro podniky všech velikostí, od startupů po velké korporace. Podniky mohou začít s jednoduchými integracemi, jako je synchronizace seznamu kontaktů, a postupně přecházet ke složitějším procesům, jako je automatizace obsahu, automatizovaná péče o zákazníky nebo zpracování plateb a fakturace.

Doporučujeme nově začínajícím podnikům postupovat krok za krokem, pečlivě kontrolovat každou fázi a využít bezplatnou zkušební verzi GTG CRM k seznámení se systémem před oficiálním zavedením. Začněte s jednoduchým testováním webhooku, abyste pochopili, jak to funguje, a poté postupně zvyšujte složitost úloh, jakmile získáte zkušenosti.

Tým podpory GTG CRM je připraven podrobně poradit s integračními řešeními, která odpovídají obchodním specifikům a současné technologické infrastruktuře každého podniku. Neváhejte nás kontaktovat pro pomoc při implementaci a optimalizaci integračních procesů.