Get Communication Content (Oracle Utilities Customer Cloud Service Initiated)

When a CSR needs to view the content of a customer’s communication from Customer Cloud Service, Customer Cloud Service sends a request to Opower to get a secure Pre-Authenticated Request (PAR) link to access the communication content.

The communication content remains in Opower and is available through the Content Storage Service which will provide a PAR (Pre-Authenticated Request) link to access the content directly from Object Storage. The PAR link is generated when the request is received from Customer Cloud Service. Customer Cloud Service receives the link to access the communications directly from Object.

The following diagram shows a graphical representation of the Get Communication Content integration process.

A CCS communication request invokes the Opower download-link operation through OIC. OIC returns the content link or an error to CCS.

Get communication content

Processing Details

The integration process deployed on Oracle Integration Cloud is exposed as a REST API and performs the following activities:

  1. The process is triggered when it receives a request from Customer Cloud Service to get an account’s communication content.

  2. Get the generated PAR link by querying the Opower CreateOutboundCommunicationDownloadLink API given the utility code and a communication content path.

  3. Check the response from the query:

    • If no error is encountered, send the PAR link to Customer Cloud Service, which opens the communication in a new browser tab.
    • Any errors encountered are reported back to Customer Cloud Service.

Technical Details

The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Utilities Opower artifacts used in this integration process.

ArtifactValue
Integration Process NameOU CCS OPOWER Communication Content Get
Integration Process IdentifierOUTL-BA-CCS_OPWR_COMMCONTENT_GET
Integration Project NameOU CCS OPOWER
Source Connection (Oracle Utilities Adapter)OU REST CCS for CCS-OPOWER
triggerOutbound message type C1COMMUOM (View Communication Content)
Target Connection (REST Adapter)OU REST OPOWER for CCS-OPOWER
invokeService: Opower GraphQL API
Query: createOutboundCommunicationDownloadLink
Method: POST
URI: https://<host_name>/graphql/
LookupOUTL-BRT-CCS_OPWR_TechnicalConfigProps