メインコンテンツへ
BlueAI
BlueAIBlueAI API
JAEN
ホーム/CRM（顧客管理）/一括操作

一括操作（Bulk Operations）

案件・連絡先の一括ステージ変更、一括削除、CSV インポート/エクスポートを行います。

|

エンドポイント

POST/api/v1/crm/bulk/deals/update案件を一括更新
POST/api/v1/crm/bulk/deals/delete案件を一括削除
POST/api/v1/crm/bulk/contacts/import連絡先を CSV インポート
GET/api/v1/crm/bulk/deals/export案件を CSV エクスポート
GET/api/v1/crm/bulk/contacts/export連絡先を CSV エクスポート
GET/api/v1/crm/bulk/companies/export会社を CSV エクスポート
POST/api/v1/crm/bulk/deals/update

案件を一括更新

複数の案件のステージ・担当者を一括で変更します。最大 100 件まで同時に処理できます。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

リクエストボディ

名前型必須説明
ids
string[]必須更新対象の案件 ID の配列（最大 100 件）
stage
string任意変更先ステージ
assigned_member_id
string任意変更先担当者 ID

レスポンスフィールド

名前型必須説明
processed
number任意処理成功件数
errors
string[]任意エラーメッセージの配列（失敗した場合）

コード例

curl -X POST "https://api.blueai.jp/api/v1/crm/bulk/deals/update" \
  -H "Cookie: better-auth.session_token=<token>" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "deal_11111111111111111111111111111111",
    "deal_22222222222222222222222222222222",
    "deal_33333333333333333333333333333333"
  ],
  "stage": "proposal",
  "assigned_member_id": "usr_99999999999999999999999999999999"
}'

レスポンス例

{
  "processed": 3,
  "errors": []
}
POST/api/v1/crm/bulk/deals/delete

案件を一括削除

複数の案件を一括で削除します。最大 100 件まで同時に処理できます。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

リクエストボディ

名前型必須説明
ids
string[]必須削除対象の案件 ID の配列（最大 100 件）

レスポンスフィールド

名前型必須説明
processed
number任意処理成功件数
errors
string[]任意エラーメッセージの配列

コード例

curl -X POST "https://api.blueai.jp/api/v1/crm/bulk/deals/delete" \
  -H "Cookie: better-auth.session_token=<token>" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "deal_11111111111111111111111111111111",
    "deal_22222222222222222222222222222222"
  ]
}'

レスポンス例

{
  "processed": 2,
  "errors": []
}
POST/api/v1/crm/bulk/contacts/import

連絡先を CSV インポート

CSV ファイルから連絡先を一括登録します。CSV のヘッダー行は first_name, last_name, email, phone, position, company_id, note に対応しています。

認証が必要です— セッション Cookie または Bearer トークンを含めてください

リクエストボディ

名前型必須説明
file
file必須CSV ファイル（multipart/form-data）

レスポンスフィールド

名前型必須説明
processed
number任意インポート成功件数
errors
string[]任意エラーメッセージの配列

コード例

curl -X POST "https://api.blueai.jp/api/v1/crm/bulk/contacts/import" \
  -H "Cookie: better-auth.session_token=<token>"
GET/api/v1/crm/bulk/deals/export

案件を CSV エクスポート

組織内の全案件を CSV 形式でダウンロードします。レスポンスは text/csv で返されます。カラム: id, name, customer_name, company_id, contact_id, amount, stage, expected_close_date, assigned_member_id, created_at, updated_at

認証が必要です— セッション Cookie または Bearer トークンを含めてください

レスポンスフィールド

名前型必須説明
(CSV)
text/csv任意UTF-8 BOM 付き CSV ファイル

コード例

curl "https://api.blueai.jp/api/v1/crm/bulk/deals/export" \
  -H "Cookie: better-auth.session_token=<token>"
GET/api/v1/crm/bulk/contacts/export

連絡先を CSV エクスポート

組織内の全連絡先を CSV 形式でダウンロードします。カラム: id, company_id, name, email, phone, position, notes, created_at, updated_at

認証が必要です— セッション Cookie または Bearer トークンを含めてください

レスポンスフィールド

名前型必須説明
(CSV)
text/csv任意UTF-8 BOM 付き CSV ファイル

コード例

curl "https://api.blueai.jp/api/v1/crm/bulk/contacts/export" \
  -H "Cookie: better-auth.session_token=<token>"
GET/api/v1/crm/bulk/companies/export

会社を CSV エクスポート

組織内の全会社を CSV 形式でダウンロードします。カラム: id, name, name_kana, department, industry, employee_count, website_url, postal_code, address, phone, email, notes, created_at, updated_at

認証が必要です— セッション Cookie または Bearer トークンを含めてください

レスポンスフィールド

名前型必須説明
(CSV)
text/csv任意UTF-8 BOM 付き CSV ファイル

コード例

curl "https://api.blueai.jp/api/v1/crm/bulk/companies/export" \
  -H "Cookie: better-auth.session_token=<token>"