Zapier

Alle nachfolgenden Punkte, die sich auf lhp.pivacom.com beziehen, erwarten, dass man bereits als Broker angemeldet ist. Klicke hier, um zu erfahren, wie man von einem Admin- zu einem Brokeraccount wechseln kann: Zugriff auf Brokeraccount.

Über Zapier

Zapier ist eine Platform, um Verbindungen zwischen verschiedenen Anwendungen (wie in diesem Fall beispielsweise die pivacom) zu kreieren.

Dazu erstellt man sich ein sogenanntes “Zap”, in welchem ein solcher Datenaustausch festgelegt wird.

Jedes Zap beginnt mit einem “Trigger”, welcher festlegt, wodurch der Vorgang gestartet wird und dadurch auch Eingabedaten zur Verfügung stellen kann.
Ein Beispiel für einen möglichen Trigger ist in Webhook Trigger erklärt. Alternativ kann man so auch Daten aus Facebook, Google Sheets oder anderen Quellen beziehen.

Durch Klicken auf das + Symbol kann man dann beliebig viele Aktionen erstellen, welche Daten von externen Quellen holen, verarbeiten oder an andere externe Seiten oder Anwendungen versenden können.
So kann man, wie in Punkt Lead in Pivasoft importieren beschrieben, mit einer Aktion Lead Daten über die XMLRPC Schnittstelle von Pivacom in das System importieren.

Unsere Pivasoft App auf Zapier erhält man aktuell nur über diesen Einladungslink. Um unsere Pivasoft App auf Zapier zu verwenden, ist außerdem ein Pro Account notwendig.

Lead in Pivasoft importieren

Zum Leadimport in Pivasoft benötigt man einen BrokerCode und ein Interfacepasswort. Den BrokerCode findet man auf lhp.pivacom.com unter Account > Daten Ändern. Auf Leadzulieferung > XMLRPC Schnittstelle kann man am Ende der Seite ein Schnittstellenpasswort generieren, das ist das Interfacepasswort.

Füge die Pivasoft App zu deinem Zap hinzu und wähle “Create Lead” als Action event aus.

Unter Configure kann man dann Daten zuweisen. Die Felder kann man auf lhp.pivacom.com unter Leadzulieferung > E-Mail Schnittstelle finden. Beachte, dass bei manchen Feldern ein bestimmtes Format verlangt wird.

Alle Pflichtfelder sind bereits in der App vorgegeben.
Weitere Felder kann man am Ende bei “More...” hinzufügen, indem man auf “+ Add value set” klickt. Auf der linken Seite kann man dann den Feldnamen eingeben und auf der rechten den Wert.

Aufgrund der Richtlinien von Zapier sind alle vorgegebenen Felder englisch betitelt. In der folgenden Tabelle ist aufgelistet, welchen Feldnamen von Pivacom sie entsprechen.

Bei den selbst hinzugefügten Feldern müssen dann aber die Feldnamen von Pivacom verwendet werden.

Wenn man in einem Datenfeld / eingibt oder das + Symbol anklickt, kann man ein Feld aus einer anderen Aktion auswählen, welcher hier dynamisch eingefügt werden soll.

Falls statische Eingabewerte bestehen, kann man sie auch entsprechend direkt auf der rechten Seite einsetzen. (Bspw. bei Broker Code direkt den richtigen BrokerCode einsetzen)

Webhook Trigger

(nicht relevant, falls man die Daten aus einer anderen Quelle bezieht)

Eine Möglichkeit, das Zap zu starten, ist mit dem Webhooks by Zapier Trigger.

Hier kann man dann unter Trigger event das Event Catch Hook auswählen, wodurch man den Hook dann über eine URL aufrufen kann.

In dem Reiter Test wird dann die URL angezeigt, welche man dann wie in dem folgenden PHP Beispielcode aufrufen kann:

<?php

declare(strict_types = 1);

error_reporting(-1);

$url = '<<Füge deine URL hier ein>>';

$curl_handle = curl_init($url);

if ($curl_handle === false) {
    throw new \Exception("Failed to create cURL session.");
}

$curl_options = [
    CURLOPT_RETURNTRANSFER => true,

    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'action' => 'send_csv',
        'brokerCode' => '<!!broker code hier eintragen!!>',
        'interfacePassword' => '<!!interface passwort hier eintragen!!>',
        'geprueft' => 'nein ',
        'art' => 'BKV ',
        'anrede' => 'Herr',
        'vorname' => 'Hans',
        'name' => 'Mustermann ',
        'geburtsdatum' => '11.01.1944 ',
        'strasse' => 'Musterstraße',
        'hausnummer' => '31 ',
        'plz' => '77777',
        'ort' => 'Musterstadt',
        'email' => 'Mustermann@Musterstadt.com ',
        'tel_privat' => '07777/555555 ',
        'tel_anmerk' => 'Handy 0170123456',
        'berufsstatus' => 'Arbeitnehmer/in ',
        'berufsbez' => 'Bürohilfe ',
        'familienstand' => 'verheiratet ',
        'kinder' => 'keine',
        'bemerkungen' => 'erste Zeile, Brauche dies un jenes<br>zweite Zeile',
        'herkunft' => 'www.musterseite.de',
        'firmenname' => 'Text',
        'branche' => 'Text',
        'legedatum' => 'Text',
    ],
];

if (!curl_setopt_array($curl_handle, $curl_options)) {
    throw new \Exception("Failed to set cURL options.");
}

$response = curl_exec($curl_handle);

if ($response === false) {
    $error = curl_error($curl_handle);
    throw new \Exception("Failed to execute cURL request: $error");
}

Man muss in Zapier nicht einstellen, welche Felder von dem Webhook erwartet werden, sondern alle von einem Request übergebenen Felder sind automatisch für die folgenden Aktionen verfügbar.

Es empfiehlt sich, zuerst eine Testabfrage des Webhooks mit allen erwarteten Feldern durchzuführen, damit diese beim Bearbeiten der Aktionen in Zapier einfach auszuwählen sind.
Nach Senden der Testabfrage kann man dann beim Webhook Trigger unter Test eine Request auswählen (Drücke Find new records, um die letzten Abfragen anzuzeigen).
Die Felder aus der Abfrage sind dann beim Erstellen und Bearbeiten der Aktionen durch Klicken auf das + Symbol in einem Feld einfach auswählbar.

Falls ein gewünschtes Eingabefeld hier nicht angezeigt wird, kann man stattdessen auch einfach den Namen des Feldes in {{ und }} eingeschlossen eingeben (z.B. {{mein Eingabefeld}}).