Descarga dialogflow fulfillment webhook php - Descarga del código fuente dialogflow fulfillment webhook php

Biblioteca PHP de cumplimiento de Dialogflow

Esta biblioteca está inspirada en dialogflow/dialogflow-fulfillment-nodejs.

Admite solicitudes y respuestas JSON del webhook de cumplimiento de Dialogflow para agentes v1 y v2.

Para obtener una referencia completa de la clase, consulte el documento.

Instalación
Uso
- Agente iniciado
- Obtener información de solicitud
- Enviar respuesta
- Mensaje rico
  - Texto
  - Imagen
  - Tarjeta
  - Sugerencia
  - Carga útil personalizada
- Acciones en Google
  - Enviar respuesta
  - Respuestas
    - Respuesta sencilla
    - Imagen
    - Tarjeta Básica
    - Lista
    - Carrusel
    - Carrusel de navegación
    - chip de sugerencia
    - Respuestas de los medios
  - Ayudantes
    - Información del usuario
    - Fecha y hora
    - Lugar y ubicación
    - Confirmación
  - Capacidades de superficie

Instalación

Instalar a través del compositor: composer require eristemena/dialogflow-fulfillment-webhook-php .

Uso

Agente iniciado

Para iniciar el agente, use el constructor DialogflowWebhookClient con el parámetro de entrada como matriz de solicitud proveniente de Dialogflow.

En Vanilla PHP, esto se puede hacer de la siguiente manera:

 use Dialogflow  WebhookClient ;

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

// or

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

o si estás usando Laravel,

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

Obtener información de solicitud

Intención

 $ intent = $ agent -> getIntent ();

Acción

 $ action = $ agent -> getAction ();

Consulta

 $ query = $ agent -> getQuery ();

Parámetros

 $ parameters = $ agent -> getParameters ();

Sesión

 $ session = $ agent -> getSession ();

Contextos

 $ contexts = $ agent -> getContexts ();

Idioma

 $ language = $ agent -> getLocale ();

Fuente de solicitud (por ejemplo: google , facebook , slack , etc.)

 $ originalRequest = $ agent -> getRequestSource ();

Solicitud original, carga útil específica de la plataforma

 $ originalRequest = $ agent -> getOriginalRequest ();

Versión del agente (1 o 2)

 $ agentVersion = $ agent -> getAgentVersion ();

Enviar respuesta

Para enviar una respuesta, utilice el método reply() .

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

Luego use render() para obtener la respuesta en una matriz. Todo lo que tienes que hacer es imprimir la matriz como JSON,

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

o en Laravel,

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

La carga útil de respuesta se formateará automáticamente según la versión del agente de la solicitud.

Mensaje rico

Texto

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

Imagen

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

Tarjeta

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

Sugerencia

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

Carga útil personalizada

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

Acciones en Google

Esta biblioteca también admite funcionalidades específicas de Acciones en Google. Todavía está en desarrollo, por lo que se agregarán más funciones en el futuro.

Para utilizar Acciones en el objeto de conversación de Google Dialogflow, primero debe asegurarse de que la requestSource provenga del Asistente de Google.

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

o simplemente puede llamar al método getActionConversation() y devolverá null si la solicitud no proviene del Asistente de 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
}

Enviar respuesta

Usando el objeto Conversación de Dialogflow, puede enviar una respuesta de dos maneras:

Enviar una respuesta y cerrar la conversación.

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

Enviar una respuesta y esperar la respuesta del usuario.

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