目次

1. 外部連携とは
   
2. Zoho Forms 組織で外部連携を有効にする
3. サービス
   
4. カスタムサービスの設定
5. 外部連携の作成
6. カスタムサービスの編集
   

外部連携は、外部サービスとの認証および連携を行うためのブリッジとして機能します。外部連携は、Zoho Forms アカウント内のフォームをサードパーティサービスにリンクするための手段と考えることができます。

Zoho Forms には、Zoho CRM、Salesforce、Google スプレッドシート、Outlook カレンダーなどの一般的なサービスとの事前構築済み連携が多数用意されています。利用したいサービスがこれらの中にない場合は、独自にカスタム外部連携を作成し、Webhook 連携を使用して目的のサービスに接続できます。

メモ:

1. 同じサービスに対して複数の外部連携を作成できます。
   
2. 外部連携は有料プランでのみご利用いただけます。
   

Zoho Forms 組織で外部連携を有効にする

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

サービス

1. 初期設定サービス:
   これらはあらかじめ設定されたサービスです。初期設定サービスを使用すると、簡単に外部連携を作成し、認証情報を使って認証できます。
   
   
2. カスタムサービス:必要なサービスが初期設定サービス一覧にない場合は、自分で設定できます。
   

1. カスタムサービス セクションで サービスを作成 をクリックし、次の情報を入力します。
   
   • サービス名: 作成するサービスの表示名です。表示名は最大 50 文字まで指定できます。
   • サービスリンク名: カスタムサービスを一意に識別するためのサービスのリンク名です。
     
     
     メモ: 指定するリンク名は、次の条件を満たす必要があります。
     

     • 先頭は小文字で始める必要があります。
     • 使用できるのは、小文字、数字、アンダースコア（_）です。
     • 最大 50 文字まで指定できます。
   • 認証タイプ: 利用するサービスの API ドキュメントに基づき、次の認証タイプから選択します。
     

     種類	説明	項目
     APIキー	この認証タイプでは、目的のサービスとの接続を確立するためのパラメーターを指定する必要があります。次の手順で、連携を実行するためにこれらのパラメーターに値を設定します。たとえば、パラメーターとして authtoken を指定した場合、次の手順ではアカウントの認証トークンを入力して、正常に接続を確立します。	認証タイプとして APIキー を選択した場合、次の項目に値を設定する必要があります。 実パラメーター: パラメーターを送信する対象となるキーの名前です（利用するサービスの API ドキュメントで指定されているキー名）。 パラメーター表示名: パラメーターの表示名です。この名前は、外部連携を認証する際に入力を求められます。 パラメーターの種類: 認証パラメーターを、invoke URL スクリプトで指定した URL にどのように付与して送信するかを決定します。サポートされるパラメータータイプ: クエリ文字列、フォームデータ、ヘッダー メモ: 必要に応じて、パラメーターをいくつでも追加できます。 パラメーターには、認証に必要な任意の種類のキーを指定できます。例: api-key、user-key、authtoken、apitoken など。
     基本	この認証タイプでは、次の手順でユーザー名とパスワードを指定する必要があります。指定したユーザー名とパスワードは、自動的にbase64アルゴリズムで暗号化され、次の形式でヘッダーとして送信されます: Basic <encrypted_username>:<encrypted_password>.	N/A
     OAuth 1	この認証タイプでは、OAuth 1認証を実行するために必要な必須パラメーターを指定する必要があります。	認証タイプとしてOAuth 1を選択した場合、次の項目に値を入力する必要があります: Consumerキー: サービスプロバイダーから発行されたConsumerキー Consumerシークレット: アプリケーションを認証するためのConsumerシークレット Request Token URL: 対象サービスのAPIドキュメントで指定されている、リクエストトークンを取得するためのURL 認証URL: 対象サービスのAPIドキュメントで指定されている認証URL Access Token URL: 対象サービスのAPIドキュメントで指定されている、アクセストークンを取得するためのURL パラメーターの種類: invoke URLスクリプトで指定したURLに対して、認証パラメーターをどのように送信するかを指定します。サポートされる種類: Query string、Form Data、Header
     OAuth 2	この認証タイプでは、OAuth 2認証を実行するために必要な必須パラメーターを指定する必要があります。	認証タイプとしてOAuth 2を選択した場合、次の項目に値を入力する必要があります: Grantタイプ: 対象サービスが認可に使用するGrantタイプです。サポートされているGrantタイプ（Authorizationコード、Client credentials）から選択できます。 クライアントID: サービスプロバイダーから発行されたクライアントID Clientシークレット: アプリケーションを認証するためのClientシークレット 認証URL: 対象サービスのAPIドキュメントで指定されている認証URL Access Token URL: 対象サービスのAPIドキュメントで指定されている、アクセストークンを取得するためのURL 更新用Token URL: 対象サービスのAPIドキュメントで指定されている、リフレッシュトークンを取得するためのURL パラメーターの種類: invoke URLスクリプトで指定したURLに対して、認証パラメーターをどのように送信するかを指定します。サポートされる種類: Query string、Header メモ: 対象サービスの開発者コンソールで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ドキュメントで指定されている、連携を実行するために必要なスコープ。
     
   • スコープ区切り文字 (OAuth 2 認証タイプにのみ適用): 利用するサービス API が、スコープを区切るために想定している区切り文字です。
     
     
     
     

     メモ:
     

     • 使用できる区切り文字は、カンマ、スペース、プラス記号です。指定しない場合は、カンマが既定の区切り文字として使用されます。
     • 複数のスコープを指定する場合にのみ、区切り文字を選択できます。

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

• マイ連携 タブに移動し、接続を作成 をクリックします。
  
• 利用するサービスを選択します。
  
• 次に、接続情報とその他の必須項目を入力します。
  
• 接続名: 接続の表示名です。
  
• 連携リンク名: リンク名は一意である必要があり、Deluge の連携タスクや Invoke URL スクリプトで認証を確立するために使用できます。
  

  
  

  

  入力するリンク名は、次の条件を満たす必要があります。
  

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