関数APIの設定例

関数APIの設定例

こちらの記事では、関数APIの設定例をご紹介します。具体的には、Zoho Deskに新しい問い合わせが追加されたら、Zoho Connectに新しいタスクを作成するための設定を取り上げます。このような処理を行うには、Zoho DeskからZoho Connectに対して問い合わせのデータを送信する必要があります。この処理においては、Zoho DeskでWebhookという機能を利用し、問い合わせが追加されたときに特定のURLにデータを送信するように設定します。送信先のURLとして、Zoho ConnectのAPIを実行するためのURL（APIエンドポイント）を指定します。なお、Zoho Deskから送信されるWebhookのデータ形式は、Zoho Connectでタスクを作成するためのAPIのデータ形式と一致していません。これでは、2つのサービス間でデータをそのまま受け取って処理を進めることはできません。  そこで、関数APIを使用すると、Zoho Connectに対して送信されるリクエストのデータの形式をZoho Connectで処理できる形式に整えることができます。以下では、このような関数APIの設定例を具体的にご紹介します。   
 
手順1：関数APIの設定を作成します。 
  1. 右側のメニューから（設定）アイコンをクリックします。
  2. ［設定］を選択します。
  3. 設定ページで［開発者向け情報］にある［関数API］をクリックします。

  4. 関数APIのページで［設定する］をクリックします。
  5. ［設定の詳細］ページで名前、アイコン、説明を入力します。
  6. 入力したら、［保存してコードを編集する］をクリックします。
手順2：Zoho Deskから送信されるPOSTリクエストのデータ形式を整え、Zoho Connectでタスクを追加するために、POSTリクエストきっかけ処理で以下のコードを設定します。
  1. payloadArray = list(body);
  2. ticket = payloadArray.get(0);
  3. ticketPayload = ticket.get("payload");
  4. desc = ticketPayload.get("description");
  5. subject = ticketPayload.get("subject");
  6. response = invokeurl
  7. [
  8.  url: "https://connect.zoho.com/pulse/api/addTask"
  9.  type: POST
  10.  parameters: {"scopeID":スコープID,"boardId":ボードID,"title":subject,"desc":desc,"sectionId":セクションID,"position":1}
  11.  connection:外部連携名
  12. ];
  13. info response;
  14. return {"statusCode":"201","response":"タスクを作成しました"};
手順3：Zoho ConnectでAPIエンドポイントを生成します。  
  1. APIエンドポイントの隣に表示されている［開く］をクリックします。
  2. ［URLを生成する］をクリックします。
     
手順4：  Zoho Deskで送信Webhookを作成し、通知先のURLとしてZoho ConnectのAPIエンドポイントのURLを指定します。 
 
以上の設定により、Zoho Deskに問い合わせが追加されると、Zoho Connectに新しいタスクが作成されるようになります。同様に、タスクの更新や削除に関する設定を行うことも可能です。 
 
ご不明な点は、support@zohoconnect.comにお問い合わせください。