ActiveCampaign-Integration einrichten
Mit der ActiveCampaign-Integration sendet dein AI-Agent erfasste Kontaktdaten direkt an dein ActiveCampaign-Konto. Neue Leads erscheinen automatisch in deiner Kontaktliste, bereit für Follow-up oder E-Mail-Kampagnen.
Kurz gesagt
Heyloha verbindet sich mit ActiveCampaign über deine API-URL und deinen API-Key. Standardfelder (Name, E-Mail, Telefon) werden automatisch synchronisiert. Für Adressdaten werden Custom-Field-IDs aus deinem ActiveCampaign-Konto benötigt.
Was wird synchronisiert?
Die folgenden Standardfelder werden automatisch mit ActiveCampaign synchronisiert:
- Vorname und Nachname
- E-Mail-Adresse
- Telefonnummer
Adresse, Postleitzahl, Stadt und Land können ebenfalls synchronisiert werden, erfordern aber Custom-Field-IDs.
ActiveCampaigns Contact-Sync-Endpunkt aktualisiert bestehende Kontakte automatisch, wenn die E-Mail übereinstimmt. Duplikate werden verhindert.
Was brauchst du?
- Ein ActiveCampaign-Konto mit API-Zugang (bei allen Plänen verfügbar).
- Deine API-URL und deinen API-Key (unter Einstellungen > Developer zu finden).
- Ein aktives Heyloha-Konto mit mindestens einem AI-Agenten.
- Optional: Custom-Field-IDs für Adresse, Postleitzahl, Stadt und Land.
API-Zugangsdaten in ActiveCampaign finden
Gehe zu Einstellungen
Melde dich bei ActiveCampaign an und gehe zu Einstellungen > Developer.
API-URL kopieren
Die API-URL sieht z.B. so aus: https://deinkonto.api-us1.com. Deine URL kann je nach Region abweichen (z.B. api-eu1.com für Europa). Kopiere die genaue URL aus deinem ActiveCampaign-Konto.
API-Key kopieren
Der API-Key steht direkt unter der API-URL. Kopiere ihn ebenfalls.
Custom-Field-IDs für Adressdaten (optional)
Wenn du auch Adressdaten synchronisieren möchtest, brauchst du die numerischen IDs deiner Custom Fields:
Gehe zu Manage Fields
In ActiveCampaign, gehe zu Einstellungen > Manage Fields.
Felder suchen oder erstellen
Suche die Felder für Adresse, Postleitzahl, Stadt und Land. Erstelle sie, falls sie noch nicht existieren.
Numerische IDs notieren
Jedes Custom Field hat eine eindeutige numerische ID. Du findest diese ID, indem du auf das Feld klickst und die Nummer in der URL notierst. Notiere die IDs für jedes Adressfeld.
Integration in Heyloha einrichten
Geh zu Agent, dann Integrationen
Klick im linken Menü auf Agent und öffne den Tab Integrationen. Der Bereich Webhooks steht ganz oben.
Klick auf Webhook hinzufügen
Klick im Bereich Webhooks auf Webhook hinzufügen. Es öffnet sich ein Formular, in dem du die Verbindung einrichtest.
Wähle 'ActiveCampaign' als Plattform
Wähle ActiveCampaign im Formular aus. Das Formular zeigt die Felder für API-URL und API-Key.
Wähle die Kanäle (optional)
Standardmäßig gilt der Webhook für alle Kanäle deines Agenten. Wenn du ihn zum Beispiel nur auf den Webchat oder nur auf WhatsApp beschränken willst, wähle die gewünschten Kanäle aus. Lässt du das Feld leer, gilt die Verbindung für jeden Kanal.
Gib deine API-Daten ein
Füge die API-URL und den API-Key ein, die du in ActiveCampaign kopiert hast.
Gib die Custom-Field-IDs ein (optional)
Jedes Custom Field hat eine eindeutige numerische ID. Du findest diese ID, indem du auf das Feld klickst und die Nummer in der URL anschaust. Notiere die IDs für jedes Adressfeld.
Benenne die Integration
Wähle einen erkennbaren Namen, zum Beispiel 'ActiveCampaign Leads'. Dieser Name wird auch als interner Funktionsname verwendet.
Wähle Kontaktfelder aus
Wähle, welche Daten dein AI-Agent sammeln soll. Wähle mindestens eine E-Mail-Adresse aus.
Wähle Event-Trigger
Wähle, wann die Integration ausgelöst werden soll: bei der Erfassung von Kontaktdaten, beim Buchen eines Termins oder beim Erreichen eines Ziels.
Beschreibe, wann die Verbindung genutzt werden soll
Gib eine Anweisung, wann der AI-Agent diese Integration aktivieren soll.
Speichern und aktivieren
Setz die Integration auf 'Aktiv' und klick im Formular auf Speichern. Die Verbindung ist sofort aktiv.
Verbindung testen
Nach dem Speichern kannst du die Verbindung über 'Verbindung testen' testen. Ein Testkontakt wird an ActiveCampaign gesendet.
- Grun 'Verbunden': API-Daten sind korrekt.
- Rote Fehlermeldung: Überprüfe API-URL und API-Key.
Zustellungslog
Jeder Zustellungsversuch wird im Log festgehalten. Heyloha versucht bei temporären Fehlern bis zu 4 Mal erneut.
Häufig gestellte Fragen
Welchen ActiveCampaign-Plan brauche ich?
Jeder Plan mit API-Zugang funktioniert. Der API-Key ist unter Einstellungen > Developer verfügbar.
Muss ich Custom Fields für Adressdaten erstellen?
Nur wenn du Adressdaten synchronisieren möchtest. Für Name, E-Mail und Telefon brauchst du keine Custom Fields.
Kann ich ActiveCampaign mit anderen Integrationen kombinieren?
Ja. Jeder AI-Agent kann mehrere Integrationen haben.
HubSpot-Integration einrichtenGenerische Webhook-Integration einrichten