必要な権限
HubSpot と Chatwork に許可する権限
HubSpot のインストール時に許可する権限と、Chatwork にログインして接続するときに許可する権限の一覧です。「権限が足りません」と表示されたときの確認先も分かります。
必要な HubSpot の権限
インストールのときに、HubSpot の認可画面で、アプリが要求する権限を許可します。不足した権限があると、設定画面に警告が出ます。
| 権限 | 対象 |
|---|---|
| crm.objects.contacts.read / write | コンタクトの読み取りと更新 |
| crm.objects.companies.read / write | 会社の読み取りと更新 |
| crm.objects.deals.read / write | 取引の読み取りと更新 |
| crm.objects.tickets.read / write | チケットの読み取りと更新 |
| crm.schemas.contacts.write / companies.write / deals.write | コンタクト・会社・取引のプロパティの作成 |
| crm.schemas.tickets.read / write | チケットのプロパティの参照と作成 |
| oauth | 認可のための基本の権限 |
主な用途
- レコードの URL の取得(通知にリンクを付けるため)。
- ルームの紐付けに合わせた、「Chatwork Room ID」「Chatwork Room URL」プロパティの作成と更新。
- メッセージ同期のノートの作成と、レコードへの関連付け。
権限が不足したとき
接続している HubSpot の権限が、アプリが必要とする権限に足りないとき、HubSpot の欄に「権限が足りません」が出ます。「再接続」を押して、権限を許可し直してください。「権限が足りません」と表示される
必要な Chatwork の権限
Chatwork にログインして接続するときは、Chatwork の認可画面で、次の権限の許可を求められます。
| 権限 | 使い道 |
|---|---|
| rooms.messages:read | ルームのメッセージの取得(チャットの表示、メッセージ同期) |
| rooms.messages:write | ルームへのメッセージの投稿(通知、チャットからの送信) |
| rooms.info:read | ルームの一覧と、ルームの情報の取得(紐付け) |
| rooms.members:read | ルームのメンバー名の取得(送信者名、宛先の候補) |
| users.profile.me:read | 接続したアカウントの名前の取得(設定画面の「アカウント」) |
| admin.users:read | 認可画面に表示されるその他の権限 |
| offline_access | 認証情報を自動で更新するための権限 |
API トークンの場合
API トークンで接続したときは、上の権限の確認の対象になりません。トークンを発行したアカウント自身の権限で動作します。
権限が足りないとき
以前に許可した権限が、不足している場合、Chatwork の欄に「権限が足りません」が出ます。「再接続」で許可し直します。通知や紐付けの途中で権限不足が判明した場合も、接続の状態が「要再接続」になります。「権限が足りません」と表示される