外部広告媒体・更新ソフト連携
媒体別のキャストIDと提供範囲、同期ジョブを管理します。
対象:管理者・連携担当者媒体IDを設定する
- 「外部媒体連携」で媒体・設定名・店舗IDを選びます。CityHeaven、ぴゅあらば、F-SPOT、デリヘルタウン、駅ちか、風俗DX、高級デリランク、ミネルバ、その他の更新ソフトを登録できます。
- キャストIDと媒体側キャストIDの対応を1行ずつ入力します。提供するプロフィール・日記・出勤予定・空き時間を選びます。
- 連携APIを有効にして保存します。初回だけ表示されるトークンは連携する更新ソフトへ設定します。URLのクエリ文字列へトークンを付けないでください。
店舗ごとの媒体ログイン情報を設定する
他店舗の認証は共有されません。保存しても送信・BOT実行は始まりません。接続確認・媒体固有の対応・運営による有効化が必要です。追加認証やCAPTCHAが必要な場合は店舗担当者が対応します。
- 操作対象が自社の店舗であることを確認します。媒体連携設定を保存し、その設定名の「この店舗の媒体ログイン設定」を開きます。
- 媒体ログインID・パスワード・媒体の店舗識別子を入力し、保存します。シティヘブンの識別子は出勤画面URLのshopdirです。
- 保存後は設定済みの状態だけを表示します。更新する場合はIDとパスワードを再入力します。不要になった認証は「保存した媒体認証を解除」で解除します。
提供内容とジョブを確認する
- 営業日を選び、「提供情報を確認」から実際のJSONを確認します。
- 公開・編集・出勤予定・予約の変更に伴う同期ジョブを確認します。
- 更新ソフト側で反映し、専用APIへ反映先の参照情報を返すと「連携先から反映確認」と表示します。
接続情報が必要な範囲
シティヘブンの出勤BOT・キャスト別受信設定は配備済みです。専用ログイン、受信DNS・Worker、SMTPの接続確認後に有効化します。現在は送受信・BOT実行が無効で、実投稿は接続していません。連携トークンは無効化・更新でき、更新前のトークンは使えなくなります。
シティヘブンの通常日記メール連携(接続準備中)
機能は配備済みですが、送受信は無効・接続設定は未実施です。日記連携方式でメール投稿を選び、運用担当がキャスト専用投稿先と許可済み送信元・SMTPを設定してから利用します。公開承認済みの通常日記を内容確認して送信する機能です。タイトル49文字・本文3600文字以内。写真はアプリへアップロードしたものを使用します。予約・限定・動画・お礼等の日記には使用しません。
掲載確認と二重投稿の防止
SMTP受付済みは媒体への掲載完了を意味しません。媒体側の表示を確認してください。送信結果不明・送信処理中の記録は自動再送しません。掲載後の訂正・取り下げは媒体側で行います。メール方式の日記は更新ソフト向けの提供対象から除外します。
出勤・日記の変更を確認する(接続準備中)
確認する営業日を選び、7日分の提供データを準備します。この操作では媒体へ投稿しません。変更内容を開くと出勤日時や公開日記を確認できます。元情報・媒体ID・キャスト設定を変更した後は、最新の内容で確認し直してください。出勤BOTは配備済みです。専用ログイン・店舗ID照合・試験反映を終えるまで実行は無効です。
キャストメールの受信・転送(接続準備中)
機能は配備済みですが、受信・転送は無効、実接続は未実施です。「キャストメールを受信・転送」を選び、運用担当がキャスト別の受信先と媒体投稿先を設定します。キャストは登録済みの本人メールから受信先へ件名・本文・写真を送ります。本人の送信者署名を検証できた通常日記だけ受け付けます。接続確認後、自動転送または管理者の内容確認後に転送します。専用の投稿用Fromへ書き換える方式ではありません。受信済み・SMTP受付済み・媒体掲載済みを区別してください。結果不明・処理中の再送は行いません。
出勤コメントと24時退勤(接続準備中)
出勤予定の「媒体に公開する出勤コメント」に掲載内容を入力します。「店舗内の備考」は配信しません。媒体設定の24時退勤で「23:59へ変換」を選ぶと、媒体向け変更データのみ変換します。給与・会計の勤務日時は変わりません。出勤の媒体への直接自動更新は未接続です。
接続確認の依頼と本人確認
媒体ログイン設定の「接続確認を依頼(投稿なし)」から確認を依頼できます。確認待ち・確認中・成功・本人確認が必要・失敗・期限切れを表示します。「接続状態を更新」で結果を読み直し、確認待ちの依頼は取り消せます。実行停止中は依頼の保存だけを行い、外部へログインしません。依頼は10分で期限切れとなり、自動再試行しません。再依頼は1分以上空けてください。追加認証やログイン失敗の場合は、表示された公式ログイン画面で本人が確認してください。認証コードは公式画面だけへ入力します。別ブラウザでの追加認証はBOTへ引き継がれません。繰り返し本人確認が必要な場合は、以下の専用ツールによる引き継ぎを利用してください。接続成功は送受信・BOT実行の許可ではありません。通常ログインの自動入力はシティヘブン、本人認証引き継ぎ後の接続確認はシティヘブン・ぴゅあらば・駅ちかに対応しています。
追加認証を引き継ぐ(シティヘブン・ぴゅあらば・駅ちか)
- 操作対象店舗と媒体設定を確認し、媒体認証情報を保存します。ぴゅあらばの店舗識別子には管理画面に表示された数字の店舗IDを指定します。
- 「本人認証ツールをダウンロード」を押します。Python 3.11以降とPlaywrightが必要です。導入は社内のPC管理担当者と行ってください。
- 「本人認証の準備ファイルを取得」を押し、画面のコマンドで専用ツールを実行します。準備ファイルは発行から15分間・1回限り有効です。
- 新しく開いた専用ブラウザの公式画面で、本人がログイン・追加認証コード入力を完了します。登録・投稿は行わず、店舗画面を確認して端末でEnterを押します。
- ホーム内 .desk-assist-auth に保存されたsessionファイルを同じ店舗・媒体設定の画面で選び、暗号化保存への許可をチェックして取り込みます。ファイルをメールやチャットへ送らないでください。
- 保存された状態は未検証です。接続確認を別途依頼します。実行停止中は確認待ちのままで、送受信・BOTは開始しません。取り込み後、PC上の認証ファイルと準備ファイルを削除してください。
認証の有効期限と解除
引き継いだ認証状態は最大6時間有効です。媒体側で先に期限切れになることもあります。パスワードや媒体設定の変更・認証解除で旧状態は使えなくなります。「引き継いだ認証を解除」で保存状態を無効にできます。別店舗・別媒体への流用はできません。CAPTCHAや追加認証は本人が公式画面で操作します。Desk Assist内の遠隔ブラウザ操作は未対応です。
ぴゅあらばの対応範囲
店舗IDの照合、本人認証引き継ぎ、読取接続確認、出勤の計画・通常画面更新・再読取のコードを用意しています。送受信・BOT実行は無効で、媒体の試験反映は未実施です。2026年10月22日にも公式日記画面で更新ツールによる投稿が利用停止対象と案内されているため、日記の自動投稿・メール転送は提供しません。本人が公式機能から投稿してください。
駅ちかの店舗別ログインと本人認証
- 媒体を「駅ちか」にして店舗IDとキャストIDの対応を保存します。店舗IDは駅ちかのプレビューURL末尾の数値です。ログインIDとは別です。
- この店舗の媒体ログイン設定にID・パスワードを保存し、店舗識別子にも同じ店舗番号を設定します。
- 本人認証ツールの専用ブラウザで公式画面にログインし、認証ファイルを同じ設定へ取り込みます。取込だけでは接続確認済みになりません。
駅ちかの出勤予定を送信せず確認する
出勤BOTは運用者用の手動実行方式です。通常の出勤画面に表示される当日から7日間だけを扱います。登録直前に元データ・店舗認証・画面全体を照合し、更新後に再読取します。媒体の出勤画面を他の担当者が同時編集していない時間帯に使用します。対象外の欄や媒体側で別途変更された予定は上書きせず停止します。未管理の媒体予定は削除しません。媒体側への試験反映は未実施です。
- 勤怠管理で出勤予定を登録し、外部媒体連携で確認する営業日を選びます。
- 「駅ちかの出勤予定を確認(送信なし)」で媒体キャストと出退勤時刻を確認します。翌日1時は25:00、翌朝6時は30:00です。
- 30分刻み以外、朝6時をまたぐ予定、同日の複数出勤は修正・照合してください。丸め処理は行いません。
駅ちかのキャスト別写メ日記メールを準備する
- 駅ちかの「アドレス管理」または「アドレス一覧」で、対象キャストの通常の写メ投稿先を確認します。ガラケー用・動画用は使用しません。
- Desk Assistで対象キャスト、本人の送信元、通常写メ投稿先を入力し、店舗・キャストとの対応を確認して保存します。投稿先は暗号化され、再表示しません。設定保存後も全体の送受信停止は維持されます。
- 接続確認後はキャストがDesk Assistの受信先1つへ件名・本文・写真を送ります。件名49文字・本文3600文字・写真5枚までというアプリの受入上限があります。動画は対象外です。
- 有効化後に原文の本人署名を検証し、承認後または許可済みの自動転送で固定投稿先1つへ転送します。署名を壊さないため原文のFrom・To・本文は維持し、配送先だけを指定します。
駅ちかの日記掲載と重複を確認する
SMTP受付は掲載完了ではありません。処理中・結果不明のメールを再送しないでください。駅ちかから他サイトへの同時投稿設定も確認し、循環転送や二重投稿を避けます。本人作成の日記・写真を使用し、店舗イベント告知は別機能で行います。公式資料の画像推奨容量は3MBです。日記の保持期間や投稿条件は媒体の最新案内も確認してください。
ぴゅあらばの出勤予定を確認する
- 媒体をぴゅあらばにして、管理画面の店舗ID・媒体キャストIDを設定します。本人認証の店舗識別子も同じ店舗IDにします。
- 確認する営業日を選び、「ぴゅあらばの出勤予定を確認(送信なし)」を押します。朝5時を区切りに開始する予定が対象です。
- 出勤時刻は5:00〜28:30、終了は53:00まで、30分刻みで準備します。翌日2時は26:00、翌々日5時は53:00です。公開コメントは30文字以内にします。
ぴゅあらばの写メ日記を利用する
Desk Assistは日記の更新ツール投稿やメール転送を提供しません。本人投稿ができることと外部ツールから投稿できることを区別してください。
- ぴゅあらば公式のマイページ設定で、キャスト本人の利用許可・日記利用状態と登録完了を確認します。
- 「ぴゅあらばの公式日記管理を開く」から本人向け手順を確認し、本人が公式の投稿機能を利用します。
媒体ごとの対応範囲を見分ける
各媒体ログイン設定に、店舗認証・出勤更新・日記配送の対応範囲を表示します。「コード実装済み」でも媒体の掲載確認は別途必要です。風俗DX・高級デリランク・ミネルバなど、接続仕様を確認できていない媒体は、媒体ID保存・公開情報の提供APIと直接接続を区別して表示します。IDを保存しただけではログインや投稿を実行しません。
F-SPOTとミネルバの接続準備
- F-SPOTは媒体を選び、店舗IDとキャストIDの対応を保存します。必要な公開情報だけを選びます。ログイン情報は店舗管理者が専用欄へ保存できます。
- ミネルバは対象媒体を選ぶと版選択が表示されます。「バージョン1」または「2024バージョン」を実際の契約と照合して保存します。
接続準備と7日分を送信せず点検する
- 操作対象店舗と媒体設定を確認し、確認する営業日を選びます。シティヘブン・駅ちか・ぴゅあらばの「接続準備と7日分を点検(送信なし)」を押します。
- 認証保管・店舗ID・キャスト対応・ログイン情報・本人認証の期限・接続確認状態を確認します。「要確認」の項目を準備します。
- 日付ごとの変更予定を開いて時刻と公開コメントを照合します。ある日が要確認でも、他の日は引き続き確認できます。日付が正常でも送信可能・掲載済みという意味ではありません。
- 日記の受信設定の保存数・設定有効数・再設定数、処理中と結果不明の件数を確認します。媒体ID変更後の投稿先は再設定してください。処理中・結果不明は再送せず媒体で照合します。