Create Phone Connection

Create a new phone connection for a product.

Returns

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

Example

phone_connection = galtea.phone_connections.create(
    product_id=product_id,
    name="production-voice-agent-" + run_identifier,
    phone_number="[phone]",
    agent_speaks_first=False,
)

Parameters

product_id · string · required

ID of the product this connection belongs to.

name · string · required

Name of the phone connection. Must be unique per product.

phone_number · string · required

The phone number Galtea dials to reach your AI agent, in E.164 format (a leading + followed by country code and number, e.g., [phone]).

agent_speaks_first · boolean

Whether the voice agent opens the conversation once the call 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 phone connection, so one connection can serve test cases in different languages. See Phone Connection.