予約ルームズ：Garoon(ガルーン)連携方法

予約ルームズアプリのVer1.4.0以降でご利用いただけます。

予約ルームズでは、「クラウド版 サイボウズ Garoon」と連携して施設を管理することが可能です。
まずは、ご利用のGaroonが連携可能かどうか、「事前確認」をご確認ください。
 

もくじ

事前確認
事前設定_cybozu.comの設定（管理者が設定）
事前設定_会議室設定画面の設定（管理者が設定）
Garoon連携できない場合

Check事前設定にはGaroon管理者アカウントとRECEPTIONIST管理者アカウントでの操作が必要です。

事前確認

1．お使いのGaroonがクラウド版か

クラウド版は、連携が可能です。
パッケージ版は、連携に対応しておりません。
 
TipsGaroonの画面最下部のフッターで、クラウド版かパッケージ版か確認できます。
 

▼クラウド版
「Cybozu Garoon」と記載

▼パッケージ版
「Cybozu Garoon Version x.x.x」と記載

2．お使いのGaroonのcybozuドメインが「.cybozu.com」か

ドメイン「.cybozu.com」のみ連携可能です。
今後、ドメイン「.cybozu.cn」にも対応を予定しております。
 
お使いのGaroonのcybozuドメインの確認方法は以下になります。
 

1.Garoon管理者アカウントでGaroonにログイン＞「歯車マーク」＞「cybozu.com共通管理」をクリックします。

2.画面の上部の「ドメイン」をご確認ください。

 

3．Garoon側でIPアドレス制限をしていないか

GaroonでIPアドレス制限をかけられている場合は、RECEPTIONISTサーバーのIPアドレス（13.115.181.254）のアクセス許可が必要となります。
 

事前設定_cybozu.comの設定

cybozu.comへのAPIリクエストを認証するために、cybozu.comにRECEPTIONIST（予約ルームズ）のOAuthクライアントを登録し、連携利用ユーザーを設定する必要があります。
こちらではその手順をご説明いたします。

1.Garoon管理者アカウントでGaroonにログイン＞「歯車マーク」＞「cybozu.com共通管理」をクリックします。

2.画面上部の、.cybozu.com以前の文字列がサブドメインになります。
この後の『事前設定_会議室設定画面の設定』で使用しますので、メモ帳などに保存しておきましょう。

3.「システム管理」＞「外部連携」の「OAuth」＞「OAuthクライアントの追加」をクリックします。

4.各項目を入力し、「保存」をクリックします。

Item Name	Detail
① クライアント名	「RECEPTIONIST(Rooms)」など分かりやすい名称を入力してください。
② クライントロゴ	省略可。よろしければ、以下の画像をご利用ください。 １クリックダウンロード
③ リダイレクトエンドポイント	「https://app.receptionist.jp/resources_setting」と入力してください。

5.保存後、「クライントID」と「クライアントシークレット」が自動生成されますので、メモ帳などに保存しておきましょう。
この後の『事前設定_会議室設定画面の設定』で使用いたします。

6.追加したRECEPTIONISTクライアントの「連携利用ユーザーの設定」をクリックします。

7.会議室管理連携用アカウント（cybozu.com共通管理者）にチェックを入れ、「保存」をクリックします。
Check個人のGaroonアカウントとは別に、会議室管理連携用のcybozu.com共通管理者のアカウントをご準備ください。

事前設定_会議室設定画面の設定

再連携の場合は、「会議室設定」＞右上の「会議室情報の編集」＞「設定」＞「連携中のカレンダー」＞「削除」を行ってから、以下操作をしてください。
 

1．ブラウザ上でGaroonを開き、会議室管理連携用アカウント（cybozu.com共通管理者）でログインします。

2．RECEPTIONIST管理者アカウントでRECEPTIONIST管理画面にログインし、「会議室設定」を選択します。

3．会議室設定画面の「Garoonカレンダーと連携」ボタンをクリックします。

4．cybozuで事前にOAuth連携を作成している情報より、各値を設定します。

5．各値を入力後、「保存」ボタンをクリックします。
 
 

6．Garoon側の承認画面が表示されますので「承諾」ボタンをクリックして連携します。

 

7．「管理者を認証しました。」と画面上部に表示されます。
Checkエラーになるなど正常にGaroon連携が完了しない場合は、この後の「Garoon連携できない場合」をご確認ください。

Garoon連携できない場合

・『事前確認』の内容をご確認ください。
・『事前設定_cybozu.comの設定』の6、7の設定がされているかご確認ください。
・会議室管理連携用アカウント（cybozu.com共通管理者）で、Garoonにログイン可能な状態かご確認ください。
 

client_idパラメーターと一致する連携サービスが見つかりません。
Code: SLASH_OA01

OAuthが利用できません。管理者に設定を依頼してください。
Code: SLASH_OA06

OAuthを利用する権限がありません。管理者に設定を依頼してください。
Code: SLASH_OA09

これでGaroon連携は完了です。