github-actions[bot]
8d021d2719
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
221 lines
12 KiB
Plaintext
221 lines
12 KiB
Plaintext
---
|
|
title: 外部ツール統合
|
|
info: これらのワークフローは、APIコールやWebhooksを介してTwentyにデータを出し入れすることに重点を置いています。
|
|
image: /images/user-guide/integrations/plug.png
|
|
sectionInfo: プロセスを自動化し、外部ツールと統合します
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/integrations/plug.png" alt="Header" />
|
|
</Frame>
|
|
|
|
以下に、Twentyと他のスタックを接続するために展開できるワークフローの例を示します。
|
|
|
|
## データ取り込みのユースケース
|
|
|
|
### Webフォーム送信
|
|
|
|
**問題**: ウェブサイトのフォーム、ランディングページ、または問い合わせフォームからのリードを直接Twentyにキャプチャする必要があります。
|
|
|
|
**解決策**: フォーム送信から自動的にレコードを作成するためにWebhookトリガーを使用する。
|
|
|
|
**設定**:
|
|
|
|
- Webhookトリガーでワークフローを作成
|
|
- Webhookを設定してフォームのデータ (名前、メール、会社名など) を期待するようにします。
|
|
- WebhookメソッドをPOSTに設定する
|
|
- トリガーで期待されるボディ構造を定義する
|
|
|
|
**トリガー**: Webhook (フォームからPOSTリクエスト)
|
|
|
|
**アクション**:
|
|
|
|
- すでに存在するかどうかを確認するためのレコードを検索する
|
|
- 分岐: 存在する場合→レコードを更新、存在しない場合→レコードを作成
|
|
- 営業担当者に割り当てられるフォローアップタスクのレコードを作成
|
|
- 販売チームへメール通知を送る
|
|
|
|
### 製品データ同期
|
|
|
|
**問題**: 販売チームは、データウェアハウスに保存されている製品の使用状況、請求、または機能の採用データへの可視性が必要です。
|
|
|
|
**解決策**: 販売者にアカウントについてのコンテキストを提供するために、定期的に製品データをTwentyに同期する。
|
|
|
|
**トリガー**: スケジュールに基づき (毎日または毎週)
|
|
|
|
**アクション**:
|
|
|
|
- データウェアハウスAPIへのHTTPリクエスト
|
|
- データを処理およびフォーマットするコードアクション
|
|
- 次のステップのためにイテレータ機能を使用
|
|
- 一致する企業レコードを見つけるためにレコードを検索
|
|
- 製品使用状況指標を追加するためにレコードを更新
|
|
- 使用状況がしきい値を下回った場合のタスクのためのレコードを作成
|
|
|
|
### 通話レコーダーからの議事録
|
|
|
|
**問題**: 営業電話からの重要な洞察が忘れられるか、CRMに正確に記録されないことがある。
|
|
|
|
**解決策**: 通話録音システムから自動的にノートとアクションアイテムを作成する。
|
|
|
|
**トリガー**: 通話録音プラットフォームからのWebhook
|
|
|
|
**アクション**:
|
|
|
|
- 会議の要約とアクションアイテムを抽出するコードアクション
|
|
- 関連する機会または連絡先を見つけるためにレコードを検索
|
|
- 会議要約を含むノートのためのレコードを作成
|
|
- アクションアイテムに基づくフォローアップタスクのためのレコードを作成
|
|
- 会議要約と次の手順を含むメールを参加者に送信
|
|
|
|
### データ強化
|
|
|
|
**問題**: 連絡先および企業レコードに、重要な人口統計および企業統計情報が欠けている。
|
|
|
|
**解決策**: 外部データプロバイダーを使用してレコードを自動的に豊かにする。
|
|
|
|
**トリガー**: レコードが作成される (人または企業オブジェクト)
|
|
|
|
**アクション**:
|
|
|
|
- エンリッチメントAPIへのHTTPリクエスト
|
|
- エンリッチメント応答を処理するためのコードアクション
|
|
- 次のステップのためにイテレータ機能を使用
|
|
- 追加の企業/連絡先情報でレコードを更新
|
|
- 高価値の見込み客が特定された場合の営業タスクのためのレコードを作成
|
|
- エンリッチメントが重要な購入シグナルを明らかにした場合のメールアラートを送信
|
|
|
|
## データ配布ユースケース
|
|
|
|
### ニュースレター購読者管理
|
|
|
|
**問題**: 特定のCRMデータのセグメントにマーケティングメールを送るために、専門のメールツールを使用したい。
|
|
|
|
**解決策**: 必要に応じて、サブスクライバーリストをメールマーケティングプラットフォームにエクスポートする。
|
|
|
|
**設定**: 全てのニュースレター受信者を含むビューをTwentyで作成
|
|
|
|
**トリガー**: 手動で起動 (選択されているレコードがない場合)
|
|
|
|
**アクション**:
|
|
|
|
- ニュースレタービューの基準を用いてレコードを検索
|
|
- メールプラットフォームのためにメールアドレスをフォーマットするコードアクション
|
|
- メールマーケティングツールにサブスクライバーを追加するHTTPリクエスト
|
|
- キャンペーントラッキングのためのレコードを作成
|
|
- マーケティングチームにメール確認を送信
|
|
|
|
### メールシーケンストリガー
|
|
|
|
**問題**: CRMイベントに基づいて、専用のメール自動化ツールを使って複雑なメールシーケンスをトリガーしたい。
|
|
|
|
**解決策**: 特定のイベントが発生した際に、新しいリードまたは顧客をメール自動化プラットフォームに送信。
|
|
|
|
**トリガー**: レコードが作成 (特定の条件を持つ人物オブジェクト)
|
|
|
|
**アクション**:
|
|
|
|
- 適切なメールシーケンスを決定するコードアクション
|
|
- メール自動化プラットフォームにコンタクトを追加するHTTPリクエスト
|
|
- シーケンス登録を追跡するためのレコードの更新
|
|
- エンゲージメントをモニターするためのフォローアップタスクのレコードを作成
|
|
|
|
### リードスコアリング統合
|
|
|
|
**問題**: CRMデータと外部信号を組み合わせた高度なリードスコアリングが必要です。
|
|
|
|
**解決策**: リードデータを外部のスコアリングツールに送信するか、ワークフロー内でスコアリングロジックを実装します。
|
|
|
|
**オプション 1 - 外部ツール**:
|
|
|
|
**トリガー**: レコードが更新 (人物オブジェクト)
|
|
|
|
**アクション**:
|
|
|
|
- スコアリングプラットフォームにリードデータを送信するHTTPリクエスト
|
|
- スコア応答を処理するコードアクション
|
|
- リードスコアでレコードを更新
|
|
- スコアがしきい値を超えた場合に営業タスクのためのレコードを作成
|
|
|
|
**オプション 2 - 内部ロジック**:
|
|
|
|
**トリガー**: レコードが更新 (人物オブジェクト)
|
|
|
|
**アクション**:
|
|
|
|
- スコアリングアルゴリズムを用いたコードアクション (企業規模、業界、行動)
|
|
- 計算されたスコアでレコードを更新
|
|
- 高スコアのリードに対して営業担当者へメールアラートを送信
|
|
|
|
### 請求書生成
|
|
|
|
**問題**: 取引が成立すると、顧客と取引情報で請求システムを更新する必要があります。
|
|
|
|
**解決策**: チャンスが獲得されると、取引データを自動的に請求システムに送信します。
|
|
|
|
**トリガー**: レコードが更新 (チャンスオブジェクト, ステージ = “成約済み”)
|
|
|
|
**アクション**:
|
|
|
|
- 完全な顧客情報を取得するためのレコードを検索
|
|
- 請求システムのためにデータをフォーマットするコードアクション
|
|
- 請求プラットフォームでの顧客作成のためのHTTPリクエスト
|
|
- 請求書生成のためのHTTPリクエスト
|
|
- 請求書参照を保存するためにレコードを更新
|
|
- 請求明細を含むメールをファイナンスチームに送信
|
|
|
|
## 高度な統合パターン
|
|
|
|
### 双方向同期
|
|
|
|
**問題**: Twentyと他のシステムとの間でデータを双方向に同期する必要があります。
|
|
|
|
**解決策**: スケジュールされたワークフローとWebhookトリガーを組み合わせてリアルタイム同期を実現します。
|
|
|
|
**From Twenty to External System**:
|
|
|
|
**トリガー**: レコードが更新 (関連するオブジェクト)
|
|
|
|
**アクション**:
|
|
|
|
- 外部システムをアップデートするHTTPリクエスト
|
|
- 同期ステータスとタイムスタンプを追跡するためにレコードを更新
|
|
|
|
**From External System to Twenty**:
|
|
|
|
**トリガー**: Webhook (外部システムから)
|
|
|
|
**アクション**:
|
|
|
|
- 一致するレコードを見つけるためのレコードを検索
|
|
- 外部システムからの新しいデータでレコードを更新
|
|
- 必要に応じて、紛争解決タスクのためのレコード作成
|
|
|
|
### マルチステップデータ処理
|
|
|
|
**問題**: 外部ソースからのデータは、Twentyで使用する前に複雑な処理が必要です。
|
|
|
|
**解決策**: データ変換と検証にはコードアクションを使用します。
|
|
|
|
**トリガー**: Webhookまたはスケジュールに基づいて
|
|
|
|
**アクション**:
|
|
|
|
- 受信データ形式を検証するためのコードアクション
|
|
- データ構造を変換するためのコードアクション
|
|
- ビジネスルールと計算を適用するためのコードアクション
|
|
- 重複を確認するためのレコードを検索
|
|
- 処理されたデータでレコードを作成または更新
|
|
- データ品質に問題がある場合はメール通知を送信
|
|
|
|
## 実装のヒント
|
|
|
|
- API キーを[設定→API & Webhooks]で安全に保存
|
|
- すべての外部API呼び出しにHTTPSを使用
|
|
- APIレート制限に注意 - 可能な場合はスケジュールされたワークフローを使用
|
|
- リアルタイム処理が必要でない場合はスケジュールされたバッチ更新を検討
|
|
- ワークスペースにつき100の同時ワークフロー制限を覚えておく - 複数のレコードを処理する際には手動トリガーに「バルク」提供を利用（詳細については[Workflow Features](/l/ja/user-guide/workflows/workflow-features)を参照）
|
|
- ワークフローがアクティブになる前にサンプルデータでテスト
|
|
|
|
統合問題のトラブルシューティングについては、[Workflow Troubleshooting](/l/ja/user-guide/workflows/workflow-troubleshooting)ガイドをご覧ください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。 複雑な統合を実装するためのサポートが必要な場合は、[Professional Services](/l/ja/user-guide/workflows/professional-services)を検討してください。
|