Integration Hub & API

В съвременната бизнес среда компаниите често оперират с множество различни софтуерни системи, всяка от които обслужва специфични цели. Това могат да бъдат системи за управление на продажбите, счетоводни системи, маркетингови инструменти или вътрешни приложения, разработени по поръчка. Всяка от тези системи съдържа ценни данни и играе важна роля в бизнес операциите.

Най-голямото предизвикателство не е липсата на данни, а фактът, че тези данни съществуват разпокъсано в множество различни платформи. Служителите трябва да превключват между системи, да въвеждат ръчно една и съща информация многократно и нямат цялостен поглед върху клиентите. Това не само води до загуба на време, но и увеличава риска от грешки и пропускане на възможности за бизнес.

Integration Hub & API на GTG CRM е проектиран да реши този проблем фундаментално. Вместо да изисква от бизнеса да подмени цялата съществуваща система, това решение създава мост, който свързва системите помежду им. Данните могат да се движат свободно между платформите, процесите се автоматизират и най-важното – AI Agent може да се включи в обработката за повишаване на оперативната ефективност.

Този документ ще предостави подробни стъпки как бизнесът може успешно да внедри интеграцията, от създаване на приложение и конфигуриране на права за достъп, до използване на API за четене и запис на данни, настройка на webhook за получаване на автоматични събития и накрая – комбиниране с AI Agent за създаване на напълно автоматизирани интелигентни процеси.

Преглед на основните функции

Integration Hub & API предоставя цялостен набор от инструменти, които позволяват на бизнеса да свърже GTG CRM с всяко приложение чрез стандартния RESTful API протокол. Системата управлява API Token с механизъм за детайлно разпределение на правата по обхват (scope), осигурявайки висока сигурност и позволявайки точно контролиране на правата за достъп на всяко интегрирано приложение.

AI Agent Integration е ключов диференциатор, който позволява на бизнеса да използва изкуствен интелект за автоматизирана обработка на данни и изпълнение на сложни задачи без програмиране. Бизнесът може да управлява множество AI Agent с различни роли, като всеки Agent е обучен за конкретна употреба.

Възможността за двупосочна синхронизация на данни между GTG CRM и външни системи помага на бизнеса винаги да има единен поглед върху клиентската информация. Пълната API документация с примери за curl команди улеснява разработчиците при интеграция и дебъгване. Бизнесът може да прави заявки за списъци с контакти, задачи, сделки и да актуализира информация в реално време.

Webhook endpoint позволява автоматично получаване на данни от външни системи без постоянно запитване. При комбиниране на Webhook с Automation и AI Agent, бизнесът може да изгради напълно автоматизирани процеси за обработка на събития. Вграденият Website Builder в екосистемата позволява създаване на уебсайт директно от GTG CRM с пълни SEO функции и автоматични Sitemap.

Ръководство стъпка по стъпка

Стъпка 1: Създаване на интеграционно приложение

Първата стъпка за започване на интеграция е създаването на ново приложение в GTG CRM. Посетете менюто "Интеграция & API" и натиснете бутона "Създай ново приложение". Дайте смислено име на приложението, за да улесните управлението му по-късно, например "Интеграция на система за продажби" или "Мобилно приложение". След въвеждане на името, натиснете "Създай", за да завършите.

Стъпка 2: Конфигуриране на права за достъп

Системата за разпределение на права по обхват (scope) позволява прецизен контрол върху това какво приложение може да прави с CRM данните. След като създадете приложението, изберете го и отидете в раздела "Права за достъп" или "Scopes". Тук ще видите списък с наличните права.

Ако приложението се нуждае само от четене на информация за контакти, изберете scope "contacts.read". Ако се нуждае от създаване и актуализиране на контакти, добавете scope "contacts.write". За да може приложението да чете информация за AI Agent в системата, предоставете права "agents.read". Ако искате приложението да може да изисква от AI Agent да изпълнява задачи, трябва да предоставите права "agents.execute". След като изберете необходимите права, натиснете "Запази", за да актуализирате конфигурацията.

Стъпка 3: Създаване на API Token

Token е удостоверителен ключ, който позволява на външни приложения да извикват API на GTG CRM сигурно. В страницата с детайли за приложението, намерете секцията "API Token" и натиснете "Създай Token" или "Generate Token". Token ще бъде показан само веднъж, във формат, започващ с "gtg_", копирайте го и го съхранете на сигурно място незабавно. Този token трябва да се използва в Authorization header на всяка API заявка.

Важна забележка: Ако добавите нови права към приложението, след като вече сте генерирали token, старият token няма автоматично да получи новите права. Трябва да генерирате нов token, за да имате пълни права за достъп според конфигурираните.

Стъпка 4: Тестване на API връзката

След като имате token, следващата стъпка е да проверите дали интеграцията работи коректно. Най-лесният начин е да използвате curl команда от терминала. Следният пример илюстрира как да получите списък с контакти от GTG CRM.

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

Ако връзката е успешна и token има достатъчно права, ще получите JSON отговор, съдържащ списък с контакти с пълна информация като ID, име, имейл, телефонен номер и други полета с данни.

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

Стъпка 5: Интеграция с вашата система

След успешно тестване, можете да интегрирате API във вашето реално приложение. Ето пример с Node.js, един от най-популярните езици за backend разработка. Този код илюстрира как да получите списък с контакти и да създадете нов контакт в 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;
}

По подобен начин можете да използвате всеки друг език за програмиране като Python, PHP, Java или C# за интеграция. Общият принцип е винаги да изпращате token в Authorization header във формат "Bearer YOUR_TOKEN" и да използвате Content-Type "application/json" за POST или PUT заявки.

Стъпка 6: Прилагане на AI Agent в реални процеси

За да видите стойността на Integration Hub, разгледайте реален бизнес сценарий. Когато нов клиент завърши регистрация на уебсайта на компанията, вместо служител ръчно да създава профил в CRM и да изпраща приветствен имейл, целият процес може да бъде автоматизиран.

Процесът работи по следния начин. Първо, клиентът попълва регистрационна форма на уебсайта за продажби. Backend-ът на уебсайта незабавно извиква GTG CRM API, за да създаде нов контакт с пълната информация за клиента като име, имейл, телефонен номер и източник на клиента.

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"
  }'

Веднага след като контактът бъде създаден в GTG CRM, AI Agent автоматично разпознава, че това е нов клиент от уебсайта. Agent анализира информацията за клиента, за да изпрати персонализиран приветствен имейл, вместо общ шаблон. Едновременно с това, Agent създава задача за проследяване на търговския представител с искане за обаждане в рамките на 24 часа, за да консултира клиента.

Предимствата на този автоматизиран процес са очевидни. Клиентът получава приветствен имейл веднага след регистрацията, което създава професионално впечатление и увеличава доверието. Без ръчни действия от страна на служител, пести се време и се намаляват грешките. Имейлът е персонализиран въз основа на клиентската информация, а не общо съдържание. Търговският представител получава известие и конкретна задача за последващи действия, гарантирайки, че няма да пропусне възможност. Всички тези фактори заедно помагат за увеличаване на процента на конверсия от потенциален клиент към реален.

Стъпка 7: Настройка на Webhook за автоматично получаване на данни

Webhook е технология, която позволява на външни системи проактивно да изпращат данни към GTG CRM, когато настъпи събитие, вместо непрекъснато да запитват за него. За да започнете, посетете страницата "Интеграция & API" и изберете таба "Webhook", след това натиснете "Създай нов Webhook" и дайте смислено име на webhook.

След създаването, системата ще предостави две важни информации. Webhook URL е endpoint, към който външни системи ще изпращат данни чрез HTTP POST. Signing Secret е таен код, използван за удостоверяване, че заявката действително идва от упълномощена система, а не от фалшив източник.

Много важна забележка е, че Signing Secret се показва само веднъж при създаване на webhook. Копирайте го и го съхранете незабавно в системата за управление на тайни на бизнеса. Ако загубите този secret, ще трябва да създадете нов webhook.

За да проверите дали webhook работи коректно, изпратете тестово събитие с curl команда. Заявката трябва да има Content-Type header като application/json и X-Webhook-Signature header, съдържащ signing secret за удостоверяване.

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
    }
  }'

Ако webhook работи правилно, ще видите това събитие в списъка с получени събития.

Стъпка 8: Комбиниране на Webhook с Automation и AI Agent

Истинската сила на Integration Hub се разкрива напълно, когато Webhook се комбинира с автоматизирани процеси и AI Agent. Това позволява на бизнеса да изгражда интелигентни процеси за обработка, които автоматично реагират на събития от външни системи, без необходимост от ръчна намеса.

За да настроите процес, посетете менюто "Automation" в GTG CRM и натиснете "Създай нов процес".

Най-важната част е конфигурирането на тригера, за да знае процесът кога да се активира. Изберете модул "Външна интеграция", обект "Webhook" и действие "Получаване на данни". Това означава, че всеки път, когато webhook получи събитие от външна система, този процес автоматично ще се задейства.

След конфигурирането на тригера, добавете AI Agent задача към процеса. Натиснете "Добави задача", изберете модул "AI", след това "AI Agent Task". Тук ще напишете инструкции за AI Agent как да обработва данните, получени от webhook.

Секцията за писане на prompt за AI Agent е мястото, където бизнесът изразява своята бизнес логика. Например, можете да напишете: "Когато събитието е order.completed, създайте документ, който записва времето на получаване на събитието и информацията за поръчката. След това изпратете имейл за благодарност на клиента и уведомете търговския екип."

След като приключите с конфигурацията, преместете статуса на процеса на "Активен". От този момент нататък, всеки път, когато външна система изпрати събитие към webhook, AI Agent автоматично ще изпълнява задачите според инструкциите.

Когато бъде изпратено събитие, можете да проследите процеса на обработка в историята на изпълнение на процеса. AI Agent ще записва резултатите от обработката, за да може бизнесът да ги проверява и одитира.

Създаден е документ по заявка:

Реален казус: MM3.vn автоматизира маркетинг съдържание

MM3 е компания, която управлява уебсайта mm3.vn и използва Integration Hub в комбинация с AI Agent за пълна автоматизация на процеса на създаване на съдържание – от получаване на пазарни данни, създаване на AI изображения, писане на аналитични статии, публикуване на уебсайта, до автоматизирано публикуване в социални медии и SEO. Резултат: намаление от 2-3 служители по съдържание до 0, неограничен брой статии.

📖 Прочетете подробен казус за MM3.vn →

Основни ползи от използването на Integration Hub

Спестяването на време е най-пряката и видима полза. Автоматизацията на синхронизацията на данни между системите напълно елиминира ръчното въвеждане на данни, което е както времеемко, така и податливо на грешки. Служителите могат да се съсредоточат върху задачи с по-висока стойност, вместо върху повтарящи се операции.

Използването на съществуващата инфраструктура е важно предимство за бизнеси, които са инвестирали в софтуерни системи. Вместо да подменят цялата съществуваща технология, бизнесът може просто да свърже GTG CRM, за да добави AI и възможности за автоматизация. Това минимизира риска от прекъсване на бизнес дейността и защитава направените технологични инвестиции.

Увеличаване на ефективността на продажбите благодарение на AI Agent, който може да обслужва клиенти двадесет и четири часа в денонощието, без почивка. Всяка възможност се проследява и обработва навременно, без да се пропуска нито един потенциален клиент поради заетост на служител или извън работно време.

Гъвкаво разширяване е силната страна на API архитектурата. Бизнесът може лесно да добавя нови функции или да се свързва с повече системи, докато нуждите на бизнеса растат. Без да е заключен в една скована платформа, бизнесът може да се адаптира и разширява със собствено темпо.

Контролът върху сигурността е гарантиран чрез система за детайлно управление на правата за достъп с scopes и tokens. Бизнесът може да предостави точни права на всяко интегрирано приложение, гарантирайки, че чувствителните данни се достъпват само от упълномощени системи.

Двупосочният webhook разширява възможностите за интеграция далеч отвъд традиционните API решения. Бизнесът не само може проактивно да извиква API, когато е необходимо, но и да получава данни автоматично от външни системи в реално време.

Автоматизацията на съдържанието е уникална възможност на GTG CRM. При комбиниране на Webhook с Automation и AI Agent, бизнесът може автоматично да създава статии, изображения и публикации в социални медии от сурови данни. Това е особено полезно за бизнеси в областта на съдържанието или маркетинга.

Автоматично SEO чрез вградения Website Builder, който включва Sitemap и Google Search Console, гарантира, че цялото ново съдържание бързо се открива и индексира от търсачките, генерирайки органичен трафик за бизнеса.

Важни бележки при внедряване

Сигурността на token е основен приоритет. API token предоставя достъп до важни бизнес данни, следователно никога не трябва да се споделя с външни лица или да се комитва в изходен код. Token трябва да се съхранява в променливи на средата или в специализирана система за управление на тайни. Ако подозирате, че token е компрометиран, незабавно го отменете и генерирайте нов.

Опресняване на token при промяна на права е задължително правило. Всеки път, когато добавите нов scope към приложение, текущият token няма автоматично да получи новото право. Бизнесът трябва да генерира отново token, за да може новият token да включва всички конфигурирани права. Пропускането на тази стъпка често води до трудни за дебъгване грешки "Permission Denied".

Сигурността на webhook чрез signing secret е подобна на сигурността на token. Този secret се показва само веднъж при създаване на webhook, следователно трябва незабавно да се съхрани. Външната система, която изпраща събития, трябва да включва този secret в header, за да може GTG CRM да удостовери валидността на заявката.

Rate limiting е механизъм за защита на системата от претоварване. API има ограничение за броя заявки в определен времеви интервал. Интегрираните приложения трябва да имплементират логика за повторни опити с exponential backoff и да избягват извикване на API прекалено често за кратък период. Ако бъде надвишен rate limit, заявката ще бъде отхвърлена с HTTP статус код 429.

Валидиране на данни преди изпращане към API помага за избягване на ненужни грешки. Проверявайте форматите на имейли, дължината на низове и други ограничения за данни от страна на клиента, преди да извикате API. Това помага за спестяване на API квоти и подобрява потребителското изживяване.

Monitoring и logging са необходими за ранно откриване на проблеми с интеграцията. Следете логовете и историята на изпълнение на автоматизацията, за да сте сигурни, че webhook получава правилни данни, AI Agent обработва според очакванията и никакви грешки не остават незабелязани. GTG CRM предоставя monitoring dashboard, за да може бизнесът да следи състоянието на интеграцията.

Prompt за AI Agent трябва да бъде написан ясно и конкретно. Колкото по-детайлни са инструкциите за обработка на всеки тип събитие, толкова по-точен ще бъде резултатът от обработката на AI. Вместо да пишете "обработи събитието", напишете "когато събитието е order.completed, създай документ, който записва времето и информацията за поръчката, след това изпрати имейл за благодарност на клиента с шаблон A, накрая създай задача за търговския екип с краен срок 24 часа".

Заключение

Integration Hub & API на GTG CRM е цялостно интеграционно решение, което помага на бизнеса да свърже съществуващите си системи с модерните AI технологии, без да се налага да променя цялата технологична инфраструктура. Чрез подробните инструкции от създаване на приложение, конфигуриране на права, настройка на webhook до комбиниране с AI Agent, бизнесът може да изгради интелигентни автоматизирани процеси и значително да спести оперативни ресурси.

Реалният казус на MM3 ясно демонстрира потенциала на това решение не само в автоматизирането на прости задачи, но и в изграждането на цяла верига на стойността от сурови данни до публикувано съдържание и автоматично SEO. Важното е, че това решение не изисква задълбочени познания по програмиране или голям технически екип, а само базово разбиране на API и способността да се пишат инструкции на естествен език за AI Agent.

Със система за детайлно разпределение на права, многослойна сигурност и гъвкава мащабируемост, Integration Hub е подходящ за всякакъв размер бизнес – от стартъпи до големи корпорации. Бизнесът може да започне с прости интеграции като синхронизация на списъци с контакти, след което постепенно да разшири към по-сложни процеси като автоматизация на съдържанието, автоматично обслужване на клиенти или обработка на плащания и издаване на фактури.

Препоръката за начинаещи бизнеси е да следват стъпките една по една, да тестват щателно на всеки етап и да използват безплатния пробен период на GTG CRM, за да се запознаят със системата, преди да пристъпят към официално внедряване. Започнете с прост webhook тест, за да разберете начина на работа, след което постепенно надграждайте към по-сложни задачи, след като натрупате опит.

Екипът за поддръжка на GTG CRM винаги е готов да предостави подробни консултации за интеграционни решения, които отговарят на специфичните бизнес нужди и настоящата технологична инфраструктура на всеки бизнес. Не се колебайте да се свържете за помощ по време на внедряването и оптимизацията на интеграционните процеси.