アクションフローでのKlaviyoアクションの使い方

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

現在のプランを確認

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

要約：◀▼

APIキーを使用してアクションフローをKlaviyoに接続することで、顧客プロフィールの管理、イベントの追跡、リストへの登録、キャンペーンの作成を自動化できます。このインテグレーションは、プロフィールの作成・更新・検索、リストやメトリックの管理、キャンペーンの処理に対応しています。安全なコネクションを確保するために専用のサービスアカウントを使用し、インテグレーションを通じてアクセスされるデータや実行されるアクションを適切に管理できるよう、権限を慎重に確認してください。

アクションビルダーをKlaviyoなどの外部システムに接続すると、管理者は自動化されたワークフロー内でZendeskと外部システムを連携させ、コラボレーションを強化し、複数のプラットフォームにわたってシームレスなエクスペリエンスを維持できます。

メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

• アクションビルダーをKlaviyoに接続する
• アクションフローでのKlaviyoアクションの使い方

アクションビルダーをKlaviyoに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。

• アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
• すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
• OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。

APIキーを作成するには

Klaviyoコネクションには、認証用のAPIキーが必要です。詳細な手順については、Klaviyo API認証情報のドキュメントをご覧ください。

重要：APIキーは安全に保管し、他人と共有しないでください。このキーによりKlaviyoアカウントへのアクセスが可能になり、アクションフローがユーザーに代わって操作を実行できるようになります。

1. Klaviyoアカウントにログインします。
2. 「設定」>「APIキー」を選択します。
3. Klaviyo-API-Key {your_key} の形式でキーをコピーします。
4. APIキーを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。

   このキーは、アクションビルダーをKlaviyoに接続する際に必要になります。

アクションビルダーをKlaviyoに接続するには

1. 管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
2. アクションフローを新規作成するか、既存のアクションフローを編集します。
3. ステップサイドバーを開きます。
4. 「外部アクション」セクションで、「Klaviyo」をクリックします。
5. 「接続」をクリックします。
6. 画面の指示に従ってKlaviyoのAPIキーを入力し、接続を完了します。プレフィックスを含めてキー全体を貼り付けてください。

   コネクションを承認するとKlaviyoにリダイレクトされ、Zendeskアカウントに権限を付与するよう求められます。

   Klaviyoコネクションは、OAuth 2.0の認証コードグラント方式を使用しています。コネクションを承認する前に、権限を慎重に確認してください。これらの権限により、アクションフローが、ユーザーに代わってKlaviyoワークスペースでページの作成や変更、コメントの追加、データベース項目の管理、コンテンツの更新を行うことができます。

   メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびKlaviyoで利用可能なアクションが表示されます。

アクションフローでのKlaviyoアクションの使い方

以下のKlaviyoアクションを使用できます。

• プロフィールを作成する
• プロフィールを更新する
• プロフィールを参照する
• イベントを作成する
• プロフィールをリストに登録する
• プロフィールをリストから削除する
• リストを参照する
• リストを一覧表示する
• リストを作成する
• メトリックを参照する
• メトリックを一覧表示する
• キャンペーンを作成する
• キャンペーンを参照する
• キャンペーンを一覧表示する

プロフィールを作成する

「プロフィールを作成する」アクションを使用して、連絡先情報や属性を含む新しい顧客プロフィールをKlaviyoに作成します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	オプション：Email、Phone number、First name、Last name、Organization、Title、Image URL、Address line 1、Address line 2、City、Region/State、Country、Zip/Postal code 「Phone number」は、プラス記号（+）、国番号、加入者番号を使用したE.164形式で指定してください。スペースやその他の特殊文字は使用できません（例：[phone]）。
出力	プロフィールID、メールアドレス、電話番号、名、姓、所属組織、役職、画像、作成日時、更新日時、位置情報オブジェクト（address1、address2、city、region、country、zipを含む）を含むオブジェクトが返されます。

プロフィールを更新する

「プロフィールを更新する」アクションを使用して、Klaviyo内の既存の顧客プロフィールを新しい情報で更新します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Profile ID オプション：Email、Phone number、First name、Last name、Organization、Title、Image URL、Address line 1、Address line 2、City、Region/State、Country、Zip/Postal code 「Phone number」は、プラス記号（+）、国番号、加入者番号を使用したE.164形式で指定してください。スペースやその他の特殊文字は使用できません（例：[phone]）。
出力	プロフィールID、メールアドレス、電話番号、名、姓、所属組織、役職、画像、作成日時、更新日時、位置情報オブジェクト（address1、address2、city、region、country、zipを含む）を含むオブジェクトが返されます。

プロフィールを参照する

「プロフィールを参照する」アクションを使用して、ID、メールアドレス、または電話番号を指定し、1件の顧客プロフィールを取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Identity profile by、Profile identifier ID、メールアドレス、または電話番号でプロフィールを識別できます。識別方法を選択すると「Profile identifier」フィールドが表示されます。
出力	プロフィールID、メールアドレス、電話番号、名、姓、所属組織、役職、画像、作成日時、更新日時、位置情報オブジェクト（address1、address2、city、region、country、zipを含む）を含むオブジェクトが返されます。

イベントを作成する

「イベントを作成する」アクションをKlaviyoで使用して、フローをトリガし、エンゲージメントを測定します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Metric name、Profile ID オプション：Properties、Timestamp 「Properties」は、JSON形式のキーと値のペアで指定してください。「Timestamp」は、ISO 8601形式（例：2025-01-15T14:30:00Z）で指定してください。指定しない場合は、デフォルトで現在の時刻が使用されます。
出力	メトリック名、プロフィールID、およびプロパティオブジェクトを含むオブジェクトが返されます。

プロフィールをリストに登録する

「プロフィールをリストに登録する」アクションを使用して、プロフィールをリストに追加します。メールアドレスとSMSの同意設定は任意で指定できます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：List オプション：Email、Phone number、Profile ID、Email consent、SMS consent 「Phone number」はE.164形式で指定してください。「Email consent」と「SMS consent」では、「Yes - Subscribe to email/SMS（SUBSCRIBED）」または「No - Do not subscribe to email/SMS（NONE）」を選択できます。
出力	成功ステータス（ブール値）とメッセージを含むオブジェクトが返されます。

プロフィールをリストから削除する

「プロフィールをリストから削除する」アクションを使用して、Klaviyoの特定のリストからプロフィールを削除します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：List、Profile ID
出力	成功ステータス（ブール値）とメッセージを含むオブジェクトが返されます。

リストを参照する

「リストを参照する」アクションを使用して、IDまたは名前で特定のリストの詳細を取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Identify list by、List identifier IDまたは名前でリストを識別できます。識別方法を選択すると「List identifier」フィールドが表示されます。
出力	リストID、名前、作成日時、更新日時、オプトイン方式を含むオブジェクトが返されます。

リストを一覧表示する

「リストを一覧表示する」アクションを使用して、Klaviyo内のすべてのリストを取得します。必要に応じて、名前によるフィルタリングやページネーションも可能です。

このアクションには以下の入力と出力が含まれます。

	変数
入力	オプション：Name、Page cursor
出力	リストの配列（各リストにID、名前、作成日時、更新日時、オプトイン処理を含む）と、ページネーションの次のページカーソルを格納したオブジェクトが返されます。

リストを作成する

「リストを作成する」アクションを使用して、Klaviyoに新しいリストを作成し、プロフィールを整理します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Name
出力	リストID、名前、作成日時、更新日時、オプトイン方式を含むオブジェクトが返されます。

メトリックを参照する

「メトリックを参照する」アクションを使用して、IDで特定のメトリックの詳細を取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Metric ID
出力	メトリックのID、名前、作成日時、更新日時、インテグレーションオブジェクト（ID、名前、カテゴリを含む）を含むオブジェクトが返されます。

メトリックを一覧表示する

「メトリックを一覧表示する」アクションを使用して、Klaviyo内のすべてのメトリックを取得します。必要に応じて、フィルタリングやページネーションも可能です。このアクションを使用すると、カスタマーの行動の追跡に利用できるイベントメトリックを確認できます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	オプション：Integration name、Integration category、Page cursor
出力	メトリックの配列（各メトリックにID、名前、作成日時、更新日時、およびID、名前、カテゴリを含むインテグレーションオブジェクトが含まれる）と、ページネーション用の次ページカーソルを含むオブジェクトが返されます。

キャンペーンを作成する

「キャンペーンを作成する」アクションを使用して、メールまたはSMSチャネルを利用した新しいマーケティングキャンペーンをKlaviyoに作成します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Name、List、Channel、Send strategy オプション：Subject、Preview text、From email、From name、Reply-to email 「Channel」には、EmailまたはSMSを指定できます。 「Send strategy」には、Immediate、Scheduled（static）、Throttled、またはSmart Send Timeを指定できます。メールキャンペーンでは、「Subject」が必須です。
出力	キャンペーンID、名前、ステータス、チャネル、作成日時、更新日時、送信日時を含むオブジェクトが返されます。

キャンペーンを参照する

「キャンペーンを参照する」アクションを使用して、IDまたは名前で特定のキャンペーンの詳細を取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Identify campaign by、Campaign identifier 「Name（contains）」で検索した場合は、最初に一致したキャンペーンが返されます。 識別方法を選択すると「Campaign identifier」フィールドが表示されます。
出力	キャンペーンID、名前、ステータス、チャネル、作成日時、更新日時、送信日時、アーカイブステータス（ブール値）を含むオブジェクトが返されます。

キャンペーンを一覧表示する

「キャンペーンを一覧表示する」アクションを使用して、Klaviyo内のキャンペーンを取得します。必要に応じて、フィルタリングやページネーションも可能です。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Channel オプション：Name、Status、Archived、Page cursor 「Status」には、Draft、Scheduled、Sent、またはCancelledを指定できます。 「Archived」フィルターには、YesまたはNoを指定します。
出力	キャンペーンの配列（各キャンペーンにID、名前、ステータス、チャネル、作成日時、更新日時、送信日時、アーカイブステータスを含む）と、ページネーションの次のページカーソルを含むオブジェクトが返されます。