インポート/エクスポート（CSV・Markdown）

FAQ管理画面の「エクスポート」「インポート」から、複数のFAQをまとめて登録・更新できます。既存FAQの一括見直しや、他システムからの移行時にご利用ください。エクスポートはFAQの閲覧権限があれば実行できますが、インポートにはFAQの編集権限が必要です。

形式は次の2つから選べます。どちらも扱える項目と取り込みの規則は同じです。

• CSV形式は1行に1件です。表計算ソフトで一覧を見ながら、短いFAQをまとめて直すのに向いています
• Markdown形式（zip）は1ファイルに1件です。長い回答（記事）をテキストエディタで編集するのに向いています。詳しくは後述の「Markdown形式（zip）」を参照してください

扱えるのはカテゴリ・質問・回答だけです。FAQの削除はできず（CSVから行を削除してインポートしても既存のFAQは残ります）、ロール制限・公開期間も設定できません。新規登録したFAQは下書きとして作成され、ロール制限・公開期間は未設定になります。また、カテゴリの末尾に、CSVでは行の順、Markdown形式ではファイルのパスの名前順で並びます。インポートで既存FAQの表示順は変わりません。表示順の変更はFAQ管理画面で行ってください。既存FAQを更新した場合、ロール制限・公開期間は変更前の設定が維持されます。公開までの流れは後述の「インポート後の公開への反映」を参照してください。

CSVファイルの形式

CSVは次の5列で、列の順番は固定です。1行目は見出し行「ID,カテゴリ,質問,回答,備考」として扱われ、見出し行がこれ以外のファイルは取り込みを中止します。

値にカンマ・改行・ダブルクォートを含む場合は、値全体をダブルクォート " で囲み、値の中のダブルクォートは "" のように2つ重ねてください。Excelなどの表計算ソフトから保存したファイルは通常この形式になっています。

文字コードはUTF-8のみ対応です。Excelで保存する場合は「CSV UTF-8（コンマ区切り）」形式を選択してください。「CSV（コンマ区切り）」形式で保存するとShift-JISとなり、文字化けやインポートエラーの原因になります。エクスポートされるファイルはBOM付きUTF-8です。

アップロードできるファイルは30MBまでです。これを超える場合はファイルを分けてインポートしてください。

ID列 - 新規登録か更新かを決める

• 空欄: 新規登録
• 値あり: 該当IDのFAQを更新

IDはエクスポートしたCSVの値をそのまま使ってください。存在しないIDや形式の異なるIDの行はスキップされます。

同じIDの行が複数あるときは、どの行の内容を採用すべきか決められないため、その行をすべてスキップし、該当のFAQは変更しません（内容が同じ行どうしでも同様です）。エラー行CSVの備考にはお互いの行番号が書かれるので、正しい内容の行を1つだけ残して再インポートしてください。既存FAQの行をコピーして別のFAQを作りたい場合は、コピーした行のID列を空欄にします。

カテゴリ列 - 名前で指定する

カテゴリはIDではなく表示名で指定します。既存のカテゴリ名と一致すればそのカテゴリに登録され、一致しない場合は同名の新しいカテゴリが自動的に作成されます。カテゴリ名は前後の空白を除いたうえで完全一致で判定するため、語中の表記ゆれ（全角/半角スペースなど）があると別のカテゴリとして作成されます。

既存FAQのカテゴリをCSVで変更することはできません（元と異なるカテゴリ名の行はスキップされます）。カテゴリの変更はFAQ管理画面の編集画面から行ってください。

エクスポート

「エクスポート」の「CSV形式」から、登録済みの全FAQ（公開・下書き問わず）をCSVファイルとしてダウンロードできます。既存FAQをまとめて更新したい場合は、まずここでダウンロードしたファイルを編集元にしてください。IDやカテゴリ名を手入力すると、エラーや意図しないカテゴリの作成につながります。

行はカテゴリの表示順→FAQの表示順の順に並びます。備考列は常に空欄で出力されます。エクスポートされる質問・回答は公開中の内容のみで、未反映の下書き（FAQ承認ワークフローの申請中など）はエクスポートに含まれません。

インポート

「インポート」ボタンからファイルを選択して実行します。拡張子が .csv のファイルはCSV形式、.zip のファイルはMarkdown形式として取り込みます。ファイルの受け付け後、取り込みは順番に処理され、画面に進み具合（開始待ち、N / M 行、書き込み中）が表示されます。一時的なエラーや処理のやり直しが表示されることがありますが、自動で再試行されるため操作は不要です。取り込みは画面を閉じても中断されません。

完了すると次の5つの件数と、スキップした行のエラー内容が表示されます。

内容が変わっていない行

既存FAQを更新する行で、質問・回答が登録済みの内容と同じ場合は「変更なし」として数えられ、編集履歴も残りません。公開中のFAQに未反映の下書きがある場合は、その下書きと同じ内容の行も変更なしとして扱われ、下書きはそのまま保たれます。このため、エクスポートしたファイルを編集せずにそのままインポートしても、FAQの状態は変わりません。

最近のインポート

「インポート」のモーダル下部に、直近10件のインポート履歴（受付日時・実行者・状態・ファイル名・件数）が表示されます。ブラウザを閉じたあとや別の端末からでも、ここから結果を確認できます。履歴は90日間保持され、スキップした行があるインポートからはあとからでもエラー行CSVをダウンロードできます。

インポート後の公開への反映

CSVでインポートしたFAQは、そのままでは公開されません。

• 新規登録したFAQは下書き状態で作成されます。公開するにはFAQ管理画面で公開操作を行ってください（FAQ承認ワークフローを有効化している場合は、承認申請・承認が必要です）。
• 公開中のFAQを更新した場合、内容はいったん下書きとして保存され、通常の編集と同様に公開操作（または承認）を行うまでエンドユーザーには反映されません。すでに未反映の下書きがある場合は質問・回答だけが書き換わり、下書きで変更していたロール制限・公開期間はそのまま保たれます。
• 下書き状態のFAQを更新した場合は、その場で内容が上書きされます。

エラーと対処法

次のエラーは行ごとに判定され、該当する行だけがスキップされます。他の行は取り込まれます。

エラー行を直して再インポートする

スキップした行があるときは、結果画面の「エラー行をダウンロード」からエラー行だけのCSVを取得できます。このファイルは通常のCSVと同じ5列形式で、1〜4列目には元の値がそのまま入り、備考列にスキップの理由が「【インポートエラー】理由｜元の備考」の形で書かれています（元の備考が空なら「【インポートエラー】理由」だけです）。

• 列数が足りなかった行は、足りない列を空欄にして出力します。
• 列数が多すぎた行は、5列目の元の値を備考の「｜」のあとに、6列目以降の値をそのまま6列目以降に残します。値を正しい列に戻し、6列目以降を削除してから再インポートしてください。直すまではスキップされ続けます。

再インポートでまたスキップされた行は、次のエラー行CSVで備考の「【インポートエラー】理由｜」の部分が新しい理由に置き換わります。元の備考はそのまま残り、理由が積み重なることはありません（備考が「【インポートエラー】」で始まる場合は、最初の「｜」までをエラーの理由とみなして置き換えます）。

1. 「エラー行をダウンロード」でファイルを取得する
2. 備考列の理由を見て1〜4列目を直す（備考列はそのままで構いません）
3. 直したファイルをそのままインポートする

エラー行CSVには取り込めなかった行しか含まれないため、成功済みの行を二重に登録してしまうことがありません。元のファイルをそのまま再インポートすると、ID列が空欄の行は前回とは別のFAQとして再び作成され、重複します。

ファイル全体が取り込まれない場合

次の場合は受付の時点でインポートが中止され、理由が画面に表示されます。FAQは1件も取り込まれません。

• ファイルサイズが30MBを超えている、または文字コードがUTF-8になっていない
• ダブルクォートの開き・閉じが対応しておらず、CSVとして読めない。「CSVの形式が正しくありません（N行目付近）」と表示されるので、その行付近の値の囲み方を「CSVファイルの形式」に沿って直してください
• 見出し行が「ID,カテゴリ,質問,回答,備考」になっていない。「見出し行が正しくありません」と表示されます
• 見出し行しかない、または空のファイル。「取り込む行がありませんでした」と表示されます
• LiteプランのFAQ登録件数上限（1,000件）を超える。現在の登録件数と、インポートで新規登録される行の合計で判定します
• 同一のアプリで別のCSVインポートが実行中。「このアプリで実行中のCSVインポートがあります」と表示されます。1つのアプリで同時に実行できるインポートは1つだけです

取り込みを始めたあとで完了できなかった場合も、結果画面に理由が表示され、FAQは1件も取り込まれません（途中まで取り込まれた状態にはなりません）。「処理が長くなりすぎたため中断しました」と表示されたときはファイルを分けて、それ以外は同じファイルで再度インポートしてください。受付の結果を受け取れなかった旨が表示された場合は、「最近のインポート」に表示されていれば受付は完了しています。

Markdown形式（zip）

Markdown形式では、FAQ1件を1つのMarkdownファイル（.md）にし、それらをまとめたzipでエクスポート・インポートします。回答はMarkdownのまま本文に書くため、長い回答でも表計算ソフトのセルに収める必要がありません。テキストエディタでの編集や、gitなどでの変更管理にも使えます。

ファイルの形式

ファイルの先頭に「---」の行で囲んだfront matterを置き、id・category・questionを書きます。2つ目の「---」の行より後ろがすべて回答です。

---
id: "agqvqhzfrfzcrmlyr7hw6jjjhq"
category: "製品仕様"
question: "接続方法が分かりません。"
---

回答の本文をMarkdownで書きます。

- 箇条書きや見出しもそのまま使えます

• 値に「:」や「#」を含む場合は、値全体をダブルクォート " で囲んでください。エクスポートしたファイルは、すべての値がダブルクォートで囲まれています。
• front matterに書けるのは id・category・question の3項目だけです。それ以外の項目（書き間違いを含む）があるファイルはスキップされます。
• 文字コードはUTF-8です。改行はLF・CRLFのどちらでも構いません。

エクスポート

「エクスポート」の「Markdown形式(zip)」から、登録済みの全FAQをzipでダウンロードできます。エクスポートされる内容（公開中の内容のみ・下書きは含まない）はCSVと同じです。

faq-markdown-20261020.zip
├── 00_はじめにお読みください.txt
├── AGENTS.md
├── 01_ご利用ガイド/
│   ├── 001_ログインできないときは.md
│   └── 002_パスワードを変更したい.md
└── 02_料金・お支払い/
    └── 001_支払い方法の種類.md

• カテゴリごとのフォルダに分かれ、フォルダ名・ファイル名の先頭には、エクスポートした時点の表示順の番号が付きます。エクスプローラーやFinderで名前順に並べると、ダッシュボードの表示順と同じ並びになります。
• 「00_はじめにお読みください.txt」には、編集のしかたと新しいFAQのひな形が書かれています。取り込みでは使われません。
• 「AGENTS.md」は、AIエージェント（Codex・Cursor など）向けに同じ規則を書いた説明書きです。フォルダをAIエージェントで開いて編集を頼むと、この規則に沿って編集されます。拡張子は .md ですが、FAQとしては取り込まれません。
• フォルダ名・ファイル名は探しやすくするための目印です。名前を変えたり、ファイルを並べ替えたりしても、表示順は変わりません。表示順の変更はダッシュボードで行ってください。

インポート

zipを「インポート」から選択して実行します。取り込みの規則（新規登録と更新の判定、カテゴリの指定、zipに無いFAQは削除しないこと、公開への反映）はCSVと同じです。

• 取り込むのは拡張子が .md のファイルだけです。カテゴリ・質問・回答は、front matterと本文の内容だけで決まります。ファイル名は自由に変えて構いません。
• カテゴリはフォルダではなく category で決まります。エクスポートした番号付きのフォルダ（「01_ご利用ガイド」など）に置いたファイルは、フォルダ名と category が一致しているかを確かめ、一致しないファイルはスキップします。フォルダを移しただけではカテゴリが変わらないことを、スキップの理由として知らせるためです。番号の無いフォルダや、zipの直下に置いたファイルは確かめません。
• 新しいFAQを追加するときは、入れたいカテゴリのフォルダに新しい .md ファイルを作り、category を同じフォルダのファイルからコピーしてください。既存のファイルをコピーして作るときは、id を消してください（消さないと元のFAQが上書きされます）。
• フォルダごとzipにしても、中身だけをzipにしても取り込めます。
• .md 以外のファイルと、macOSがzipの作成時に加えるファイル（__MACOSX フォルダ、._ で始まるファイル、.DS_Store）は無視されます。
• 新しく追加したFAQは、カテゴリの末尾に並びます。複数追加したときは、zip内のパス（フォルダ名・ファイル名）の名前順に並びます。既存のFAQの表示順は、インポートでは変わりません。
• 進み具合と結果の件数は、行数ではなくファイル数で表示されます。
• アップロードできるzipは30MBまでです。1ファイルの大きさにも上限があり、質問・回答の文字数の上限内であれば収まります。

エラーと対処法

スキップしたファイルは、結果画面にzip内のパスと理由が表示されます。CSVと違い、エラー行のダウンロードはありません。手元のファイルを直して、zipを作り直して再インポートしてください。

CSVと共通の行ごとのエラー（カテゴリが空、文字数の上限、存在しないID、カテゴリの変更など）に加えて、次のエラーがあります。

次の場合は受付の時点でインポートが中止され、FAQは1件も取り込まれません。

• zipとして読めないファイル（CSVをMarkdown形式として選んだ場合を含む）
• 拡張子が .md のファイルが1つも無いzip
• zip内のファイル数や、展開した大きさが上限を超えるzip