WebhookブロックのDELETEメソッド

他のアプリ／システムに登録されている問い合わせやユーザーのデータを削除したい場合があります。WebhookのDELETEブロックでは、自動ガイドボットの会話フロー内から他のアプリ／システムに登録されているデータを削除できます。Zoho Desk、Zoho CRMなどの外部アプリ／システムからデータを削除するにあたって、APIを通じて処理が行われます。問い合わせのキャンセル、サービスの登録解除、テストデータの消去など、さまざまな操作を行うことが可能です。

以下では、WebhookブロックのDELETEメソッドの概要やよくある質問について説明します。

参考情報：自動ガイドボットのWebhookブロックの概要

DELETEメソッドとは

DELETEメソッドとは、APIを通じて外部アプリ／システムからデータを完全に削除する仕組みです。自動ガイドボットの会話フロー内から、外部アプリ／システムのデータを削除できます。

データの削除後、元に戻すことはできません。データの削除には、専用IDまたはエンドポイントが使用されます。

使用するタイミング

DELETEメソッドが役に立つタイミングは、以下のとおりです。

顧客がサポートの依頼をキャンセルしたい
既存のデータ、重複するデータ、テスト用データを削除したい
アプリ／システムから特定のデータを削除するように依頼された
サブスクリプション／サービスが終了したため、該当のデータを削除したい

顧客からデータの削除を依頼された場合や、使用しなくなったデータを削除したい場合にDELETEメソッドを使用することで、データをすばやく削除できます。

使用例

自動ガイドボットで問い合わせを受け付けた後、チャットの利用者から問い合わせを取り下げたいと依頼があったとします。この場合、以下のようにDELETEメソッドを使用することで、問い合わせのデータを削除できます。

DELETEメソッドのURL

https://api.yourapp.com/delete-ticket/TX12345（TX12345は削除対象の問い合わせ番号です）

レスポンスの例

{

“ticket_id“: “TX12345“,

“status“: “Deleted“

}

その後、ボットを通じて以下のように確認メッセージを表示できます。

「問い合わせ（番号：TX12345）を削除しました。またのご利用お待ちしております。」

ボディ（任意）

通常、DELETEメソッドではボディの情報は必要ありません。ただし、一部のAPIでは、認証や処理の確認の理由からボディの詳細を入力する必要があります。詳細については、APIドキュメントをご確認ください。

DELETEメソッドのメリット

不要なデータを削除することで、データを整理できます。
顧客の要望に応じてデータを削除することで、プライバシーの保護やコンプライアンスの徹底が可能です。
外部アプリ／システムでデータを削除する手間を省くことができます。

Webhookブロックの各メソッドの違い

GET

POST

PUT

PATCH

DELETE

GET

主な使用目的	一般的な使用例	リクエストボディ	例
サーバーからデータを取得する	ユーザー情報の取得問い合わせの履歴の取得ナレッジベースの記事の取得	×	メールアドレスをもとに顧客のサブスクリプション情報を表示する

POST

主な使用目的	一般的な使用例	リクエストボディ	例
外部アプリ／システムに新しいデータを作成する	新しい問い合わせの作成フォームの送信ユーザーのフィードバックの記録	○（例：JSON）	チャットの利用者の情報をもとにZoho Deskで新しい問い合わせを作成する

PUT

主な使用目的	一般的な使用例	リクエストボディ	例
既存のデータを更新する／置き換える	問い合わせのステータスの更新連絡先情報の更新サブスクリプション情報の変更	○（すべてのデータ）	問い合わせの優先度を「緊急」に変更する

PATCH

主な使用目的	一般的な使用例	リクエストボディ	例
既存のデータの一部を更新する	問い合わせの優先度の更新顧客の電話番号の変更特定の項目の更新	○（一部のデータ）	問い合わせのステータスの項目のみを「対応中」に更新する

DELETE

主な使用目的	一般的な使用例	リクエストボディ	例
サーバーからデータを削除する	問い合わせの削除ユーザーの登録解除顧客のデータの削除	任意	ユーザーの問い合わせを削除する