snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx

@@ -0,0 +1,82 @@
+---
+title: Code アクションで配列を扱う
+description: ワークフローの Code アクションで配列入力を適切に扱う方法を学びましょう。
+---
+
+Code アクションで配列を扱う際、次の2つの一般的な課題に直面することがあります:
+
+1. **文字列として渡される配列** — 外部システムや前のステップからのデータが、本来の配列ではなく文字列として届く
+2. **個々の項目を選べない** — 配列全体しか選択できず、その中の特定フィールドを選べない
+
+どちらも Code ノードで解決できます。
+
+## 文字列から配列をパースする
+
+配列は、ネイティブな配列ではなく、文字列や JSON としてワークフローの各ステップ間で受け渡されることがよくあります。 これは次のような場合に発生します:
+
+* HTTP Request で外部 API からデータを受け取る場合
+* Webhook ペイロードを処理する場合
+* ワークフローのステップ間でデータを受け渡す場合
+
+**解決策**: Code アクションの先頭に次のパターンを追加します:
+
+```javascript
+export const main = async (params: {
+  users: any;
+}): Promise<object> => {
+  const { users } = params;
+
+  // Handle input that may come as a string or an array
+  const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
+
+  // Now you can safely work with usersFormatted as an array
+  return {
+    users: usersFormatted.map((user) => ({
+      ...user,
+      activityStatus: String(user.activityStatus).toUpperCase(),
+    })),
+  };
+};
+```
+
+重要な行は `typeof users === "string" ? JSON.parse(users) : users` は、入力が文字列かどうかを判定し、必要であればパースし、すでに配列であればそのまま使用します。
+
+## 配列から個別のフィールドを取り出す
+
+Webhook が `answers: [...]` のような配列を返すことがありますが、その後のワークフローのステップでは、**配列全体** — その中の個別の項目は選択できません。
+
+**解決策**: 特定のフィールドを抽出して構造化オブジェクトとして返す Code ノードを追加します:
+
+```javascript
+export const main = async (params: {
+  answers: any;
+}): Promise<object> => {
+  const { answers } = params;
+
+  // Handle input that may come as a string or an array
+  const answersFormatted = typeof answers === "string"
+    ? JSON.parse(answers)
+    : answers;
+
+  // Extract specific fields from the array
+  const firstname = answersFormatted[0]?.text || "";
+  const name = answersFormatted[1]?.text || "";
+
+  return {
+    answer: {
+      firstname,
+      name
+    }
+  };
+};
+```
+
+この Code ノードは、配列ではなく構造化オブジェクトを返します。 以降のステップでは、変数ピッカーから `answer.firstname` や `answer.name` のような個別フィールドを選択できるようになります。
+
+<Tip>
+**配列からフィールドを取り出す代わりに、配列自体をループ処理したいですか？** Code ステップまたは Logic Function ステップがトップレベルの配列を返す場合は、それをそのまま [Iterator](/l/ja/user-guide/workflows/capabilities/use-iterator) に渡せます。Iterator の入力としてそのステップの **Whole list** オプションを選択し、ループ内では `{{iterator.currentItem}}` を使って各要素を参照します。 その場合、配列をオブジェクトに再構成する必要はありません。
+</Tip>
+
+<Tip>
+コードエディタ右上の四角いアイコンをクリックすると全画面表示になります — デフォルトのエディタ幅には制限があるため便利です。
+</Tip>

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/bring-product-data-in-twenty.mdx

@@ -0,0 +1,182 @@
+---
+title: 製品データを Twenty に取り込む
+description: データウェアハウスの製品カタログデータをスケジュールに基づいてCRMに同期します。
+---
+
+このパターンを使用して、データウェアハウス（例: Snowflake、BigQuery、PostgreSQL）の製品データとTwentyの同期を維持します。
+
+## ワークフローの構成
+
+1. **トリガー**: スケジュール実行
+2. **Code**: データウェアハウスをクエリする
+3. **Code**（任意）：データを配列として整形
+4. **Iterator**: 各製品をループ処理する
+5. **Upsert Record**: Twentyで作成または更新
+
+<img src="/images/user-guide/workflows/create_users_workflow.png" style={{width:'100%'}} />
+
+## ステップ 1: トリガーをスケジュールする
+
+データの鮮度要件に合わせた頻度でワークフローを実行するよう設定します:
+
+* ほぼリアルタイム同期用に5分ごと
+* 重要度の低いデータには1時間ごと
+* バッチ更新には毎日
+
+## ステップ 2: データウェアハウスをクエリする
+
+直近のデータを取得するために「**Code**」アクションを追加します:
+
+```javascript
+export const main = async () => {
+  const intervalMinutes = 10; // Match your schedule frequency
+  const cutoffTime = new Date(Date.now() - intervalMinutes * 60 * 1000).toISOString();
+
+  // Replace with your actual data warehouse connection
+  const response = await fetch("https://your-warehouse-api.com/query", {
+    method: "POST",
+    headers: {
+      "Authorization": "Bearer YOUR_API_KEY",
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      query: `
+        SELECT id, name, sku, price, stock_quantity, updated_at
+        FROM products
+        WHERE updated_at >= '${cutoffTime}'
+      `
+    })
+  });
+
+  const data = await response.json();
+  return { products: data.results };
+};
+```
+
+<Tip>
+`updated_at >= last X minutes` でフィルタリングして、最近変更されたレコードのみを取得します。 これにより同期が効率的になります。
+</Tip>
+
+## ステップ 3: データを整形（任意）
+
+ウェアハウスが変換を要する形式でデータを返す場合は、別の「**Code**」アクションを追加します。 一般的な変換には、型変換、フィールド名の変更、データのクリーンアップなどがあります。
+
+### 例: 真偽値およびステータスフィールドを含むユーザーデータ
+
+```javascript
+export const main = async (params: {
+  users: any;
+}): Promise<object> => {
+  const { users } = params;
+  const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
+
+  // Convert string "true"/"false" to actual booleans
+  const toBool = (v: any) => v === true || v === "true";
+
+  return {
+    users: usersFormatted.map((user) => ({
+      ...user,
+      activityStatus: String(user.activityStatus).toUpperCase(),
+      isActiveLast30d: toBool(user.isActiveLast30d),
+      isActiveLast7d: toBool(user.isActiveLast7d),
+      isActiveLast24h: toBool(user.isActiveLast24h),
+      isTwenty: toBool(user.isTwenty),
+    })),
+  };
+};
+```
+
+### 例: 型変換を含む製品データ
+
+```javascript
+export const main = async (params: { products: any }) => {
+  const products = typeof params.products === "string"
+    ? JSON.parse(params.products)
+    : params.products;
+
+  return {
+    products: products.map(product => ({
+      externalId: product.id,
+      name: product.name,
+      sku: product.sku,
+      price: parseFloat(product.price),        // String → Number
+      stockQuantity: parseInt(product.stock_quantity),
+      isActive: product.status === "active"    // String → Boolean
+    }))
+  };
+};
+```
+
+### 例: 日付および通貨の整形
+
+```javascript
+export const main = async (params: { deals: any }) => {
+  const deals = typeof params.deals === "string"
+    ? JSON.parse(params.deals)
+    : params.deals;
+
+  return {
+    deals: deals.map(deal => ({
+      ...deal,
+      // Convert Unix timestamp to ISO date
+      closedAt: deal.closed_timestamp
+        ? new Date(deal.closed_timestamp * 1000).toISOString()
+        : null,
+      // Ensure amount is a number (remove currency symbols)
+      amount: parseFloat(String(deal.amount).replace(/[^0-9.-]/g, "")),
+      // Normalize stage names
+      stage: deal.stage?.toLowerCase().replace(/_/g, " ")
+    }))
+  };
+};
+```
+
+### 一般的な変換
+
+| ソース形式                | ターゲット形式          | コード                                      |
+| -------------------- | ---------------- | ---------------------------------------- |
+| `"true"` / `"false"` | `true` / `false` | `v === true \|\| v === "true"`           |
+| `"123.45"`           | `123.45`         | `parseFloat(value)`                      |
+| `"active"`           | `"ACTIVE"`       | `value.toUpperCase()`                    |
+| `1704067200` (Unix)  | ISO 日付           | `new Date(v * 1000).toISOString()`       |
+| `"$1,234.56"`        | `1234.56`        | `parseFloat(v.replace(/[^0-9.-]/g, ""))` |
+| `null` / `undefined` | `""`             | `value \|\| ""`                          |
+
+## ステップ 4: 製品をループ処理する
+
+「**Iterator**」アクションを追加します:
+
+* 入力: `{{code.products}}`
+
+配列内の各製品をループ処理します。
+
+## ステップ 5: 各レコードをアップサートする
+
+Iterator 内で「**Upsert Record**」アクションを追加します:
+
+| 設定         | 値                         |
+| ---------- | ------------------------- |
+| **オブジェクト** | カスタムの Product オブジェクト      |
+| **一致条件**   | 外部IDまたはSKU（一意の識別子）        |
+| **名前**     | `{{iterator.item.name}}`  |
+| **SKU**    | `{{iterator.item.sku}}`   |
+| **価格**     | `{{iterator.item.price}}` |
+
+<Tip>
+作成と更新で分岐を作る代わりに、**Upsert**（更新または作成）を使用します。 その方が構築が速く、デバッグも容易です。
+</Tip>
+
+## ユースケース例
+
+| ソース               | データ                 |
+| ----------------- | ------------------- |
+| **ERP システム**      | 製品カタログ、価格設定、在庫      |
+| **Eコマースプラットフォーム** | 受注、顧客、製品更新          |
+| **データウェアハウス**     | 集計メトリクス、エンリッチされたデータ |
+| **在庫管理システム**      | 在庫水準、再発注アラート        |
+
+## 関連
+
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [Code アクションで配列を扱う](/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/bring-typeform-submissions-in-twenty.mdx

@@ -0,0 +1,130 @@
+---
+title: Typeform の回答を Twenty に取り込む
+description: Typeform の webhook ペイロードを処理して、フォームの回答からリードを作成します。
+---
+
+標準的な webhook 設定については、[Webhook トリガーを設定](/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger)を参照してください。 本記事では、Typeform のカスタムペイロード構造に必要となる特有の処理について説明します。
+
+### ステップ 1: Webhook ワークフローを作成
+
+1. 「**Settings → Workflows**」に移動
+2. 「**+ New Workflow**」をクリック
+3. トリガーとして「**Webhook**」を選択します
+4. webhook URL をコピーします
+
+### ステップ 2: Typeform を設定
+
+1. Typeform でフォームを開く
+2. 「**Connect → Webhooks**」に移動
+3. Twenty の webhook URL を貼り付けます
+4. 保存
+
+### ステップ 3: Typeform のペイロードを理解する
+
+Typeform は入れ子の JSON 構造を送信します。 簡略化した例はこちら：
+
+```json
+{
+  "event_type": "form_response",
+  "form_response": {
+    "form_id": "abc123",
+    "submitted_at": "2025-01-15T10:30:00Z",
+    "answers": [
+      {
+        "text": "Jane",
+        "type": "text",
+        "field": { "id": "field1", "type": "short_text", "title": "First Name" }
+      },
+      {
+        "text": "Smith",
+        "type": "text",
+        "field": { "id": "field2", "type": "short_text", "title": "Last Name" }
+      },
+      {
+        "text": "Acme Corp",
+        "type": "text",
+        "field": { "id": "field3", "type": "short_text", "title": "Company" }
+      },
+      {
+        "email": "jane@acme.com",
+        "type": "email",
+        "field": { "id": "field4", "type": "email", "title": "Email" }
+      },
+      {
+        "type": "choice",
+        "field": { "id": "field5", "type": "dropdown", "title": "Team Size" },
+        "choice": { "label": "10-50" }
+      }
+    ]
+  }
+}
+```
+
+重要なポイント：
+
+* フォームデータは `form_response` の下に入れ子になっています
+* **回答は配列として返され**、名前付きフィールドではありません
+* 各回答には参照用にフィールドの種類とタイトルが含まれます
+
+### ステップ 4: answers 配列からフィールドを抽出する
+
+`answers` は配列のため、後続ステップでは配列全体しか選択できず、個別のフィールドは選択できません。 必要なフィールドを抽出するために「**Code**」アクションを追加します:
+
+```javascript
+export const main = async (params: {
+  answers: any;
+}): Promise<object> => {
+  const { answers } = params;
+
+  // Handle input that may come as a string or an array
+  const answersFormatted = typeof answers === "string"
+    ? JSON.parse(answers)
+    : answers;
+
+  // Extract fields by position or by finding the field type
+  const firstName = answersFormatted[0]?.text || "";
+  const lastName = answersFormatted[1]?.text || "";
+  const company = answersFormatted[2]?.text || "";
+  const email = answersFormatted.find(a => a.type === "email")?.email || "";
+  const teamSize = answersFormatted.find(a => a.type === "choice")?.choice?.label || "";
+
+  return {
+    contact: {
+      firstName,
+      lastName,
+      company,
+      email,
+      teamSize
+    }
+  };
+};
+```
+
+以降のステップでは、変数ピッカーから `contact.firstName` や `contact.email` のような個別フィールドを選択できるようになります。
+
+<Tip>
+配列の扱いの詳細については、[Code アクションで配列を扱う](/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)を参照してください。
+</Tip>
+
+### ステップ 5: レコードを作成
+
+「**Create Record**」アクションを追加します:
+
+| フィールド      | 値                                       |
+| ---------- | --------------------------------------- |
+| **オブジェクト** | 人物                                      |
+| **名**      | `{{code.contact.firstName}}`            |
+| **姓**      | `{{code.contact.lastName}}`             |
+| **メール**    | `{{code.contact.email}}`                |
+| **会社**     | `{{code.contact.company}}` に基づいて検索または作成 |
+
+### ステップ 6: テストして有効化
+
+1. Typeform でテスト回答を送信
+2. ワークフローの実行を確認し、データが取り込まれたことを検証
+3. ワークフローを有効化します
+
+## 関連
+
+* [Webhook トリガーを設定](/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger)
+* [Code アクションで配列を扱う](/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx

@@ -0,0 +1,263 @@
+---
+title: Twenty から PDF を生成する
+description: PDF（見積書など）を生成してレコードに添付するワークフローを作成します。
+---
+
+Twenty で PDF を自動生成または取得し、レコードに添付します。 これは、会社、商談、またはその他のオブジェクトに関連付けられた見積書、請求書、レポートを作成する用途で一般的に使用されます。
+
+## 概要
+
+このワークフローでは **手動トリガー** を使用し、選択した任意のレコードに対してオンデマンドで PDF を生成できるようにします。 次を **ロジック関数** が処理します:
+
+1. URL（PDF 生成サービスから）から PDF をダウンロードする
+2. ファイルを Twenty にアップロードする
+3. レコードに関連付けられた添付ファイルを作成する
+
+## 前提条件
+
+ワークフローを設定する前に:
+
+1. **API キーを作成**: **Settings → APIs** に移動して新しい API キーを作成します。 ロジック関数にはこのトークンが必要です。
+2. **PDF 生成サービスを設定**（任意）：PDF を動的に生成したい場合（例: 見積書）は、Carbone、PDFMonkey、DocuSeal のようなサービスを使用して PDF を作成し、ダウンロード URL を取得します。
+
+## ステップバイステップの設定
+
+### ステップ 1: トリガーを設定
+
+1. **Workflows** に移動し、新しいワークフローを作成します
+2. **手動トリガー** を選択します
+3. PDF を添付したい対象オブジェクト（例: **Company** や **Opportunity**）を選択します
+
+<Tip>
+手動トリガー付き ユーザーは、レコードが選択されると右上に表示されるボタンを使用してこのワークフローを実行できます — これは、PDFを生成して添付するためのワークフローを実行します。
+</Tip>
+
+### ステップ 2: ロジック関数を追加する
+
+1. **コード** アクション (Logic Function) を追加します
+2. 以下のコードで新しい関数を作成します
+3. 入力パラメーターを設定します
+
+#### 入力パラメーター
+
+| パラメーター      | 値                       |
+| ----------- | ----------------------- |
+| `companyId` | `{{trigger.object.id}}` |
+
+<Note>
+別のオブジェクト（Person、Opportunity など）に添付する場合は、適切にパラメーター名を変更（例: `personId`、`opportunityId`）し、ロジック関数を更新します。
+</Note>
+
+#### ロジック関数のコード
+
+```typescript
+export const main = async (
+  params: { companyId: string },
+) => {
+  const { companyId } = params;
+  // Replace with your Twenty GraphQL endpoints (/metadata for metadata and files or /graphql for your records)
+  // Cloud: https://api.twenty.com/graphql
+  // Self-hosted: https://your-domain.com/graphql
+
+  const metadataGraphqlEndpoint = 'https://api.twenty.com/metadata';
+  const dataGraphqlEndpoint = 'https://api.twenty.com/graphql';
+
+  // Replace with your API key from Settings → APIs
+  const authToken = 'YOUR_API_KEY';
+
+  // Replace with your PDF URL
+  // This could be from a PDF generation service or a static URL
+  const pdfUrl = 'https://your-pdf-service.com/generated-quote.pdf';
+  const filename = 'quote.pdf';
+
+  // Step 1: Download the PDF file
+  const pdfResponse = await fetch(pdfUrl);
+
+  if (!pdfResponse.ok) {
+    throw new Error(`Failed to download PDF: ${pdfResponse.status}`);
+  }
+
+  const pdfBlob = await pdfResponse.blob();
+  const pdfFile = new File([pdfBlob], filename, { type: 'application/pdf' });
+
+  const fieldMetadataIdQuery = `
+    query FindUploadFileFieldMetadataId {
+      objects {
+        edges {
+          node {
+            nameSingular
+            fieldsList {
+              id
+              name
+            }
+          }
+        }
+      }
+    }
+  `;
+
+  // Step 2: Find a fieldMetadataId of "Attachment file" field in Attachments object with GraphQL API
+  const response = await fetch(metadataGraphqlEndpoint, {
+      method: 'POST',
+      headers: {
+        Authorization: `Bearer ${authToken}`
+      },
+      body: {
+        query: fieldMetadataIdQuery,
+      }
+    });
+  const result = await response.json();
+  const uploadFileFieldMetadataId = result.data.objects.edges.find(object => object.node.nameSingular === 'attachment').node.fieldsList.find(field => field.name === 'file').id;
+
+  // Step 3: Upload the file via GraphQL multipart upload
+  const uploadMutation = `
+    mutation UploadFilesFieldFile($file: Upload!, $fieldMetadataId: String!) {
+      uploadFilesFieldFile(file: $file, fieldMetadataId: $fieldMetadataId) {
+        id
+      }
+    }
+  `;
+
+  const uploadForm = new FormData();
+  uploadForm.append('operations', JSON.stringify({
+    query: uploadMutation,
+    variables: { file: null, fieldMetadataId: uploadFileFieldMetadataId },
+  }));
+  uploadForm.append('map', JSON.stringify({ '0': ['variables.file'] }));
+  uploadForm.append('0', pdfFile);
+
+  const uploadResponse = await fetch(metadataGraphqlEndpoint, {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${authToken}` },
+    body: uploadForm,
+  });
+
+  const uploadResult = await uploadResponse.json();
+
+  if (uploadResult.errors?.length) {
+    throw new Error(`Upload failed: ${uploadResult.errors[0].message}`);
+  }
+
+  const fileId = uploadResult.data?.uploadFilesFieldFile?.id;
+
+  if (!fileId) {
+    throw new Error('No file id returned from upload');
+  }
+
+  // Step 4: Create the attachment linked to the company
+  const attachmentMutation = `
+    mutation CreateOneAttachment($data: AttachmentCreateInput!) {
+      createAttachment(data: $data) {
+        id
+        name
+      }
+    }
+  `;
+
+  const attachmentResponse = await fetch(dataGraphqlEndpoint, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${authToken}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      query: attachmentMutation,
+      variables: {
+        data: {
+          name: filename,
+          targetCompanyId: companyId,
+          file: [
+            {
+              fileId: fileId,
+              label: filename
+            }
+          ]
+        },
+      },
+    }),
+  });
+
+  const attachmentResult = await attachmentResponse.json();
+
+  if (attachmentResult.errors?.length) {
+    throw new Error(`Attachment creation failed: ${attachmentResult.errors[0].message}`);
+  }
+
+  return attachmentResult.data?.createAttachment;
+};
+```
+
+### ステップ 3: ユースケースに合わせてカスタマイズする
+
+#### 別のオブジェクトに添付する場合
+
+`targetCompanyId` を適切なフィールドに置き換えます:
+
+| オブジェクト     | フィールド名                     |
+| ---------- | -------------------------- |
+| 会社         | `targetCompanyId`          |
+| 人物         | `targetPersonId`           |
+| 商談         | `targetOpportunityId`      |
+| カスタムオブジェクト | `targetYourCustomObjectId` |
+
+関数のパラメーターと、添付のミューテーション内の `variables.data` オブジェクトの両方を更新します。
+
+#### 動的な PDF URL を使用する場合
+
+PDF 生成サービスを使用する場合、次のことができます:
+
+1. まず HTTP Request アクションで PDF を生成します
+2. 返された PDF URL をパラメーターとしてロジック関数に渡します
+
+```typescript
+export const main = async (
+  params: { companyId: string; pdfUrl: string; filename: string },
+) => {
+  const { companyId, pdfUrl, filename } = params;
+  // ... rest of the function
+};
+```
+
+### ステップ 4: テストして有効化
+
+1. ワークフローを保存します
+2. Company のレコードに移動します
+3. **⋮** メニューをクリックし、ワークフローを選択します
+4. レコードの **Attachments** セクションを確認し、PDF が添付されたことを確認します
+5. ワークフローを有効化します
+
+## PDF 生成サービスとの連携
+
+動的な見積書や請求書を作成する場合:
+
+### 例: 見積書を生成 → PDF を添付
+
+| 手順 | アクション           | 目的                           |
+| -- | --------------- | ---------------------------- |
+| 1  | 手動トリガー（Company） | ユーザーがレコード上で実行を開始             |
+| 2  | レコード検索          | Opportunity または明細行の詳細を取得     |
+| 3  | HTTPリクエスト       | レコードデータを用いて PDF 生成 API を呼び出す |
+| 4  | ロジック関数          | 生成された PDF をダウンロードして添付        |
+
+### 一般的な PDF 生成サービス
+
+* **Carbone** - テンプレートベースのドキュメント生成
+* **PDFMonkey** - テンプレートからの動的な PDF 作成
+* **DocuSeal** - ドキュメント自動化プラットフォーム
+* **Documint** - API ファーストのドキュメント生成
+
+各サービスは、PDF URLを返すAPIを提供し、ロジック関数に渡すことができます。
+
+## トラブルシューティング
+
+| 問題                   | 解決策                                       |
+| -------------------- | ----------------------------------------- |
+| "PDF のダウンロードに失敗しました" | PDF URL にアクセスでき、有効な PDF が返されることを確認します     |
+| "アップロードに失敗しました"      | API キーが有効で、書き込み権限があることを確認します              |
+| "添付ファイルの作成に失敗しました"   | オブジェクト ID のフィールド名が対象オブジェクトに一致していることを確認します |
+
+## 関連
+
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)
+* [ロジック関数](/l/ja/user-guide/workflows/capabilities/workflow-actions#code)
+* [Twenty から見積書または請求書を生成する](/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/generate-quote-or-invoice-from-twenty.mdx

@@ -0,0 +1,144 @@
+---
+title: Twenty から見積書または請求書を作成
+description: 商談がクローズしたときに、外部ツールで請求書を自動作成します。
+---
+
+商談データを請求書発行システム (Stripe、QuickBooks、Xero など) に自動送信します。 商談が受注になったときに。
+
+## ワークフローの構成
+
+1. **トリガー**: レコードが更新 (商談オブジェクト)
+2. **フィルター**: ステージ = Closed Won
+3. **レコード検索**: 会社の詳細を取得
+4. **コード** (任意): ペイロードを整形
+5. **HTTP リクエスト**: 請求書発行システムに送信
+
+## ステップ 1: トリガーを設定
+
+1. 新しいワークフローを作成
+2. **Record is Updated** トリガーを選択
+3. オブジェクトとして **Opportunity** を選択
+
+## ステップ 2: Closed Won でフィルター
+
+商談が受注になったときのみ続行するように、**フィルター** アクションを追加:
+
+| 設定        | 値                           |
+| --------- | --------------------------- |
+| **フィールド** | ステージ                        |
+| **条件**    | 等しい                         |
+| **値**     | `CLOSED_WON` (またはあなたのステージ名) |
+
+<Tip>
+このトリガーは、商談の更新があるたびに発火します。 このフィルターにより、ステージが Closed Won に変わった場合にのみワークフローが続行されます。
+</Tip>
+
+## ステップ 3: 会社の詳細を取得
+
+商談レコードには、請求書に必要なすべての会社フィールドが含まれていない可能性があります。 **レコード検索** アクションを追加:
+
+| 設定         | 値                                        |
+| ---------- | ---------------------------------------- |
+| **オブジェクト** | 会社                                       |
+| **一致条件**   | ID が `{{trigger.object.companyId}}` に等しい |
+
+これにより、請求先住所、税番号などを含む会社の完全なレコードを取得します。
+
+## ステップ 4: ペイロードを整形 (任意)
+
+請求書発行システムが特定のフォーマットを想定している場合は、**コード** アクションを追加:
+
+```javascript
+export const main = async (params: {
+  opportunity: any;
+  company: any;
+}): Promise<object> => {
+  const { opportunity, company } = params;
+
+  return {
+    invoice: {
+      // Customer info from Company
+      customer_name: company.name,
+      customer_email: company.email || "",
+      billing_address: {
+        line1: company.address?.street || "",
+        city: company.address?.city || "",
+        postal_code: company.address?.postalCode || "",
+        country: company.address?.country || ""
+      },
+      tax_id: company.taxId || null,
+
+      // Invoice details from Opportunity
+      amount: opportunity.amount,
+      currency: opportunity.currency || "USD",
+      description: `Invoice for ${opportunity.name}`,
+      due_days: 30,
+
+      // Reference back to Twenty
+      metadata: {
+        opportunity_id: opportunity.id,
+        company_id: company.id
+      }
+    }
+  };
+};
+```
+
+## ステップ 5: 請求書発行システムに送信
+
+**HTTP リクエスト** アクションを追加:
+
+| 設定       | 値                                    |
+| -------- | ------------------------------------ |
+| **メソッド** | POST                                 |
+| **URL**  | 請求書発行 API のエンドポイント                   |
+| **ヘッダー** | `Authorization: Bearer YOUR_API_KEY` |
+| **本文**   | `{{code.invoice}}` またはフィールドを直接マッピング  |
+
+### 例: Stripe の請求書
+
+```
+POST https://api.stripe.com/v1/invoices
+Headers:
+  Authorization: Bearer sk_live_xxx
+  Content-Type: application/x-www-form-urlencoded
+
+Body:
+  customer: {{company.stripeCustomerId}}
+  collection_method: send_invoice
+  days_until_due: 30
+```
+
+### 例: QuickBooks の請求書
+
+```
+POST https://quickbooks.api.intuit.com/v3/company/{realmId}/invoice
+Headers:
+  Authorization: Bearer YOUR_ACCESS_TOKEN
+  Content-Type: application/json
+
+Body: {{code.invoice}}
+```
+
+## ワークフロー全体の概要
+
+| 手順 | アクション                | 目的                       |
+| -- | -------------------- | ------------------------ |
+| 1  | トリガー: Record Updated | 任意の商談が変更されたときに発火         |
+| 2  | フィルター                | ステージが Closed Won の場合のみ続行 |
+| 3  | レコード検索               | 請求用の会社詳細を取得              |
+| 4  | コード                  | 請求書発行 API 向けにデータを整形      |
+| 5  | HTTPリクエスト            | 外部システムで請求書を作成            |
+
+## ヒント
+
+* **外部 ID を保存**: **Update Record** アクションを使用して、API から返された請求書 ID を商談に保存
+* **エラー処理**: HTTP リクエストが失敗した場合に通知を送信する分岐を追加
+* **まずテスト**: 本番運用前に、請求書発行システムのサンドボックス/テストモードを使用
+
+## 関連
+
+* [Twenty から PDF を生成する](/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty) — 生成された PDF をレコードに添付する
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [Closed Won の自動化](/l/ja/user-guide/workflows/how-tos/crm-automations/closed-won-automations)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger.mdx

@@ -0,0 +1,170 @@
+---
+title: Webhook トリガーの設定
+description: 外部サービスからデータを受け取り、ワークフローをトリガーします。
+---
+
+Webhook トリガーは、一意の URL にデータを送信することで外部サービスがあなたのワークフローを開始できるようにします。 フォーム、サードパーティアプリ、カスタム統合に接続するために使用します。
+
+## Webhook を使用するタイミング
+
+| ユースケース         | 例                       |
+| -------------- | ----------------------- |
+| **Web フォーム**   | お問い合わせフォームの送信でリードを作成    |
+| **サードパーティアプリ** | Stripe の支払い → 顧客レコードを作成 |
+| **カスタム統合**     | 自社アプリ → Twenty の自動化     |
+| **ノーコードツール**   | Zapier、Make、n8n との連携    |
+
+## ステップバイステップの設定
+
+### ステップ 1: ワークフローを作成
+
+1. 「**Settings → Workflows**」に移動
+2. 「**+ New Workflow**」をクリック
+3. 名前を付ける（例: "Website Form Submission"）
+
+### ステップ 2: Webhook トリガーを設定
+
+1. トリガーブロックをクリック
+2. 「**Webhook**」を選択
+3. 次のような一意の Webhook URL が発行されます:
+   ```
+   https://api.twenty.com/webhooks/workflow/abc123...
+   ```
+4. この URL をコピーします—外部サービスで使用します
+
+### ステップ 3: 想定されるデータ構造を定義
+
+**POST** リクエストの場合、想定されるボディ構造を定義します:
+
+1. 「**Define expected body**」をクリック
+2. サービスが送信する内容に一致するサンプル JSON を入力します:
+
+```json
+{
+  "firstName": "John",
+  "lastName": "Doe",
+  "email": "john@example.com",
+  "company": "Acme Inc",
+  "message": "Interested in your product"
+}
+```
+
+3. 「**Save**」をクリック—これにより、後続のステップで使用できる変数が作成されます
+
+### ステップ 4: アクションを追加
+
+Webhook データを使用するアクションを追加します:
+
+**例: Person レコードを作成**
+
+1. 「**Create Record**」アクションを追加
+2. 「**People**」オブジェクトを選択
+3. フィールドをマッピング:
+
+| フィールド | 値                                       |
+| ----- | --------------------------------------- |
+| 名     | `{{trigger.body.firstName}}`            |
+| 姓     | `{{trigger.body.lastName}}`             |
+| メール   | `{{trigger.body.email}}`                |
+| 会社    | `{{trigger.body.company}}` に基づいて検索または作成 |
+
+### ステップ 5: Webhook をテスト
+
+有効化する前に、Webhook をテストします:
+
+**cURL を使用**:
+
+```bash
+curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
+  -H "Content-Type: application/json" \
+  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'
+```
+
+**Postman などを使用**:
+
+1. Webhook URL に対して POST リクエストを作成
+2. Content-Type ヘッダーを `application/json` に設定
+3. テスト用の JSON ボディを追加
+4. 送信してワークフローの実行を確認
+
+### ステップ 6: 有効化
+
+テストが完了したら、ワークフローを稼働させるために「**Activate**」をクリックします。
+
+## さまざまなデータ構造の扱い
+
+### ネストされたデータ
+
+Webhook がネストされたデータを送信する場合:
+
+```json
+{
+  "contact": {
+    "name": "John Doe",
+    "email": "john@example.com"
+  },
+  "source": "website"
+}
+```
+
+次のように参照します: `{{trigger.body.contact.email}}`
+
+### 配列
+
+データに配列が含まれる場合:
+
+```json
+{
+  "items": [
+    {"name": "Product A", "qty": 2},
+    {"name": "Product B", "qty": 1}
+  ]
+}
+```
+
+配列の扱い方はユースケースによって異なります:
+
+**項目数が不明 → Iterator を使用**
+
+配列内の各項目を処理する必要がある場合（例: 各項目ごとにレコードを作成）、配列を解析するために **Code** アクションを追加し、その後 **Iterator** を使用します:
+
+```javascript
+export const main = async (params: { items: any }) => {
+  const items = typeof params.items === "string"
+    ? JSON.parse(params.items)
+    : params.items;
+  return { items };
+};
+```
+
+次に Iterator を使用してループ処理します: `{{code.items}}`
+
+**既知／特定のフィールド → 名前付きフィールドとして抽出**
+
+配列に個別にアクセスしたい特定のフィールドが含まれている場合（例: フォーム回答で位置 0 が常に "first name"、位置 1 が常に "last name" のようなケース）、それらを抽出するために **Code** アクションを追加します:
+
+```javascript
+export const main = async (params: { items: any }) => {
+  const items = typeof params.items === "string"
+    ? JSON.parse(params.items)
+    : params.items;
+
+  return {
+    product: {
+      name: items[0]?.name || "",
+      qty: items[0]?.qty || 0
+    }
+  };
+};
+```
+
+これで、後続のステップで `product.name` と `product.qty` を個別に選択できます。
+
+<Tip>
+配列の扱いの詳細については、[Code アクションで配列を扱う](/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)を参照してください。
+</Tip>
+
+## 関連
+
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx

@@ -0,0 +1,121 @@
+---
+title: 受信メールへの自動返信
+description: AI を使用して受信メールをトリアージし、スレッド返信を自動的に送信するワークフローを構築します。
+---
+
+受信メールに数秒で対応 — 数時間ではなく。 このワークフローは、AI Agent を使用してノイズ(ニュースレター、スパム、自動返信)を除去し、実際のメッセージに対するパーソナライズされた応答をドラフトします。 そして、元の会話の中でスレッド返信として送信します。
+
+## メールスレッドの仕組み
+
+すべてのメールには、送信者のメールサーバーによって割り当てられる一意の識別子である非表示の `Message-ID` ヘッダーが含まれています。 メールに返信すると、メールクライアントはフィンガープリントを参照する `In-Reply-To` ヘッダーを設定します。 Gmail、Outlook、その他すべてのクライアントはメッセージをスレッドにまとめています。
+
+Twenty では、そのフィンガープリントは Message オブジェクトに `headerMessageId` として保存されます。 ワークフローはそれをつかみ、返信メール送信アクションのIn-Reply-To 項目に渡します。
+
+## ワークフローの構築
+
+### ステップ 1: 新しいワークフローを作成
+
+**設定->ワークフロー**に進み\*\*+新しいワークフロー\*\*をクリックしてください。
+
+### ステップ2：受信メッセージをトリガーする
+
+**レコードが作成されたら** **メッセージ**を選択します。
+
+メールがTwentyに届くたびに、これは火事になります。
+
+<img src="/images/user-guide/workflows/auto-reply/workflow-overview.png" style={{width:'100%'}} />
+
+### ステップ 3: 送金者を調べてください
+
+**レコードを検索**アクションを追加します。
+
+送信者のアドレスはメッセージ自体にありません — 関連するメッセージ参加者レコードにあります。
+
+| フィールド      | 値                             |
+| ---------- | ----------------------------- |
+| **オブジェクト** | メッセージ参加者                      |
+| **フィルター**  | メッセージ **です** `{{trigger.id}}` |
+| **フィルター**  | ロールは **以下から**                 |
+| **制限**     | 1                             |
+
+これにより、`handle` で送信者のメールアドレスと、`displayName` で送信者の名前が表示されます。
+
+<img src="/images/user-guide/workflows/auto-reply/find-sender.png" style={{width:'100%'}} />
+
+### ステップ 4: トリアージしてAIとの返信をドラフトする
+
+**AI エージェント** アクションを追加します。 この単一のステップは、2つのことを行います: 電子メールに返信が値するかどうかを決定し、その場合は1つを書き込みます。
+
+次のようなプロンプトを使用します。
+
+```
+You are an email triage assistant for a sales team. Read the following
+inbound email and decide if it deserves a reply.
+
+Subject: {{trigger.subject}}
+Body: {{trigger.text}}
+From: {{Find Sender.first.displayName}} ({{Find Sender.first.handle}})
+
+If this email is spam, a newsletter, an automated notification, or
+otherwise does not need a human reply, respond with exactly: SKIP
+
+Otherwise, write a short, professional reply (3-4 sentences max) that:
+- Acknowledges their specific message
+- Lets them know someone from the team will follow up shortly
+- Is warm but not overly casual
+
+Respond with only the reply text, no subject line or greeting prefix.
+```
+
+AI Agent は、次のステップが参照できるレスポンスを `response` フィールドに出力します。
+
+<img src="/images/user-guide/workflows/auto-reply/ai-triage.png" style={{width:'100%'}} />
+
+### ステップ5：AIの決定に支局
+
+**If/Else**アクションを追加して、AIが返信するかスキップするかを確認します。
+
+| フィールド       | 値                                    |
+| ----------- | ------------------------------------ |
+| **条件**      | AI Agent の`response` **`SKIP`を含まない** |
+| **If true** | メール送信を続ける                            |
+| **それ以外**    | 何もしない (ワークフロー終了)                     |
+
+スパム、ニュースレター、自動生成されたメッセージは削除されます。 他のすべてが次のステップに移動します。
+
+<img src="/images/user-guide/workflows/auto-reply/should-reply.png" style={{width:'100%'}} />
+
+### ステップ 6: スレッド返信を送信
+
+"if true" ブランチに **メール送信** アクションを追加します。 **詳細オプション**をクリックし、**返信内に追加**をクリックします。
+
+| フィールド           | 値                                      |
+| --------------- | -------------------------------------- |
+| **宛先**          | `{{Find Sender.first.handle}}`         |
+| **件名**          | `Re: {{trigger.subject}}`              |
+| **本文**          | `{{AI Triage & Draft Reply.response}}` |
+| **In-Reply-To** | `{{trigger.headerMessageId}}`          |
+
+In-Reply-To フィールドは、新しい会話ではなく返信になります。 受信者は、Gmail、Outlook、または他のクライアントでは、元の電子メールの下でスレッド化されていることを確認します。
+
+<img src="/images/user-guide/workflows/auto-reply/send-email.png" style={{width:'100%'}} />
+
+<Tip>
+**In-Reply-To** はトリガーから `message.headerMessageId` を期待します — 受信者のアドレスではなく、メールの固有の指紋です。 空白のままにすると、電子メールは単独のメッセージとして送信されます。
+</Tip>
+
+<Warning>
+Gmail は件名を使用してメッセージをスレッドにグループ化します。 元のスレッドの中に返信を表示するには、件名が `Re:` (コロンとスペースを含む) で始まる必要があります。 In-Reply-To ヘッダーが正しく設定されている場合でも、返信は別個の会話として表示されます。
+</Warning>
+
+### ステップ 7: テストして有効化
+
+**テスト**をクリックし、メールクライアントを確認してください。 返信は元のメッセージの下に入れ子になっているように見えます。
+
+あなたがそれに満足しているときに有効にします。
+
+## 上に構築するアイデア
+
+* **VIPへの返信のみ** — 送信者のドメインを確認するブランチを追加します。
+* **意図でルート化** — サポートリクエストとは異なる販売お問い合わせに対応するために、別個の AI Agent プロンプトを使用してください。
+* **返信する前にエンリッチする** — 送信者の会社を引っ張ったり、AIプロンプトに履歴を出すために検索レコードのステップを追加し、よりパーソナライズされた返信を求めます。

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/closed-won-automations.mdx

@@ -0,0 +1,179 @@
+---
+title: Closed Won の自動化
+description: 商談が成約（Closed Won）になったときに、成約後の活動を自動化します。
+---
+
+商談がクローズしたら、複数のことを行う必要があります：会社のステータスを更新し、チームメンバーに通知し、オンボーディングタスクを作成します。 これらをひとつのワークフローで自動化します。
+
+## 問題
+
+商談が "Closed Won" に移動したとき：
+
+* 会社タイプを "Prospect" から "Customer" に変更する必要があります
+* オンボーディングタスクを作成する必要があります
+* カスタマーサクセスチームに通知する必要があります
+* 営業担当者への確認が必要です
+
+これを手作業で行うのは時間がかかり、ミスの原因になります。
+
+## 解決策
+
+成約後のすべての作業を自動で処理するワークフローを作成します。
+
+## ワークフローのセットアップを完了
+
+### ステップ 1: ワークフローを作成
+
+1. 「**Settings → Workflows**」に移動
+2. 「**+ New Workflow**」をクリック
+3. 名前を "Deal Won - Post-Win Automation" にします
+
+### ステップ 2: トリガーを設定
+
+1. 「**Record is Updated**」を選択
+2. 「**Opportunities**」を選択
+3. "Fields to monitor" で **Stage** を選択
+
+### ステップ 3: ステージフィルターを追加
+
+1. 「**Filter**」アクションを追加
+2. 条件: `{{trigger.object.stage}}` が "Closed Won" と等しい
+
+### ステップ 4: 会社タイプを更新
+
+1. 「**Update Record**」アクションを追加
+2. 設定:
+
+| フィールド         | 値                               |
+| ------------- | ------------------------------- |
+| **オブジェクト**    | 会社                              |
+| **レコード**      | `{{trigger.object.company.id}}` |
+| **種類**        | 顧客                              |
+| **初回ディール日**   | `{{trigger.object.closedAt}}`   |
+| **アカウントオーナー** | `{{trigger.object.owner.id}}`   |
+
+### ステップ 5: オンボーディングタスクを作成
+
+1. 「**Create Record**」アクションを追加
+2. 設定:
+
+| フィールド      | 値                                                                                                    |
+| ---------- | ---------------------------------------------------------------------------------------------------- |
+| **オブジェクト** | タスク                                                                                                  |
+| **タイトル**   | `Onboarding: {{trigger.object.name}}`                                                                |
+| **担当者**    | カスタマーサクセスチームのメンバー                                                                                    |
+| **期日**     | 今から3日後                                                                                               |
+| **優先**     | 高                                                                                                    |
+| **関連会社**   | `{{trigger.object.company.id}}`                                                                      |
+| **関連商談**   | `{{trigger.object.id}}`                                                                              |
+| **説明**     | `New customer onboarding for {{trigger.object.company.name}}. Deal value: {{trigger.object.amount}}` |
+
+### ステップ 6: カスタマーサクセスに通知
+
+1. 「**Send Email**」アクションを追加
+2. 設定:
+
+| フィールド  | 値                                                  |
+| ------ | -------------------------------------------------- |
+| **宛先** | customer-success@yourcompany.com                   |
+| **件名** | `🎉 New Customer: {{trigger.object.company.name}}` |
+| **本文** | 下記の例を参照してください                                      |
+
+**メール本文の例**:
+
+```
+Hi CS Team,
+
+We have a new customer!
+
+Company: {{trigger.object.company.name}}
+Deal: {{trigger.object.name}}
+Value: {{trigger.object.amount}}
+Sales Rep: {{trigger.object.owner.name}}
+Close Date: {{trigger.object.closedAt}}
+
+An onboarding task has been created automatically.
+
+Let's give them a great start!
+```
+
+### ステップ 7: 営業担当者に確認を送信
+
+1. さらに「**Send Email**」アクションを追加
+2. 設定:
+
+| フィールド  | 値                                                               |
+| ------ | --------------------------------------------------------------- |
+| **宛先** | `{{trigger.object.owner.email}}`                                |
+| **件名** | `✅ Deal Closed: {{trigger.object.name}}`                        |
+| **本文** | おめでとうございます！ ディールの処理が完了しました。 カスタマーサクセスチームに通知され、オンボーディングが開始されました。 |
+
+### ステップ 8: テストして有効化
+
+1. テスト用の商談を "Closed Won" に移動してテストします
+2. 確認:
+   * 会社の種別が "Customer" に変更された
+   * オンボーディングタスクが作成された
+   * CS チームがメールを受信した
+   * 営業担当者が確認を受け取った
+3. 準備ができたら有効化します
+
+## Closed Lost の処理
+
+失注ディール向けに同様のワークフローを作成します:
+
+### トリガー
+
+* レコードが更新（Opportunities、Stage = "Closed Lost"）
+
+### アクション
+
+1. 「**Create Record**」: "Lost Deal Analysis" 用のタスク
+2. 「**Update Record**」: 失注理由を会社レコードに追加
+3. 「**Send Email**」: 失注の旨をマネージャーに通知
+
+## 高度な設定: 多段階のオンボーディング
+
+複雑なオンボーディングには、複数のタスクを作成します:
+
+```javascript
+export const main = async (params) => {
+  const tasks = [
+    { title: "Welcome call", daysFromNow: 1, assignee: "CS" },
+    { title: "Send onboarding materials", daysFromNow: 2, assignee: "CS" },
+    { title: "Technical setup", daysFromNow: 5, assignee: "Support" },
+    { title: "30-day check-in", daysFromNow: 30, assignee: "CS" }
+  ];
+
+  return { tasks };
+};
+```
+
+配列から各タスクを作成するには **Iterator** を使用します。
+
+## カスタマイズのアイデア
+
+### 他のツールも最新状態に保つ
+
+* **HTTP Request** で請求システムに顧客を作成する
+
+### 条件付きアクション
+
+「**Filter**」アクションを使用して次を行います:
+
+* エンタープライズと SMB で異なるオンボーディング
+* 地域に基づいて担当者を変える
+* 小規模ディールでは通知をスキップ
+
+### 取引の詳細を含める
+
+整形には「**Code**」アクションを使用:
+
+* ディールのサマリードキュメント
+* CS チーム向けの引き継ぎメモ
+* カスタムのオンボーディングチェックリスト
+
+## 関連
+
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [ワークフローからメールを送信](/l/ja/user-guide/workflows/capabilities/send-emails-from-workflows)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/detect-stale-opportunities.mdx

@@ -0,0 +1,136 @@
+---
+title: 停滞した商談を検出
+description: 商談が更新されていない場合にマネージャーに自動的に通知します。
+---
+
+商談が停滞したときにマネージャーにアラートを送信して、パイプラインの健全性を保ちましょう。 このワークフローは、指定した日数の間更新されていない商談をチェックします。
+
+## 問題
+
+更新されずに放置された商談は次のような事態を招きます:
+
+* 商談が冷え込む
+* 予測の信頼性低下
+* 収益の損失
+
+## 解決策
+
+停滞した商談を見つけ、マネージャーにメールを送信する定期実行のワークフローを作成します。
+
+## ステップバイステップの設定
+
+### ステップ 1: ワークフローを作成
+
+1. 「**Settings → Workflows**」に移動
+2. 「**+ New Workflow**」をクリック
+3. 名前を "停滞商談アラート" にします
+
+### ステップ 2: トリガーを設定
+
+1. 「**On a Schedule**」を選択
+2. 毎日実行に設定 (例: 毎朝 8 時)
+
+### ステップ 3: 停滞した商談を検索
+
+1. 「**Search Records**」アクションを追加
+2. 設定:
+
+| フィールド      | 値                                               |
+| ---------- | ----------------------------------------------- |
+| **オブジェクト** | 商談                                              |
+| **フィルター**  | Updated At が (today - 7 days) より前               |
+| **フィルター**  | Stage が "Closed Won" ではなく、かつ "Closed Lost" でもない |
+| **制限**     | 100                                             |
+
+### ステップ 4: 該当があるか確認
+
+1. 「**Filter**」アクションを追加
+2. 条件: `{{searchRecords.length}}` が 0 より大きい
+3. 停滞した商談がない場合、ワークフローはここで停止します
+
+### ステップ 5: アラートを整形 (コードアクション)
+
+メールを整形するために「**Code**」アクションを追加します:
+
+```javascript
+export const main = async (params) => {
+  const opportunities = params.opportunities;
+
+  // Group opportunities by owner
+  const byOwner = {};
+  opportunities.forEach(opp => {
+    const ownerEmail = opp.owner?.email || 'unassigned';
+    if (!byOwner[ownerEmail]) {
+      byOwner[ownerEmail] = [];
+    }
+    byOwner[ownerEmail].push({
+      name: opp.name,
+      amount: opp.amount,
+      lastUpdated: opp.updatedAt,
+      stage: opp.stage
+    });
+  });
+
+  // Format summary for manager
+  let summary = "Stale Opportunities Report\n\n";
+  Object.entries(byOwner).forEach(([owner, opps]) => {
+    summary += `${owner}: ${opps.length} stale opportunities\n`;
+    opps.forEach(opp => {
+      summary += `  - ${opp.name} (${opp.stage})\n`;
+    });
+    summary += "\n";
+  });
+
+  return {
+    summary,
+    totalCount: opportunities.length
+  };
+};
+```
+
+### ステップ 6: アラートメールを送信
+
+「**Send Email**」アクションを追加:
+
+| フィールド  | 値                                    |
+| ------ | ------------------------------------ |
+| **宛先** | sales-manager@yourcompany.com        |
+| **件名** | `🚨 要対応の停滞商談が {{code.totalCount}} 件` |
+| **本文** | `{{code.summary}}`                   |
+
+### ステップ 7: テストして有効化
+
+1. ワークフローを実行するには「**Test**」をクリック
+2. メールに正しいデータが含まれていることを確認します
+3. 準備ができたら有効化します
+
+## カスタマイズオプション
+
+### 停滞のしきい値を変更
+
+「**Search Records**」フィルターを編集し、7 日を希望の期間に変更します:
+
+* 高回転の営業には 3 日
+* エンタープライズの商談には 14 日
+* 長いセールスサイクルには 30 日
+
+### 個々の担当者にアラート
+
+マネージャー宛ての 1 通のメールではなく、**Iterator** を使用して、各担当者に自分の停滞中の商談についてのパーソナライズされたメールを送信します。
+
+### エスカレーションを追加
+
+深刻度を段階的に上げた複数のワークフローを作成します:
+
+1. 7 日目: 担当者にメール
+2. 14 日目: 担当者 + マネージャーにメール
+3. 21 日目: マネージャーが介入できるようタスクを作成
+
+### Slack にも通知
+
+メールの代わりに、またはメールに加えて、**HTTP Request** を使用して Slack の Webhook に投稿します。
+
+## 関連
+
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [ワークフローからメールを送信](/l/ja/user-guide/workflows/capabilities/send-emails-from-workflows)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx

@@ -0,0 +1,69 @@
+---
+title: 受信メール数を表示
+description: 各連絡先から受信したメール数を自動的にカウントして表示するワークフローを作成します。
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+<img src="/images/user-guide/workflows/workflow-number-of-emails-received.png" style={{width:'100%'}} />
+
+## 概要
+
+このワークフローは新しいメールを受信するたびにトリガーされ、その送信者からのメールの合計数で Person レコード上のカスタムフィールドを更新します。
+
+## 前提条件
+
+このワークフローを設定する前に、**People** オブジェクトにカスタムフィールドを作成します:
+
+1. 「**設定 → データモデル → People**」に移動します
+2. 新しい **Number** フィールドを追加します
+3. 「この人物から受信したメール数」などの名前を付けます
+
+## ステップバイステップの設定
+
+<VimeoEmbed videoId="1148700336" title="デモ動画" />
+
+### ステップ 1: トリガーを設定
+
+1. 「**Workflows**」に移動し、新しいワークフローを作成します
+2. トリガーとして **Record is Created** を選択します
+3. **Message Participants**（Advanced objects 内にあります）を選択します
+
+<Note>
+Message Participant は、メッセージ ID と person ID の組み合わせで、メッセージごとに一意のレコードを作成します。 これは、送信者（または受信者）のメールアドレスを含む `handle` フィールドにアクセスできるため、Messages を直接扱うよりも追跡が容易です。
+</Note>
+
+### ステップ 2: Role でフィルター
+
+1. 「**Filter**」アクションを追加します
+2. 条件を設定します: **Role** が **FROM** と等しい
+
+これにより、この人物が送信したメッセージのみをカウントし、相手宛てに送られたメッセージは含めないようにします。
+
+### ステップ 3: 同じ Handle を持つすべての Message Participants を検索
+
+1. 「**Search Records**」アクションを追加します
+2. オブジェクトとして **Message Participants** を選択します
+3. フィルターを追加します: **Handle** がトリガーの handle（送信者のメールアドレス）と等しい、かつ **Role** が **FROM** と等しい
+4. **Limit** を 1 から **200**（最大値）に増やします
+
+これにより、このメールアドレスからのすべてのメッセージを見つけ、合計数を取得します。
+
+<Note>
+Search Records アクションは、返せるレコードが最大 200 件に制限されています。 ただし、個々のレコードではなく `totalCount` の値のみを使用するため、このステップではこの人物が送信したメールの総数が返されます。
+</Note>
+
+### ステップ 4: Create or Update Record アクションで Person レコードを更新
+
+1. 「**Create or Update Record**」アクションを追加します
+2. オブジェクトとして **People** を選択します
+3. Message Participant の `handle` とメールアドレスを照合して該当の人物を特定します
+4. カスタムの「受信メール数」フィールドを `{{searchRecords.totalCount}}` に設定します
+
+Search Records アクションの `totalCount` の値は、この人物から受信したメールの総数を表します。
+
+## 関連
+
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [カスタムフィールドの作成方法](/l/ja/user-guide/data-model/how-tos/customize-your-data-model)
+* [Search Records アクション](/l/ja/user-guide/workflows/capabilities/workflow-actions#search-records)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/display-related-record-data.mdx

@@ -0,0 +1,170 @@
+---
+title: 関連レコードのデータを表示
+description: ワークフローを使用して、関連レコードのデータ（例：商談上の会社情報）を表示します。
+---
+
+関連レコードのデータを自分のレコード上に直接表示します — たとえば、会社の従業員数をその会社の商談に表示します。 入れ子フィールドがネイティブに利用可能になるまで、このワークフローによる回避策が役立ちます。
+
+## 一般的な使用例
+
+| ソース | コピー先 | コピーするフィールド     |
+| --- | ---- | -------------- |
+| 会社  | 商談   | 業種、会社規模、ARR    |
+| 人物  | 商談   | メール、電話、役職      |
+| 商談  | 会社   | 直近の商談金額、直近の受注日 |
+
+## 基本的なフィールドのコピー
+
+### 例: 連絡先のメールを商談にコピー
+
+**目標**: 商談で連絡担当者を設定したとき、その人物のメールを商談にコピーして簡単に参照できるようにする。
+
+### 前提条件
+
+ワークフローを作成する前に、**設定 → データモデル → 商談** でコピー先フィールドを作成します:
+
+* 連絡先メール（タイプ: Email）
+* 連絡先電話（タイプ: Phone）
+
+### セットアップ
+
+1. **トリガー**: レコードが更新（商談、連絡担当者フィールド）
+
+2. **フィルター**: 連絡担当者が空でないことを確認
+
+3. **レコード検索**: リンクされた人物を見つける
+   * オブジェクト: People
+   * フィルター: ID が `{{trigger.object.pointOfContact.id}}` に等しい
+
+4. **レコードを更新**:
+   * オブジェクト: Opportunities
+   * レコード: `{{trigger.object.id}}`
+   * 連絡先メール: `{{searchRecords[0].email}}`
+   * 連絡先電話: `{{searchRecords[0].phone}}`
+
+## 複数フィールドのコピー
+
+### 例: 関連するすべての商談に会社情報を同期
+
+**目標**: 会社の詳細が変更されたら、関連するすべての商談を更新する。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新（会社）
+   * フィールド: 業種、会社規模、年間売上高
+
+2. **レコード検索**: この会社のすべての商談を見つける
+   * オブジェクト: Opportunities
+   * フィルター: 会社 ID が `{{trigger.object.id}}` に等しい
+
+3. **イテレーター**: 各商談をループ処理する
+
+4. **レコードを更新** (イテレーター内):
+   * オブジェクト: Opportunities
+   * レコード: `{{iterator.currentItem.id}}`
+   * 会社の業種: `{{trigger.object.industry}}`
+   * 会社規模: `{{trigger.object.companySize}}`
+   * 会社のARR: `{{trigger.object.annualRevenue}}`
+
+## レコード作成時のコピー
+
+### 例: 会社データで商談を事前入力
+
+**目標**: 会社にリンクされた商談を作成するとき、主要な会社情報を自動コピーする。
+
+### 前提条件
+
+**設定 → データモデル → 商談** でコピー先フィールドを作成します:
+
+* 会社の業種（タイプ: Text）
+* 会社規模（タイプ: Number）
+
+### セットアップ
+
+1. **トリガー**: レコードが作成（商談）
+   * フィルター: 会社が空でない
+
+2. **レコード検索**: リンクされた会社の詳細を取得
+   * オブジェクト: Companies
+   * フィルター: ID が `{{trigger.object.company.id}}` に等しい
+
+3. **レコードを更新**:
+   * オブジェクト: Opportunities
+   * レコード: `{{trigger.object.id}}`
+   * 会社の業種: `{{searchRecords[0].industry}}`
+   * 会社規模: `{{searchRecords[0].employees}}`
+
+<Note>
+**タスクとノートの制限**: タスクとノートのリレーションは多対多としてハードコードされており、ワークフローのトリガーやアクションではまだ使用できません。 これらのリレーションにアクセスするには、代わりに[API](/l/ja/developers/extend/api)を使用してください。
+</Note>
+
+## 双方向同期
+
+### 例: 主担当者を同期した状態に保つ
+
+**目標**: 会社の主担当者が変更されたら、その人物を更新する。 人物が主担当者になったときは、会社を更新する。
+
+### ワークフロー 1: 会社 → 人物
+
+1. **トリガー**: レコードが更新（会社、主担当者フィールド）
+2. **レコードを更新**: 人物の "Is Primary Contact" を true に設定
+3. **レコード検索**: 以前の主担当者を見つける
+4. **レコードを更新**: 以前の連絡先の "Is Primary Contact" を false に設定
+
+### ワークフロー 2: 人物 → 会社
+
+1. **トリガー**: レコードが更新（人物、Is Primary Contact = true）
+2. **レコードを更新**: 会社の主担当者をこの人物に設定
+
+<Note>
+無限ループを避けるため、双方向同期の取り扱いには注意してください。 更新前に値が実際に変更されたかを確認するフィルターを使用する。
+</Note>
+
+## コードによる複雑なマッピング
+
+### 例: コピー時にデータを変換
+
+**目標**: 人物から商談へ電話番号をコピーし、フォーマットする。
+
+```javascript
+export const main = async (params) => {
+  const { phone } = params;
+
+  if (!phone) return { formattedPhone: null };
+
+  // Remove non-numeric characters
+  const digits = phone.replace(/\D/g, '');
+
+  // Format as (XXX) XXX-XXXX
+  const formatted = digits.length === 10
+    ? `(${digits.slice(0,3)}) ${digits.slice(3,6)}-${digits.slice(6)}`
+    : phone;
+
+  return { formattedPhone: formatted };
+};
+```
+
+## ベストプラクティス
+
+### ループを回避する
+
+* 互いにトリガーし合って終わらないワークフローを作成しない
+* 特定のフィールド条件を使用する
+* 値が実際に変更されたかを確認するチェックを追加する
+
+### 欠損データの取り扱い
+
+* コピー前に常にソースレコードの存在を確認する
+* 任意フィールドには既定値を用意する
+* ソースフィールドが空の場合はフィルターでスキップする
+
+### パフォーマンス
+
+* 多数のレコードにコピーする場合はバッチ更新を使用する
+* 大規模な同期処理にはスケジュールされたワークフローを使用する
+* 複数レコードの更新にはイテレーターの使用を検討する
+
+## 関連
+
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx

@@ -0,0 +1,202 @@
+---
+title: 数式フィールド
+description: ネイティブ対応が提供されるまで、ワークフローを使って数式フィールドを作成します。
+---
+
+Twenty は現時点でネイティブの数式フィールドをまだサポートしていません（2026 年に提供予定）ですが、ワークフローを使えば同等の結果を実現できます。 この回避策により、単純な連結から複雑なビジネスロジックまで、フィールド値を自動計算して入力できます。
+
+## 一般的な使用例
+
+| ユースケース       | 数式例                          |
+| ------------ | ---------------------------- |
+| **氏名**       | First Name + " " + Last Name |
+| **見込み金額**    | Amount × Probability         |
+| **期日までの日数**  | Due Date - Today             |
+| **ステージ滞在日数** | Today - Stage Entry Date     |
+| **リードスコア**   | 複数の基準に基づくポイント                |
+
+<Tip>
+パイプラインのステージでの時間を追跡する完全な例については、[商談が各ステージにとどまる時間を追跡](/l/ja/user-guide/views-pipelines/how-tos/track-time-in-stage) を参照してください。
+</Tip>
+
+## 基本の式：連結
+
+### 例：氏名を自動入力
+
+**目的**: 名と姓を自動的に結合して氏名フィールドにする。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新または作成される（People）
+
+2. **フィルター**: 名または姓が変更されたかを確認
+
+3. **コードアクション**:
+
+```javascript
+export const main = async (params) => {
+  const { firstName, lastName } = params;
+
+  const fullName = [firstName, lastName]
+    .filter(Boolean)
+    .join(' ');
+
+  return { fullName };
+};
+```
+
+4. **レコードを更新**: 氏名を `{{code.fullName}}` に設定
+
+## 数値の式：見込み金額
+
+### 例：見込み収益を計算
+
+**目的**: 商談金額に確度を掛けて見込み金額を算出する。
+
+ワークフロー全体については、[パイプラインで見込み金額を表示する方法](/l/ja/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline) を参照してください。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新される（Opportunities、Amount または Probability フィールド）
+
+2. **コードアクション**:
+
+```javascript
+export const main = async (params) => {
+  const { amount, probability } = params;
+
+  const expectedAmount = (amount || 0) * (probability || 0) / 100;
+
+  return { expectedAmount };
+};
+```
+
+3. **レコードを更新**: 見込み金額を `{{code.expectedAmount}}` に設定
+
+## 日付の式：日数計算
+
+### 例：タスクの期日までの日数
+
+**目的**: タスクの期日まで残り何日かを計算する。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新または作成される（Tasks、Due Date フィールド）
+
+2. **コードアクション**:
+
+```javascript
+export const main = async (params) => {
+  const { dueDate } = params;
+
+  if (!dueDate) {
+    return { daysUntilDue: null };
+  }
+
+  const due = new Date(dueDate);
+  const today = new Date();
+  const diffTime = due - today;
+  const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+
+  return { daysUntilDue: diffDays };
+};
+```
+
+3. **レコードを更新**: 期日までの日数を `{{code.daysUntilDue}}` に設定
+
+<Note>
+負の値は期限超過のタスクを示します。 このフィールドを使用して、緊急度でタスクをフィルターまたは並べ替えることができます。
+</Note>
+
+## 条件付き式：リードスコア
+
+### 例：条件に基づいてリードスコアを計算
+
+**目的**: 企業規模、業種、エンゲージメントに基づいてリードにスコアを付与する。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新される（People または Companies）
+
+2. **コードアクション**:
+
+```javascript
+export const main = async (params) => {
+  const { companySize, industry, hasEmail, hasPhone, source } = params;
+
+  let score = 0;
+
+  // Company size scoring
+  if (companySize === 'Enterprise') score += 30;
+  else if (companySize === 'Mid-Market') score += 20;
+  else if (companySize === 'SMB') score += 10;
+
+  // Industry scoring
+  const targetIndustries = ['Technology', 'Finance', 'Healthcare'];
+  if (targetIndustries.includes(industry)) score += 25;
+
+  // Contact info scoring
+  if (hasEmail) score += 10;
+  if (hasPhone) score += 15;
+
+  // Source scoring
+  if (source === 'Referral') score += 20;
+  else if (source === 'Website') score += 10;
+
+  return { leadScore: score };
+};
+```
+
+3. **レコードを更新**: リードスコアを `{{code.leadScore}}` に設定
+
+## テキストの式：ドメイン抽出
+
+### 例：メールからドメインを抽出
+
+**目的**: メールのドメインを自動抽出して保存する。
+
+### セットアップ
+
+1. **トリガー**: レコードが更新される（People、Email フィールド）
+
+2. **コードアクション**:
+
+```javascript
+export const main = async (params) => {
+  const { email } = params;
+
+  if (!email) return { domain: null };
+
+  const domain = email.split('@')[1]?.toLowerCase();
+
+  return { domain };
+};
+```
+
+3. **レコードを更新**: ドメインフィールドを `{{code.domain}}` に設定
+
+## ベストプラクティス
+
+### パフォーマンス
+
+* 関連するフィールド変更時のみトリガーする
+* 計算が不要なレコードをスキップするためにフィルターを使用する
+* 大量のワークフローでは複雑な計算を避ける
+
+### エラーハンドリング
+
+* 計算の前に null/undefined の値を確認する
+* データが欠落している場合はデフォルト値を使用する
+* 計算が失敗したときは明確なエラーメッセージを返す
+
+### テスト
+
+* エッジケース（空のフィールド、ゼロ値）でテストする
+* 有効化する前に計算を手動で検証する
+* 意図しない結果がないかワークフローの実行を監視する
+
+## 関連
+
+* [パイプラインで見込み金額を表示する方法](/l/ja/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline)
+* [ステージ内の時間を追跡する方法](/l/ja/user-guide/views-pipelines/how-tos/track-time-in-stage)
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx

@@ -0,0 +1,127 @@
+---
+title: レビュー対象のノートをチームメンバーに通知
+description: ノートのレビュー担当に同僚を割り当てたとき、自動でメール通知を送信します。
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+<Note>
+**ノート内でチームメンバーを直接タグ付けすることはまだサポートされていません。** この機能は 2026 年後半に提供予定です。 当面の間、このワークフローが実用的な回避策となります。
+</Note>
+
+## 課題
+
+ノート内で同僚をタグ付けして、レビュー通知が届くようにしたい。 現時点では、Twenty はノートやタスクでの @メンションをサポートしていません。
+
+## 回避策
+
+ノート本文でのタグ付けの代わりに、次のようにします。
+
+1. Notes オブジェクトに **Reviewer** リレーションフィールドを作成する
+2. ノートの作成または編集時にレビュアーを割り当てる
+3. ワークフローをレビューアに自動的にメールを送信し、ノートへのリンクが付いています。
+
+<Warning>
+**制限**: この方法では、フィールドごとに 1 人のレビュアーしか割り当てられません。 複数人に通知する必要がある場合は、リレーションフィールドを追加で作成します（例: Reviewer 1、Reviewer 2）。 一度に多数のコラボレーターをタグ付けする必要がある場合、拡張性は高くありません。
+</Warning>
+
+## ステップバイステップの設定
+
+### ステップ 1: Reviewer フィールドを作成
+
+<img src="/images/user-guide/workflows/reviewer-field-for-note.png" style={{width:'100%'}} />
+
+1. 「**設定 → データモデル → Notes**」に移動します
+2. **Add Field** をクリック
+3. 設定:
+
+| 設定            | 値                       |
+| ------------- | ----------------------- |
+| **Name**      | Reviewer                |
+| **種類**        | リレーション                  |
+| **関連オブジェクト**  | ワークスペースメンバー             |
+| **リレーションタイプ** | 複数のノート → 1人のワークスペースメンバー |
+
+4. フィールドを保存
+
+### ステップ 2: ワークフローを作成
+
+<VimeoEmbed videoId="1151897168" title="デモ動画" />
+
+#### ワークフローのトリガーを作成
+
+1. メインビューに移動し、新しいワークフローを作成します
+2. トリガーとして **Record Updated** を選択します
+3. オブジェクトとして **Note** を選択し、**Reviewer** フィールドを指定します。
+4. これにより、ノートのレビュアーが更新されるたびにトリガーされます。
+
+#### レビュアーが割り当てられた直後かを確認するフィルターを追加
+
+レビュアーが割り当てられたときのみ続行するように、**フィルター** アクションを追加します:
+
+| 条件           | 値     |
+| ------------ | ----- |
+| **Reviewer** | 空ではない |
+
+#### ワークスペースメンバーを検索
+
+1. 「**Search Records**」アクションを追加します
+2. 「Advanced Objects」内の **Workspace Member** を選択
+3. フィルターを追加:
+
+| 条件     | 値                            |
+| ------ | ---------------------------- |
+| **ID** | が `{{note.reviewerId}}` に等しい |
+
+これにより、メールアドレスや氏名を含むワークスペースメンバーの完全なレコードが取得されます。
+
+#### 通知メールを送信
+
+1. 「**Send Email**」アクションを追加します
+2. 設定:
+
+| フィールド  | 値                                                   |
+| ------ | --------------------------------------------------- |
+| **宛先** | Search Record → First Workspace Member → User Email |
+| **件名** | ノートのレビューをお願いします                                     |
+| **本文** | 下記の例を参照してください                                       |
+
+**メール本文の例:**
+
+```text
+Hi {{searchRecord.firstWorkspaceMember.name.firstName}},
+
+You've been assigned to review a note.
+
+View the note here:
+https://yourSubDomain.twenty.com/object/note/{{recordIsUpdated.id}}
+
+Best,
+Twenty
+```
+
+<Note>
+`yourSubDomain` を実際の Twenty ワークスペースのサブドメインに置き換えてください。
+</Note>
+
+#### テストと有効化
+
+1. ワークフローを手動で実行するには「**Test**」をクリックします
+2. ノートを作成または編集し、レビュアーを割り当てます
+3. レビュアーの受信トレイに通知メールが届いているか確認します
+4. ワークフローを有効化します
+
+## 使用方法
+
+セットアップ後、チームは次の手順でこのワークフローを利用できます。
+
+1. 新しいノートを作成（または既存のノートを編集）
+2. **Reviewer** フィールドで同僚を選択
+3. 同僚に、ノートへの直接リンク付きメールが自動送信されます
+
+## 関連
+
+* [ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)
+* [ワークフローからメールを送信](/l/ja/user-guide/workflows/capabilities/send-emails-from-workflows)
+* [カスタムフィールドの作成方法](/l/ja/user-guide/data-model/how-tos/create-custom-fields)
+* [リレーションフィールドの作成方法](/l/ja/user-guide/data-model/how-tos/create-relation-fields)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/crm-automations/send-email-alerts-with-tasks-due.mdx

@@ -0,0 +1,106 @@
+---
+title: 期限のタスクに関するメールアラートを送信
+description: 差し迫ったタスクや期限超過のタスクについてチームメンバーに自動通知します。
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+<img src="/images/user-guide/workflows/email_tasks_due.png" style={{width:'100%'}} />
+
+本日が期限のタスクについて、各チームメンバーに毎日メールでリマインダーを送信します。
+
+## 概要
+
+このワークフローはスケジュールで実行され、以下を実行します:
+
+1. すべてのワークスペースメンバーを取得
+2. 各メンバーを順に処理
+3. 各メンバーの本日が期限のタスクを検索
+4. 整形し、パーソナライズされたメールを送信
+
+## ステップバイステップの設定
+
+<VimeoEmbed videoId="1147463514" title="デモ動画" />
+
+### ステップ 1: トリガーを設定
+
+1. 「**Settings → Workflows**」に移動し、新しいワークフローを作成します
+2. トリガーとして「**On a Schedule**」を選択します
+3. 毎日 8:00 の cron 式を使用します: `0 8 * * *`
+
+### ステップ 2: すべてのワークスペースメンバーを検索
+
+1. 「**Search Records**」アクションを追加します
+2. 「**Workspace Members**」（advanced objects 内）を選択します
+3. フィルターは不要です—すべてのメンバーが取得されます
+
+### ステップ 3: Iterator を追加
+
+1. 「**Iterator**」アクションを追加します
+2. 入力配列を前のステップのワークスペースメンバーに設定します
+3. Iterator 内のすべてのアクションはメンバーごとに1回実行されます
+
+### ステップ 4: 本日が期限のタスクを検索（Iterator 内）
+
+1. Iterator 内で「**Search Records**」アクションを追加します
+2. オブジェクトとして「**Tasks**」を選択します
+3. フィルターを追加:
+   * **Assignee** = 現在のワークスペースメンバー（Iterator から）
+   * **Due Date** = 今日
+
+### ステップ 5: タスクをメール本文に整形（Iterator 内）
+
+タスクをリンク付きの読みやすいリストに整形するために「**Code**」アクションを追加します:
+
+```javascript
+export const main = async (params: {
+  tasksDue?: Array<{ id: string; title: string }> | null | string;
+}) => {
+  const tasksDue =
+    typeof params.tasksDue === "string"
+      ? JSON.parse(params.tasksDue)
+      : params.tasksDue;
+
+  if (!Array.isArray(tasksDue) || tasksDue.length === 0) {
+    return {
+      formattedTasks: "No tasks due today."
+    };
+  }
+
+  const formattedTasks = tasksDue
+    .map(
+      t =>
+        `${t.title}\nhttps://yourSubDomain.twenty.com/object/task/${t.id}`
+    )
+    .join("\n\n");
+
+  return { formattedTasks };
+};
+```
+
+<Note>
+`yourSubDomain` を実際の Twenty ワークスペースのサブドメインに置き換えてください。
+</Note>
+
+### ステップ 6: メールを送信（Iterator 内）
+
+1. 「**Send Email**」アクションを追加します（引き続き Iterator 内）
+2. 設定:
+
+| フィールド  | 値                                                         |
+| ------ | --------------------------------------------------------- |
+| **宛先** | `{{iterator.currentItem.userEmail}}`（ワークスペースメンバーのメールアドレス） |
+| **件名** | 本日が期限のタスク                                                 |
+| **本文** | `{{code.formattedTasks}}`                                 |
+
+### ステップ 7: テストして有効化
+
+1. ワークフローを手動で実行するには「**Test**」をクリックします
+2. 受信トレイでメールを確認します
+3. ワークフローを有効化します
+
+## 関連
+
+* [ワークフローのアクション](/l/ja/user-guide/workflows/capabilities/workflow-actions)
+* [ワークフローからメールを送信](/l/ja/user-guide/workflows/capabilities/send-emails-from-workflows)
+* [Code アクションで配列を扱う](/l/ja/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions)

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/need-more-help/professional-services.mdx

@@ -0,0 +1,21 @@
+---
+title: プロフェッショナルサービス
+description: Twenty のチームおよび認定パートナーから、複雑なワークフローや自動化の構築に関する専門的な支援を受けましょう。
+---
+
+## いつプロフェッショナルなサポートが必要ですか？
+
+次の用途については、プロフェッショナル サービスの利用をご検討ください:
+
+* 複雑なマルチシステム統合
+* 高度なビジネスロジックと自動化ルール
+* 大規模データ処理ワークフロー
+* カスタムAPIの開発
+* チームのトレーニングとワークフローの最適化
+* 社内リソースがない場合
+
+## サービスの選択肢
+
+### 実装パートナー
+
+認定パートナーと連携して、高度なカスタマイズを行います。 弊社の[導入パートナー](https://twenty.com/partners)とつながるには、[contact@twenty.com](mailto:contact@twenty.com) までお問い合わせください。

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting.mdx

@@ -0,0 +1,170 @@
+---
+title: ワークフロートラブルシューティング
+description: 一般的なワークフローの問題とその解決方法。
+---
+
+## 一般的な問題と解決策
+
+### ワークフローがトリガーされない
+
+**症状**: 期待したタイミングでワークフローが実行されない。
+
+**考えられる原因**:
+
+1. **ワークフローが有効化されていない**: ワークフローが "Draft" ではなく "Active" に設定されていることを確認する
+2. **トリガー条件が満たされていない**: トリガーが想定するイベントに一致しているか確認する
+3. **フィールドが監視対象ではない**: "Record is Updated" トリガーの場合、対象のフィールドが監視されていることを確認する
+4. **権限**: ワークフローを実行する権限があるか確認する
+
+**解決策**:
+
+* ワークフロー一覧でワークフローのステータスを確認する
+* 想定するアクションで実際にトリガーされるかテストする
+* トリガー設定を見直す
+* 権限について管理者に連絡する
+
+### ワークフローが早すぎるタイミングでトリガーされる（フィールドが空）
+
+**症状**: UI でレコードを手動作成すると、すべてのフィールドを入力する前にワークフローがトリガーされる。 フィールド値がほぼ空の状態でワークフローが実行されてしまう。
+
+**原因**: Twenty はすべてをリアルタイムで保存します — つまり、"edit" と "read" の別モードはありません。 レコードを作成すると即時に保存され、追加のフィールドを入力する前に "Record is created" イベントがトリガーされます。
+
+**"Record is created" が有効に機能するケース**:
+
+* API 呼び出しで作成されたレコード（1 回のリクエストでフィールドが入力される）
+* インポートで作成されたレコード
+* 他のワークフローからの自動レコード作成
+
+**解決策**: UI で手動作成したレコードには、トリガーとして **"Record is created or updated"** を使用する。 このようにすることで:
+
+* ユーザーが入力を完了しフィールドを保存した後にワークフローがトリガーされる
+* 空の値ではなく完全なデータを取得できる
+
+<Tip>
+ワークフローをレコードごとに 1 回だけ実行したい場合は、`createdAt equals updatedAt`（初回保存）などのフィールドを確認するために Filter アクションを追加するか、ワークフローがすでに実行されたかを追跡するカスタムのチェックボックスフィールドを使用する。
+</Tip>
+
+### アクションの失敗
+
+**症状**: ワークフローは実行されるが、一部のアクションが失敗する。
+
+**考えられる原因**:
+
+1. **データ不足**: 必須フィールドが空である
+2. **無効な参照**: 以前のステップの変数が存在しない
+3. **API エラー**: 外部サービスがエラーを返している
+4. **権限の問題**: アクションの実行に必要な権限が不足している
+
+**解決策**:
+
+* ワークフローの実行詳細でエラーメッセージを確認する
+* すべての必須フィールドに値が入っていることを確認する
+* API 接続を個別にテストする
+* ロール権限を見直す
+
+### HTTP リクエストのエラー
+
+**症状**: HTTP Request アクションが失敗する、または想定外の結果を返す。
+
+**一般的なエラーコード**:
+
+* **400**: 不正なリクエスト - リクエストボディの形式を確認する
+* **401**: 認証エラー - API キーを確認する
+* **403**: アクセス拒否 - API の権限を確認する
+* **404**: 見つかりません - エンドポイントURLを確認する
+* **429**: リクエスト過多 - レート制限を実装する
+* **500**: サーバーエラー - 外部サービス側の問題
+
+**解決策**:
+
+* APIエンドポイントURLを確認する
+* 認証ヘッダーを確認する
+* まず Twenty の外で API 呼び出しをテストする
+* Code アクションでエラーハンドリングを追加する
+
+### Code アクションのエラー
+
+**症状**: JavaScript コードが実行に失敗する。
+
+**一般的な問題**:
+
+1. **構文エラー**: タイプミスまたは無効な JavaScript
+2. **未定義の変数**: 存在しない変数を参照している
+3. **型エラー**: 不適切なデータ型に対する操作
+4. **タイムアウト**: コードの実行に時間がかかりすぎている
+
+**解決策**:
+
+* 組み込みのコードエディタの検証機能を使用する
+* まず JavaScript コンソールでコードロジックをテストする
+* デバッグのために console.log を追加する
+* 複雑な処理を簡素化する
+
+### メールが送信されない
+
+**症状**: Send Email アクションでメールが配信されない。
+
+**考えられる原因**:
+
+1. **メールアカウントが未接続**: Settings → Accounts を確認する
+2. **無効なメールアドレス**: 受信者のメールアドレスの形式が正しくない
+3. **送信制限**: メールプロバイダのレート制限に達している
+4. **スパムフィルター**: メールがブロックされている
+
+**解決策**:
+
+* メールアカウントの接続を確認する
+* 受信者のメールアドレスを検証する
+* メールプロバイダの制限を確認する
+* スパム判定される可能性があるメール内容を見直す
+
+## ワークフローのデバッグ
+
+### ワークフロー実行の活用
+
+1. ワークフローエディタに移動する
+2. **Runs** パネルを開く
+3. 失敗した実行を探す
+4. クリックしてステップごとの詳細を表示する
+5. エラーメッセージと出力データを確認する
+
+### 個別ステップのテスト
+
+1. Code アクションでは **Test** ボタンを使用する
+2. HTTP リクエストでは、エンドポイントを個別にテストする
+3. ワークフローをトリガーするテスト用レコードを作成する
+4. 制御されたテストには手動トリガーを使用する
+
+### 一般的なデバッグパターン
+
+**ロギングを追加**:
+デバッグのために中間値をログ出力する Code アクションを使用する。
+
+**ステップを分離**:
+失敗箇所を特定するため、各ステップを個別にテストする。
+
+**データフローを確認**:
+各ステップが期待どおりの入力データを受け取っていることを確認する。
+
+## 問題を避けるためのベストプラクティス
+
+### 有効化前
+
+* ドラフトモードで十分にテストする
+* すべての API 接続を検証する
+* トリガー条件を丁寧に見直す
+* 想定される動作を文書化する
+
+### 開発中
+
+* 説明的なステップ名を使用する
+* Code アクションにコメントを追加する
+* 実データに近いデータでテストする
+* エッジケースを想定して計画する
+
+### 有効化後
+
+* 初期の実行を綿密に監視する
+* 失敗時のアラートを設定する
+* 実行履歴を定期的に見直す
+* 可能な限りワークフローをシンプルに保つ

packages/twenty-docs/l/ja/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx

@@ -0,0 +1,236 @@
+---
+title: ワークフローに関するFAQ
+description: Twenty のワークフローに関するよくある質問。
+---
+
+<AccordionGroup>
+
+  <Accordion title="なぜワークフローを有効化できないのですか？">
+    これは権限の問題である可能性が高いです。 ワークフローを作成して有効化するには、ワークフローへのアクセス権が必要です。
+
+    **解決策**：**Settings → Members → Roles** でワークフローへのアクセス権を付与してもらうよう、ワークスペース管理者に連絡してください。
+
+    サイドバーにワークフローセクションがまったく表示されない場合、権限の問題であることが確認できます。
+  </Accordion>
+
+  <Accordion title="上部のナビバーに手動ワークフローのボタンが表示されないのはなぜですか？">
+    手動ワークフローは、適切に設定されている場合にのみナビバーに表示されます:
+
+    1. ワークフローが**アクティブ**（ドラフトモードではない）である必要があります
+    2. ナビバーの配置は**Pinned**に設定する必要があります
+    3. Single/Bulk トリガーの場合、正しいオブジェクトのページを表示している必要があります
+
+    **確認方法**：ワークフローを開く → トリガーをクリック → "Navbar placement" が "Pinned" に設定されていることを確認します。
+
+    ナビバーの設定に関係なく、**Cmd + K**（または **Ctrl + K**）で手動ワークフローに常にアクセスできます。
+  </Accordion>
+
+  <Accordion title="Single、Global、Bulk の手動トリガーの違いは何ですか？">
+    | タイプ | 必要なレコード | ワークフロー実行 |
+    | --- | ------- | -------- |
+    \| **Global** | なし | 1回、レコード入力なし |
+    \| **Single** | 1件以上を選択 | 選択した各レコードごとに1回 |
+    \| **Bulk** | 1件以上を選択 | 1回、すべてのレコードを配列として |
+
+    * **Global**：ワークフローがレコードのコンテキストを必要としない場合に使用します（例：レポートの生成）
+    * **Single**：選択した各レコードを個別に処理したい場合に使用します（例：個別メールの送信）
+    * **Bulk**：レコードをまとめて処理する必要がある場合、またはクレジットの使用を最適化したい場合に使用します（Iterator アクションが必要）
+
+    詳細は[ワークフローのトリガー](/l/ja/user-guide/workflows/capabilities/workflow-triggers)を参照してください。
+  </Accordion>
+
+  <Accordion title="If/Else ノードが見つかりません。 どうすればよいですか？">
+    明示的な If/Else ノードはまだ利用できませんが、ロードマップに含まれています。
+
+    **現在の回避策**：ステップから複数のブランチを作成し、それぞれを **Filter** アクションで開始します:
+
+    ```
+    Step 1
+       │
+       ├── Branch A: Filter (condition = true) → Actions...
+       │
+       └── Branch B: Filter (condition = false) → Actions...
+    ```
+
+    フィルター条件を満たしたブランチのみが、その後のアクションを実行します。
+
+    手順については[ブランチの使い方](/l/ja/user-guide/workflows/capabilities/workflow-branches)を参照してください。
+  </Accordion>
+
+  <Accordion title="ワークフローのブランチは並行実行されますか？">
+    **はい**、ブランチは既定で並行実行されます。
+
+    どちらか一方のブランチのみを実行したい場合：
+    * 各ブランチの先頭に **Filter** アクションを追加します
+    * 互いに排他的な条件を設定します（例：ブランチA：status = "Open"、ブランチB：status ≠ "Open"）
+
+    フィルター条件を満たさないブランチは実行を停止し、他のブランチは継続します。
+  </Accordion>
+
+  <Accordion title="ブランチを再び結合できますか？">
+    **はい**。 並行ブランチの実行が完了した後、両方のブランチが接続するステップを追加できます。
+
+    ワークフローエディタで:
+    1. 分岐したアクションを完了する
+    2. ブランチの後に新しいステップを追加する
+    3. 各ブランチの終端からこの新しいステップに接続をドラッグする
+
+    すべての接続されたブランチが完了すると、マージされたステップが実行されます。
+  </Accordion>
+
+  <Accordion title="Search Records の結果の上限はどれくらいですか？">
+    **Search Records は最大 200 件のレコードを返します。**
+
+    より多くを処理する必要がある場合：
+    * 結果を絞り込むために、より具体的なフィルターを追加する
+    * スケジュールされたワークフローを使用してバッチ処理する
+    * 一括処理には API の使用を検討する
+
+    ほとんどのワークフローでは、200 件のレコードで十分です。 この上限に頻繁に達する場合は、自動化の構成を見直すことを検討してください。
+  </Accordion>
+
+  <Accordion title="ワークフローのメールで CC を追加できますか？">
+    **まだできません。** Send Email アクションでの CC と BCC フィールドはロードマップにあります。
+
+    **現在の回避策**：追加の受信者に送信するために複数の Send Email アクションを追加するか、CC に対応した外部のメールサービス経由で送信するために HTTP Request を使用します。
+  </Accordion>
+
+  <Accordion title="前のステップの出力はどのように使用しますか？">
+    各アクションは、後続のステップで使用できる出力データを生成します。
+
+    **前のステップのデータを参照するには**：
+    * フィールドを設定する際に変数ピッカーを使用する
+    * または `{{stepName.fieldName}}` を直接入力する
+
+    **例**:
+    * トリガーデータ：`{{trigger.object.email}}`
+    * 検索結果：`{{searchRecords[0].name}}`
+    * コードの出力：`{{code.calculatedValue}}`
+
+    アクション設定内の任意のフィールドにカーソルを合わせると、前のステップから利用できる変数が表示されます。
+  </Accordion>
+
+  <Accordion title="Iterator が失敗するのはなぜですか？">
+    **Iterator は配列入力が必要です。** よくある問題：
+
+    1. **入力が配列ではない**：Search Records など配列を返すアクションの結果を渡していることを確認してください
+    2. **配列が空**：Iterator の前にフィルターを追加し、`{{searchRecords.length}} > 0` を確認してください
+    3. **誤った変数を選択**：単一レコードではなく、配列そのものを選択していることを確認してください
+
+    **正しい設定**：
+    1. Search Records（配列を返す）
+    2. Filter：length > 0
+    3. Iterator：`{{searchRecords}}` を選択
+    4. Iterator 内のアクションでは `{{iterator.currentItem.fieldName}}` を使用する
+  </Accordion>
+
+  <Accordion title="Code アクションの最大実行時間はどれくらいですか？">
+    Code アクション（ロジック関数）の**既定のタイムアウトは 5 分**（300 秒）です。
+
+    設定可能な最大タイムアウトは**15 分**（900 秒）です。
+
+    コードがこの制限を超えると、アクションはタイムアウトエラーで失敗します。
+
+    **タイムアウトを回避するためのヒント**：
+    * 大きな処理は Iterator を使用して小さなチャンクに分割する
+    * 重い計算は避け、集中的な処理が必要な場合は HTTP Request を介して外部サービスを使用する
+    * コードを最適化して実行時間を短縮する
+    * より長時間の処理が必要な場合は、データをバッチ処理するスケジュールされたワークフローの使用を検討する
+  </Accordion>
+
+  <Accordion title="ワークフロー実行履歴はどのように確認しますか？">
+    ワークフローの実行履歴は、実行の経過を表示し、問題のデバッグに役立ちます。
+
+    **アクセス方法**：
+    * ワークフローエディタ → 右側の **Runs** パネル
+    * またはサイドバーの **Workflow Runs** に移動
+
+    **実行の見方**：
+    * **ステータス**：Running、Completed、Failed、Waiting
+    * **ステップ**：どのステップが実行され、どのような出力だったかを確認
+    * **エラー**：失敗したステップをクリックしてエラーメッセージを確認
+    * **データ**：各ステップの入力/出力データを表示
+
+    詳細は[ワークフローの実行](/l/ja/user-guide/workflows/capabilities/workflow-runs)を参照してください。
+  </Accordion>
+
+  <Accordion title="ワークフローの実行が表示されないのはなぜですか？">
+    ワークフローの実行が、レート制限により即時に失敗している可能性があります。 Twenty では、ワークスペースあたり 1 時間に 5,000 回の実行というハードリミットが適用されます。
+
+    この制限を超えると、ワークフローは即座に失敗としてマークされ、実行リストに表示されなくなります。
+
+    **この制限に達しがちな一般的なケース**：
+    * Single の手動トリガーで 5,000 件を超えるレコードを選択すること
+    * ワークスペース全体で同時に複数のワークフローが実行されていること
+    * 高頻度の自動トリガー（例：更新頻度の高いオブジェクトでの Record Updated）
+
+    **解決策**:
+    * 多数のレコードを 1 回の実行で処理するには、Single ではなく**Bulk** トリガーを使用する
+    * 大規模なバッチ処理の間隔を空ける
+    * フィルターを使用してトリガーの頻度を下げる
+    * 負荷の高いワークフローを閑散時間帯にスケジュールする
+  </Accordion>
+
+  <Accordion title="ワークフローのレート制限は何ですか？">
+    Twenty では、システムの安定性を確保するため 2 種類のレート制限があります：
+
+    | 制限 | 値 | 動作 |
+    | -- | - | -- |
+    \| **Soft limit** | 1 分あたり 100 実行 | "Not Started" ステータスでキューに入り、徐々に処理される |
+    \| **Hard limit** | 1 時間あたり 5,000 実行 | 実行は即時に失敗する |
+
+    **ソフトリミット（100/分）**：ワークフローは失敗しません。キューで待機し、時間をかけて処理されます。 100 件を超えるレコードをトリガーしても構いませんが、実行は遅くなります。
+
+    **ハードリミット（5,000/時）**：これはワークスペース全体に適用されます。 すべてのワークフローの合計が 1 時間に 5,000 回の実行を超えると、追加の実行は即時に失敗します。
+
+    **制限内に収めるためのヒント**：
+    * 大規模バッチには Single トリガーではなく、Iterator と併用した Bulk トリガーを使用する
+    * 関連する自動化をまとめて、ワークフローの数を減らす
+    * スケジュールされたワークフローを使用して負荷を時間的に分散する
+  </Accordion>
+
+  <Accordion title="失敗したワークフロー実行を再試行できますか？">
+    **いいえ、現時点では自動再試行機能はありません。**
+
+    ワークフロー実行が失敗した場合は、次を行います：
+    1. **Settings → Workflows → [Your Workflow] → Runs** でエラーを確認する
+    2. 問題を修正する（データ、設定、または外部サービス）
+    3. 影響を受けたレコードに対して、ワークフローを手動で再度トリガーする
+
+    **失敗を減らすためのヒント**：
+    * アクションの前にデータを検証するため、**Filter** ノードを追加する
+    * **Search Records** を使用して、関連レコードが存在するか確認する
+    * 一括処理の前に、少数のレコードで十分にテストする
+
+    自動再試行機能は、今後のリリースに向けたロードマップに含まれています。
+  </Accordion>
+
+  <Accordion title="CSV インポートの前にワークフローを無効化すべきですか？">
+    **はい。ワークフローがレコードの作成または更新でトリガーされる場合は無効化してください。**
+
+    CSV でデータをインポートすると、作成または更新された各レコードがワークフローをトリガーする可能性があります。 大規模なインポート（数千件のレコード）は次の事態を招く可能性があります：
+    * 5,000 実行/時の制限に達する
+    * ワークフロークレジットを大量に消費する
+    * 想定外のメールや通知を送信する
+    * 重複するタスクやレコードを作成する
+
+    **一括インポートの前に**：
+    1. **Settings → Workflows** に移動する
+    2. インポート対象のオブジェクトでトリガーされるワークフローを特定する
+    3. 一時的に**無効化**する
+    4. CSV インポートを実行する
+    5. 完了したらワークフローを**再有効化**する
+
+    **代替案**：インポートしたデータでワークフローを実行する必要がある場合は、レート制限内に収めるため小さなバッチでインポートします。
+  </Accordion>
+
+  <Accordion title="ワークフローのレイアウトを整えるにはどうすればよいですか？">
+    ワークフローのキャンバスでノードが散らばって見づらい場合、自動的に整理できます：
+
+    1. ワークフローのキャンバス上の任意の場所を右クリックする
+    2. **Tidy up workflow** をクリックする
+
+    これにより、すべてのノードが自動的に整理され、見やすいレイアウトに再配置されます。
+  </Accordion>
+
+</AccordionGroup>