Загрузка dialogflow fulfillment webhook php - dialogflow fulfillment webhook php Загрузка исходного кода

PHP-библиотека выполнения Dialogflow

Эта библиотека вдохновлена диалоговым потоком/dialogflow-fulfillment-nodejs.

Он поддерживает запросы и ответы JSON веб-перехватчика Dialogflow для агентов v1 и v2.

Полную информацию о классе можно найти в документе.

Установка
Использование
- Инициировать агент
- Получить информацию о запросе
- Отправить ответ
- Богатое сообщение
  - Текст
  - Изображение
  - Карта
  - Предположение
  - Пользовательская полезная нагрузка
- Действия в Google
  - Отправить ответ
  - Ответы
    - Простой ответ
    - Изображение
    - Базовая карта
    - Список
    - Карусель
    - Просмотр карусели
    - Чип предложения
    - Ответы СМИ
  - Помощники
    - Информация о пользователе
    - Дата и время
    - Место и расположение
    - Подтверждение
  - Возможности поверхности

Установка

Установите через композитор: composer require eristemena/dialogflow-fulfillment-webhook-php .

Использование

Инициировать агент

Чтобы инициировать агент, используйте конструктор DialogflowWebhookClient с входным параметром в качестве массива запроса, поступающего от Dialogflow.

В Vanilla PHP это можно сделать следующим образом:

 use Dialogflow  WebhookClient ;

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

// or

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

или если вы используете Laravel,

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

Получить информацию о запросе

Намерение

 $ intent = $ agent -> getIntent ();

Действие

 $ action = $ agent -> getAction ();

Запрос

 $ query = $ agent -> getQuery ();

Параметры

 $ parameters = $ agent -> getParameters ();

Сессия

 $ session = $ agent -> getSession ();

Контексты

 $ contexts = $ agent -> getContexts ();

Язык

 $ language = $ agent -> getLocale ();

Источник запроса (например: google , facebook , slack и т. д.)

 $ originalRequest = $ agent -> getRequestSource ();

Исходный запрос, полезная нагрузка для конкретной платформы

 $ originalRequest = $ agent -> getOriginalRequest ();

Версия агента (1 или 2)

 $ agentVersion = $ agent -> getAgentVersion ();

Отправить ответ

Чтобы отправить ответ, используйте метод reply() .

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

Затем используйте render() чтобы получить ответ в массиве. Все, что вам нужно сделать, это распечатать массив в формате JSON.

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

или в Ларавеле,

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

Полезные данные ответа будут автоматически отформатированы в соответствии с версией агента запроса.

Богатое сообщение

Текст

 $ 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 );

Изображение

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

Карта

 $ 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 );

Предположение

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

Пользовательская полезная нагрузка

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

Действия в Google

Эта библиотека также поддерживает специальные функции Actions on Google. Он все еще находится в стадии разработки, поэтому в будущем будут добавлены дополнительные функции.

Чтобы использовать Actions on Google Dialogflow Conversation, вам сначала необходимо убедиться, что requestSource поступает из Google Assistant,

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

или вы можете просто вызвать метод getActionConversation() , и он вернет null если запрос поступает не от Google Assistant.

 $ 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
}

Отправить ответ

Используя объект диалога Dialogflow, вы можете отправить ответ двумя способами:

Отправьте ответ и закройте разговор

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

Отправьте ответ и дождитесь ответа пользователя

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