Receiving and Processing MO Messages Sent on Facebook

Function

This interface is invoked to receive and process MO messages sent on Facebook.

Usage Description

• Prerequisites

  The authentication is successful, and the connection to the CC-Messaging is successful.

• For details, visit official document at https://developers.facebook.com/.

Interface Authentication

Obtain the authentication character string in the request header X-Hub-Signature-XX and compare the parameter in the request with the encrypted secretKey in the channel configuration. If they are the same, the authentication is successful.
        String algorithm = channelConfig.getAlgorithm();
        String signature = "";
        if (AlgorithmEnum.SHA256.getValue().equals(algorithm)) {
            String signatureHeader = request.getHeader("X-Hub-Signature-256");
            // Verify signatureHeaderSha256.
            if (StringUtils.isTrimEmpty(signatureHeader)) {
                log.error("sha256 Signature from facebook is empty");
                return false;
            }
            signature = StringUtils.substringAfter(signatureHeader, "sha256=");
        } else {
            String signatureHeader = request.getHeader();
            // Verify signatureHeader.
            if (StringUtils.isTrimEmpty(signatureHeader)) {
                log.error("sha1 Signature from facebook is empty");
                return false;
            }
            signature = StringUtils.substringAfter(signatureHeader, "sha1=");
        }
        String hash;
        try {
            hash = getSignatureByAlgorithm(payloadContent, secretKey, channelConfig.getAlgorithm());
        } catch (Exception e) {
            log.error("Fail to get the signature, and the exception is {}", e.getMessage());
            return false;
        }
        return StringUtils.equals(hash, signature);

Interface Prototype

Request Parameters

Response Parameters

If this interface is invoked successfully, no response is returned.

If this interface fails to be invoked, a status code and error description are returned.

Example

• Request

  POST /social/on/facebook/202108135240338790
  
  host : 10.10.10.2:28090
  connection : Keep-Alive
  x-forwarded-for : 10.10.10.3, 10.10.10.4
  x-real-ip : 10.10.10.5
  content-length : 314
  remote-host : 10.10.10.6
  accept : */*
  accept-encoding : deflate, gzip
  user-agent : facebookexternalua
  content-type : application/json
  x-hub-signature-256 : sha256=599c****************3bc
  facebook-api-version : v8.0
  
  {
  	"object" : "page",
  	"entry" : [{
  			"id" : "107416531546370",
  			"time" : 1629191082254,
  			"messaging" : [{
  					"sender" : {
  						"id" : "5465176836886605"
  					},
  					"recipient" : {
  						"id" : "107416531546370"
  					},
  					"timestamp" : 1629191082001,
  					"message" : {
  						"mid" : "m_5ugOgGm2v5x36EyvvInnNOwvV5bGYdVdhgz8VK0mdjnLC3qm8PfaQZdWwAsLOg8hiDIqmpkcYQtllLH_tDzl7A",
  						"text" : "jianlian"
  					}
  				}
  			]
  		}
  	]
  }