[JAVA] Renvoyer les données vocales avec le webhook api.ai

Aperçu

• api.ai peut renvoyer des messages riches tels que des données vocales, des vidéos et des fichiers sous forme de charge utile personnalisée, pas seulement du texte.
• Référence) Rich Messages
• Il semble que toutes les intégrations ne soient pas prises en charge
• Ceci est un mémorandum du type de réponse à renvoyer lors de la webhooking avec facebook messenger.

la mise en oeuvre

Ce n'est pas comme *, mais si vous souhaitez renvoyer des données audio, par exemple, nous implémenterons le retour json suivant.

fulfillment

"fulfillment": {
      "messages": [
        {
          "payload": {
            "facebook": {
              "attachment": {
                "payload": {
                  "url": "https://hogehoge/audio/description.mp3"
                },
                "type": "audio"
              }
            }
          },
          "type": 4
        }
      ]
    }

• Manette. Si Fulfillmet est renvoyé tel quel, une exception se produira, elle est donc renvoyée sous forme de chaîne de caractères.

MainController.java

@Controller
public class MainController {
	
	private final MainService mainService;
	
	public MainController(MainService mainService) {
		this.mainService = mainService;
	}
	
	@ResponseBody
	@PostMapping(value="/webhook")
	public String webhook(HttpServletRequest request) {
		return mainService.createFulfillmentJson();
	}
}

• Faites json.
• Selon le message riche, ResponseSpeech, ResponseImage, ResponsePayload, etc. qui héritent de ResponseMessage sont préparés respectivement.

MainService.java

@Slf4j
@Service
public class MainService {
	private final Gson gson = GsonFactory.getDefaultFactory().getGson();
	
	public String createFulfillmentJson() {
		JsonObject urlJson = new JsonObject();
		urlJson.addProperty("url", "https://hogehoge/audio/description.mp3");
		
		JsonObject payloadJson = new JsonObject();
		payloadJson.add("payload", urlJson);
		payloadJson.addProperty("type", "audio");
		
		JsonObject attachmentJson = new JsonObject();
		attachmentJson.add("attachment", payloadJson);
		
		JsonObject facebookJson   = new JsonObject();
		facebookJson.add("facebook", attachmentJson);
		
		ResponsePayload responsePayload = new ResponsePayload();
		responsePayload.setPayload(facebookJson);
		
		List<ResponseMessage> messages = Collections.singletonList(responsePayload);

		Fulfillment fulfillment = new Fulfillment();
		fulfillment.setMessages(messages);

		return gson.toJson(fulfillment);
	}
}

• Les données vocales sont renvoyées comme ceci.

référence

• Je n'avais pas un bon échantillon, j'ai donc fait référence au code de test du SDK. FulfillmentTest.java
• Référence API côté facebook Envoyer la référence API (https://developers.facebook.com/docs/messenger-platform/send-api-reference/contenttypes)