Create WebRTC Connection

Create a new WebRTC connection for a product.

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.