aB-Agenta Integration

Die aB-Agenta Integration verbindet meetergo mit deinem eigenen aBServer. Sie unterstützt drei voneinander unabhängige Abläufe:

Kunden und zugeordnete Notizen aus aB-Agenta in das meetergo CRM importieren
nach einer Buchung einen Kunden in aB-Agenta erstellen oder aktualisieren
optional neue meetergo CRM-Notizen und Dokumente an aB-Agenta senden

Voraussetzungen

Prüfe vor der Verbindung folgende Punkte:

Das Entwickler- oder API-Modul ist für deine aB-Agenta Lizenz freigeschaltet.
aB-Agenta und aBServer wurden nach der Freischaltung aktualisiert.
Dein aBServer ist über das Internet mit HTTPS und einem gültigen TLS-Zertifikat erreichbar.
Dein meetergo Tarif enthält CRM-Integrationen.
Du bist Administrator des meetergo Arbeitsbereichs.

Eine lokale Adresse wie localhost, 192.168.x.x oder ein Server, der nur im Büronetz erreichbar ist, kann nicht verwendet werden. meetergo prüft Hostname, DNS-Ergebnis und Weiterleitungen, bevor Zugangsdaten gesendet werden.

Wenn das Entwickler-Modul heute freigeschaltet wurde, führe in aB-Agenta unter Zusatzmodule → Systemeinstellungen → Online-Update eine Aktualisierung durch.

Verbindungsdaten erhalten

Du brauchst folgende Werte von deinem aBServer Administrator oder vom ArtBase Entwicklungssupport:

aBServer-URL: die öffentliche HTTPS-Adresse des Servers
API-Benutzername
API-Passwort
Servicepasswort: wird im Header ab-servicepassword gesendet
Datenverzeichnis: optional, wenn dein aBServer ab-datadirectory benötigt
Client-Secret: optional, wenn dein aBServer ab-client-secret benötigt

Deine ArtBase Kundennummer und die aB-Agenta Seriennummer identifizieren deine Lizenz. Sie sind keine API-Zugangsdaten und werden nicht in meetergo eingetragen.

Behandle alle Verbindungswerte wie Passwörter. meetergo speichert die Zugangsdaten verschlüsselt und zeigt sie später nicht erneut an.

ArtBase veröffentlicht eine Übersicht zur aB-Agenta API und die API-Dokumentation.

aB-Agenta verbinden

Öffne Einstellungen → Integrationen.
Suche aB-Agenta in der Kategorie CRM und klicke auf Verbinden.
Trage aBServer-URL, API-Benutzername, API-Passwort und Servicepasswort ein.
Trage optional Datenverzeichnis und Client-Secret ein, wenn dein Server diese Werte verwendet.
Klicke auf Verbindung testen und Felder laden.
Wähle das Kundenobjekt in aB-Agenta. Das Standard-Kundenobjekt ist vorausgewählt, wenn es verfügbar ist.
Ordne mindestens Vorname, Nachname und E-Mail zu. Ordne weitere Kundeneigenschaften nach Bedarf zu.
Optional: Aktiviere CRM-Notizen und Dokumente an aB-Agenta senden, wähle das Zielobjekt und ordne Kundenreferenz, Inhalt, Titel und Erstellungsdatum zu.
Klicke auf Verbindung speichern.

Die Einrichtung liest Objekt- und Eigenschaftsmetadaten von deinem eigenen aBServer. Deshalb können auch angepasste aB-Agenta Installationen ihre eigenen Objekt- und Eigenschaftsnamen verwenden.

Kunden in das meetergo CRM importieren

Öffne CRM → Kontakte.
Klicke auf Aus aB-Agenta importieren.
Wenn ein Notizobjekt konfiguriert ist, wähle aus, ob zugeordnete Notizen importiert werden sollen.
Klicke auf Import starten.

Pro Durchlauf werden bis zu 5.000 Kunden verarbeitet. Ein neuer Import kann alle 5 Minuten gestartet werden. Vorhandene Kontakte werden zuerst über die gespeicherte aB-Agenta Datensatz-ID und danach über die E-Mail erkannt. Wiederholte Importe aktualisieren passende Kontakte. Lokale CRM-Kontakte werden nicht gelöscht oder archiviert.

Buchungsteilnehmer an aB-Agenta senden

Die Verbindung allein aktiviert noch keine Buchungssynchronisierung. Aktiviere sie für jede Terminseite, deren Buchungen an aB-Agenta gesendet werden sollen:

Öffne Terminseiten und bearbeite eine Terminseite.
Öffne die CRM-Einstellungen.
Suche aB-Agenta unter Verbundene Apps und klicke auf Verwalten.
Aktiviere Kunden erstellen oder aktualisieren.

Nach einer Buchung sucht meetergo den Kunden über die E-Mail oder erstellt einen neuen Kunden im zugeordneten Objekt. Die Buchung bleibt erfolgreich, wenn der aBServer vorübergehend nicht erreichbar ist.

CRM-Notizen und Dokumente an aB-Agenta senden

Wenn CRM-Notizen und Dokumente an aB-Agenta senden aktiviert ist, werden neue Notizen und Dateien an verknüpften meetergo CRM-Kontakten in das konfigurierte aB-Agenta Objekt übertragen. Dieser Ablauf ist unabhängig von der Buchungssynchronisierung.

Die lokale CRM-Aktion wird durch einen vorübergehenden Ausfall des aBServers nicht blockiert. Der externe Fehler wird für die Fehlersuche protokolliert.

Verbindung aktualisieren oder trennen

Öffne Einstellungen → Integrationen → aB-Agenta.

Klicke auf Verbindung aktualisieren, um neue Zugangsdaten zu prüfen oder Zuordnungen zu ändern. Geheime Werte müssen erneut eingetragen werden.
Klicke auf Trennen, um die gespeicherte Verbindung zu entfernen. Bereits in meetergo importierte Kundendaten bleiben erhalten.

Fehlerbehebung

Der Verbindungstest schlägt fehl

Prüfe, ob die URL mit https:// beginnt, ein gültiges öffentliches Zertifikat verwendet und außerhalb deines Firmennetzes erreichbar ist. Prüfe danach Benutzername, Passwort, Servicepasswort und optionale Header mit deinem aBServer Administrator.

Das API-Modul ist nicht verfügbar

Starte aB-Agenta neu, während der Rechner mit dem Internet verbunden ist, oder führe unter Zusatzmodule → Systemeinstellungen → Online-Update eine Aktualisierung durch. Wenn das Modul weiterhin fehlt, wende dich an den ArtBase Entwicklungssupport.