WikiSysop: Created page with "{{Article |Standalone=No |DisplayName=Provision an API key for GES |TocName=Provision an API key for GES |Context=Use the Environment Service API to assign API keys to a speci..."

2022-09-30T19:45:58Z

Created page with "{{Article |Standalone=No |DisplayName=Provision an API key for GES |TocName=Provision an API key for GES |Context=Use the Environment Service API to assign API keys to a speci..."

New page

{{Article
|Standalone=No
|DisplayName=Provision an API key for GES
|TocName=Provision an API key for GES
|Context=Use the Environment Service API to assign API keys to a specific contact center and to validate that API keys were successfully assigned to the correct contact center.
|ComingSoon=No
|Section={{Section
|alignment=Vertical
|structuredtext=If you plan to work with the Genesys Engagement Service (GES) APIs, then you must first provision an API key. An API key is a unique identifier for an application within a specific contact center. Genesys uses your GES API key to associate a Callback API request with your tenant. If an API key has not been provisioned for GES, then you cannot use the GES APIs. On the other hand, if you use basic in-queue callbacks only, you do not need to provision the API key.

The contact center-to-API key relationship is one-to-many. That is, one contact center can have many API keys assigned to it. An API key can be assigned to only one contact center.

To provision an API key for GES, you use the Environment Service API in the '''gauth''' namespace. For information about Genesys Authentication, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Overview|display text=About Genesys Authentication}}.

All operations supported by the Environment Service API require authenticated access. You'll need client credentials and an authentication token to add an API key to the Environment Service. The token is sent with the request to the Environment Service to store the API key. For information, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Provision|anchor=CreateToken|display text=Create an authentication token}}.
|Status=No
}}{{Section
|sectionHeading=What you'll need to do to provision an API key
|anchor=TaskSummary
|alignment=Vertical
|structuredtext=To provision an API key for GES, you'll do the following:

*Create an API key.<br />The API key must be unique. You decide what you want to use for a key, but Genesys recommends that you generate a UUIDv4 and use that as your API key for GES.
*{{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=GETApprCCID|display text=Find the contact center ID (CCID)}} for the contact center to which you'll assign the API key.
*{{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=AssignAPIKey|display text=Assign the API key}} to the contact center.
*{{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=ValidateAPIKey|display text=Validate the API key}}. You can use a GET request to check that the API key is assigned to the correct CCID. You can also use the {{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=ValidateAPIKeyUI|display text=Callback UI}} to validate the API key.

If you need to remove an API key from a CCID, see {{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=UnassignAPIKey|display text=Unassign an API key}}.

For more information about using the Environment Service API, including how to change CORS settings, or information about Callback APIs, see {{Link-SomewhereInThisVersion|manual=CABPEGuide|topic=ProvisionAPIKey|anchor=Resources|display text=Additional resources}}.
|Status=No
}}{{Section
|sectionHeading=Get the appropriate contact center ID
|anchor=GETApprCCID
|alignment=Vertical
|structuredtext=To manage the GES API key, you require the contact center ID (CCID) for the contact center where GES is deployed. Use a GET operation to request the CCID from the appropriate Environment pod. Include the GES Environment node and port information in the request. For example: <source lang="yaml">GET env:8091/environment/v3/contact-centers</source>

The API responds with the CCID, Environment ID, domain, and authentication information.

If you don't have a CCID already assigned to the appropriate contact center, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Provision|anchor=AddCC|display text=Add a contact center}}.
|Status=No
}}{{Section
|sectionHeading=Assigning an API key to a contact center
|anchor=AssignAPIKey
|alignment=Vertical
|structuredtext=You create your own API key. Use an API key that is random and unique. The assignment of an API key fails if the API key already exists or is assigned to another contact center. Genesys recommends that you generate a UUIDv4 and use that as your API key.

Remember that all operations supported by the Environment Service API require authenticated access. You'll need client credentials and an authentication token to assign the API key to a contact center. The token is sent with the request to the Environment Service to store the API key. For information, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Provision|anchor=CreateToken|display text=Create an authentication token}}.

To provision and associate an API key with your contact center, use the following POST request:
<source lang="yaml">
POST .../environment/v3/contact-centers/{ccid}/api-keys
</source>

Include the API key attribute (<tt>apiKey</tt>) in the body of the POST API request. For example:
<source lang="yaml">
curl --location --request POST 'env:8091/environment/v3/contact-centers/ed4c03f3-6275-4419-8b2b-11d14af10655/api-keys' \

--header 'Content-Type: application/json' \
--header 'Authorization: Bearer f3aa2109-8889-4182-b2b7-d86917c53e4e' \
--data-raw '{
"data": {
"apiKey" : "78fd8f03-d9d0-4140-8aae-09f3f15d1392"
}
}'
</source>

After you've assigned the API key to the contact center, the key is used as the value for <tt>x-api-key</tt> in the header of every request to the GES APIs.
|Status=No
}}{{Section
|sectionHeading=Validating that the API key is correctly assigned to a contact center
|anchor=ValidateAPIKey
|alignment=Vertical
|structuredtext=To verify that the API key for GES was successfully assigned to the contact center where GES is deployed, use the API key that you created for GES to look up the CCID. You can also use the CCID to retrieve the collection of API keys assigned to the contact center; ensure the API key for GES is included.

To find the contact center to which a specific API key is assigned, use the following GET request. The API key must be URL-encoded. For information, see [https://developers.google.com/maps/url-encoding Google URL-Encoding].
<source lang="yaml">GET .../environment/v3/contact-centers/api-key/<url-encoded api key value></source>

The API response provides the CCID, Environment ID, domain, and authentication information.

To retrieve the list of API keys assigned to a contact center, use the following GET request:
<source lang="yaml">GET .../environment/v3/contact-centers/{ccid}/api-keys</source>

The API returns the list of API keys assigned to the CCID.
|Status=No
}}{{Section
|sectionHeading=Validating an API key using the Callback UI
|anchor=ValidateAPIKeyUI
|alignment=Vertical
|structuredtext=For information about validating an API key using the Callback UI, see {{Link-AnywhereElse|product=PEC-CAB|version=Current|manual=Administrator|topic=CallbackDeveloper|anchor=validate_api_key|display text=Validating your API key}} in the ''Callback Administrator's Guide''.
|Status=No
}}{{Section
|sectionHeading=Unassigning an API key
|anchor=UnassignAPIKey
|alignment=Vertical
|structuredtext=To remove an API key from a contact center, use the following DELETE operation, where {apiKey} is the API key you want to remove from the contact center:
<source lang="yaml">
DELETE .../environment/v3/contact-centers/{ccid}/api-keys/{apiKey}
</source>
|Status=No
}}{{Section
|sectionHeading=Additional resources
|anchor=Resources
|alignment=Vertical
|structuredtext=When provisioning an API key for GES or working with GES APIs, you might find the following resources helpful:

*For detailed information about using the Genesys Authentication Environment Service API to create authentication tokens or to add a Genesys tenant, contact center, or data center, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Provision|display text=Provision Genesys Authentication}}.
*The documentation for GES REST APIs is available through the [https://developer.genesyscloud.com/reference/engagement/ Genesys Multicloud CX Developer Center]. The GES/Callback APIs are:
**[https://developer.genesyscloud.com/reference/engagement/Callbacks/index.html Callbacks] — Create, retrieve, cancel callbacks.
**[https://developer.genesyscloud.com/reference/engagement/Estimated-Wait-Time/index.html Estimated Wait Time] —Retrieve Estimated Wait Time.
**[https://developer.genesyscloud.com/reference/engagement/Availability/index.html Availability] — Retrieve time slots for a callback, matching Office Hours.
**[https://developer.genesyscloud.com/reference/engagement/Call-In/index.html Call In] — Request the phone number to call in.
**[https://developer.genesyscloud.com/reference/engagement/Queue-Status/index.html Queue Status] — Retrieve information about a queue's readiness to accept callbacks.
**[https://developer.genesyscloud.com/reference/engagement/Statistics/ Statistics] — Provides a proxy to the GWS Statistics API. To use the Callback Statistics API, you must first [https://all.docs.genesys.com/PEC-CAB/Current/Administrator/CallbackStatisticsAPI register your GWS credentials] in the Callback UI ('''Developer''' > '''Credential Management''' > '''GWS Credentials''' tab).

*For web-based callbacks, you might need to configure or update CORS domains. For information, see {{Link-AnywhereElse|product=AUTH|version=Current|manual=AuthPEGuide|topic=Provision|anchor=UpdateCORS|display text=Update CORS settings}}.
|Status=No
}}
}}

PEC-CAB/Current/CABPEGuide/ProvisionAPIKey - Revision history

WikiSysop: Created page with "{{Article |Standalone=No |DisplayName=Provision an API key for GES |TocName=Provision an API key for GES |Context=Use the Environment Service API to assign API keys to a speci..."