Unduhan dialogflow fulfillment webhook php - unduhan kode sumber dialogflow fulfillment webhook php

Pustaka PHP Pemenuhan Dialogflow

Perpustakaan ini terinspirasi oleh dialogflow/dialogflow-fulfillment-nodejs.

Ini mendukung permintaan dan respons JSON webhook pemenuhan Dialogflow untuk agen v1 dan v2.

Untuk referensi kelas lengkap silakan merujuk ke dokumen.

Instalasi
Penggunaan
- Inisiasi Agen
- Dapatkan Info Permintaan
- Kirim Balasan
- Pesan yang Kaya
  - Teks
  - Gambar
  - Kartu
  - Saran
  - Muatan khusus
- Tindakan di Google
  - Kirim Balasan
  - Tanggapan
    - Respon Sederhana
    - Gambar
    - Kartu Dasar
    - Daftar
    - Korsel
    - Menjelajah Korsel
    - Chip Saran
    - Tanggapan Media
  - Pembantu
    - Informasi pengguna
    - Tanggal dan Waktu
    - Tempat dan Lokasi
    - Konfirmasi
  - Kemampuan Permukaan

Instalasi

Instal melalui komposer: composer require eristemena/dialogflow-fulfillment-webhook-php .

Penggunaan

Inisiasi Agen

Untuk memulai agen, gunakan konstruktor DialogflowWebhookClient dengan parameter input sebagai larik permintaan yang berasal dari Dialogflow.

Di Vanilla PHP, ini bisa dilakukan sebagai berikut,

 use Dialogflow  WebhookClient ;

$ agent = new WebhookClient ( json_decode ( file_get_contents ( ' php://input ' ), true ));

// or

$ agent = WebhookClient :: fromData ( $ _POST );

atau jika Anda menggunakan Laravel,

 $ agent =  Dialogflow  WebhookClient :: fromData ( $ request -> json ()-> all ());

Dapatkan Info Permintaan

Maksud

 $ intent = $ agent -> getIntent ();

Tindakan

 $ action = $ agent -> getAction ();

Pertanyaan

 $ query = $ agent -> getQuery ();

Parameter

 $ parameters = $ agent -> getParameters ();

Sidang

 $ session = $ agent -> getSession ();

Konteks

 $ contexts = $ agent -> getContexts ();

Bahasa

 $ language = $ agent -> getLocale ();

Sumber Permintaan (misal: google , facebook , slack , dll)

 $ originalRequest = $ agent -> getRequestSource ();

Permintaan Asli, muatan khusus platform

 $ originalRequest = $ agent -> getOriginalRequest ();

Versi Agen (1 atau 2)

 $ agentVersion = $ agent -> getAgentVersion ();

Kirim Balasan

Untuk mengirim balasan, gunakan metode reply() .

 $ agent -> reply ( ' Hi, how can I help? ' );

Kemudian gunakan render() untuk mendapatkan respons dalam array. Yang harus Anda lakukan adalah mencetak array sebagai JSON,

 header ( ' Content-type: application/json ' );
echo json_encode ( $ agent -> render ());

atau di Laravel,

 return response ()-> json ( $ agent -> render ());

Payload respons akan secara otomatis diformat sesuai dengan Versi Agen permintaan.

Pesan yang Kaya

Teks

 $ text =  Dialogflow  RichMessage  Text :: create ()
    -> text ( ' This is text ' )
    -> ssml ( ' <speak>This is <say-as interpret-as="characters">ssml</say-as></speak> ' )
;
$ agent -> reply ( $ text );

Gambar

 $ image =  Dialogflow  RichMessage  Image :: create ( ' https://www.example.com/image.png ' );
$ agent -> reply ( $ image );

Kartu

 $ card =  Dialogflow  RichMessage  Card :: create ()
    -> title ( ' This is title ' )
    -> text ( ' this is text body ' )
    -> image ( ' https://www.example.com/image.png ' )
    -> button ( ' This is a button ' , ' https://docs.dialogflow.com/ ' )
;
$ agent -> reply ( $ card );

Saran

 $ suggestion =  Dialogflow  RichMessage  Suggestion :: create ([ ' Suggestion one ' , ' Suggestion two ' ]);
$ agent -> reply ( $ suggestion );

Muatan khusus

 if ( $ agent -> getRequestSource ()== ' google ' ) {
    $ agent -> reply ( Dialogflow  RichMessage  Payload :: create ([
        ' expectUserResponse ' => false
    ]));
}

Tindakan di Google

Pustaka ini juga mendukung fungsi khusus Actions on Google. Ini masih dalam pengembangan, jadi lebih banyak fitur akan ditambahkan di masa depan.

Untuk menggunakan objek Percakapan Actions on Google Dialogflow, Anda harus terlebih dahulu memastikan requestSource berasal dari Asisten Google,

 if ( $ agent -> getRequestSource ()== ' google ' ) {
    $ conv = $ agent -> getActionConversation ();
    
    // here you can use the rest of Actions on Google responses and helpers
    
    $ agent -> reply ( $ conv );
}

atau Anda cukup memanggil metode getActionConversation() , dan metode tersebut akan mengembalikan null jika permintaan tidak datang dari Asisten Google.

 $ conv = $ agent -> getActionConversation ();

if ( $ conv ) {
	// here you can use the rest of Actions on Google responses and helpers
} else {
	// the request does not come from Google Assistant
}

Kirim Balasan

Menggunakan objek Dialogflow Conversation, Anda dapat mengirim balasan dengan dua cara,

Kirim balasan dan tutup percakapan

 $ conv -> close ( ' Have a nice day! ' );

Kirim balasan dan tunggu tanggapan pengguna

 $ conv -> ask ( ' Hi, how can I help? ' );