Genesys

PolyAI integrates with Genesys Cloud’s Bring Your Own Carrier (BYOC) service to provide efficient call handling, routing, and handoff capabilities. This guide explains how to integrate your Genesys Cloud instance with the PolyAI app available on the Genesys AppFoundry page.

​

PolyAI configuration

1. Get connection tokens:

   • PolyAI will provide you with two tokens:
     • A UAT Token to use for testing.
     • A Production Token to use for live deployment.
   • Use these tokens to authenticate your SIP trunks with PolyAI.

2. Enable Handoff API:

   • If screen pop is required, make sure you have configured your project to meet the standards of the Handoff API.
   • Request an API key from PolyAI for this functionality.

3. Prepare for SIP INVITE data:

   • Your Genesys SIP INVITE will include:
     • x-inin-cnv: the Genesys Conversation ID.
     • X-User-to-User: Custom data in the format X-User-to-User:{data};encoding=ascii.

4. Send data during SIP REFER:

   • To return data to Genesys, use this format in the SIP REFER message:

     Refer-To: <sip:{route}@{ip}?User-to-User={pd}{data}%3Bencoding%3Dhex>

     • Replace {pd} with the protocol discriminator (two hex digits).
     • Replace {data} with the hex-encoded information.

​

Genesys trunk setup

​

Prerequisites

• PolyAI tokens: You should have both UAT and Production tokens provided by PolyAI.
• Admin access: Ensure your Genesys account has permissions to manage external SIP trunks.

​

Configure the primary trunk

To configure a SIP trunk with Genesys Cloud, follow these steps.

​

Create the secondary trunk

Repeat the above steps with the secondary PolyAI server and IP for your region:

​

Set failover routing

1. Go to Site > Edit Site > Outbound Routes in Genesys Cloud.
2. Set the distribution pattern to Sequential to enable failover from the primary trunk to the secondary trunk.

For support, contact PolyAI at support@polyai.com.