Integration Hub & API

Im modernen Geschäftsumfeld betreiben Unternehmen oft mehrere verschiedene Softwaresysteme für spezifische Zwecke. Dies können Vertriebsmanagementsoftware, Buchhaltungssysteme, Marketingtools oder individuell entwickelte interne Anwendungen sein. Jedes dieser Systeme enthält wertvolle Daten und spielt eine wichtige Rolle im Geschäftsbetrieb.

Die größte Herausforderung ist nicht der Mangel an Daten, sondern die Tatsache, dass diese Daten auf vielen verschiedenen Plattformen isoliert vorhanden sind. Mitarbeiter müssen zwischen Systemen wechseln, dieselben Informationen mehrmals manuell eingeben und haben keinen umfassenden Überblick über den Kunden. Dies verschwendet nicht nur Zeit, sondern erhöht auch das Risiko von Fehlern und verpassten Geschäftschancen.

Der Integration Hub & API von GTG CRM wurde entwickelt, um dieses Problem grundlegend zu lösen. Anstatt Unternehmen zu zwingen, ihre bestehenden Systeme vollständig zu ersetzen, schafft diese Lösung eine Brücke, die die Systeme miteinander verbindet. Daten können frei zwischen Plattformen übertragen, Prozesse automatisiert und – am wichtigsten – KI-Agenten zur Steigerung der betrieblichen Effizienz eingesetzt werden.

Dieses Dokument führt Sie Schritt für Schritt durch die erfolgreiche Implementierung der Integration, von der Erstellung von Anwendungen und der Konfiguration von Zugriffsberechtigungen über die Nutzung der API zum Lesen und Schreiben von Daten und die Einrichtung von Webhooks für den automatischen Empfang von Ereignissen bis hin zur Kombination mit KI-Agenten zur Erstellung vollständig automatisierter intelligenter Verarbeitungsprozesse.

Überblick über die Hauptfunktionen

Der Integration Hub & API bietet ein umfassendes Toolset, mit dem Unternehmen GTG CRM über das Standard-RESTful-API-Protokoll mit jeder Anwendung verbinden können. Das API-Token-Verwaltungssystem mit detaillierter Berechtigungssteuerung pro Scope gewährleistet ein hohes Maß an Sicherheit und ermöglicht die präzise Kontrolle der Zugriffsrechte jeder integrierten Anwendung.

Die KI-Agenten-Integration ist ein wichtiger Differenzierungsfaktor, der es Unternehmen ermöglicht, künstliche Intelligenz zur automatischen Datenverarbeitung und Ausführung komplexer Aufgaben ohne Programmierung zu nutzen. Unternehmen können mehrere KI-Agenten mit unterschiedlichen Rollen verwalten, wobei jeder Agent für einen bestimmten Verwendungszweck trainiert ist.

Die bidirektionale Datensynchronisation zwischen GTG CRM und externen Systemen hilft Unternehmen, stets einen einheitlichen Blick auf Kundeninformationen zu haben. Die vollständige API-Dokumentation mit Curl-Befehlsbeispielen erleichtert Entwicklern die Integration und Fehlerbehebung. Unternehmen können Kontaktlisten, Aufgaben, Transaktionen abfragen und Informationen in Echtzeit aktualisieren.

Der Webhook-Endpunkt ermöglicht den automatischen Empfang von Daten aus externen Systemen, ohne dass ständig abgefragt werden muss. Durch die Kombination von Webhooks mit Automatisierung und KI-Agenten können Unternehmen vollständig automatisierte ereignisgesteuerte Verarbeitungsprozesse aufbauen. Der im Ökosystem integrierte Website Builder ermöglicht die direkte Erstellung von Websites aus GTG CRM mit vollen SEO- und automatischen Sitemap-Funktionen.

Schritt-für-Schritt-Anleitung

Schritt 1: Integration von Anwendungen erstellen

Der erste Schritt zur Integration ist die Erstellung einer neuen Anwendung in GTG CRM. Navigieren Sie zum Menü „Integration & API“ und klicken Sie auf die Schaltfläche „Neue Anwendung erstellen“. Geben Sie der Anwendung einen aussagekräftigen Namen für eine einfache Verwaltung in der Zukunft, z. B. „Integration des Verkaufssystems“ oder „Mobile Anwendung“. Klicken Sie nach Eingabe des Namens auf „Erstellen“, um den Vorgang abzuschließen.

Schritt 2: Zugriffsberechtigungen konfigurieren

Das Scopes-basierte Berechtigungssystem ermöglicht die präzise Kontrolle darüber, was die Anwendung mit den CRM-Daten tun kann. Nach der Erstellung der Anwendung wählen Sie die gerade erstellte Anwendung aus und greifen Sie auf die Registerkarte „Berechtigungen“ oder „Scopes“ zu. Hier sehen Sie eine Liste der möglichen Berechtigungen.

Wenn die Anwendung nur Kontaktinformationen lesen muss, wählen Sie den Scope „contacts.read“. Wenn sie Kontakte erstellen und aktualisieren muss, fügen Sie den Scope „contacts.write“ hinzu. Damit die Anwendung Informationen über KI-Agenten im System lesen kann, gewähren Sie die Berechtigung „agents.read“. Wenn die Anwendung KI-Agenten zur Ausführung von Aufgaben auffordern soll, muss die Berechtigung „agents.execute“ gewährt werden. Klicken Sie nach Auswahl der erforderlichen Berechtigungen auf „Speichern“, um die Konfiguration zu aktualisieren.

Schritt 3: API-Token erstellen

Das Token ist der Authentifizierungsschlüssel, mit dem externe Anwendungen die GTG CRM-API sicher aufrufen können. Suchen Sie auf der Detailseite der Anwendung den Abschnitt „API-Token“ und klicken Sie auf „Token erstellen“ oder „Token generieren“. Das Token wird nur einmal angezeigt und beginnt mit dem Format „gtg_“. Kopieren Sie es und speichern Sie es sofort sicher. Dieses Token muss im Autorisierungsheader jedes API-Requests verwendet werden.

Wichtiger Hinweis: Wenn Sie nach der Token-Erstellung neue Berechtigungen für eine Anwendung hinzufügen, hat das alte Token diese neuen Berechtigungen nicht automatisch. Sie müssen ein neues Token erstellen, um die vollständig konfigurierten Berechtigungen zu erhalten.

Schritt 4: API-Verbindung testen

Nachdem Sie das Token haben, ist der nächste Schritt zu überprüfen, ob die Integration ordnungsgemäß funktioniert. Der einfachste Weg ist die Verwendung eines Curl-Befehls im Terminal. Das folgende Beispiel zeigt, wie Sie eine Kontaktliste von GTG CRM abrufen.

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

Wenn die Verbindung erfolgreich ist und das Token über ausreichende Berechtigungen verfügt, erhalten Sie eine JSON-Antwort mit der Liste der Kontakte mit allen Details wie ID, Name, E-Mail, Telefonnummer und anderen Datenfeldern.

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

Schritt 5: In Ihre Systeme integrieren

Nach erfolgreicher Prüfung können Sie die API in Ihre tatsächlichen Anwendungen integrieren. Hier ist ein Beispiel mit Node.js, einer der beliebtesten Sprachen für die Backend-Entwicklung. Dieser Codeausschnitt zeigt, wie Sie eine Kontaktliste abrufen und einen neuen Kontakt in GTG CRM erstellen.

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

Ähnlich können Sie jede andere Programmiersprache wie Python, PHP, Java oder C# zur Integration verwenden. Das allgemeine Prinzip ist, das Token immer im Autorisierungsheader im Format „Bearer YOUR_TOKEN“ zu senden und Content-Type als „application/json“ für POST- oder PUT-Anfragen zu verwenden.

Schritt 6: KI-Agenten in realen Prozessen einsetzen

Um den Wert des Integration Hubs vollständig zu verstehen, betrachten wir ein reales Geschäftsszenario. Wenn sich ein neuer Kunde auf der Verkaufswebsite eines Unternehmens registriert, kann der gesamte Prozess automatisiert werden, anstatt dass ein Mitarbeiter manuell ein Profil im CRM erstellen und eine Begrüßungs-E-Mail senden muss.

Der Prozess funktioniert wie folgt: Zuerst füllt der Kunde das Registrierungsformular auf der Verkaufswebsite aus. Das Backend der Website ruft sofort die GTG CRM-API auf, um einen neuen Kontakt mit allen Kundendaten wie Name, E-Mail, Telefonnummer und Kundenquelle zu erstellen.

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

Sobald der Kontakt in GTG CRM erstellt wurde, erkennt der KI-Agent automatisch, dass es sich um einen neuen Kunden von der Website handelt. Der Agent analysiert die Kundendaten, um eine personalisierte Begrüßungs-E-Mail zu versenden, anstatt einer generischen Vorlage. Gleichzeitig erstellt der Agent eine Nachverfolgungsaufgabe für den Vertriebsmitarbeiter mit der Aufforderung, innerhalb von 24 Stunden anzurufen, um den Kunden zu beraten.

Die Vorteile dieses automatisierten Prozesses sind offensichtlich. Der Kunde erhält sofort nach der Registrierung eine personalisierte Begrüßungs-E-Mail, was einen professionellen Eindruck hinterlässt und das Vertrauen stärkt. Keine manuellen Eingriffe durch Mitarbeiter erforderlich, was Zeit spart und Fehler reduziert. Die E-Mail ist auf die Kundendaten zugeschnitten, nicht generisch. Vertriebsmitarbeiter werden benachrichtigt und erhalten eine konkrete Aufgabe zur Nachverfolgung, sodass keine Chance verpasst wird. All diese Faktoren zusammen tragen dazu bei, die Lead-to-Customer-Konversionsrate zu erhöhen.

Schritt 7: Webhooks für automatischen Datenempfang einrichten

Webhooks sind eine Technologie, die es externen Systemen ermöglicht, aktiv Daten an GTG CRM zu senden, wenn ein Ereignis auftritt, anstatt ständig abzufragen. Um zu beginnen, rufen Sie die Seite „Integration & API“ auf, wählen Sie die Registerkarte „Webhook“ und klicken Sie dann auf „Neuen Webhook erstellen“ und geben Sie dem Webhook einen aussagekräftigen Namen.

Nach der Erstellung liefert das System zwei wichtige Informationen. Die Webhook-URL ist der Endpunkt, an den externe Systeme Daten über HTTP POST senden. Der Signing Secret ist ein geheimer Code, der zur Authentifizierung verwendet wird, um sicherzustellen, dass die Anfrage tatsächlich von einem autorisierten System und nicht von einer gefälschten Quelle stammt.

Es ist sehr wichtig zu beachten, dass das Signing Secret nur einmal bei der Erstellung des Webhooks angezeigt wird. Kopieren Sie es und speichern Sie es sofort in Ihrem sicheren Secret-Management-System. Wenn Sie dieses Secret verlieren, müssen Sie einen neuen Webhook erstellen.

Um zu testen, ob der Webhook ordnungsgemäß funktioniert, senden Sie ein Testereignis mit einem Curl-Befehl. Die Anforderung muss den Content-Type-Header als application/json und den X-Webhook-Signature-Header mit dem Signing Secret zur Authentifizierung enthalten.

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

Wenn der Webhook ordnungsgemäß funktioniert, sehen Sie dieses Ereignis in der Liste der empfangenen Ereignisse.

Schritt 8: Webhooks mit Automatisierung und KI-Agenten kombinieren

Die wahre Stärke des Integration Hubs wird erst dann voll ausgeschöpft, wenn Webhooks mit Automatisierungs- und KI-Agenten-Prozessen kombiniert werden. Dies ermöglicht es Unternehmen, intelligente Verarbeitungsprozesse zu erstellen, die automatisch auf Ereignisse von externen Systemen reagieren, ohne manuelles Eingreifen.

Um einen Prozess einzurichten, navigieren Sie im GTG CRM zum Menü „Automatisierung“ und klicken Sie auf „Neuen Prozess erstellen“.

Der wichtigste Teil ist die Konfiguration des Triggers, damit der Prozess weiß, wann er aktiviert werden soll. Wählen Sie das Modul „Externe Integration“, das Objekt „Webhook“ und die Aktion „Daten empfangen“. Das bedeutet, dass dieser Prozess jedes Mal automatisch ausgelöst wird, wenn der Webhook ein Ereignis von einem externen System empfängt.

Nach der Konfiguration des Triggers fügen Sie dem Prozess eine KI-Agenten-Aufgabe hinzu. Klicken Sie auf „Aufgabe hinzufügen“, wählen Sie das Modul „KI“ und dann „KI-Agenten-Aufgabe“. Hier schreiben Sie die Anweisungen für den KI-Agenten, wie die vom Webhook empfangenen Daten verarbeitet werden sollen.

Der Teil, in dem der Prompt für den KI-Agenten geschrieben wird, ist, wo das Unternehmen seine Geschäftslogik zum Ausdruck bringt. Sie könnten zum Beispiel schreiben: „Wenn das Ereignis order.completed ist, erstellen Sie ein Dokument, das die Zeit des Ereignisses und die Bestellinformationen festhält. Senden Sie dann eine Dankes-E-Mail an den Kunden und informieren Sie das Vertriebsteam.“

Nach Abschluss der Konfiguration wechseln Sie den Prozessstatus zu „Aktiv“. Von nun an wird der KI-Agent jedes Mal, wenn das externe System ein Ereignis an den Webhook sendet, die Aufgaben gemäß den Anweisungen automatisch ausführen.

Wenn ein Ereignis empfangen wird, können Sie den Verarbeitungsprozess im Ausführungsprotokoll des Prozesses verfolgen. Der KI-Agent zeichnet die Verarbeitungsergebnisse auf, damit das Unternehmen sie überprüfen und auditieren kann.

Das Dokument wurde nach Bedarf erstellt:

Fallstudie: MM3.vn automatisiert Marketinginhalte

MM3 ist ein Unternehmen, das die Website mm3.vn betreibt. Es nutzt den Integration Hub in Kombination mit KI-Agenten, um den Prozess der Inhaltserstellung vollständig zu automatisieren – vom Empfang von Marktdaten, der Erstellung von KI-Bildern, dem Schreiben von Analyseartikeln, der Veröffentlichung auf der Website bis hin zur automatischen Veröffentlichung in sozialen Medien und SEO. Ergebnis: Reduzierung von 2-3 Content-Mitarbeitern auf 0, unbegrenzte Artikelanzahl.

📖 Lesen Sie die detaillierte Fallstudie über MM3.vn →

Kernvorteile der Nutzung des Integration Hubs

Zeitersparnis ist der direkteste und offensichtlichste Vorteil. Die Automatisierung der Datensynchronisation zwischen Systemen eliminiert die manuelle Dateneingabe, eine sowohl zeitaufwändige als auch fehleranfällige Aufgabe. Mitarbeiter können sich auf höherwertige Aufgaben konzentrieren, anstatt auf sich wiederholende Aufgaben.

Die Nutzung vorhandener Infrastruktur ist ein wichtiger Vorteil für Unternehmen, die in Softwaresysteme investiert haben. Anstatt die gesamte bestehende Technologie zu ersetzen, müssen Unternehmen nur GTG CRM verbinden, um KI- und Automatisierungsfunktionen hinzuzufügen. Dies minimiert das Risiko von Geschäftsunterbrechungen und schützt die getätigten Technologieinvestitionen.

Steigerung der Verkaufseffizienz durch KI-Agenten, die Kunden rund um die Uhr ohne Pausen betreuen können. Jede Chance wird zeitnah verfolgt und bearbeitet, sodass kein Lead verloren geht, weil Mitarbeiter beschäftigt oder außerhalb der Arbeitszeit sind.

Flexible Erweiterbarkeit ist eine Stärke der API-Architektur. Unternehmen können bei wachsendem Geschäftsumfang problemlos neue Funktionen hinzufügen oder sich mit weiteren Systemen verbinden. Ohne an eine starre Plattform gebunden zu sein, können Unternehmen ihr Tempo anpassen und erweitern.

Sicherheitskontrolle wird durch ein detailliertes Zugriffssteuerungsmanagementsystem mit Scopes und Tokens gewährleistet. Unternehmen können jeder integrierten Anwendung präzise Berechtigungen erteilen und sicherstellen, dass sensible Daten nur von autorisierten Systemen abgerufen werden.

Bidirektionale Webhooks erweitern die Integrationsmöglichkeiten weit über traditionelle API-Lösungen hinaus. Unternehmen können nicht nur bei Bedarf aktiv APIs aufrufen, sondern auch Echtzeitdaten von externen Systemen empfangen.

Inhaltsautomatisierung ist eine einzigartige Fähigkeit von GTG CRM. Durch die Kombination von Webhooks mit Automatisierung und KI-Agenten können Unternehmen automatisch Artikel, Bilder und Social-Media-Beiträge aus Rohdaten erstellen. Dies ist besonders nützlich für Unternehmen in den Bereichen Content oder Marketing.

Automatische SEO durch den Website Builder mit integrierter Sitemap und Google Search Console stellt sicher, dass alle neuen Inhalte von Suchmaschinen schnell erkannt und indexiert werden, was zu organischem Traffic für das Unternehmen führt.

Wichtige Überlegungen zur Implementierung

Token-Sicherheit hat oberste Priorität. API-Token gewähren Zugriff auf wichtige Unternehmensdaten und sollten daher niemals an Dritte weitergegeben oder in den Quellcode eingecheckt werden. Tokens sollten in Umgebungsvariablen oder einem speziellen Secret-Management-System gespeichert werden. Wenn Sie vermuten, dass ein Token kompromittiert wurde, widerrufen Sie es und erstellen Sie sofort ein neues Token.

Token-Aktualisierung bei Berechtigungsänderungen ist eine zwingende Regel. Jedes Mal, wenn Sie einer Anwendung einen neuen Scope hinzufügen, hat das aktuelle Token diese neuen Berechtigungen nicht automatisch. Unternehmen müssen ein neues Token erstellen, damit das neue Token alle konfigurierten Berechtigungen enthält. Das Vergessen dieses Schritts führt oft zu schwer zu debuggenden „Berechtigungsfehler“-Fehlern.

Webhook-Sicherheit durch Signing Secret ist ähnlich wie Token-Sicherheit. Dieses Secret wird nur einmal bei der Erstellung des Webhooks angezeigt und muss daher sofort gespeichert werden. Das externe System, das das Ereignis sendet, muss dieses Secret im Header angeben, damit GTG CRM die Gültigkeit der Anfrage authentifizieren kann.

Ratenbegrenzung ist ein Mechanismus zum Schutz des Systems vor Überlastung. Die API hat eine Begrenzung der Anzahl von Anfragen in einem bestimmten Zeitraum. Integrierte Anwendungen müssen eine Wiederholungslogik mit exponentiellem Backoff implementieren und vermeiden, zu viele API-Aufrufe in kurzer Zeit durchzuführen. Wenn das Ratenlimit überschritten wird, wird die Anfrage mit dem HTTP-Statuscode 429 abgelehnt.

Datenvalidierung vor dem Senden an die API hilft, unnötige Fehler zu vermeiden. Überprüfen Sie das E-Mail-Format, die Zeichenkettenlänge und andere Datenbeschränkungen auf Client-Seite, bevor Sie die API aufrufen. Dies spart API-Kontingente und verbessert das Benutzererlebnis.

Überwachung und Protokollierung sind unerlässlich, um Integrationsprobleme frühzeitig zu erkennen. Überwachen Sie Protokolle und die Ausführungshistorie von Automatisierungen, um sicherzustellen, dass Webhooks die richtigen Daten empfangen, KI-Agenten wie erwartet verarbeiten und keine Fehler übersehen werden. GTG CRM bietet ein Überwachungs-Dashboard, mit dem Unternehmen den Integrationsstatus verfolgen können.

Prompts für KI-Agenten sollten klar und spezifisch formuliert sein. Je detaillierter die Verarbeitung jedes Ereignistyps beschrieben wird, desto genauer sind die Verarbeitungsergebnisse der KI. Anstatt „Ereignis verarbeiten“ zu schreiben, schreiben Sie „wenn das Ereignis order.completed ist, erstellen Sie ein Dokument, das die Zeit und die Bestellinformationen aufzeichnet, senden Sie dann eine Dankes-E-Mail an den Kunden mit der Vorlage A und erstellen Sie schließlich eine Aufgabe für das Vertriebsteam mit einer Frist von 24 Stunden“.

Fazit

Der Integration Hub & API von GTG CRM ist eine umfassende Integrationslösung, die Unternehmen hilft, ihre bestehenden Systeme mit moderner KI-Technologie zu verbinden, ohne ihre gesamte technologische Infrastruktur ändern zu müssen. Anhand der detaillierten Schritt-für-Schritt-Anleitungen von der Erstellung von Anwendungen, der Konfiguration von Berechtigungen, der Einrichtung von Webhooks bis hin zur Kombination mit KI-Agenten können Unternehmen intelligente Automatisierungsprozesse erstellen und Betriebskosten erheblich einsparen.

Die Fallstudie von MM3 hat das Potenzial dieser Lösung klar bewiesen, nicht nur bei der Automatisierung einfacher Aufgaben, sondern auch beim Aufbau ganzer Wertschöpfungsketten von Rohdaten bis hin zu veröffentlichten Inhalten und automatisierter SEO. Wichtig ist, dass diese Lösung keine tiefgreifenden Programmierkenntnisse oder ein großes technisches Team erfordert, sondern nur grundlegendes API-Verständnis und die Fähigkeit, natürliche Sprachanweisungen für KI-Agenten zu schreiben.

Mit seinem detaillierten Berechtigungssystem, mehrstufiger Sicherheit und flexibler Skalierbarkeit eignet sich der Integration Hub für Unternehmen jeder Größe, von Start-ups bis hin zu großen Unternehmen. Unternehmen können mit einfachen Integrationen wie der Synchronisation von Kontaktlisten beginnen und dann schrittweise zu komplexeren Prozessen wie der Inhaltsautomatisierung, der automatischen Kundenbetreuung oder der Zahlungsabwicklung und Rechnungsstellung übergehen.

Für neue Unternehmen wird empfohlen, Schritt für Schritt vorzugehen, in jeder Phase sorgfältig zu prüfen und das kostenlose Testangebot von GTG CRM zu nutzen, um sich mit dem System vertraut zu machen, bevor die offizielle Implementierung erfolgt. Beginnen Sie mit einem einfachen Webhook-Test, um die Funktionsweise zu verstehen, und erweitern Sie dann schrittweise zu komplexeren Aufgaben, sobald Sie Erfahrungen gesammelt haben.

Das Support-Team von GTG CRM steht jederzeit zur Verfügung, um detaillierte Beratung zu Integrationslösungen anzubieten, die für die spezifischen Geschäftsbedürfnisse und die aktuelle technologische Infrastruktur jedes Unternehmens geeignet sind. Zögern Sie nicht, uns zu kontaktieren, um Unterstützung bei der Implementierung und Optimierung Ihrer Integrationsprozesse zu erhalten.