Integration Hub & API

I en modern affärsmiljö drivs företag ofta av många olika mjukvarusystem som tjänar specifika ändamål. Det kan vara säljhante­ringsprogram, redovisningssystem, marknadsföringsverktyg eller egna interna applikationer. Varje system innehåller värdefull data och spelar en viktig roll i företagets drift.

Den största utmaningen är inte bristen på data, utan att denna data finns spridd över flera olika plattformar. Anställda måste växla mellan system, mata in samma information manuellt flera gånger och saknar en helhetsbild av kunden. Detta slösar inte bara tid utan ökar också risken för fel och missade affärsmöjligheter.

GTG CRMs Integration Hub & API är designat för att lösa detta grundläggande problem. Istället för att kräva att företaget byter ut alla befintliga system, skapar denna lösning en brygga som kopplar samman systemen. Data kan flöda fritt mellan plattformar, processer automatiseras, och viktigast av allt, AI-agenter kan delta i behandlingen för att öka driftseffektiviteten.

Detta dokument guidar dig steg för steg för att framgångsrikt implementera integration, från att skapa applikationer och konfigurera åtkomstbehörigheter, till att använda API:er för att läsa och skriva data, ställa in webhooks för att ta emot automatiska händelser och slutligen kombinera med AI-agenter för att skapa helt automatiserade intelligenta processer.

Översikt över huvudfunktioner

Integration Hub & API tillhandahåller en omfattande uppsättning verktyg som gör det möjligt för företag att ansluta GTG CRM till vilken applikation som helst via standardiserat RESTful API-protokoll. Systemet hanterar API-token med detaljerad behörighetsmekanism per scope, vilket säkerställer hög säkerhet och exakt kontroll över åtkomsträtten för varje integrerad applikation.

AI Agent Integration är en viktig skillnad som gör det möjligt för företag att utnyttja artificiell intelligens för att automatiskt bearbeta data och utföra komplexa uppgifter utan programmering. Företag kan hantera flera AI-agenter med olika roller, var och en tränad för ett specifikt användningsområde.

Tvåvägs datasynkronisering mellan GTG CRM och externa system säkerställer att företag alltid har en enhetlig bild av kundinformation. Fullständig API-dokumentation med exempel på curl-kommandon hjälper utvecklare att enkelt integrera och felsöka. Företag kan fråga efter kontaktlistor, uppgifter, affärer och uppdatera information i realtid.

Webhook-ändpunkter gör det möjligt att ta emot data automatiskt från externa system utan kontinuerlig polling. Genom att kombinera webhooks med automation och AI-agenter kan företag bygga helt automatiserade händelsehanteringsprocesser. En integrerad Website Builder i ekosystemet gör det möjligt att bygga webbplatser direkt från GTG CRM med fullständiga SEO-funktioner och automatiska sitemaps.

Steg-för-steg-guide

Steg 1: Skapa en integrationsapplikation

Det första steget för att påbörja integrationen är att skapa en ny applikation i GTG CRM. Gå till menyn "Integration & API" och klicka på knappen "Skapa ny applikation". Ge applikationen ett meningsfullt namn för enkel hantering i framtiden, till exempel "Integrering av säljsystem" eller "Mobilapplikation". Klicka på "Skapa" för att slutföra efter att ha angett namnet.

Steg 2: Konfigurera åtkomstbehörigheter

Systemet för behörighetsdelning per scope gör det möjligt att exakt kontrollera vad applikationen kan göra med CRM-data. Efter att ha skapat applikationen, välj den och gå till fliken "Behörigheter" eller "Scopes". Här hittar du en lista över tillgängliga behörigheter.

Om applikationen bara behöver läsa kontaktinformation, välj scopet "contacts.read". Om den behöver skapa och uppdatera kontakter, lägg till scopet "contacts.write". För att applikationen ska kunna läsa information om AI-agenter i systemet, ge behörigheten "agents.read". Om du vill att applikationen ska kunna be AI-agenter att utföra uppgifter, måste du ge behörigheten "agents.execute". Klicka på spara efter att ha valt nödvändiga behörigheter för att uppdatera konfigurationen.

Steg 3: Skapa en API-token

Token är en autentiseringsnyckel som gör det möjligt för externa applikationer att säkert anropa GTG CRM API. På applikationens detaljsida, hitta avsnittet "API-token" och klicka på "Skapa token" eller "Generera token". Token kommer att visas en enda gång med formatet som börjar med "gtg_". Kopiera och spara den omedelbart på en säker plats. Denna token måste användas i Authorization-headern för varje API-begäran.

Viktig anmärkning: Om du lägger till nya behörigheter för en applikation efter att ha skapat en token, kommer den gamla token inte automatiskt att få dessa nya behörigheter. Du måste skapa en ny token för att få fullständiga konfigurerade behörigheter.

Steg 4: Testa API-anslutningen

Efter att ha fått token, är nästa steg att testa om integrationen fungerar korrekt. Det enklaste sättet är att använda ett curl-kommando från terminalen. Exemplet nedan visar hur du hämtar en lista över kontakter från GTG CRM.

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

Om anslutningen lyckas och token har tillräckliga behörigheter får du ett JSON-svar som innehåller en lista över kontakter med fullständig information som ID, namn, e-post, telefonnummer och andra datafält.

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

Steg 5: Integrera med ditt system

Efter lyckad testning kan du integrera API:et i din faktiska applikation. Nedan är ett exempel med Node.js, ett av de mest populära språken för backend-utveckling. Denna kod illustrerar hur man hämtar en lista över kontakter och skapar en ny kontakt i 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;
}

På samma sätt kan du använda vilket annat programmeringsspråk som helst, som Python, PHP, Java eller C#, för integration. Den allmänna principen är att alltid skicka token i Authorization-headern med formatet "Bearer YOUR_TOKEN" och använda Content-Type som "application/json" för POST- eller PUT-begäran.

Steg 6: Använda AI-agenter i verkliga processer

För att tydligt se värdet av Integration Hub, överväg ett verkligt affärsscenario. När en ny kund fyller i ett registreringsformulär på företagets webbplats, istället för att en anställd manuellt skapar en profil i CRM och skickar ett välkomstmail, kan hela processen automatiseras.

Processen fungerar på följande sätt. Först fyller kunden i registreringsformuläret på webbplatsen. Webbplatsens backend anropar omedelbart GTG CRM API för att skapa en ny kontakt med fullständig kundinformation som namn, e-post, telefonnummer och kundkälla.

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

Så fort kontakten skapas i GTG CRM identifierar AI-agenten automatiskt att det är en ny kund från webbplatsen. Agenten analyserar kundinformationen för att skicka ett personligt välkomstmail, inte ett generiskt mallinnehåll. Samtidigt skapar agenten en uppföljningsuppgift för säljaren med instruktionen att ringa inom 24 timmar för att ge råd till kunden.

Fördelarna med denna automatiserade process är tydliga. Kunden får ett välkomstmail omedelbart efter registreringen, vilket skapar ett professionellt intryck och ökar förtroendet. Ingen manuell hantering krävs av anställda, vilket sparar tid och minimerar fel. Mejlet är personligt baserat på kundinformation, inte generellt innehåll. Säljare informeras och får en specifik uppgift att följa upp, vilket säkerställer att inga möjligheter missas. Alla dessa faktorer bidrar tillsammans till att öka konverteringsgraden från lead till faktisk kund.

Steg 7: Ställ in webhooks för att ta emot data automatiskt

Webhook är en teknik som gör det möjligt för externa system att aktivt skicka data till GTG CRM när en händelse inträffar, istället för att ständigt polla för att kontrollera. För att komma igång, gå till sidan "Integration & API" och välj fliken "Webhook", klicka sedan på "Skapa ny webhook" och ge webhooken ett meningsfullt namn.

Efter skapandet kommer systemet att ge två viktiga uppgifter. Webhook URL är ändpunkten som externa system kommer att skicka data till via HTTP POST. Signing Secret är en hemlig kod som används för att verifiera att begäran verkligen kommer från ett auktoriserat system och inte från en falsk källa.

Mycket viktigt: Signing Secret visas endast en gång när webhooken skapas. Kopiera och spara den omedelbart i företagets säkra hemlighetshanteringssystem. Om du förlorar denna hemlighet måste du skapa en ny webhook.

För att testa att webhooken fungerar korrekt, skicka ett test händelse med ett curl-kommando. Begäran måste ha Content-Type-headern som application/json och X-Webhook-Signature-headern som innehåller signing secret för autentisering.

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

Om webhooken fungerar korrekt ser du att händelsen dyker upp i listan över mottagna händelser.

Steg 8: Kombinera webhooks med automation och AI-agenter

Integration Hubs verkliga styrka utnyttjas till fullo när webhooks kombineras med automatiserade processer och AI-agenter. Detta gör det möjligt för företag att bygga intelligenta behandlingsprocesser som automatiskt reagerar på händelser från externa system utan manuellt ingripande.

För att ställa in en process, gå till menyn "Automation" i GTG CRM och klicka på "Skapa ny process".

Den viktigaste delen är att konfigurera triggern så att processen vet när den ska aktiveras. Välj modulen "Extern integration", objektet "Webhook", och åtgärden "Ta emot data". Detta innebär att varje gång webhooken tar emot en händelse från ett externt system, aktiveras denna process automatiskt.

Efter att ha konfigurerat triggern, lägg till en AI Agent-uppgift i processen. Klicka på lägg till uppgift, välj modulen "AI", välj sedan "AI Agent-uppgift". Detta är där du kommer att skriva instruktioner för AI-agenten om hur den ska bearbeta data som mottagits från webhooken.

Avsnittet för att skriva prompten till AI-agenten är där företaget uttrycker sin affärslogik. Du kan till exempel skriva: "När händelsen är order.completed, skapa ett dokument som noterar tidpunkten för händelsen och orderinformationen. Skicka sedan ett tackmail till kunden och meddela säljteamet."

Efter att ha slutfört konfigurationen, ändra processens status till "Aktiv". Från och med nu, varje gång ett externt system skickar en händelse till webhooken, kommer AI-agenten automatiskt att utföra uppgifter enligt instruktionerna.

När en händelse skickas in kan du följa bearbetningsprocessen i processens exekveringshistorik. AI-agenten kommer att logga bearbetningsresultatet så att företaget kan granska och granska.

Dokument som skapats enligt begäran:

Verkligt fall: MM3.vn automatiserar marknadsföringsinnehåll

MM3 är ett företag som driver webbplatsen mm3.vn och har använt Integration Hub i kombination med AI-agenter för att helt automatisera innehållsskapandeprocessen – från att ta emot marknadsdata, skapa AI-bilder, skriva analysartiklar, publicera på webbplatsen, till att automatiskt posta på sociala medier och SEO. Resultat: minskning från 2-3 innehållsmedarbetare till 0, obegränsat antal artiklar.

📖 Läs den detaljerade fallstudien om MM3.vn →

Kärnfördelar med Integration Hub

Tidsbesparing är den mest direkta och märkbaraste fördelen. Automatisering av datasynkronisering mellan system eliminerar helt manuellt datainmatningsarbete, ett tidskrävande och felbenäget arbete. Anställda kan fokusera på mer värdeskapande uppgifter istället för repetitiva uppgifter.

Utnyttja befintlig infrastruktur är en viktig fördel för företag som har investerat i mjukvarusystem. Istället för att behöva byta ut all befintlig teknik, behöver företaget bara ansluta GTG CRM för att lägga till AI- och automatiseringsfunktioner. Detta minimerar risken för avbrott i affärsverksamheten och skyddar redan gjorda teknikinvesteringar.

Ökad försäljningseffektivitet tack vare AI-agenter som kan hantera kundservice tjugofyra timmar om dygnet, sju dagar i veckan, utan rast. Alla möjligheter följs upp och hanteras i tid, inga leads missas på grund av att anställda är upptagna eller utanför arbetstid.

Flexibel skalbarhet är en styrka med API-arkitektur. Företag kan enkelt lägga till nya funktioner eller ansluta till fler system när affärsbehoven växer. Utan att vara låst till en stel plattform kan företag anpassa och expandera i sin egen takt.

Säkerhetskontroll garanteras genom systemet för detaljerad behörighetshantering med scope och tokens. Företag kan ge exakta behörigheter till varje integrerad applikation, vilket säkerställer att känslig data endast nås av auktoriserade system.

Tvåvägs webhooks utökar integrationsmöjligheterna långt utöver traditionella API-lösningar. Företag kan inte bara aktivt anropa API:er vid behov, utan också ta emot data automatiskt från externa system i realtid.

Automatisering av innehåll är en unik funktion i GTG CRM. Genom att kombinera webhooks med automation och AI-agenter kan företag automatiskt skapa artiklar, bilder och sociala medieinlägg från rådata. Detta är särskilt användbart för företag inom innehålls- eller marknadsföringssektorn.

Automatisk SEO genom en integrerad Website Builder med sitemap och Google Search Console säkerställer att allt nytt innehåll snabbt upptäcks och indexeras av sökmotorer, vilket genererar naturlig trafik till företaget.

Viktiga överväganden vid implementering

Tokensäkerhet är högsta prioritet. API-token ger åtkomst till företagets viktiga data och bör därför aldrig delas med utomstående eller kommitteras i källkoden. Token bör lagras i miljövariabler eller ett dedikerat hemlighetshanteringssystem. Om du misstänker att en token har läckt, återkalla den och skapa en ny token omedelbart.

Uppdatera token vid ändring av behörigheter är en regel som måste följas. Varje gång ett nytt scope läggs till för en applikation, får den befintliga token inte automatiskt dessa nya behörigheter. Företaget måste skapa om token så att den nya token inkluderar alla konfigurerade behörigheter. Att glömma detta steg leder ofta till svårfelsökta "Permission Denied"-fel.

Webhooksäkerhet genom signing secret är liknande tokensäkerhet. Denna hemlighet visas endast en gång när webhooken skapas och måste därför lagras omedelbart. Externa system som skickar händelser måste inkludera denna hemlighet i headern för att GTG CRM ska kunna verifiera begärans giltighet.

Rate limiting är en mekanism för att skydda systemet från överbelastning. API:et har en gräns för antalet begäranden inom en viss tidsperiod. Integrerade applikationer bör implementera retry-logik med exponential backoff och undvika att anropa API:et för ofta under korta perioder. Om rate limit överskrids, kommer begäran att nekas med HTTP-statuskod 429.

Validering av data innan det skickas till API:et hjälper till att undvika onödiga fel. Kontrollera e-postformat, stränglängd och andra databegränsningar på klientsidan innan du anropar API:et. Detta sparar API-kvot och förbättrar användarupplevelsen.

Övervakning och loggning är nödvändigt för att upptäcka integrationsproblem tidigt. Övervaka loggar och automatiseringshistorik för att säkerställa att webhooks tar emot korrekt data, att AI-agenter bearbetar som förväntat och att inga fel missas. GTG CRM tillhandahåller en övervakningsdashboard så att företag kan följa integrationens status.

Prompts för AI-agenter måste skrivas tydligt och specifikt. Ju mer detaljerad information om hur varje typ av händelse ska hanteras, desto mer exakt blir AI:ns bearbetningsresultat. Istället för att skriva "bearbeta händelsen", skriv "när händelsen är order.completed, skapa ett dokument som registrerar tidpunkten och orderinformationen, skicka sedan ett tackmail till kunden med mall A, och slutligen skapa en uppgift för säljteamet med en deadline på 24 timmar".

Slutsats

GTG CRMs Integration Hub & API är en komplett integrationslösning som hjälper företag att ansluta sina befintliga system till modern AI-teknik utan att behöva byta ut hela sin teknik infrastruktur. Genom detaljerade steg-för-steg-instruktioner från att skapa applikationer, konfigurera behörigheter, ställa in webhooks till att kombinera med AI-agenter, kan företag bygga intelligenta automatiserade processer och spara betydande driftresurser.

MM3:s verkliga fallstudie har tydligt visat lösningens potential inte bara för att automatisera enkla uppgifter, utan också för att bygga hela värdekedjan från rådata till publicerat innehåll och automatisk SEO. Viktigast är att denna lösning inte kräver djup programmeringskunskap eller ett stort tekniskt team, utan bara en grundläggande förståelse för API:er och förmågan att skriva instruktioner på naturligt språk för AI-agenter.

Med ett detaljerat behörighetssystem, flerskiktssäkerhet och flexibel skalbarhet är Integration Hub lämplig för alla företagsstorlekar, från startups till stora företag. Företag kan börja med enkla integrationer som synkronisering av kontaktlistor, och sedan gradvis utöka till mer komplexa processer som innehållsautomatisering, automatisk kundhantering, eller hantering av betalningar och fakturering.

Rekommendationen för nystartade företag är att följa stegen, testa noggrant i varje fas och utnyttja GTG CRMs kostnadsfria provperiod för att bekanta sig med systemet innan officiell implementering. Börja med en enkel webhook-test för att förstå hur det fungerar, och uppgradera sedan gradvis till mer komplexa uppgifter när erfarenhet har samlats.

GTG CRMs supportteam är alltid redo att ge detaljerad rådgivning om integrationslösningar som passar företagets särdrag och befintliga teknik infrastruktur. Tveka inte att kontakta oss för hjälp under implementeringsprocessen och optimeringen av integrationsprocesser.