Zoho APIコンソールでクライアントアプリケーションを登録する

CatalystとZoho Cliq間のセキュアで認可された通信を有効にするには、Zoho APIコンソールでクライアントアプリケーションを登録する必要があります。このステップは、Event Functionコードに埋め込むOAuth認証情報を生成するために必要です。

クライアントを登録すると、以下の情報が取得できます：

• Client ID：登録したアプリケーションに割り当てられる一意の識別子です。

• Client Secret：Client IDとともにクライアントの認証に使用される秘密鍵です。

これらの認証情報を使用して、以下のOAuthトークンを生成します：

• Grant Token (code)：APIコンソールでClient IDとClient Secretを使用して生成される一時トークンです。Refresh Tokenの取得に使用されます。

• Refresh Token：以前のAccess Tokenの有効期限が切れた際に新しいAccess Tokenをリクエストするための永続的なトークンです。次のステップでREST APIクライアントを使用して生成します。

• Access Token：Zoho Cliq APIの呼び出しを認可する一時トークンです。手動で生成する必要はなく、ランタイム中にRefresh Tokenを使用して自動的に処理されます。

Client ID、Client Secret、およびRefresh TokenはEvent Functionコードに追加されます。これらにより、CatalystがZoho Cliqチャンネルでプログラム的にアクション（メッセージの投稿など）を実行できるようになります。FunctionはRefresh Tokenを使用して新しいAccess Tokenを継続的に取得し、CatalystとCliq間の途切れない接続を確保します。

Zoho APIコンソールでクライアントアプリケーションを登録するには：

1. Zoho APIコンソールにアクセスし、Get StartedまたはAdd Clientをクリックします。
   

2. クライアントタイプとしてSelf Clientを選択します。CatalystアカウントとCliqアカウントが同じOrganizationで設定されているため、このアプリケーションにはSelf Clientを使用できます。
   

3. ポップアップでCreateをクリックしてクライアントを登録します。 APIコンソールが登録されたクライアントのClient IDとClient Secretの値を生成して表示します。
   

4. Generate CodeタブをクリックしてGrant Tokenを生成します。

   • Scopeフィールドに以下を入力します：ZohoCliq.Webhooks.CREATE
   • スコープのDescriptionを追加します。
   • Grant TokenのTime Durationを設定します。
     

5. Createをクリックします。作成されると、Grant Token（code）が表示されます。
   

生成されたClient ID、Client Secret、およびGrant Tokenをコピーして控えておいてください。これらの値は次のステップでRefresh Tokenの生成とプロジェクト内のFunctionファイルの設定に使用します。