Skip to main content

​
Returns

Returns a WebRTC Connection object for the given parameters, or None if an error occurs.

​
Example

web_rtc_connection = galtea.web_rtc_connections.create(
    product_id=product_id,
    name="production-voice-agent-" + run_identifier,
    api_key="YOUR_PIPECAT_CLOUD_API_KEY",
    agent_name="my-pipecat-agent",
    agent_speaks_first=False,
)

​
Parameters

​
product_id
string
required
ID of the product this connection belongs to.
​
name
string
required
Name of the WebRTC connection. Must be unique per product.
​
api_key
string
required
The Pipecat Cloud public API key (pk_...) Galtea uses to reach your agent, the credential its runtime /start call needs. This is not the pcc_pat_ Personal Access Token used to deploy the agent. This is a secret. Galtea stores it encrypted and the API never returns it. A fetched connection exposes only a has_api_key boolean, never the key itself.
​
agent_name
string
required
The name of your deployed Pipecat Cloud agent (for example, the agent_name you deployed with). It must match that agent’s name exactly. Galtea passes it to Pipecat Cloud’s /start call to launch the session; if no deployed agent has this name, the call fails.
​
agent_speaks_first
boolean
Whether the voice agent opens the conversation once the session connects. Defaults to False (the simulated caller speaks first). Pass True for interviewer-style agents that greet the caller first.
The simulated caller’s spoken language is taken from each test case’s language, not the WebRTC connection, so one connection can serve test cases in different languages. See WebRTC Connection.