# クラヴィヨとの統合 Klaviyoインテグレーションは、Botpress チャットボットと、顧客データとマーケティングオートメーションの主要プラットフォームであるKlaviyoとの連携を可能にします。この統合により、チャットボットはリードの作成、顧客情報の更新、SMSやメールマーケティングへのプロフィールの登録が可能になります。 ## 利用可能なアクション ### プロフィール作成 Klaviyoに新しい顧客プロフィールを作成します。このアクションにより、Klaviyoデータベースに新しい連絡先を追加し、包括的なプロフィール情報を追加することができます。 ** 必須フィールド:** - メールアドレス**または電話番号** (+15005550006のようなE.164形式) ** オプションフィールド:*** - 姓**と**名**。 - 組織**および**役職**(英語 - ロケール** (en-US, fr-FRのようなIETF BCP 47フォーマット) - ロケーション**(住所行、都市、国、地域、郵便番号を含む住所の詳細) - カスタムプロパティ**(追加プロファイルデータを格納するためのキーと値のペア) **Output:**作成されたプロフィールをKlaviyo IDと共に返します。 ### プロフィールの更新 Klaviyoの既存の顧客プロファイルを更新します。この操作により、作成後のプロファイル情報を変更することができます。 ** 必須フィールド:** - プロファイルID** (更新するプロファイルのKlaviyo固有の識別子) **オプションフィールド:** - メールアドレス** (プロフィールのEメールを更新します) - 電話番号** (E.164形式) - ファーストネーム**およびラストネーム**。 - 組織**と**役職**。 - ロケール**(IETF BCP 47形式) - ロケーション**(完全な住所情報) - カスタムプロパティ**(キーと値のペア) **出力:*** 現在のすべての情報を含む更新されたプロファイルを返します。 ### プロフィールの取得 Klaviyoから一意のIDを使用して特定の顧客プロファイルを取得します。このアクションは個々の顧客情報を検索するのに便利です。 ** 必須フィールド:** - プロファイルID** (取得するプロファイルのKlaviyo固有の識別子) **出力:** ID、Eメール、電話番号、名前、その他保存されている全てのデータを含む、完全なプロフィール情報を返します。 ### プロフィールの取得 フィルターとソートオプションを使用して、Klaviyoから複数の顧客プロフィールを検索して取得します。このアクションは、特定の条件に基づいて顧客のグループを見つけるのに最適です。 **フィルターオプション - フィルターフィールド:** `id`, `email`, `phone_number`, `external_id`, `created`, `updated` から選択します。 - **Filter Operator:** `equals`、`contains`、`greater-than`、`less-than`、`starts-with`、`ends-with` などの比較演算子を使用する。 - フィルタの値:** 検索する値(文字列と日付をサポートする) **ページネーションとソート:** - ページサイズ:** 返すプロファイルの数 (1-100、デフォルト: 20) - 並べ替え:** 任意のフィールドで降順に並べ替えることができます。 **使用例 - 特定の日付以降に作成されたすべてのプロフィールを検索する - ドメインを含むメールアドレスを持つプロフィールを検索する - 作成日順に並べ替えたプロフィールを取得する(新しいものから順に取得する) **Output:** 条件にマッチするプロフィールの配列を返します。 ### プロフィールを登録する 複数の顧客プロファイルをKlaviyoのメール/SMSマーケティングリストに登録します。このアクションは非同期に登録処理を行い、一度に最大1,000件のプロファイルを登録できます。 ** 必須フィールド:** - プロファイル購読:** 同意情報を持つプロファイルの配列 - プロファイルID** (または識別のためのEメール/電話) - Eメール同意:** Eメールマーケティングの同意を示すブール値 - SMS同意:** SMSマーケティングの同意を示すブール値 **オプション・フィールド - リストID:**購読プロファイルを追加する特定のKlaviyoリスト - **Historical Import:** 過去のプロファイルをインポートするためのブール値 ** 重要な注意事項:** - 1回のリクエストにつき最大1,000プロファイルまで - 少なくとも1つのプロファイルが必要です。 - 同意フラグにより、プロファイルがどのマーケティングチャンネルに登録されるかが決定されます。 - この操作はKlaviyoによって非同期に処理されます。 **Output:**サブスクリプションジョブが正常にスケジュールされたかどうかを示す成功ブール値を返します。