お問い合わせ一覧を取得

初回お問い合わせ（フォーム送信）と、その後のやりとり（返信/コメント/ユーザー返信）を時系列（新しい順）で統合したフィードをページング付きで返します。

GET /inquiries

認証

AuthorizationヘッダにBearerトークン形式でAPIキーを指定してください。

エンタープライズプラン契約必須。

クエリパラメータ

名前

型

説明

page

integer

ページ番号（1 始まり。未指定は 1）

per_page

integer

1ページあたりの件数（未指定は 20、最大 100）

form_hash_keys[]

string[]

フォームの hash_key で絞り込み（複数指定可）

assignee_hash_keys[]

string[]

担当者（メンバー）の hash_key で絞り込み（複数指定可）

statuses[]

integer[]

ステータスコードで絞り込み（複数指定可）

unreplied

boolean

true で未返信のお問い合わせのみ

has_attachment

boolean

true で添付ファイルありのお問い合わせのみ

created_from

string(date-time)

この日時以降に作成されたイベントのみ（ISO8601）

created_to

string(date-time)

この日時以前に作成されたイベントのみ（ISO8601）

リクエスト例

curl -G "https://tayori.com/external/api/v1/inquiries" \
  -H "Authorization: Bearer $TAYORI_API_KEY" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=20" \
  --data-urlencode "unreplied=true"

レスポンスフィールド

フィールド

型

説明

data

object[]

イベント配列

data[].task_hash_key

string

お問い合わせ（タスク）の hash_key

data[].task_item_hash_key

string | null

やりとりの hash_key（初回お問い合わせは null）

data[].contents_type

string

inquiry / reply / customer_reply / comment

data[].form_hash_key

string | null

フォームの hash_key

data[].form_name

string | null

フォーム名

data[].manage_number

integer | null

管理番号

data[].email

string | null

送信者メールアドレス

data[].referer

string | null

リファラ

data[].user_agent

string | null

ユーザーエージェント

data[].priority

object | null

優先度 { code, label }

data[].status

object | null

ステータス { code, label }

data[].assign_members

object[]

担当者 { hash_key, name }

data[].contents

string | null

初回お問い合わせのプレビュー（短縮回答）。inquiry 以外は null

data[].reply_contents

string | null

返信本文（reply / customer_reply）

data[].comment_contents

string | null

コメント本文（comment）

data[].created_at

string(date-time)

発生日時

data[].attachments

object[]

添付 { hash_key, file_name, file_url }

pagination.current_page

integer

現在のページ

pagination.per_page

integer

1ページあたりの件数

pagination.total_count

integer

総件数

pagination.total_pages

integer

総ページ数