Skip to content

Inkit

InkitとBrazeは、デジタルでもダイレクトメールでも、企業が安全に文書を作成・配布できるようにする。

BrazeとInkitの統合により、BrazeのWebhookを使って文書を生成し、Brazeユーザーに直接郵送することができる。

前提条件

必要条件 説明
Inkitアカウント このパートナーシップを利用するには、Inkitアカウントが必要である。
InkitのAPIキー

<INKIT_API_TOKEN>
このキーは、Inkitダッシュボードの 開発タブにあり、BrazeとInkitのアカウントを接続することができる。
InkitテンプレートID

<INKIT_TEMPLATE_ID>
テンプレートを作成した後、テンプレートタブからテンプレートIDをコピーしてBrazeのテンプレートで使用することができる。

例えば、Inkit環境にテンプレートID:tmpl_3bDScFl9cwr3OAVR1RSdECinvoice_template というテンプレートを作成する。
HTTPヘッダー HTTPヘッダーは、BrazeからInkitに送信するAPIリクエストの一部である。その中に、Inkit APIへの呼び出しを認証および承認するためのInkit APIキーを含める。

統合

ステップ1:Inkitテンプレートを作成する

Inkitプラットフォーム上で、Brazeキャンペーンで使用するテンプレートをHTML、Word、PowerPoint、ExcelまたはPDFで作成する。詳しくはInkitのドキュメントを参照されたい。

ステップ2:BrazeのWebhookテンプレートを作成する

今後のキャンペーンやCanvasで使用するInkitウェブフックテンプレートを作成するには、Brazeプラットフォームの「テンプレート」>「ウェブフックテンプレート」に移動する。

単発のInkitウェブフックキャンペーンを作成したい場合、または既存のテンプレートを使用したい場合は、新しいキャンペーンを作成する際にBrazeのウェブフックを選択する。

Templates & MediaセクションのWebhook Templatesタブにある、利用可能なデザイン済みWebhookテンプレートのセレクション。

Inkitウェブフック・テンプレートを選択すると、以下のように表示される:

  • ウェブフックのURL:空白
  • リクエスト・ボディRaw Text

Webhook URLフィールドで、InkitのWebhook URLを作成し、入力する必要がある。

Braze webhook builderのcomposeタブに表示されるリクエストボディコードとwebhook URL。

リクエストヘッダと方法

Inkitは、認証のために、Base 64でエンコードされたInkit APIキーを含む、HTTP Header 。以下はすでにキーと値のペアとしてテンプレート内に含まれているが、「設定」タブでは、<INKIT_API_TOKEN> をあなたのInkit APIキーに置き換える必要がある。

  • HTTPメソッド:POST
  • ヘッダーをリクエストする
    • 認可する:ベーシック {{ '<INKIT_API_TOKEN>' | base64_encode }}
    • Content-Type: application/json

Request body

リキッドが以下の必須フィールドとオプションフィールドに関連する適切なカスタム属性と一致していることを確認する。また、どのリクエストにもカスタムデータフィールドを追加することができる。

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:リクエストをプレビューする

Brazeタグに該当するテキストは自動的にハイライトされる。streetこのWebhookを送信するには、unitstatezipカスタム属性として設定する必要がある。

Previewパネルでリクエストをプレビューするか、Testタブに移動して、ランダムなユーザー、既存のユーザーを選択するか、ウェブフックをテストするために自分でカスタマイズする。

「このページはどの程度役に立ちましたか?」
New Stuff!