Erstellen eines Kunden/Leads aus einem Website-Formular

Hier ist eine präzise Schritt-für-Schritt-Anleitung, wie Sie die Webhook-Einstellungen in z.B. WordPress Fluent Forms konfigurieren können, um die Robaws API mit Basic Auth zu nutzen.

Da die meisten Wordpress- und anderen Softwareprogramme auf die gleiche Weise funktionieren, können Sie die folgenden Schritte ausführen, um die Daten aus einem Lead-Formular auf Ihrer Website an Robaws zu senden.

Schritt 1: Base64-codierte Anmeldedaten erstellen

Basic Authentication erfordert, dass die Anmeldedaten (Benutzername:Passwort) in Base64 codiert werden. Hier erfahren Sie, wie Sie dies tun können:

Kombinieren von Benutzername und Passwort:

Format: username:password

Beispiel:

user@example.com:securepassword

Base64-Codierung:

Online-Tool verwenden: Nutzen Sie ein Online-Tool wie Base64 Encode.

Terminal-Befehl: Wenn Sie Zugriff auf ein Terminal haben, können Sie den folgenden Befehl verwenden:

echo -n "user@example.com:securepassword" | base64

Ergebnis:

dXNlckBleGFtcGxlLmNvbTpzZWN1cmVwYXNzd29yZA==

Schritt 2: Webhook konfigurieren

Zugriff auf Dashboard:

- Melden Sie sich im WordPress-Adminbereich an.
- Navigieren Sie z.B. zu Fluent Forms > Alle Formulare.

Formular auswählen oder erstellen:

- Wählen Sie das Formular aus, das Sie mit Robaws integrieren möchten, oder erstellen Sie ein neues Formular.

Webhook-Integration hinzufügen:

- Öffnen Sie das gewünschte Formular im Editor.
- Klicken Sie auf Integrationen im Menü auf der linken Seite.
- Wählen Sie Webhook aus der Liste der verfügbaren Integrationen.
- Klicken Sie auf Neue Webhook hinzufügen oder Add Webhook.

Webhook-Einstellungen konfigurieren:

Name:
- Geben Sie dem Webhook einen aussagekräftigen Namen, z.B. Robaws API Integration.
Request URL:
- bashCopy codehttps://app.robaws.be/api/v2/clients
Request Method:
- Wählen Sie POST.
Format:
- Wählen Sie JSON (da die Robaws API JSON-Daten erwartet).
Headers:
- Fügen Sie die erforderlichen Header hinzu. Klicken Sie auf + Hinzufügen, um neue Header hinzuzufügen.

Header 1:

- Name: Content-Type
- Wert: application/json

Header 2:

- Name: Authorization
- Wert: Basic dXNlckBleGFtcGxlLmNvbTpzZWN1cmVwYXNzd29yZA==
(Ersetzen Sie dXNlckBleGFtcGxlLmNvbTpzZWN1cmVwYXNzd29yZA== mit Ihren tatsächlichen Base64-codierten Anmeldedaten.)

Body:
- Verwenden Sie das folgende JSON-Format und ersetzen Sie die Platzhalter {field_*} mit den entsprechenden Fluent Forms-Feldplatzhaltern:

{
          "name": "{field_name}",
          "email": "{field_email}",
          "phone": "{field_phone}",
          "address": "{field_address}",
          "extraFields": {
            "Quelle": {
              "stringValue": "{field_quelle}"
            }
          }
        }

Beispiel:

{
              "name": "{name}",
              "email": "{email}",
              "phone": "{phone}",
              "address": "{address}",
              "extraFields": {
                "Quelle": {
                  "stringValue": "{quelle}"
                }
              }
            }

Hinweis:
- Die {field_*} Platzhalter sollten durch die tatsächlichen Platzhalter Ihrer Formularfelder ersetzt werden. In Fluent Forms finden Sie diese Platzhalter, indem Sie auf das jeweilige Feld klicken und den Platzhalter aus den Feldoptionen kopieren.

Conditional Logic (Optional):
- Wenn Sie möchten, dass der Webhook nur unter bestimmten Bedingungen ausgelöst wird, können Sie hier entsprechende Regeln festlegen. Andernfalls können Sie dieses Feld leer lassen.

Webhook speichern:

- Nachdem Sie alle Einstellungen vorgenommen haben, klicken Sie auf Speichern oder Save, um die Webhook-Integration zu aktivieren.

**Schritt 3: Integration testen**

Testformular ausfüllen:
- Öffnen Sie das Formular auf der Website des Endkunden und füllen Sie es mit Testdaten aus.

Überprüfung in Robaws:
- Melden Sie sich bei Robaws an und prüfen Sie, ob ein neuer Kontakt mit den übermittelten Daten erstellt wurde, einschließlich der extraFields.

Fehlerbehebung:

Keine Kontakt-Erstellung:

Überprüfen Sie die Base64-Codierung: Stellen Sie sicher, dass die `Authorization`Header korrekt codiert sind.
Feldzuordnung: Vergewissern Sie sich, dass die Fluent Forms-Felder korrekt den Robaws-Feldern zugeordnet sind.
API-Antworten prüfen: Falls möglich, prüfen Sie die API-Antworten oder Logs in Fluent Forms, um Fehler zu identifizieren.

Beispielhafte Webhook-Konfiguration:

Angenommen, Ihr Formular hat folgende Felder:

- Name: {name}
- E-Mail: {email}
- Telefon: {phone}
- Adresse: {address}
- Quelle: {contact_via}

Und Ihre Base64-codierten Anmeldedaten sind dXNlckBleGFtcGxlLmNvbTpzZWN1cmVwYXNzd29yZA==.

Webhook Einstellungen:

- Name: Robaws API Integration
- Request URL: https://app.robaws.be/api/v2/clients
- Request Method: POST
- Format: JSON
- Headers:

Content-Type: application/json
    Authorization: Basic dXNlckBleGFtcGxlLmNvbTpzZWN1cmVwYXNzd29yZA==

- Body:

{
      "name": "{name}",
      "email": "{email}",
      "phone": "{phone}",
      "address": "{address}",
      "extraFields": {
        "Contact via": {
          "stringValue": "{contact_via}"
        }
      }
    }

Sicherheitsaspekte:

Schützen Sie Ihre Anmeldedaten:
- Stellen Sie sicher, dass die Base64-codierten Anmeldedaten nicht öffentlich zugänglich sind.
- Verwenden Sie HTTPS, um die Sicherheit der Datenübertragung zu gewährleisten.

Eingeschränkte Berechtigungen:
- Wenn möglich, nutzen Sie ein dediziertes Benutzerkonto mit eingeschränkten Rechten für die API-Integration, um das Risiko bei einem eventuellen Datenleck zu minimieren.

Zusätzliche Tipps:

Formularfeld-Platzhalter finden:
- In Fluent Forms finden Sie die Platzhalter, indem Sie im Formular-Editor auf das jeweilige Feld klicken und den Platzhalter aus den Feldoptionen kopieren.

Webhook-Logs überprüfen:
- Fluent Forms bietet möglicherweise Logs oder Protokolle für Webhook-Anfragen. Überprüfen Sie diese, um sicherzustellen, dass die Anfragen erfolgreich gesendet werden oder um Fehler zu identifizieren.

Dokumentation konsultieren:
- Schauen Sie sich die Fluent Forms Dokumentation an, um weitere Details zur Webhook-Konfiguration zu erhalten.

Support kontaktieren:
- Wenn Sie auf spezifische Probleme stoßen, wenden Sie sich an den Fluent Forms Support oder das Robaws Support-Team für zusätzliche Hilfe.

Zusammenfassung

Durch das Hinzufügen des `Authorization`-Headers mit Ihren Base64-codierten Anmeldedaten in den Webhook-Einstellungen von Fluent Forms können Sie die Formulareinreichungen sicher und automatisiert an die Robaws API übermitteln.

Achten Sie dabei stets auf die Sicherheit Ihrer Anmeldedaten und testen Sie die Integration gründlich, um sicherzustellen, dass alle Daten korrekt übertragen werden.

Beispiel Videos

Aktualisiert am: 21/10/2024