OpenConnect

OpenConnect


Info

OpenConnect replaces "Connect API" - Please use this article to test connectivity and API calls into OpenConnect


Why Is OpenConnect Critical To Oracle & Zendesk?
  1. OpenConnect allows Experience Cloud to integrate with various contact center platforms, such as telephony, voice, ACD, routing, and contact center solutions, to facilitate CRM automation and data transfer into the CRM. 
  2. OpenConnect addresses several common challenges within Oracle & Zendesk environments, primarily the inefficiencies caused by operating multiple disparate systems. By seamlessly connecting the CRM with contact center routing platforms and telephony voice channels, OpenConnect enhances workflow efficiency in several ways.

Building A Connection


Step 1: Requirements
  1. The platform using access to OpenConnect must be able to establish Ingress and Egress API connections.
  2. You will need a few pieces of information to authenticate with OpenConnect: JWT Key, CRM ID, Event Name
Step 2: JWT Key
JWT Key 
Copy the API Token or Re-Generate a new token if applicable.


Login to Experience Cloud.



 Expand the Navigation Menu and Click "System Settings" 

  • Select "API Key" from Menu
  • Click “Re-generate”
  • Copy New Key
  • Update any references of the old key with the newly re-generated key.
Step 3: CRM ID
Example: In Service Cloud or Fusion, the CRM ID is the domain.

Info
For Zendesk, use the hostname of the Zendesk Environment URL.

Example: https://this-is-a-test.zendesk.com/example/ex
Step 4: Event Name

To trigger the published PopFlow, we must get the event to which it belongs. 

  1. Login to Experience Cloud and navigate to the Instance
  2. Find the event of the published PopFlow and copy the name exactly (case and length sensitive)
Step 5: Parameters
Warning

Required

Add each required query parameter. Note each parameter is case-sensitive.

 

agentid

  • The agentid creates the experience at the agent/user level. For example, use your user login for the agentid or use login for the user who will receive the experience.


jwt
  • Replace insert_api_key with the generated API key from Experience Cloud.

event

  • The event is the event's name that will trigger the PopFlow from your Experience Cloud platform.

 

Optional Data Properties

Pass and include additional data elements in your requests, such as interaction data, custom information, routing, or ACD data.

Step 6: Testing
Test your API calls using the GET & POST Sections below.
GET
Add each required query parameter.


  1. agentid={insert_agentId}&jwt={insert_api_key}&event={name_of_event}

 

Ex: agentid=123&jwt=456&event=testing123

 


Info
Add any additional data needed for PopFlow workflow.

  1. &prop1={insert_prop1}&prop2={insert_prop2}

 

All together, it will look like this:

 

POST
Alert

Payload Size Limitations 

OpenConnect limits the payload size to 128 KB per message due to variable-length encoding. 

 

Set up the base URL: https://connect.openmethodscloud.com/api/sendmessage/CRM?

 

  1. Then, the body is set up, ensuring the Content-Type is set to application/JSON.
  2. Finally, add the required body fields and the additional data for the PopFlow workflow. 

  1. {
  2.    "agentid": "insert_agentId",
  3.    "jwt": "insert_api_key",
  4.    "crmid": "insert_crmid",
  5.    "event": "insert_event_name",
  6.    "insert_prop_1": "insert_prop_1_value",
  7.    "insert_prop_2": "insert_prop_2_value",
  8.    "insert_prop_3": "insert_prop_3_value",
  9. }

 

  

 Troubleshooting

Was the event not triggered?

  1. Ensure the event name is typed correctly, both case and length (spaces included).
  2. Double-check that the intended Popflow to be triggered is published to the event being called.
  3. Finally, if in Service Cloud CRM, ensure that the published profile matches the CRM user's profile.
  4. If you received a 401 Error - Unauthorized Response - Check your API Key is valid.

 

Example Connection Sets

Example connection sets utilizing OpenConnect to facilitate information to/from OpenMethods:

  • 8x8
  • Amazon Connect
  • Avaya
  • Cisco UCCE
  • Cisco UCCX
  • Cisco WebEx Contact Center
  • Five9
  • Genesys PureCloud
  • Genesys PureConnect
  • Genesys PureEngage
  • InContact Central
  • InContact Hub
  • TalkDesk
  • Twilio Flex

 

 




    Still can’t find an answer?
      • Related Articles

      • Product Requirements & Compatibility

        Browser Support We've optimized our product for Google Chrome. Although similar browsers may work, we recommend using Chrome for the best performance and features. Known Browser Issues Modern browsers with memory and power-saving features can cause ...
      • Required: URL Allow List & API Endpoints

        This section includes Allow List URLs specific to OpenMethods services and owned connections. Our Recommended Method: ⚠️ OpenMethods is constantly making updates and improvements to our Application and API architecture. To avoid missing URLs and ...
      • Changelog

        OpenMethods is constantly improving our platform and products. The following is a historical list (changelog) of updates delivered to OpenMethods clients and their corresponding schedule maintenance and release events via our Status Page. If you have ...