Интеграционен хъб & 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 позволява автоматично получаване на данни от външни системи, без да е необходимо постоянно гласуване (polling). Когато Webhook се комбинира с Automation и AI Agent, бизнесът може да изгради напълно автоматизирани процеси за обработка на събития. Вграденият в екосистемата Website Builder позволява създаването на уебсайтове директно от GTG CRM с пълни SEO функции и автоматичен Sitemap.

Стъпка по стъпка ръководство за употреба

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

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

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

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

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

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

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

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

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

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

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

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

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

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

След като тестването е успешно, можете да интегрирате API във вашето реално приложение. По-долу е пример с Node.js, един от най-популярните езици за бекенд разработка. Този код илюстрира как да получите списък с контакти и да създадете нов контакт в 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#, за да извършите интеграцията. Общият принцип е винаги да изпращате токена в заглавката Authorization с формат "Bearer YOUR_TOKEN" и да използвате Content-Type като "application/json" за POST или PUT заявки.

Стъпка 6: Използване на AI Агент в реални процеси

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

Процесът протича по следния начин. Първо, клиентът попълва регистрационен формуляр на уебсайта за продажби. Бекендът на уебсайта незабавно извиква 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 автоматично разпознава, че това е нов клиент от уебсайта. Агентът анализира информацията за клиента, за да изпрати персонализиран поздрав по имейл, а не общ шаблон. Едновременно с това, Агентът създава задача за проследяване на търговски представител с изискване за обаждане в рамките на 24 часа, за да консултира клиента.

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

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

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

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

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

За да проверите дали webhook-ът работи правилно, изпратете тестов event с curl команда. Заявката трябва да има хедър Content-Type като application/json и хедър X-Webhook-Signature, съдържащ 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 с автоматизация и AI Agent

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

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

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

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

Секцията за писане на промпт за 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) и токени. Бизнесът може да предоставя точни разрешения на всяко интегрирано приложение, като гарантира, че чувствителните данни се достъпват само от упълномощени системи.

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

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

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

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

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

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

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

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

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

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

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

Заключение

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

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

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

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

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