---
title: Typeform
description: Typeformとの連携
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="typeform"
  color="#262627"
/>

{/* MANUAL-CONTENT-START:intro */}
[Typeform](https://www.typeform.com/)は、会話形式のフォーム、アンケート、クイズを作成するためのユーザーフレンドリーなプラットフォームで、魅力的なユーザー体験に重点を置いています。

Typeformでできること：

- **インタラクティブなフォームの作成**：一度に一つの質問を表示するユニークなインターフェースで、回答者を引き込む美しい会話形式のフォームをデザイン
- **体験のカスタマイズ**：条件分岐ロジック、非表示フィールド、カスタムテーマを使用してパーソナライズされたユーザージャーニーを作成
- **他のツールとの連携**：ネイティブ統合とAPIを通じて1000以上のアプリと接続
- **回答データの分析**：包括的な分析とレポートツールを通じて実用的な洞察を取得

Simでは、Typeform統合によりエージェントがワークフローの一部としてTypeformデータをプログラム的に操作できるようになります。エージェントはフォームの回答を取得し、送信データを処理し、ユーザーフィードバックを意思決定プロセスに直接組み込むことができます。この統合は、リード資格評価、顧客フィードバック分析、データ駆動型のパーソナライゼーションなどのシナリオに特に価値があります。SimとTypeformを接続することで、フォームの回答を実用的な洞察に変換するインテリジェントな自動化ワークフローを作成できます - 感情分析、フィードバックの分類、要約の生成、さらには特定の回答パターンに基づくフォローアップアクションのトリガーなどが可能です。
{/* MANUAL-CONTENT-END */}

## 使用方法

Typeformをワークフローにインテグレーションします。回答の取得、ファイルのダウンロード、フォームのインサイトの取得が可能です。フォームが送信されたときにワークフローをトリガーするトリガーモードで使用できます。APIキーが必要です。

## ツール

### `typeform_responses`

Typeformからフォームの回答を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | はい | Typeformフォームのid |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `pageSize` | number | いいえ | 取得する回答の数（デフォルト：25） |
| `since` | string | いいえ | この日付以降に送信された回答を取得（ISO 8601形式） |
| `until` | string | いいえ | この日付以前に送信された回答を取得（ISO 8601形式） |
| `completed` | string | いいえ | 完了ステータスによるフィルタリング（true/false） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `total_items` | number | 回答の総数 |
| `page_count` | number | 利用可能なページの総数 |
| `items` | array | response_id、submitted_at、answers、およびmetadataを含む回答オブジェクトの配列 |

### `typeform_files`

Typeformレスポンスでアップロードされたファイルをダウンロードする

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | はい | TypeformフォームID |
| `responseId` | string | はい | ファイルを含むレスポンスID |
| `fieldId` | string | はい | ファイルアップロードフィールドの一意のID |
| `filename` | string | はい | アップロードされたファイルのファイル名 |
| `inline` | boolean | いいえ | インラインContent-Dispositionでファイルをリクエストするかどうか |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `fileUrl` | string | アップロードされたファイルの直接ダウンロードURL |
| `contentType` | string | アップロードされたファイルのMIMEタイプ |
| `filename` | string | アップロードされたファイルの元のファイル名 |

### `typeform_insights`

Typeformフォームのインサイトと分析を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | はい | TypeformフォームID |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `fields` | array | このフィールドで離脱したユーザー数 |

### `typeform_list_forms`

Typeformアカウント内のすべてのフォームのリストを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `search` | string | いいえ | タイトルでフォームをフィルタリングする検索クエリ |
| `page` | number | いいえ | ページ番号（デフォルト：1） |
| `pageSize` | number | いいえ | ページあたりのフォーム数（デフォルト：10、最大：200） |
| `workspaceId` | string | いいえ | ワークスペースIDでフォームをフィルタリング |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `total_items` | number | アカウント内のフォームの総数 |
| `page_count` | number | 利用可能なページの総数 |
| `items` | array | id、title、created_at、last_updated_at、settings、theme、および_linksを含むフォームオブジェクトの配列 |

### `typeform_get_form`

特定のフォームの完全な詳細と構造を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `formId` | string | はい | フォームの一意の識別子 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | フォームの一意識別子 |
| `title` | string | フォームのタイトル |
| `type` | string | フォームのタイプ（form、quizなど） |
| `settings` | object | 言語、プログレスバーなどを含むフォーム設定 |
| `theme` | object | テーマ参照 |
| `workspace` | object | ワークスペース参照 |
| `fields` | array | フォームフィールド/質問の配列 |
| `welcome_screens` | array | ウェルカム画面の配列（設定されていない場合は空） |
| `thankyou_screens` | array | サンキュー画面の配列 |
| `created_at` | string | フォーム作成タイムスタンプ（ISO 8601形式） |
| `last_updated_at` | string | フォーム最終更新タイムスタンプ（ISO 8601形式） |
| `published_at` | string | フォーム公開タイムスタンプ（ISO 8601形式） |
| `_links` | object | 公開フォームURLを含む関連リソースリンク |

### `typeform_create_form`

フィールドと設定を含む新しいフォームを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `title` | string | はい | フォームのタイトル |
| `type` | string | いいえ | フォームのタイプ（デフォルト："form"）。オプション："form"、"quiz" |
| `workspaceId` | string | いいえ | フォームを作成するワークスペースID |
| `fields` | json | いいえ | フォーム構造を定義するフィールドオブジェクトの配列。各フィールドには、type、title、およびオプションのプロパティ/検証が必要 |
| `settings` | json | いいえ | フォーム設定オブジェクト（言語、progress_barなど） |
| `themeId` | string | いいえ | フォームに適用するテーマID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `id` | string | 作成されたフォームの一意識別子 |
| `title` | string | フォームのタイトル |
| `type` | string | フォームのタイプ |
| `settings` | object | フォーム設定オブジェクト |
| `theme` | object | テーマ参照 |
| `workspace` | object | ワークスペース参照 |
| `fields` | array | 作成されたフォームフィールドの配列（追加されていない場合は空） |
| `welcome_screens` | array | ウェルカム画面の配列（設定されていない場合は空） |
| `thankyou_screens` | array | サンキュー画面の配列 |
| `_links` | object | 公開フォームURLを含む関連リソースリンク |

### `typeform_update_form`

JSON Patchオペレーションを使用して既存のフォームを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `formId` | string | はい | 更新するフォームの一意の識別子 |
| `operations` | json | はい | JSON Patchオペレーションの配列（RFC 6902）。各オペレーションには：op（add/remove/replace）、path、および値（add/replaceの場合）が必要 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功確認メッセージ |

### `typeform_delete_form`

フォームとそのすべての回答を完全に削除する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Typeformパーソナルアクセストークン |
| `formId` | string | はい | 削除するフォームの一意の識別子 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `deleted` | boolean | フォームが正常に削除されたかどうか |
| `message` | string | 削除確認メッセージ |
