アクションフローでのAirtableアクションの使い方

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

要約：◀▼

Airtableをアクションフローに接続することで、レコードの作成、更新、削除、検索などのタスクを自動化できます。認証には個人用アクセストークンを、セキュリティの確保には専用のサービスアカウントを使用します。利用可能なアクションには、一括処理、コメントの追加、テーブルスキーマの取得などがあり、Airtableのデータ管理をワークフローに直接統合することで、コラボレーションとデータ処理の効率化を図ることができます。

アクションビルダーをAirtableなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskと外部システムを連携させることができます。これにより、コラボレーションを強化し、複数のプラットフォームにまたがってシームレスなエクスペリエンスを維持できます。

メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

アクションビルダーをAirtableに接続する
アクションフローでのAirtableアクションの使い方

アクションビルダーをAirtableに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。

アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。

個人用アクセストークンを作成するには

Airtableコネクションの認証には、個人用アクセストークン（PAT）が必要です。詳細については、Airtableのドキュメントを参照してください。

https://airtable.com/create/tokens で個人用アクセストークンを作成します。
使用するベースへのアクセス権をトークンに付与します。
トークンに、data.records:read, data.records:write, data.recordComments:read, data.recordComments:write,schema.bases:read への各スコープが含まれていることを確認します。
トークンを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。
このキーは、アクションビルダーをAirtableに接続する際に必要になります。

アクションビルダーをAirtableに接続するには

管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
アクションフローを新規作成するか、既存のアクションフローを編集します。
ステップサイドバーを開きます。
「外部アクション」セクションで、「Airtable」をクリックします。
「接続」をクリックします。
Airtableの指示に従って、Airtableのアクセストークンを入力し、接続を完了します。
メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびAirtableで利用可能なアクションが表示されます。

アクションフローでのAirtableアクションの使い方

以下のAirtableアクションを使用できます。

レコードを作成
レコードを更新
レコードを削除
レコードを参照
レコードを検索
コメントを参照
レコードを一括作成
レコードを一括削除
レコードにコメントを追加
テーブルスキーマを参照

レコードを作成する

「レコードを作成」アクションを使用して、Airtableテーブルに新しいレコードを作成します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Base ID`、`Table name`、`Record fields`（またはテーブル固有の動的フィールド） Base IDは「app」で始まり（例：appAbCd1234EfGhIj）、AirtableのURLで確認できます。 Table nameには、テーブル名（例：Contacts）または「tbl」で始まるテーブルIDを指定できます。ベースとテーブルを選択すると、そのテーブル固有のフィールドが動的に読み込まれる。Record fieldsは「FieldName:Value, Field2:Value2」の形式で指定します。配列の値はセミコロン（;）で区切ります（例：Tags: tag1; tag2）。
出力	レコードの詳細：「ok」ステータス、baseId、tableName、およびレコードオブジェクト（id、createdTime、fieldsを含む）など。

必須：Base ID、

Table
                                            name

、Record fields（またはテーブル固有の動的フィールド）

Base IDは「app」で始まり（例：appAbCd1234EfGhIj）、AirtableのURLで確認できます。

Table nameには、テーブル名（例：Contacts）または「tbl」で始まるテーブルIDを指定できます。

ベースとテーブルを選択すると、そのテーブル固有のフィールドが動的に読み込まれる。Record fieldsは「FieldName:Value, Field2:Value2」の形式で指定します。配列の値はセミコロン（;）で区切ります（例：Tags: tag1; tag2）。

出力レコードの詳細：「ok」ステータス、baseId、tableName、およびレコードオブジェクト（id、createdTime、fieldsを含む）など。

レコードを更新する

「レコードを更新」アクションを使用して、Airtableテーブル内の既存のレコードを編集します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Base ID`、`Table name`、`Record ID`、`Record fields`（またはテーブル固有の動的フィールド）先頭に「rec」が付いたRecord ID（例：recAbCd1234EfGhIj）。ベースとテーブルを選択すると、そのテーブル固有のフィールドが動的に読み込まれる。更新するフィールドの値のみ入力する。指定しなかったフィールドの既存の値は変更されない。
出力	レコードの詳細：「ok」ステータス、baseId、tableName、およびレコードオブジェクト（idとupdated fieldsを含む）など。

必須：Base ID、

Table
                                            name

、Record ID、Record fields（またはテーブル固有の動的フィールド）

先頭に「rec」が付いたRecord ID（例：recAbCd1234EfGhIj）。

ベースとテーブルを選択すると、そのテーブル固有のフィールドが動的に読み込まれる。更新するフィールドの値のみ入力する。指定しなかったフィールドの既存の値は変更されない。

出力レコードの詳細：「ok」ステータス、baseId、tableName、およびレコードオブジェクト（idとupdated fieldsを含む）など。

レコードを削除する

「レコードを削除」アクションを使用して、特定のレコードをAirtableテーブルから完全に削除します。

重要：この操作を行うと、レコードが完全に削除され、元に戻すことはできません。慎重に使用してください。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table name`、`Record ID`
出力	削除の詳細：「OK」ステータス、baseId、tableName、削除確認、レコードIDなど。

レコードを参照する

「レコードを参照」アクションを使用して、レコードIDを指定し、Airtableテーブルからレコードを取得します。このアクションを使用して、特定のレコードに関する詳細情報（すべてのフィールド値を含む）を取得します。出力スキーマは、テーブルの実際のフィールド構造を動的に反映します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table name`、`Record ID`
出力	レコードの詳細：「ok」ステータス、baseId、tableId、tableName、およびレコードオブジェクト（id、createdTime、値のあるfieldsを含む）など。

レコードを検索する

「レコードを検索」アクションを使用して、フィルター、並べ替え、ページネーションによってテーブル内のレコードを検索します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Base`、`Table` オプション：`Filter by formula`、`View`、`Sort field`、`Sort direction`、`Max records`、`Page size`、`Offset`、`Return fields by field ID` 「Filter by formula」では、Airtableの数式構文（例：「{Name} = 'John'」）が使用される。「View」は、結果を特定のビューに限定する。「Sort direction」には「Ascending」または「Descending」を指定します。「Page size」の最大値は100。応答内の「Offset」値を使用して、検索結果の次のページを取得する。「Return fields by field ID」では、出力にフィールド名とフィールドIDのどちらを使用するかを指定します。
出力	レコードの配列：「ok」ステータス、baseId、tableId、tableName、レコード（各レコードにID、createdTime、およびフィールドを含む）、およびページネーションのオフセットなど。

必須：Base、Table

オプション：Filter by formula、View、Sort field、Sort direction、Max records、Page size、Offset、Return fields by field ID

「Filter by formula」では、Airtableの数式構文（例：「{Name} = 'John'」）が使用される。「View」は、結果を特定のビューに限定する。「Sort direction」には「Ascending」または「Descending」を指定します。「Page size」の最大値は100。応答内の「Offset」値を使用して、検索結果の次のページを取得する。「Return fields by field ID」では、出力にフィールド名とフィールドIDのどちらを使用するかを指定します。

出力レコードの配列：「ok」ステータス、baseId、tableId、tableName、レコード（各レコードにID、createdTime、およびフィールドを含む）、およびページネーションのオフセットなど。

コメントを参照する

「コメントを参照」アクションを使用して、Airtableのレコードに関するすべてのコメントを取得します。

このアクションには以下の入力と出力が含まれます。

変数

入力

	変数
入力	必須：`Base ID`、`Table name`、`Record ID` オプション：`Page size`、`Offset` 「Page size」は、1回のリクエストごとに返すコメントの数を指定する（1～100、デフォルトは100）。応答内の「Offset」値を使用して、コメントの次のページを取得する。Offsetが空文字列の場合、取得できる次のページがないことを示します。
出力	コメントの配列：ok status、baseId、tableName、recordId、コメント（各コメントにid、text、createdTime、lastUpdatedTime、および作成者の詳細を含む）、およびページネーションのオフセットなど。

必須：Base ID、

Table
                                            name

、Record ID

オプション：Page size、Offset

「Page size」は、1回のリクエストごとに返すコメントの数を指定する（1～100、デフォルトは100）。応答内の「Offset」値を使用して、コメントの次のページを取得する。Offsetが空文字列の場合、取得できる次のページがないことを示します。

出力コメントの配列：ok status、baseId、tableName、recordId、コメント（各コメントにid、text、createdTime、lastUpdatedTime、および作成者の詳細を含む）、およびページネーションのオフセットなど。

レコードを一括作成する

「レコードを一括作成」アクションを使用して、一度に複数のレコードをAirtableテーブルに作成します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table name`、`Records` 複数のレコードを「FieldName:Value, Field2:Value2」という形式で記述し、各レコードを「---」（ダッシュ3つ）で区切る。例："Name:John Doe, Status:Active\n---\nName:Jane Smith, Status:Done"。これは、データを一括インポートする場合に便利です。
出力	レコード配列：ok status、baseId、tableName、および作成されたレコードの配列（各レコードにidとcreatedTimeを含む）など。

レコードを一括削除する

「レコードを一括削除」アクションを使用して、一度に複数のレコードをAirtableテーブルから削除します。この操作は、一括でのクリーンアップ作業に役立ちます。

重要：この操作を行うと、指定したすべてのレコードが完全に削除され、元に戻すことはできません。慎重に使用してください。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table name`、`Record IDs` レコードIDは、カンマ区切りまたは1行に1つの形式で指定できます（例：recAbCd123, recEfGh456, recIjKl789）。
出力	レコード配列：ok status、baseId、tableName、およびレコードの配列（各レコードにidと削除確認を含む）など。

レコードにコメントを追加する

「レコードにコメントを追加」アクションを使用して、Airtableのレコードにコメントを投稿します。コメントは、そのレコードへのアクセス権を持つすべてのコラボレーターに表示されます。このアクションを使用して、Zendeskのワークフローからレコードにメモ、更新情報、または背景情報を追加できます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table name or ID`、`Record ID`、`Comment text`
出力	コメントの詳細：ok status、baseId、tableIdOrName、recordId、およびコメントオブジェクト（id、text、createdTime、およびid、email、nameなどの作成者の詳細を含む）など。

テーブルスキーマを参照する

「テーブルスキーマを参照」アクションを使用して、Airtableテーブルのスキーマとフィールドの定義を取得します。このアクションを使用すると、利用可能なすべてのフィールドとそのデータ型を含め、テーブルの構造を確認できます。これは、さまざまなテーブル構造に対応する必要がある動的なワークフローを構築する際に特に役立ちます。このレスポンスに含まれるtableIdを使用すると、他のアクションでテーブルをより確実に指定できます。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：`Base ID`、`Table ID or name`
出力	テーブルスキーマ：「ok」ステータス、baseId、tableId、tableName、およびテーブルオブジェクト（id、name、primaryFieldId、description、id/name/type/descriptionを含むfields配列、およびid/name/typeを含むviews配列）など。