Member Junction
    Preparing search index...

    Full telephony section configuration shape.

    interface TelephonyConfig {
        costPerMinute?: number;
        enabled: boolean;
        inboundRunAsUserEmail?: string;
        livekitSip?: LiveKitSipSettings;
        maxCallSeconds?: number;
        maxConcurrentCalls?: number;
        outbound?: OutboundPolicySettings;
        ringcentral?: RingCentralTelephonyConfig;
        teams?: TeamsMeetingsConfig;
        transferTargets?: TransferTargetSettings[];
        twilio?: TwilioTelephonyConfig;
        vonage?: VonageTelephonyConfig;
    }

    Hierarchy (View Summary)

    Index

    Properties

    costPerMinute?: number

    Estimated carrier cost rate per minute in reporting currency (e.g. 0.015 for 1.5 cents/min). Used to compute Interaction.CostEstimate at call end. Defaults to 0.015 if unset.

    enabled: boolean
    inboundRunAsUserEmail?: string

    Email of the user INBOUND calls run as. Required for inbound calls: if unset, unknown, inactive, or the system user, the call is rejected (there is deliberately no fallback to a privileged user). Point it at a dedicated least-privilege account.

    livekitSip?: LiveKitSipSettings
    maxCallSeconds?: number

    Maximum length of one phone call in seconds (default 1800). The session is stopped at the cap.

    maxConcurrentCalls?: number

    Most phone calls (every carrier together, both directions) the server will carry at once (default 25). Keep this at or below the realtime model plan's concurrent-session limit: past the cap an inbound caller hears a polite "all agents are busy" and an outbound call is refused, instead of every call degrading.

    Outbound destination policy and per-user rate limit applied to every Place*Call mutation.

    transferTargets?: TransferTargetSettings[]

    The places the agent may transfer a live call to, by name. Empty or absent means the agent cannot transfer at all, even on a carrier that supports it: the agent never names a free-form number.