関数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の設定を作成します。

右側のメニューから（設定）アイコンをクリックします。
［設定］を選択します。
設定ページで［開発者向け情報］にある［関数API］をクリックします。
関数APIのページで［設定する］をクリックします。
［設定の詳細］ページで名前、アイコン、説明を入力します。
入力したら、［保存してコードを編集する］をクリックします。

手順2：Zoho Deskから送信されるPOSTリクエストのデータ形式を整え、Zoho Connectでタスクを追加するために、POSTリクエストきっかけ処理で以下のコードを設定します。

payloadArray = list(body);
ticket = payloadArray.get(0);
ticketPayload = ticket.get("payload");
desc = ticketPayload.get("description");
subject = ticketPayload.get("subject");
response = invokeurl
[
url: "https://connect.zoho.com/pulse/api/addTask"
type: POST
parameters: {"scopeID":スコープID,"boardId":ボードID,"title":subject,"desc":desc,"sectionId":セクションID,"position":1}
connection:外部連携名
];
info response;
return {"statusCode":"201","response":"タスクを作成しました"};

手順3：Zoho ConnectでAPIエンドポイントを生成します。