Skip to content

Inkit

Inkit und Braze ermöglichen es Unternehmen, Dokumente sicher zu erstellen und zu verteilen – sowohl digital als auch per Direkt-Mailing.

Diese Integration wird von Inkit gepflegt.

Über die Integration

Die Integration von Braze und Inkit erlaubt es Ihnen, mit Braze-Webhooks Dokumente zu erstellen und diese direkt an Braze-Nutzer:innen zu versenden.

Voraussetzungen

Anforderung Beschreibung
Inkit-Konto Um diese Partnerschaft zu nutzen, benötigen Sie ein Inkit-Konto.
Inkit API-Schlüssel

<INKIT_API_TOKEN>		 Dieser Schlüssel befindet sich auf Ihrem Inkit Dashboard unter dem Tab Development und ermöglicht es Ihnen, Ihre Braze- und Inkit-Konten zu verbinden.
Inkit Template-ID

<INKIT_TEMPLATE_ID>		 Nachdem Sie ein Template erstellt haben, können Sie die Template-ID aus dem Tab Templates kopieren, um sie in Ihrem Template in Braze zu verwenden.

Sie könnten zum Beispiel in der Inkit-Umgebung ein Template namens invoice_template mit der Template-ID tmpl_3bDScFl9cwr3OAVR1RSdEC erstellen.
HTTP-Header Der HTTP-Header ist Teil der API-Anfrage, die Sie von Braze an Inkit senden. Darin enthalten ist Ihr Inkit API-Schlüssel zur Authentifizierung und Autorisierung von Aufrufen der Inkit API.

Integration

1. Schritt: Ein Inkit-Template erstellen

Erstellen Sie auf der Inkit-Plattform ein Template, das Sie in Ihrer Braze-Campaign in HTML, Word, PowerPoint, Excel oder PDF verwenden können. Lesen Sie die Inkit-Dokumentation, um mehr zu erfahren.

2. Schritt: Ihr Braze-Webhook-Template erstellen

Um ein Inkit-Webhook-Template zu erstellen, das Sie in zukünftigen Campaigns oder Canvases verwenden können, navigieren Sie auf der Braze-Plattform zu Content > Webhook. Wählen Sie dann Create webhook template aus.

Wenn Sie eine einmalige Inkit-Webhook-Campaign erstellen oder ein bestehendes Template verwenden möchten, wählen Sie bei der Erstellung einer neuen Campaign Webhook in Braze aus.

Eine Auswahl der verfügbaren vorgefertigten Webhook-Templates im Tab „Webhook-Templates“ im Bereich „Templates und Medien“.

Sobald Sie das Inkit-Webhook-Template ausgewählt haben, sollten Sie Folgendes sehen:

  • Webhook-URL: Leer
  • Anfragetext: Rohtext

Erstellen Sie im Feld „Webhook-URL“ eine Inkit-Webhook-URL und geben Sie diese ein.

Anfragetext-Code und Webhook-URL im Tab „Verfassen“ des Braze-Webhook-Builders.

Anfrage-Header und Methode

Inkit benötigt einen HTTP Header für die Autorisierung, einschließlich Ihres Inkit API-Schlüssels, der in Base64 kodiert ist. Das Folgende ist bereits als Schlüssel-Wert-Paar im Template enthalten, aber im Tab Einstellungen müssen Sie <INKIT_API_TOKEN> durch Ihren Inkit API-Schlüssel ersetzen.

  • HTTP-Methode: POST
  • Anfrage-Header:
    • Authorization: Basic {{ '<INKIT_API_TOKEN>' | base64_encode }}
    • Content-Type: application/json

Anfragetext

Vergewissern Sie sich, dass Ihr Liquid die richtigen angepassten Attribute enthält, die mit den folgenden erforderlichen und optionalen Feldern verknüpft sind. Sie können auch angepasste Datenfelder zu jeder Anfrage hinzufügen.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "api_token": "<INKIT_API_TOKEN>",
  "template_id": "<INKIT_TEMPLATE_ID>",
  "first_name": "{{${first_name}}}",
  "last_name": "{{${last_name}}}",
  "email": "{{${email_address}}}",
  "company": "{{custom_attribute.${company_name}}}",
  "phone" : "{{${phone_number}}}",
  "address_line_1": "{{custom_attribute.${address}}}",
  "address_line_2": "{{custom_attribute.${address2}}}",
  "address_city": "{{${city}}}",
  "address_state": "{{custom_attribute.${state}}}",
  "address_zip": "{{custom_attribute.${zip}}}",
  "address_country": "{{${country}}}",
  "source" : "Braze"
}

3. Schritt: Vorschau Ihrer Anfrage

Ihr Rohtext wird automatisch hervorgehoben, wenn es sich um einen passenden Braze-Tag handelt. street, unit, state und zip müssen als angepasste Attribute eingerichtet werden, um diesen Webhook zu senden.

Eine Vorschau Ihrer Anfrage finden Sie im Panel Vorschau. Alternativ können Sie zum Tab Test navigieren, wo Sie zufällige Nutzer:innen oder bestehende Nutzer:innen auswählen oder eigene Daten anpassen können, um Ihren Webhook zu testen.
New Stuff!