ヘルプ

meetly の使い方とよくある質問

はじめに

meetly は Google カレンダー連携の日程調整ツールです。主催者は候補日を出すだけ、参加者はログイン不要で投票できます。

1. イベントを作成
/events/new から候補日時を入力 (または「自動生成」) し、共有 URL を発行します。
2. リンクを共有
発行された共有 URL を Slack やメールで参加者へ。ログイン不要で投票できます。
3. 参加者が投票
各候補に「参加 / 場合により / 不可」を選んで送信。secretToken で後から再編集も可能。
4. 主催者が確定
投票状況を見て一番都合の良い候補で「確定」を押すと、Google カレンダーに予定登録 + Meet リンク + 招待メールが自動送信されます。

機能一覧

複数カレンダー連携

primary + 共有/転送カレンダーから busy をまとめて検出

通常時の空き時間 + 臨時上書き

曜日別ルール + 特定日の上書き (Google Calendar 互換)

予約受付期間 / バッファ / 1日上限

○日前〜○時間前まで受付 / busy 前後にバッファ / 1日 N 件まで

投票締切 + 隠れ投票

締切後はロック / Hidden Poll で他者の票を非公開

予約フォームのカスタム項目

会社名 / フリーテキスト / 選択肢などを参加時に必須化

Webhook + Add to Calendar

確定/キャンセルで外部 URL に POST / 4 サービスへの 1 クリック追加

よくある質問

キーワード検索可

参加者は Google アカウントが必要ですか？: いいえ。参加者はログイン不要です。共有 URL を開いて名前を入れるだけで投票できます。Google ログインが必要なのは主催者だけです。お名前を出したくない場合は「匿名で参加」を押すと「匿名 #abc123」のランダム名が自動で入ります。
「カレンダー一覧の取得に失敗しました」と表示されます: Google OAuth に必要なスコープ (calendar.readonly) が付与されていません。/status から「Google を再連携」を押し、同意画面で「Google カレンダーの表示」も許可してください。Google Cloud Console 側の OAuth 同意画面の Scopes に `calendar.readonly` が登録されていない場合は、まずそちらに追加が必要です。
busy (予定あり) が週プレビューに反映されません: 選択カレンダーが 1 つもチェックされていない、または週プレビュー範囲外の予定の可能性があります。前週/次週ボタンで切り替えると対象週の busy が再取得されます。手動で再取得したい場合は週プレビュー右上の更新ボタン (RefreshCw アイコン) を押してください。
予定の色やタイトルが反映されません: 色は per-event の colorId (Google Calendar 標準 11 色) > calendar の backgroundColor の優先順位で解決されます。タイトルは events.list の summary。visibility=private なら「(非公開)」表示。transparency=transparent (Free) の予定や、自分が「不参加」と回答した予定は busy 扱いから除外されます。
確定後に Google Meet リンクが添付されません: イベント作成時に「確定時に Google Meet リンクを自動生成して招待に添付する」チェックを ON にしてください (/events/new)。OFF の場合は通常の予定だけ作成されます。
Webhook には何が送られますか？: `event.confirmed` または `event.canceled` を `type` に持つ JSON が POST されます。`event` フィールドに `id / publicSlug / title / status / confirmedSlot.startAt/endAt / meetingUrl` が含まれます。Slack の incoming webhook URL や n8n / Zapier の webhook trigger に渡せます。
Webhook ペイロードの改ざん検知 (署名) はできますか？: はい。サーバ環境変数 `WEBHOOK_HMAC_SECRET` を設定すると、全ての Webhook 送信時に `X-Meetly-Signature: sha256=<hex>` ヘッダが付きます。受信側で同じ secret を使い `HMAC-SHA256(rawBody, secret)` を再計算して照合してください。GitHub / Stripe / Slack の慣行と同じ形式です。
Webhook の送信失敗はどう確認できますか？: Webhook は best-effort 送信で、失敗時はサーバーログに `[event.confirm] webhook failed:` / `[event.cancel] webhook failed:` のエラーが出ます。タイムアウトは 5 秒です。Webhook URL を打ち間違えても確定/キャンセル自体は成功します。
投票締切を過ぎた後はどうなりますか？: サーバ側で投票を弾きます (BAD_REQUEST)。締切日時は (UTC) で評価され、それ以降は upsertMany が失敗します。主催者は通常通り確定 / キャンセルできます。
隠れ投票 (Hidden poll) って何ですか？: ON にすると、参加者は他の参加者の票を見られなくなります。集計 (yes / maybe / no カウント) も表示されません。主催者だけが集計を確認できます (Doodle の有料機能相当)。
参加者が自分の参加を取り消したい: 投票後に表示される「マイページ」リンク (/p/[secretToken]) から「参加を取り消す」が押せます。投票も同時に削除されます。
イベントを iCal で配信できますか？: はい。各イベントの `/events/[slug]/ical` でダウンロードできます。確定済みは 1 件、未確定は候補を TENTATIVE として、キャンセル済みは CANCELLED として返します。
臨時の空き時間 (Date overrides) と通常時の空き時間の関係は？: 特定日付に override を 1 件でも作るとその日の通常時ルールは無視されます。「終日不可」をオンにするとその日の予約は完全に塞がれます。
QR コードはどこで取得できますか？: 管理画面 (/events/[slug]/manage) の「共有リンク」カード右側に表示されます。スマホでスキャンすると即座に投票ページが開けます。PDF / 印刷物に貼るときに便利です。
「この時間で確定」を間違って押してしまいました: 確定時は確認ダイアログが出るので、誤って押した場合は「キャンセル」を選んでください。すでに確定済みなら「イベントをキャンセル」でステータスを canceled に変更できます。Google カレンダー上の予定は自動削除されないので、必要なら手動で削除してください。
週プレビューの赤い線は何ですか？: 「今」を示す現在時刻ラインです (Google Calendar 互換)。表示週内 + 表示時間内 (default 7-22 時) のときだけ表示されます。1 分ごとに自動更新されます。
公開ページに busy が表示されると主催者の予定が漏れませんか？: 公開ページには Google FreeBusy 相当の「予定あり/なし」だけ表示され、予定タイトルや詳細は出ません。また、表示範囲は候補スロット範囲 ±7 日にクリップされており、任意期間の覗き見はできません。
キーボードショートカットはありますか？: 「?」キーで一覧モーダルが開きます。n=新規作成 / e=自分のイベント / h=ヘルプなど。フォーム入力中は無効です。
サンプルイベントを試したい: /events で右上の「サンプルで試す」ボタンを押すと、タイトル/説明/直近の平日 9 候補スロットが入った状態で /events/new?sample=1 が開きます。そのまま「イベントを作成」しても、内容を編集してから作成しても OK です。

オンボーディング

一度閉じた「ようこそ画面」を再表示できます。

セキュリティと連絡先

meetly (dev) は社内テストユーザー限定で稼働しています。Google から取得した access/refresh token は自社管理の PostgreSQL に暗号化保存され、サインアウト時に削除されます。バグ報告 / 機能要望は /status ページから連絡してください。