Peristiwa kustom

Peristiwa kustom adalah peristiwa yang Anda tentukan. Peristiwa ini digunakan untuk menangani hal-hal yang terjadi di luar percakapan dengan pengguna akhir. Misalnya, pengguna akhir mengklik tombol, waktu dengan durasi tertentu telah berlalu, inventaris yang tersedia telah berubah selama percakapan, dan sebagainya.

Anda dapat memanggil peristiwa ini menggunakan fulfillment atau API.

Memanggil peristiwa dengan API

Permintaan untuk panggilan Sessions jenis detectIntent berisi kolom queryInput.event, yang digunakan untuk memanggil peristiwa. Jenis kolom ini adalah EventInput, dan berisi kolom untuk nama peristiwa, parameter opsional, dan kode bahasa.

Saat Anda memberikan peristiwa ke panggilan deteksi intent, Anda tidak memberikan data lain, seperti ekspresi pengguna akhir. Satu-satunya tujuan panggilan ini adalah untuk memanggil peristiwa dan memicu intent.

Memanggil peristiwa dengan fulfillment

Anda dapat memanggil peristiwa melalui fulfillment dengan menetapkan kolom followupEventInput dari WebhookResponse. Anda dapat menetapkan kolom followupEventInput.parameters secara opsional untuk memberikan parameter ke intent.

Contoh:

{
  "followupEventInput": {
    "name": "event-name",
    "parameters": {
      "parameter-name-1": "parameter-value-1",
      "parameter-name-2": "parameter-value-2"
    },
    "languageCode": "en-US"
  }
}

Jika parameter followupEventInput ditetapkan untuk WebhookResponse, Dialogflow akan mengabaikan kolom fulfillmentText, fulfillmentMessages, dan payload. Selain itu, kolom followupEventInput.languageCode adalah kolom wajib, tetapi Dialogflow mengabaikan kolom ini, karena bahasa telah ditentukan dalam permintaan deteksi intent asli.

Saat Dialogflow menerima respons webhook yang menyertakan peristiwa, Dialogflow akan segera memicu intent yang sesuai tempat peristiwa tersebut ditentukan.

Alur berikut menjelaskan langkah-langkahnya:

1. Pengguna akhir mengetik atau mengucapkan ekspresi.
2. Dialogflow mencocokkan ekspresi pengguna akhir dengan Intent-1, yang dikonfigurasi untuk fulfillment.
3. Dialogflow mengirimkan permintaan webhook ke server Anda.
4. Server Anda merespons dengan respons webhook yang menyertakan peristiwa lanjutan.
5. Dialogflow tidak merespons pengguna untuk kecocokan Intent-1 , tetapi memicu Intent-2 , yang dikonfigurasi untuk peristiwa tersebut.
6. Dialogflow melanjutkan seolah-olah pengguna akhir memulai kecocokan untuk Intent-2 dan menangani parameter dan fulfillment yang diperlukan seperti yang ditentukan oleh konfigurasi Intent-2.

Menghubungkan kecocokan intent dengan peristiwa respons webhook

Kecocokan intent dapat dihubungkan dengan peristiwa respons webhook. Dalam alur yang dijelaskan di atas, Intent-2 juga dapat dikonfigurasi untuk fulfillment. Jika respons webhook server Anda menyediakan peristiwa lain, Dialogflow akan melanjutkan untuk mencocokkan Intent-3 (dikonfigurasi untuk peristiwa tersebut) tanpa merespons pengguna akhir untuk Intent-2.

Dialogflow tidak merespons pengguna akhir hingga rantai berakhir. Saat menghubungkan intent dengan cara ini, setiap respons webhook harus dikirim dalam batasan waktu tunggu.