Synthflow AI voice agents for Genesys Cloud


How a call moves
- A customer dials your Genesys number. The number stays on your Genesys number plan. Synthflow imports it as a custom number whose SIP domain is your organization's BYOC address, such as synthflow.byoc.usw2.pure.cloud.
- Architect picks the calls. Your inbound flow sends the DIDs or IVR branches you chose to the Synthflow trunk; every other call keeps its flow.
- The call crosses the trunk to sip.synthflow.ai on port 32681, or 32682 for TLS, with digest authentication, and Genesys admits only Synthflow's signaling addresses.
- The agent knows the caller. The caller's number is a variable on every call, and an inbound webhook can return the caller's account before the conversation starts.
- The agent does the work, from its knowledge base and with custom actions in your systems while the caller waits.
- The agent hands the caller back. A cold transfer sends a SIP REFER over the same trunk to a SIP address in your Genesys organization, with the values it collected in one User-to-User header. The caller's own number stays on the call.
- Architect routes on that data. The flow at that address reads Call.UUIData, keeps each value as participant data and queues the call with a Transfer to ACD action.
- Synthflow keeps the AI's record: transcript, actions and outcome in each call log, and the post-call webhook sends them to your systems.
What Genesys keeps
Hand-off data
- UUI Passthrough on. Genesys Cloud recognizes UUI data only once UUI Passthrough is enabled (Set UUI Data). It sits on the Synthflow trunk under Protocol (Genesys's steps), with Type set to User-To-User.
- Both encodings arrive whole. Genesys removes the first octet of a User-to-User header as its protocol discriminator, unless a pd parameter carries it (UUI data formats). Synthflow's hex payload starts with 00 and its ASCII payload carries pd=00, so your values arrive intact.
- 128 characters or fewer. Genesys accepts 28 KB but recommends 128 characters, because some systems discard longer data (UUI overview).
- ASCII for accented letters. Genesys cannot decode hex that turns into extended ASCII (characters 128 to 255), so send José in ASCII, or send an ID (UUI data formats).
- No secure flows. Call.UUIData is not available in secure call flows; pass values there as invocation data (Set UUI Data).
Worked example: the billing line
disputes|48213977|yes|duplicate card charge: 43 characters, inside 128. In hex the header carries 88 characters, the 00 plus two for each of the 43, and Genesys decodes the same 43. The reason varies by call, so budget for the longest answer you expect.Setup
Fit and limits
- Tier 2. Synthflow does not regression-test Genesys Cloud (telephony integrations), so deployments vary more than on Tier 1 systems such as Five9 and can need Professional Services: put launch support in the agreement.
- Throughput. Synthflow's guide says this trunk "provides basic SIP connectivity, and its throughput may be limited", and that "higher concurrency and priority routing" need an AppFoundry listing, so size your peak concurrent calls with Synthflow and your Genesys account team before you commit volume.
- BYOC Cloud. The guide is written for BYOC Cloud, and Genesys says UUI is not available for Genesys Cloud Voice calls (UUI overview), so on BYOC Premises or Genesys Cloud Voice, settle the route with both teams first.
- One try on a cold transfer. If the Genesys address does not answer, the call ends (call transfers), so point every hand-back at an Architect flow that always answers and queues.
- Transfers tested by real calls. The Test Center simulates transfers, and Synthflow's transfer page confirms the SIP REFER of a cold transfer only for Twilio and Telnyx, so test each hand-back reason with real calls on your trunk.
- Data into the agent. Synthflow reads X- headers, X-EI and Diversion on an incoming call, not a User-to-User header (call context), so get context from the caller's number and an inbound webhook lookup.
Questions
Does Synthflow integrate with Genesys Cloud?
Yes. A Synthflow agent connects to Genesys Cloud CX over a BYOC Carrier trunk, takes the calls Architect routes to it, places outbound calls and transfers callers back to Genesys queues, as Synthflow's Genesys Cloud guide sets out.
Is Synthflow in the Genesys AppFoundry?
Not today, and the trunk needs no app: your Genesys admin creates it under Admin, Telephony, Trunks, External Trunks. Synthflow's guide asks you to raise a full AppFoundry integration with your Genesys account team and Synthflow sales.
Can the AI agent tell Architect why the caller needs a person?
Yes, on a cold transfer. The transfer action packs values such as the intent, an account number and the reason into the SIP User-to-User header, and your Architect flow reads them from Call.UUIData.
Does the caller keep their number when the agent hands them back?
Yes, on a cold transfer: it hands the call over with SIP REFER, so Genesys sees the original caller's number, and Synthflow's guide has you test that each transfer lands in its queue with caller ID intact. A warm transfer starts a new call leg and shows the agent's number: Synthflow's Caller ID setting for the caller's original number works only with numbers bought from Synthflow, so it fails on a number imported from Genesys (call transfers).
Can the Synthflow agent make outbound calls through Genesys Cloud?
Yes. The agent places calls over the same trunk, and Genesys sends them out with the Caller Address set on the trunk. Volume runs within the concurrency and call attempts per second agreed with Synthflow (concurrency).
Is Synthflow SOC 2 compliant?
Yes. Synthflow's Trust Center lists SOC 2 Type 2, ISO/IEC 27001, GDPR, HIPAA (self-attested) and PCI DSS v4.0.1, and your security team requests the reports there. On the trunk, Synthflow checks the digest credentials of the calls Genesys sends, Genesys admits only Synthflow's signaling addresses, and signaling can run over TLS (Genesys Cloud guide, Connect over SIP).