So sendest du Einwilligungen über Zapier an Klaviyo

Übersicht

Erfahre, wie du einen benutzerdefinierten Zapier-Webhook erstellst, um die SMS-Einwilligung an Klaviyo zu senden. Du kannst die Anweisungen in diesem Leitfaden ganz einfach anpassen, um auch die E-Mail-Einwilligung zu senden.

Die folgenden Schritte helfen dir dabei, einen Zap mit einem Webhook (auch Catch Hook genannt) zu erstellen, der eine Python-Skriptaktion auslöst. Das Skript sendet einen API-Aufruf an Klaviyo, um E-Mail- und Telefonnummern für eine Liste zu abonnieren.

Über die Integration

Dieser Leitfaden verwendet eine Zapier-Code-Aktion, die ein Python-Skript ausführt, sobald der Trigger erkannt wird. Mit dieser Lösung kannst du Felder den Datentypen zuordnen, die Klaviyo-Endpunkte erfordern; konkret die Endpunkte Profile abonnieren und Profile abmelden.

Zapier-Webhook einrichten

1. Melde dich bei deinem Zapier-Konto an.
2. Wähle auf der Hauptseite in Zapier +Erstellen aus und wähle dann Zap.
3. Gib einen Namen für deinen neuen Zap ein (z. B. Klaviyo Webhook).
4. Suche nach Webhook und wähle dann Webhooks by Zapier aus dem Trigger-Menü aus.
   

5. Wähle im nächsten Menü in den Optionen für Trigger Event die Option Catch Hook aus.
   

6. Klicke auf Weiter.
7. Wähle die Registerkarte Test aus.
8. Kopiere die Webhook-URL, die Zapier dir bereitstellt, damit du deine Anfragen dorthin senden kannst.
   

9. Bevor du testest, musst du Testdaten an deinen Webhook senden. Weitere Informationen findest du in unserem Leitfaden So sendest du Testdaten an Zapier. Achte darauf, Telefonnummern korrekt zu formatieren, wenn du Testdaten sendest.
10. Sobald du die Testdaten an den Webhook gesendet hast, klicke auf Trigger testen (im Tab Test).
    

11. Wenn die Anfrage erfolgreich ist, wird eine Erfolgsmeldung angezeigt, und die Testdaten werden unterhalb der Erfolgsmeldung eingefügt, ähnlich wie im folgenden Beispiel:
    

12. Sobald dein Trigger funktioniert, klicke auf Mit ausgewähltem Datensatz fortfahren.

Zapier-Aktion einrichten

1. Gib im Aktionsmenü Code by Zapier in das Suchfeld ein und wähle die Option aus der Liste aus.
   

2. Klicke auf Ereignis auswählen > Python ausführen.
   

3. Klicke auf Weiter.

Feldzuordnung einrichten und Skriptlogik erstellen

1. Richte die Feldzuordnung ein, um die Eingabedaten in der Tabelle unten mit den richtigen Testdaten zu korrelieren, die du zuvor gesendet hast.
   

1. Füge ein Script wie das folgende in das Codefeld ein:
   

import requests

# configuring sms subscribe or unsubscribe call
if (input_data["sms_consent"] == "true" or input_data["sms_consent"] == "True" or input_data["sms_consent"] == "TRUE"):
  url = "https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs/"  payload = { "data": {
        "type": "profile-subscription-bulk-create-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                            "subscriptions": {
                                "sms": { "marketing": { "consent": "SUBSCRIBED" } }
                            }
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "type": "list",
                    "id": "LIST_ID"
                } } }
    } }

elif (input_data["sms_consent"] == "false" or input_data["sms_consent"] == "False" or input_data["sms_consent"] == "FALSE"):  url = "https://a.klaviyo.com/api/profile-subscription-bulk-delete-jobs/"
  payload = { "data": {
        "type": "profile-subscription-bulk-delete-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "type": "list",
                    "id": "LIST_ID"
                } } }
    } }
headers = {
    "accept": "application/json",
    "revision": "2024-05-15",
    "content-type": "application/json",
    "Authorization": "Klaviyo-API-Key your-private-api-key"
}

response = requests.post(url, json=payload, headers=headers)

# Zapier requires an 'output' object
output = {"response text": response.text}

1. Ersetze your-private-api-keydurch deinen privaten Klaviyo API-Schlüssel.
   

1. Ersetze LIST_ID (an beiden Stellen) durch die Klaviyo-Listen-ID, an die du deine Zapier-Daten senden möchtest. Du findest deine Listen-ID in Klaviyo, indem du zu Zielgruppe > Listen & Segmente > Einstellungen navigierst. Wenn du Personen sofort abonnieren möchtest, ohne eine Bestätigung (was beim Testen hilfreich sein kann), stell sicher, dass deine Liste auf Single-Opt-in eingestellt ist (zu finden unter dem Tab Einwilligung in den Listeneinstellungen).
2. Klicke auf Weiter und dann auf Schritt testen.
3. Wenn dein Test erfolgreich ist, siehst du eine Antwort ohne Fehler wie die untenstehende:
   

4. Du kannst auch in Klaviyo prüfen, ob der Test erfolgreich war, indem du zu deiner Liste navigierst und sicherstellst, dass das Profil hinzugefügt wurde.
   

5. Wenn dein Test erfolgreich ist, klicke auf Veröffentlichen, um deinen Zap zu veröffentlichen. Wenn dein Test nicht erfolgreich ist, sieh dir unsere Tipps zur Fehlerbehebung für häufige Probleme an.

Tipps zur Fehlerbehebung

Folgende Probleme treten häufig bei der Einrichtung des Zapier-Webhooks auf. Wenn andere Probleme auftreten, kannst du dich an die Klaviyo Community wenden, um weitere Hilfe zu erhalten.

EOL beim Scannen eines String-Literals

Wenn du diesen Fehler siehst, fehlt dir ein Anführungszeichen um eine deiner Variablen. Überprüfe die Listen-ID und den privaten API-Schlüssel, um sicherzustellen, dass sie auf beiden Seiten von Anführungszeichen umgeben sind.

SyntaxError: ungültige Syntax

Wenn dieser Fehler angezeigt wird, entferne die Kommentare im Python-Code (jede Zeile, die mit # beginnt).

Weitere Ressourcen