目次

1. 外部連携とは
   
2. Zoho Forms組織での外部連携の有効化
3. サービスの作成
4. 外部連携の作成
5. カスタムサービスの編集
   

外部連携は、外部サービスと認証および連携するための架け橋となります。外部連携は、Zoho Formsアカウント内のフォームとサードパーティサービスをリンクする手段と考えてください。

Zoho Formsでは、Zoho CRM、Salesforce、Google 表計算シート、Outlookカレンダーなど、主要なサービスとの事前構築済み連携を幅広く提供しています。ご希望のサービスが利用できない場合は、ご自身で独自の外部連携を作成し、Webhook連携を使って目的のサービスと接続できます。

メモ:

1. 同じサービスで複数の外部連携を作成できます。
   
2. 外部連携は有料プランでのみ利用可能です。
   

Zoho Forms 組織の接続を有効にする

1. スーパ管理者としてZoho Formsアカウントにログインします。
   
2. アイコンをフォーム一覧ページの左側でクリックし、コントロールパネルにアクセスします。
   
   
   
   
3. コントロールパネル内の外部連携をクリックします（開発者向け情報の下にあります）。
   
   
4. 接続をクリックします。
   
   
   

サービスの作成

1. Zoho Formsアカウントで、アイコンをフォーム一覧ページの左側でクリックし、コントロールパネルにアクセスします。
   
   
   
2. 外部連携をクリックします（開発者向け情報の下にあります）。
   
   
3. カスタム サービスの下にある作成 サービスをクリックします。
   
   
   
4. 以下の情報を入力してください：
   
   • サービス 名前: 作成したいサービスの表示名です。表示名は最大50文字まで入力できます。
   • サービス リンク 名前: カスタム サービスを一意に識別するためのリンク 名前です。
     
     
     メモ: 入力するリンク 名前は、次の条件を満たす必要があります。
     

     • 英小文字から始めてください。
     • 英小文字、数字、アンダースコア（_）が使用できます。
     • 最大50文字まで入力できます。
   • Authentication 種類: 必要なサービスのAPIドキュメントに基づき、以下の認証タイプから選択してください。
     

     種類	説明	項目
     APIキー	このauth種類では、接続したいサービスと連携するために必要なパラメーターを指定する必要があります。次の手順で、連携を実行するためにパラメーターの値を入力してください。例えば、パラメーターとしてauthtokenを指定した場合、次の手順でアカウントの認証トークンを入力し、正常に接続を確立します。	認証種類としてAPIキーを選択した場合、以下の項目に値を入力する必要があります。 Actual Parameter: パラメーターを送信する対象となるキーの名前（ご利用のサービスのAPIドキュメントで指定されているもの） Parameter 表示名: パラメーターの表示名。この名前は接続を認証する際に表示されます。 パラメーターの種類: この項目で、認証パラメーターがinvoke URLスクリプトで指定されたURLと一緒にどのように送信されるかを決定します。対応しているパラメーターの種類：クエリ文字列、フォームデータ、ヘッダー メモ: 必要に応じて、パラメーターはいくつでも追加できます。 パラメーターは認証に必要な任意の種類のキーを指定できます。例：api-キー、ユーザー-キー、authtoken、apitokenなど。
     基本	このauth種類では、次の手順でユーザー名とパスワードを指定する必要があります。指定されたユーザー名とパスワードは自動的にbase64アルゴリズムで暗号化され、ヘッダーとして次の形式で送信されます：基本 :	なし
     OAuth 1	このauth種類では、OAuth 1認証を行うために必須パラメーターを指定する必要があります。	認証種類としてOAuth 1を選択した場合、以下の項目に値を入力する必要があります。 Consumer キー: サービスプロバイダーから発行されたConsumer キー Consumer シークレット: アプリケーション認証用のConsumer シークレット Request Token URL: 希望するサービスのAPIドキュメントで指定されたリクエストトークン取得用URL 認証 URL: 希望するサービスのAPIドキュメントで指定された認証URL Access Token URL: 希望するサービスのAPIドキュメントで指定されたアクセストークン取得用URL パラメーターの種類: 認証パラメーターを、invoke URLスクリプトで指定されたURLにどのように送信するかを決定します。対応しているパラメータータイプ：クエリ文字列、フォームデータ、ヘッダー
     OAuth 2	このauth種類では、OAuth 2認証を実行するために必要なパラメーターの指定が必要です。	認証種類としてOAuth 2を選択する場合、以下の項目に値を入力する必要があります。 Grant種類: 利用するサービスが認可を行う際に使用するGrant種類です。サポートされているgrant types（Authorizationコード、client credentials）から選択できます。 クライアントID: サービスプロバイダーから発行されたクライアントID Clientシークレット: アプリケーションの認証に使用するclientシークレット 認証URL: 利用するサービスのAPIドキュメントで指定されている認証URL Access Token URL: 利用するサービスのAPIドキュメントで指定されているアクセストークン取得用URL 更新するToken URL: 利用するサービスのAPIドキュメントで指定されているリクエストトークン取得用URL パラメーターの種類: 認証パラメーターがinvoke URLスクリプトで指定されたURLと共にどのように送信されるかを決定します。サポートされているパラメータータイプは、クエリストリングとヘッダーです。 メモ: Zoho クライアントを必須サービスの開発者コンソールで登録する際、コールバックURLは以下の通り設定してください。 US ドメイン:   https://deluge.Zoho.com/delugeauth/callback EU ドメイン:   https://dre.Zoho.eu/delugeauth/callback CN ドメイン:   https://dre.Zoho.com。cn/delugeauth/callback IN ドメイン:   https://deluge.Zoho.in/delugeauth/callback AU ドメイン:   https://dre.Zoho.com。au/delugeauth/callback JP ドメイン:   https://dre.Zoho.jp/delugeauth/callback CA ドメイン: https://dre。zohocloud。ca/delugeauth/callback

   • Scope (OAuth 2 認証種類にのみ適用): サービスのAPIドキュメントで指定されている統合を実行するために必要なScopeです。
     
   • Scope Delimiter (OAuth 2 認証種類にのみ適用): サービスAPIがScopeを区切る際に期待するデリミタです。
     
     
     
     

     メモ:
     

     • サポートされているデリミタ（カンマ、スペース、プラス）から選択できます。指定がない場合、カンマが初期設定のデリミタとして使用されます。
     • 2つ以上のScopeを指定する場合のみ、デリミタを選択できます。

5. 必要な詳細を入力した後、 作成 サービス をクリックします。

• サービスを作成した後、My 外部連携タブに移動し、コネクションの作成をクリックします。
  
• 利用したいサービスを選択します。
  
• 次に、コネクションやその他の必要な詳細を入力します。
  
• Connection 名前: 接続の表示名
  
• 外部連携のリンク名: リンク名は一意である必要があり、Deluge連携タスクやinvoke URLスクリプトで使用して認証を確立できます。
  

  
  

  

  入力するリンク名は、以下の条件を満たしてください。
  

  • 小文字のアルファベットで始めてください。
  • 小文字のアルファベット、数字、アンダースコア（_）が使用できます。
  • 最大50文字まで入力できます。
    
• 「作成 と 接続」をクリックします。
  
   
• ユーザー権限ダイアログがポップアップしますので、認証情報を入力して続行してください。
  
• 接続の概要が表示されます。
  
  
• 認証に成功すると、接続が作成され、外部連携ページに一覧表示されます。
  
• 接続にカーソルを合わせると、編集、取り消す、または削除が可能です。
  
  
• カスタムサービス用の接続が正常に作成されると、Webhookの設定時に使用でき、Zoho Formsで収集したデータをWebアプリケーション内で処理することが可能です。