説明動画(約45秒)
1デモの通話と、どの箱を引くか
いただいたデモ動画(あかり管理サービス・グランメゾン中野坂上305号室)の流れに合わせています。
通話1 入居者さまから受電発信番号・物件名・部屋から物件を特定。受付票の送り先(管理会社)も引く物件マスタ 656
通話2・3 サービス会社へ照会工種とエリアで当たる順に。1社目不可→2社目。打ち切り社数で人へ業者マスタ 657
手配のご依頼の送付対応可の会社のメールへ業者マスタ 657
通話4 入居者さまへ連絡受電時の電話番号へ物件マスタ 656
通話5 完了報告を受電会社名カナ・物件名カナで照合。完了報告は管理会社へ両方
2用意した2つの箱と項目(フィールドコード)
緑の字は、デモ動画を見て足した項目です。
物件マスタ アプリ 656
→ 住所・管理会社の送り先を返す
| 項目名 | フィールドコード |
|---|---|
| 物件名 | bukken_name |
| 物件名カナ | bukken_kana |
| 部屋番号 | room_no |
| 住所 | address |
| 都道府県 | prefecture |
| 市区町村 | city |
| 入居者名 | tenant_name |
| 入居者名カナ | tenant_kana |
| 入居者電話(ハイフンなし) | tenant_tel |
| 管理会社 | kanri_company |
| 管理会社の宛先(部署) | kanri_dept |
| 管理会社電話 | kanri_tel |
| 管理会社メール(受付票・完了報告の送り先) | kanri_email |
| メモ | note |
架空のサンプル6件。デモと同じ「グランメゾン中野坂上 305」も入っています。
業者マスタ アプリ 657
→ 宛先を当たる順に返す
| 項目名 | フィールドコード |
|---|---|
| 都道府県(エリア) | prefecture |
| 対応エリアの補足 | area_note |
| 工種 | genre |
| 当たる順 | priority |
| 業者コード | vendor_code |
| 会社名 | vendor_name |
| 会社名カナ | vendor_kana |
| 電話(ハイフンなし) | tel |
| メール(手配のご依頼の送り先) | email |
| 受付時間 | hours |
| 24時間対応 | is_24h |
| 注意(遠方費・資格など) | caution |
| 打ち切り(何社で人に戻すか) | max_tries |
| 使えるか | active |
ZENBU の手配ナビと同じ形(東京都・9工種・当たる順)のサンプル41行。デモの「中野設備サービス」「城西水道工業」も東京都・水の1位・2位に入っています。
3値の決まり
| 項目 | 決まり |
|---|---|
| 電話番号 | ハイフンなしの数字だけ(例 09000000006) |
工種 genre | 水/鍵/電気/建具/ガス/ガラス/害虫・害獣/ゴミ・清掃/共用部 の9つ。「排水の詰まり」「水が流れない」は「水」。 |
受付時間 hours | 「開始-終了」の時。7-2=7時〜翌2時、9-24=9時〜24時。空欄は記載なし(is_24h=不明)。 |
打ち切り max_tries | 今は全行3。3社に断られたら人に戻す想定です。 |
使えるか active | 「止めている」の行は引かないでください。 |
4引き方(Kintone REST API・確かめ済み)
発信番号から物件を引く
日本財託様の「建物名が分からない」ケース
GET /k/v1/records.json?app=656 query = tenant_tel = "09000000006" → グランメゾン中野坂上 305 東京都中野区中央9-9-9 あかり管理サービス(akari-kanri@example.com)
番号で見つからないときは bukken_kana like "ナカノサカウエ" and room_no = "305" でも引けます。
工種とエリアから宛先を引く
業者手配エージェント
GET /k/v1/records.json?app=657
query = prefecture = "東京都" and genre = "水"
and active in ("使える")
order by priority asc limit 3
→ 1位 中野設備サービス
2位 城西水道工業
3位 サンプル業者A
5いただいたご質問への回答
| ご質問 | 回答 |
|---|---|
| 物件・建物・部屋・入居者のデータ | ZENBU には物件の一覧(マスタ)はなく、案件ごとの記録だけです。お客様の個人情報のため、検証用にサンプルの箱(656)を作りました。 |
| 業者・協力会社のデータ | あります(手配ナビ:都道府県×工種ごとに当たる順)。同じ形のサンプルの箱(657)を作りました。 |
| 大東建託様の回線のデータに、物件や担当者の一覧は? | ありません。案件ごとの記録と、営業所の一覧(FAX・電話)だけです。 |
| 日本財託様の Kintone に業者マスタはあるか | ZENBU からは分かりません。日本財託様にご確認ください。 |
6安全のために決めたこと
- 本番の案件や手配ナビの箱は見せません。検証用の2つの箱だけです。
- 物件・入居者・業者・管理会社は、名前・電話・メールまですべて架空です。
- 電話番号は
0300000…などの使われない形にしました。AI が本物の方へ発信しないためです(デモ動画の 090-1234-5678・03-1234-5678 は実在しうるので使っていません)。 - APIトークンは「レコード閲覧」のみ。アプリごとに発行します。
7お渡しするもの(4点)
済
サブドメイン
iv234ntfjjtr.cybozu.com
済
アプリID
物件マスタ 656
業者マスタ 657
済
参照のみのAPIトークン
656・657 で発行済み(レコード閲覧のみ)。8 で合言葉を入れると表示されます
済
フィールドコード一覧
このページの2の表
ご相談したいこと
① 打ち切り(今は3社)を工種ごとに変えるか。② 受付時間外の扱い(翌朝に回す/人に戻す)。③ エリアを市区町村まで細かくするか(今は都道府県+補足欄)。④ 本番に乗せるときの物件マスタの置き場(管理会社さまの Kintone か、ZENBU 側か)。
① 打ち切り(今は3社)を工種ごとに変えるか。② 受付時間外の扱い(翌朝に回す/人に戻す)。③ エリアを市区町村まで細かくするか(今は都道府県+補足欄)。④ 本番に乗せるときの物件マスタの置き場(管理会社さまの Kintone か、ZENBU 側か)。
8APIトークン(合言葉で開きます)
別途お伝えした合言葉を入れると表示されます。ページの中には暗号のまま入っていて、合言葉がないと読めません。どちらも「レコード閲覧」のみです。
curl -H "X-Cybozu-API-Token: (656のトークン)" \ "https://iv234ntfjjtr.cybozu.com/k/v1/records.json?app=656&query=tenant_tel%20%3D%20%2209000000006%22"