Integrationsnav och API

I dagens affärsvärld fungerar företag ofta med många olika mjukvarusystem som tjänar specifika syften. Det kan vara försäljningshanteringsprogramvara, bokföringssystem, marknadsföringsverktyg eller egna internt utvecklade 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 existerar separat på många olika plattformar. Anställda måste växla mellan system, mata in samma information manuellt flera gånger och saknar en heltäckande bild 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 utformade för att lösa detta problem fundamentalt. Istället för att kräva att företaget ersätter alla befintliga system, skapar denna lösning en brygga som kopplar ihop systemen. Data kan flöda fritt mellan plattformarna, processer automatiseras och, viktigast av allt, AI Agents kan delta i bearbetningen för att öka driftseffektiviteten.

Detta dokument kommer att guida dig steg för steg hur ditt företag kan implementera integration framgångsrikt, från att skapa applikationer och konfigurera åtkomstbehörigheter, till att använda API 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 Agents för att skapa helt automatiserade intelligenta bearbetningsprocesser.

Översikt över huvudfunktioner

Integration Hub & API erbjuder 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 standard RESTful API-protokollet. API Token-hanteringssystemet med detaljerad scope-baserad behörighetsmekanism säkerställer hög säkerhet, vilket möjliggör exakt kontroll av åtkomsträttigheter för varje integrerad applikation.

AI Agent Integration är en viktig differentiator, 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 Agents med olika roller, där varje Agent är tränad för ett specifikt användningsområde.

Dubbelriktad datasynkronisering mellan GTG CRM och externa system hjälper företag att alltid ha en enhetlig bild av kundinformationen. Fullständig API-dokumentation med curl command-exempel gör det enkelt för utvecklare att integrera och felsöka. Företag kan fråga efter listor över kontakter, uppgifter, affärer och uppdatera information i realtid.

Webhook-slutpunkter tillåter automatisk mottagning av data från externa system utan att behöva kontinuerlig polling. Genom att kombinera Webhooks med Automation och AI Agents kan företag bygga helt automatiserade händelsebearbetningsprocesser. Den integrerade Website Builder inom 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 framtida hantering, till exempel "Säljsystemintegration" eller "Mobilapplikation". Efter att ha angett namnet, klicka på "Skapa" för att slutföra.

Steg 2: Konfigurera åtkomstbehörigheter

Scope-baserad behörighetssystem tillåter exakt kontroll av vad applikationen kan göra med CRM-data. Efter att ha skapat applikationen, välj den nyskapade applikationen och gå till fliken "Behörigheter" eller "Scopes". Här ser du en lista över tillgängliga behörigheter som kan beviljas.

Om applikationen endast behöver läsa kontaktinformation, välj scopet "contacts.read". Om det behövs för att skapa och uppdatera kontakter, lägg till scopet "contacts.write". För att applikationen ska kunna läsa information om AI-agenter i systemet, bevilja behörigheten "agents.read". Om du vill att applikationen ska kunna begära att en AI-agent utför uppgifter, måste behörigheten "agents.execute" beviljas. När du har valt de nödvändiga behörigheterna, klicka på spara för att uppdatera konfigurationen.

Steg 3: Skapa API-token

En token är en autentiseringsnyckel som externa applikationer kan använda för att säkert anropa GTG CRM:s API. På applikationens detaljsida, leta upp sektionen "API Token" och klicka på "Create Token" eller "Generate Token". Token kommer att visas en enda gång med formatet som börjar med "gtg_", kopiera och lagra den omedelbart på en säker plats. Denna token måste användas i Authorization-headern för alla API-förfrågningar.

Viktig anmärkning: Om du lägger till nya behörigheter för en applikation efter att en token har skapats, kommer den gamla token inte automatiskt att ha dessa nya behörigheter. Du måste skapa en ny token för att få full tillgång till de konfigurerade behörigheterna.

Steg 4: Testa API-anslutningen

När du har 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 att ha testat framgångsrikt kan du integrera API:et i din faktiska applikation. Nedan finns ett exempel med Node.js, ett av de mest populära språken för backend-utveckling. Denna kod visar hur du 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, till exempel 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 "application/json" som Content-Type för POST- eller PUT-förfrågningar.

Steg 6: Använd AI-agenter i verkliga arbetsflöden

För att tydligt se värdet av Integration Hub, överväg ett verkligt affärsscenario. När en ny kund har slutfört en registrering på företagets e-handelssida, istället för att personalen manuellt skapar en profil i CRM och skickar ett välkomstmeddelande, kan hela processen automatiseras.

Arbetsprocessen fungerar på följande sätt. Först fyller kunden i ett registreringsformulär på webbplatsen. Webbplatsens backend anropar omedelbart GTG CRM API för att skapa en ny kontakt med fullständig kundinformation som namn, e-postadress, 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å snart kontakten har skapats i GTG CRM identifierar AI Agent automatiskt att det är en ny kund från webbplatsen. Agenten analyserar kundinformationen för att skicka ett personligt välkomstmeddelande, inte en generell mall. Samtidigt skapar Agenten en uppföljningsuppgift för säljaren med en uppmaning att ringa inom 24 timmar för att ge kunden rådgivning.

Fördelarna med denna automatiserade process är tydliga. Kunden får ett personligt välkomstmeddelande omedelbart efter registreringen, vilket skapar ett professionellt intryck och ökar förtroendet. Ingen manuell inmatning från personalen krävs, vilket sparar tid och minimerar fel. E-postmeddelandet är personligt baserat på kundinformationen, inte generellt innehåll. Säljpersonalen informeras och får en specifik uppgift för uppföljning, 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: Konfigurera Webhooks för att ta emot data automatiskt

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

Efter skapandet kommer systemet att tillhandahålla två viktiga uppgifter. Webhook URL är slutpunkten 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 faktiskt kommer från ett auktoriserat system och inte från en falsk källa.

En mycket viktig anmärkning är att Signing Secret endast visas en enda gång när webhooken skapas. Kopiera och lagra den omedelbart i företagets säkra hemlighetshanteringssystem. Om du tappar bort denna hemlighet måste du skapa en ny webhook.

För att testa att webhooken fungerar korrekt, skicka en test-händelse med ett curl-kommando. Begäran måste ha headern Content-Type satt till application/json och headern X-Webhook-Signature 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 kommer du att se denna händelse dyka upp i listan över mottagna händelser.

Steg 8: Kombinera Webhooks med Automation och AI Agent

Den verkliga kraften i Integration Hub utnyttjas till fullo när Webhooks kombineras med automatiseringsflöden och AI Agent. Detta gör det möjligt för företag att bygga intelligenta processflöden som automatiskt reagerar på händelser från externa system utan manuell intervention.

För att konfigurera ett flöde, gå till menyn "Automation" i GTG CRM och klicka på "Skapa nytt flöde".

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" och sedan "AI Agent-uppgift". Det är här du kommer att skriva instruktioner till AI Agenten om hur den ska hantera data som tas emot från webhooken.

Avsnittet för att skriva en prompt 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 då händelsen mottogs och orderinformationen. Skicka sedan ett tackmeddelande till kunden och meddela säljteamet."

När konfigurationen är klar, ä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 uppgifterna enligt instruktionerna.

När en händelse skickas in kan du följa bearbetningsprocessen i processens exekveringshistorik. AI Agenten kommer att logga bearbetningsresultaten så att företaget kan granska och revidera dem.

Dokumentet skapades 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 Agent för att helt automatisera innehållsskapandeprocessen – från att ta emot marknadsdata, skapa AI-bilder, skriva analysartiklar, publicera på webbplatsen, till att publicera på sociala medier och automatisk SEO. Resultat: minskning från 2-3 innehållsanställda till 0, obegränsat antal artiklar.

📖 Läs det detaljerade fallet om MM3.vn →

Kärnfördelar med att använda Integration Hub

Tidsbesparing är den mest direkta och tydliga fördelen. Automatisering av datasynkronisering mellan system eliminerar helt manuellt datainmatningsarbete, ett arbete som både är tidskrävande och felbenäget. Personalen kan fokusera på mer värdefulla uppgifter istället för repetitiva uppgifter.

Att utnyttja befintlig infrastruktur är en viktig fördel för företag som har investerat i mjukvarusystem. Istället för att ersätta all befintlig teknik, behöver företaget bara ansluta GTG CRM för att lägga till AI- och automatiseringskapacitet. Detta minimerar risken för avbrott i affärsverksamheten och skyddar den investering i teknik som gjorts.

Ökad säljeffektivitet tack vare AI Agent som kan vårda kunder tjugofyra sju utan paus. Alla möjligheter övervakas och hanteras snabbt, utan att missa några leads för att personalen är upptagen eller utanför arbetstid.

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

Säkerhetskontroll garanteras genom ett detaljerat åtkomsthanteringssystem med scope och tokens. Företag kan ge exakt behörighet till varje integrerad applikation, vilket säkerställer att känslig data endast nås av auktoriserade system.

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

Automatiserad innehållsskapande är en unik funktion hos GTG CRM. Genom att kombinera webhooks med automation och AI-agenter kan företag automatiskt skapa artiklar, bilder och inlägg på sociala medier från rådata. Detta är särskilt användbart för företag inom innehålls- eller marknadsföringsbranschen.

Automatisk SEO genom en inbyggd webbplatsbyggare med sitemap och Google Search Console säkerställer att allt nytt innehåll snabbt upptäcks och indexeras av sökmotorer, vilket genererar organisk trafik för företaget.

Viktiga överväganden vid implementering

Token-säkerhet är högsta prioritet. API-tokens ger åtkomst till viktig företagsdata, så de bör aldrig delas med obehöriga eller begås till källkoden. Tokens bör lagras i miljövariabler eller ett dedikerat hemlighetshanteringssystem. Om du misstänker att en token har läckt ut, återkalla den och skapa en ny omedelbart.

Uppdatera token vid behörighetsändring är en regel som måste följas. Varje gång ett nytt scope läggs till en applikation, kommer den nuvarande token inte automatiskt att ha den nya behörigheten. Företag måste skapa en ny token för att den nya token ska inkludera alla konfigurerade behörigheter. Att glömma detta steg leder ofta till svårfelsökta "Permission Denied"-fel.

Webhook-säkerhet via en signaturhemlighet liknar token-säkerhet. Denna hemlighet visas endast en gång vid skapandet av webhooken 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:er har en gräns för antalet förfrågningar under en viss tidsperiod. Integrerade applikationer bör implementera återförsökslogik med exponentiell backoff och undvika att anropa API:er för ofta under korta tidsperioder. Om rate limit överskrids, kommer begäran att nekas med HTTP-statuskod 429.

Validering av data innan den 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 API-anrop. 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 automationskörningshistorik för att säkerställa att webhooks tar emot rätt data, att AI-agenter bearbetar som förväntat och att inga fel förbises. GTG CRM tillhandahåller en övervakningsinstrumentpanel för företag att följa integrationens status.

AI-agentens prompt måste skrivas tydligt och specifikt. Ju mer detaljerad information som ges om hur olika typer av händelser ska hanteras, desto mer exakt blir AI:ns resultat. Istället för att skriva "hantera händelse", skriv "när händelsen är order.completed, skapa ett dokument som registrerar tid och orderinformation, skicka sedan ett tackmeddelande till kunden med mall A, och skapa slutligen en uppgift för säljteamet med en deadline på 24 timmar".

Slutsats

GTG CRMs Integration Hub & API är en omfattande integrationslösning som hjälper företag att ansluta sina befintliga system till modern AI-teknik utan att behöva ändra hela sin tekniska infrastruktur. Genom detaljerade guider från att skapa applikationer, konfigurera behörigheter, ställa in webhooks till att integrera med AI-agenter, kan företag bygga intelligenta automatiserade processer och avsevärt spara driftsresurser.

Case study thực tế của MM3 har tydligt visat potentialen hos denna lösning, inte bara för att automatisera enkla uppgifter, utan även för att bygga hela värdekedjan från rådata till publicerat innehåll och automatisk SEO. Viktigt är att lösningen inte kräver djup programmeringskunskap eller stor teknisk personal, utan endast grundläggande förståelse för API:er och förmågan att skriva instruktioner i naturligt språk för AI Agent.

Med ett detaljerat behörighetssystem, flera säkerhetslager 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 automatiserad innehållsskapande, automatisk kundvård eller hantering av betalningar och fakturering.

För företag som börjar rekommenderas det att arbeta stegvis, testa noggrant i varje fas och utnyttja GTG CRMs gratis 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 är lämpliga för varje företags specifika affärsbehov och befintliga tekniska infrastruktur. Tveka inte att kontakta oss för att få hjälp under implementeringen och optimeringen av integrationsprocessen.