Salesloftをデータパイプラインソースとして設定する ​

Salesloftをデータパイプラインソースとして設定し、ユーザー、アカウント、ケイデンス、通話およびメールアクティビティなどのセールスエンゲージメントレコードを抽出して送信先に同期します。

このガイドでは、Salesloft認証情報の生成、コネクションの設定、パイプラインの設定、オブジェクトの追加、同期動作の確認、既知の制限事項の理解について説明します。

サポートされている機能 ​

Salesloftをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続: 単一のグローバルエンドポイントhttps://api.salesloft.comを通じてHTTPS経由でSalesloftに接続します。オンプレミスエージェントは不要です。
• 2つの認証方式: APIキーまたはOAuth 2.0（認可コードグラント）コネクションで接続します。詳細については、サポートされているコネクションタイプを参照してください。
• フル同期および増分同期: ほとんどのオブジェクトは、各レコードのupdated_atタイムスタンプを使用して増分同期されます。フィルター可能なタイムスタンプを公開していないオブジェクトは、デフォルトでフル同期されます。詳細については、同期モードを参照してください。
• オブジェクトレベルの選択: 送信先で個別のテーブルとして同期するSalesloftオブジェクトを選択します。完全なリストについては、サポートされているオブジェクトを参照してください。
• 派生結合キー列: Opportunitiesレコードのownerなど、別のレコードを参照するフィールドの場合、パイプラインは元のJSON参照と並行してスカラー<field>_id列を追加するため、JSONを解析せずにテーブルを結合できます。詳細については、主キーとリレーションシップを参照してください。
• GDPR対応のコンプライアンスフィールド: Peopleオブジェクトのeu_residentおよびdo_not_contactフィールドは常にマスクなしで同期されるため、ダウンストリームでコンプライアンス主導の処理を適用できます。詳細については、機密データの処理を参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護：データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。サポートされる最小間隔は15分です。

前提条件 ​

Salesloftをデータパイプラインソースとして接続するには、次が必要です。

• Salesloftアカウント
• 選択した認証方法の認証情報:
  • APIキー: Salesloftアカウント設定から生成した個人用APIキー。設定手順については、Salesloft APIキーを生成するを参照してください。
  • OAuth 2.0（認可コードグラント）: 認可コードグラントタイプで登録されたSalesloft OAuthアプリケーション、およびアプリケーションを認可する権限を持つSalesloftユーザーアカウント。設定手順については、Salesloft OAuthアプリケーションを登録するを参照してください。

Salesloft OAuthアプリケーションを登録する ​

OAuth 2.0（認可コードグラント）を使用してSalesloftへのコネクションを作成する前に、SalesloftでOAuthアプリケーションを登録し、Workato Custom OAuth profilesを作成する必要があります。 APIキーで接続する場合は、このセクションをスキップしてください。

Salesloft APIキーを生成する ​

Workatoでコネクションを作成する前に、SalesloftでAPIキーを生成する必要があります。 OAuth 2.0（認可コードグラント）コネクションで接続する場合は、このセクションをスキップしてください。

推奨スコープ ​

OAuthアプリケーションを登録するかAPIキーを生成するときに、次のスコープを付与します。スコープはどちらの方式でも同一です。

サポートされるコネクションタイプ ​

Salesloftデータパイプラインは、2つの認証方式をサポートしています。

• APIキー: Salesloftアカウントから生成した個人用APIキーを指定します。設定手順については、Salesloft APIキーを生成するを参照してください。
• OAuth 2.0（認可コードグラント）: 作成したSalesloft OAuthアプリケーションを基に構築されたカスタムOAuthプロファイルを使用して、Workatoを認可します。 SalesloftデータパイプラインはデフォルトのWorkato管理アプリをサポートしていないため、接続する前に独自のOAuthアプリケーションを登録し、カスタムOAuthプロファイルを作成する必要があります。設定手順については、Salesloft OAuthアプリケーションを登録するを参照してください。

Salesloftは、データパイプラインでのBasic認証またはSCIMトークンをサポートしていません。

Salesloftに接続する ​

Salesloftに接続するには、次の手順を実行します。

パイプラインの設定 ​

Salesloftをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Salesloftデータパイプラインは、Salesloft REST API v2リソースからデータを同期します。次の表は、サポートされているオブジェクトをカテゴリ別に示しています。各オブジェクトは、宛先内の個別のテーブルとして同期されます。

ユーザーとアカウント ​

Opportunities ​

ケイデンスとシーケンス ​

セールスアクティビティ ​

通話およびメール参照データ ​

ユーザーとチーム ​

CRM同期 ​

ワークスペース設定 ​

同期モード ​

Salesloftデータパイプラインは、フル同期と増分同期をサポートしています。パイプラインは各オブジェクトに同期モードをデフォルト設定します。オブジェクトに使用可能なタイムスタンプがない場合を除き、この設定は変更できます。オブジェクトごとの同期モード設定については、パイプラインを設定するを参照してください。

フル同期 ​

フル同期では、各実行時にオブジェクトで使用可能なすべてのレコードを抽出し、送信先テーブルを一致するように更新します。以前に同期されたレコードが実行時に表示されなくなった場合、Workatoはそのレコードを削除するのではなく、削除済みとしてフラグ付けします。詳細については、削除追跡を参照してください。

各オブジェクトの初回実行ではフル同期が実行されます。サポートされるオブジェクトでは、When first started, this pipeline should pick up records fromフィールドで設定した日付から開始します。フィールドを空白のままにすると、パイプラインは使用可能なすべてのレコードを抽出します。

更新タイムスタンプによるフィルタリングをSalesloftエンドポイントがサポートしていないオブジェクトは、常にフル同期されます。各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

増分同期 ​

初回同期が完了すると、パイプラインは各レコードのupdated_atタイムスタンプをカーソルとして使用し、前回の成功した実行以降に作成または更新されたレコードのみを抽出します。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

フル同期されるオブジェクトの場合、Workatoは各実行を送信先テーブルと比較し、レコードがSalesloftに表示されなくなった場合、行を削除するのではなく、_workato_is_deleted = trueでレコードをフラグ付けします。増分同期されるオブジェクトの場合、Salesloftは読み取りクライアントに削除済みレコードを公開しないため、Workatoは削除を検出できません。削除されたレコードは、最後に同期された値のまま送信先に残ります。

Meetingsは、ソース主導の削除シグナルを持つ唯一のオブジェクトです。 SalesloftのAPIはキャンセル済みおよび削除済みのミーティングを直接報告するため、パイプラインは欠落した行から推測するのではなく、そのシグナルから_workato_is_deletedを設定します。詳細については、合成列を参照してください。

Accounts、Cadences、EmailTemplatesでは、アーカイブを削除ではなくステータス変更として扱うため、アーカイブ済みレコードは送信先に残ります。オブジェクトごとの削除追跡を確認するには、サポートされるオブジェクトテーブルを参照してください。

スキーマとデータ型の処理 ​

Salesloftからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

主キーとリレーションシップ ​

OpportunityTagを除き、各送信先テーブルはSalesloftレコードのidを主キーとして使用します。 SalesloftにはOpportunityTag専用のエンドポイントがないため、パイプラインは各Opportunitiesレコードに埋め込まれたtags配列からタグごとに1行を派生し、opportunity_idとtag_nameの複合キーを使用します。

他のレコードへのリレーションシップは、Peopleのaccountなど、埋め込みJSON参照列として同期されます。パイプラインは、Peopleのaccount_idなど、これらの参照列のほとんどと並行して、同じレスポンスから派生したスカラー<field>_id列も追加します。両方の列は個別に同期されるため、結合キーとして使用するスカラーID列のみを選択し、ストレージを削減するために完全なJSON参照を選択解除することも、両方を保持することもできます。

カスタムフィールド ​

Salesloftでは、顧客がPeople、Accounts、Opportunitiesにカスタムフィールドを定義できます。カスタムフィールドのセットはSalesloftワークスペースによって異なるため、これらは個別の列ではなく、単一のcustom_fields JSON文字列列として同期されます。ワークスペース内のカスタムフィールド定義については、CustomFieldsオブジェクトを参照してください。

タグ ​

PeopleおよびAccountsのtagsフィールドは、タグ名文字列のプレーンなJSON配列を返します。 SalesloftはPeopleまたはAccountsでタグID参照を返さないため、これらの値を外部キーでTagsオブジェクトに結合することはできません。

タイムスタンプ ​

Salesloftタイムスタンプは、タイムゾーン付きタイムスタンプ値として同期され、ソースのISO 8601 UTC形式を保持します。

ネストされたフィールド ​

Emailsレコードのエンゲージメントcountsなど、ネストされたオブジェクトを含むフィールドは、単一列のJSON文字列として同期されます。

通話録音 ​

Callsのrecordings配列内の各エントリには、通話録音音声の有効期限付き署名済みURLを指すurlフィールドが含まれます。パイプラインはこのURLをメタデータとしてのみ同期し、音声コンテンツの取得や保存は行いません。

合成列 ​

Workatoは、フル同期されるすべてのオブジェクトの送信先テーブルに次の合成列を追加します。

機密データの処理 ​

Salesloftオブジェクトには、重要な個人を特定できる情報（PII）が含まれる場合があります。次のオブジェクトには、一般的に機密フィールドが含まれます:

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Salesloftをデータパイプラインソースとして使用する場合、次の制限事項が適用されます。

増分オブジェクト上の削除済みレコード ​

Salesloftは読み取りクライアントに削除済みレコードを公開しないため、パイプラインは増分同期されるオブジェクトの削除を検出できません。 Salesloftで削除されたレコードは、そのオブジェクトのフル同期を実行するまで、最後に同期された値のまま送信先に残ります。この影響を受けるオブジェクトについては、削除追跡を参照してください。

Meetingsの可用性はSalesloftプランによって異なります ​

Meetingsオブジェクトは、すべてのSalesloftプランで使用できるわけではありません。プランにMeetings APIアクセスが含まれていない場合、パイプラインはMeetingsの権限エラーを報告しますが、選択した他のオブジェクトの同期は継続します。

メールコンテンツには追加の権限が必要です ​

OAuthアプリケーションまたはAPIキーのどちらで接続する場合でも、Emailsのsubject、body、error_messageフィールドを同期するには、email_contentsとemail_bodiesの両方のスコープが必要です。いずれかのスコープが不足しているコネクションでは、それらのフィールドを暗黙的に省略するのではなく、Emailsオブジェクト全体の同期に失敗します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。これより高い頻度で同期をトリガーすることはできません。