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

Outreachをデータパイプラインソースとしてセットアップし、prospects、accounts、opportunities、シーケンスアクティビティなどのOutreachレコードを抽出して、送信先に同期します。

このガイドを使用して、Outreachをデータパイプラインソースとして接続し、パイプラインを設定し、サポートされるオブジェクト、同期モード、スキーマ処理、および制限事項を確認します。

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

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

• クラウド接続：https経由でOutreach REST APIに接続します。 オンプレミスエージェントは不要です。
• 増分同期：ほとんどのオブジェクトについて、初回同期後は新規および更新されたレコードのみを抽出します。
• カスタムオブジェクト：Outreach組織で定義されているカスタムオブジェクトを検出して同期します。
• オブジェクトレベルの選択：パイプラインに含めるOutreachオブジェクトとフィールドを選択します。
• フィールドレベルのデータ保護：フィールド値をそのままレプリケートするか、送信先に到達する前にハッシュ化します。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• 設定可能な同期頻度：最短15分間隔で同期をスケジュールします。

前提条件 ​

Outreachをデータパイプラインソースとして設定する前に、次の要件を満たしてください。

• Outreachアカウント
• 同期する予定のオブジェクトにアクセスできるOutreachユーザー

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

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

• OAuth 2.0（認可コードグラント）：OutreachユーザーアカウントでサインインしてWorkatoを認可します。 このコネクションは、Outreachデータへの読み取り専用アクセスを要求します。

Outreachに接続する ​

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

パイプラインの設定 ​

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

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

0 8 * * *

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

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

Prospectsとaccounts ​

Opportunities ​

Sequencesとコンテンツ ​

Callsとタスク ​

ユーザーとワークスペース ​

カスタムオブジェクト ​

Outreachデータパイプラインは、Outreach組織で定義されているカスタムオブジェクトを自動的に検出し、Add new objectsパネルで使用できるようにします。 OutreachがオブジェクトのupdatedAtフィールドをフィルター可能かつソート可能として報告する場合、カスタムオブジェクトは増分同期されます。 それ以外の場合、そのオブジェクトは実行のたびにすべてのレコードを再抽出します。

同期モード ​

Outreachデータパイプラインは、完全同期と増分同期をサポートしています。 パイプラインは、各オブジェクトの同期モードを自動的に決定します。

フル同期 ​

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

増分同期 ​

初回同期が完了すると、パイプラインは前回の正常な同期以降に作成または更新されたレコードのみを抽出します。 パイプラインは、各レコードのupdatedAtタイムスタンプを使用して変更を追跡します。

各オブジェクトの増分メカニズムを確認するには、サポートされるオブジェクトの表を参照してください。

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

パイプラインは、各Outreachオブジェクトのスキーマを送信先にレプリケートし、Outreachのデータ型を送信先の列型にマッピングします。

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

各送信先テーブルは、Outreachレコードのidを主キーとして使用します。 他のレコードへのリレーションシップは、prospectsオブジェクトのaccountIdなど、ID参照列として同期されます。 関連レコード自体は、それぞれ独自のオブジェクトとして同期されます。 パイプラインを設定するときに、同期する予定の各オブジェクトを選択します。

タイムスタンプ ​

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

配列フィールド ​

prospectのメールアドレスのリストなど、複数の値を含むフィールドは、単一の列内のJSON文字列として同期されます。

カスタムフィールド ​

Outreachは、prospects、accounts、opportunitiesオブジェクトに番号付きカスタムフィールド（custom1からcustom150）を提供し、usersオブジェクトにはcustom1からcustom5を提供します。 パイプラインは、入力済みのすべてのカスタムフィールド値をJSONオブジェクトとして単一の_workato_custom_fields_data列に同期します。

JSONオブジェクトの各キーは、フィールド番号とOutreach内のフィールドラベルを組み合わせたものです。 フィールドにラベルがない場合、キーはcustom1などのフィールド番号のみになります。 すべてのカスタムフィールド値は文字列として同期されます。

機密データの処理 ​

Outreachオブジェクトには、個人を特定できる情報（PII）と通信コンテンツが含まれる場合があります。 次のオブジェクトには、機密データが含まれることがよくあります。

パイプラインは、メールボックスのSMTPまたはIMAP認証情報を同期することはありません。 通話録音はURLとしてのみ同期されます。 パイプラインは音声コンテンツを抽出しません。

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

制限事項 ​

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

削除済みレコード ​

パイプラインは、増分同期されるオブジェクトの削除を検出できません。 Outreach REST APIは、削除されたレコードを読み取りクライアントに公開しないため、増分同期では前回の実行以降に変更されたレコードのみが抽出され、削除されたレコードは検出されません。 これは、ソフト削除（OutreachのRecycle Bin）とハード削除の両方に適用されます。

その結果、Outreachで削除されたレコードは、最後に同期された値とともに送信先に残り、増分同期によって削除されたり、削除済みとしてフラグ付けされたりすることはありません。

sequenceTemplatesやrecipientsなど、実行のたびに完全同期されるオブジェクトは、削除追跡をサポートしています。 どのオブジェクトが増分同期されるかを確認するには、同期モードを参照してください。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。