Class CallManager

Index

Constructors

Methods

registerProvider getProvider on initiateCall hangupCall speakText processWebhook processNormalizedEvent getCall findCallByProviderCallId getActiveCalls handleInboundCall dispose

Constructors

constructor

new CallManager(config): CallManager
Parameters
- config: VoiceCallConfig
Returns CallManager
- Defined in src/channels/telephony/CallManager.ts:75

Methods

registerProvider

registerProvider(provider): void
Register a telephony provider.
Parameters
- provider: IVoiceCallProvider
Returns void
- Defined in src/channels/telephony/CallManager.ts:84

getProvider

getProvider(name?): undefined | IVoiceCallProvider
Get a registered provider by name.
Parameters
- Optional name: VoiceProviderName
Returns undefined | IVoiceCallProvider
- Defined in src/channels/telephony/CallManager.ts:91

on

on(handler): (() => void)
Register a handler for call events.
Parameters
- handler: CallManagerEventHandler
Returns (() => void)
Unsubscribe function.
- - (): void
  - Returns void
- Defined in src/channels/telephony/CallManager.ts:102

initiateCall

initiateCall(params): Promise<CallRecord>
Initiate an outbound phone call.

Creates a CallRecord in 'initiated' state, delegates to the provider to place the call, and returns the internal call ID.
Parameters
- params: {
      toNumber: string;
      fromNumber?: string;
      mode?: CallMode;
      message?: string;
      seedId?: string;
      providerName?: VoiceProviderName;
  }
  - toNumber: string
  - Optional fromNumber?: string
  - Optional mode?: CallMode
  - Optional message?: string
  - Optional seedId?: string
  - Optional providerName?: VoiceProviderName
Returns Promise<CallRecord>
- Defined in src/channels/telephony/CallManager.ts:133

hangupCall

hangupCall(callId): Promise<void>
Hang up a call. Transitions to 'hangup-bot' terminal state.
Parameters
- callId: string
Returns Promise<void>
- Defined in src/channels/telephony/CallManager.ts:216

speakText

speakText(callId, text): void
Add a bot speech entry to the transcript and transition to speaking.
Parameters
- callId: string
- text: string
Returns void
- Defined in src/channels/telephony/CallManager.ts:239

processWebhook

processWebhook(providerName, ctx): void
Process an incoming webhook from a telephony provider.

Verifies the signature, parses events, and applies state transitions. Idempotent — duplicate event IDs are silently skipped.
Parameters
- providerName: VoiceProviderName
- ctx: WebhookContext
Returns void
- Defined in src/channels/telephony/CallManager.ts:256

processNormalizedEvent

processNormalizedEvent(event): void
Process a single normalized call event.
Parameters
- event: NormalizedCallEvent
Returns void
- Defined in src/channels/telephony/CallManager.ts:281

getCall

getCall(callId): undefined | CallRecord
Get a call by internal ID.
Parameters
- callId: string
Returns undefined | CallRecord
- Defined in src/channels/telephony/CallManager.ts:417

findCallByProviderCallId

findCallByProviderCallId(providerCallId): undefined | CallRecord
Find a call by provider-assigned call ID.
Parameters
- providerCallId: string
Returns undefined | CallRecord
- Defined in src/channels/telephony/CallManager.ts:422

getActiveCalls

getActiveCalls(): CallRecord[]
Get all active (non-terminal) calls.

Returns CallRecord[]
- Defined in src/channels/telephony/CallManager.ts:434

handleInboundCall

handleInboundCall(params): null | CallRecord
Handle an inbound call based on the configured policy. Creates a CallRecord if the call is accepted.
Parameters
- params: {
      providerCallId: string;
      provider: VoiceProviderName;
      fromNumber: string;
      toNumber: string;
      seedId?: string;
  }
  - providerCallId: string
  - provider: VoiceProviderName
  - fromNumber: string
  - toNumber: string
  - Optional seedId?: string
Returns null | CallRecord
- Defined in src/channels/telephony/CallManager.ts:444

dispose

dispose(): void
Clean up all state (for shutdown).

Returns void
- Defined in src/channels/telephony/CallManager.ts:552

Class CallManager

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns CallManager

Methods

registerProvider

Parameters

Returns void

getProvider

Parameters

Returns undefined | IVoiceCallProvider

on

Parameters

Returns (() => void)

Returns void

initiateCall

Parameters

toNumber: string

Optional fromNumber?: string

Optional mode?: CallMode

Optional message?: string

Optional seedId?: string

Optional providerName?: VoiceProviderName

Returns Promise<CallRecord>

hangupCall

Parameters

Returns Promise<void>

speakText

Parameters

Returns void

processWebhook

Parameters

Returns void

processNormalizedEvent

Parameters

Returns void

getCall

Parameters

Returns undefined | CallRecord

findCallByProviderCallId

Parameters

Returns undefined | CallRecord

getActiveCalls

Returns CallRecord[]

handleInboundCall

Parameters

providerCallId: string

provider: VoiceProviderName

fromNumber: string

toNumber: string

Optional seedId?: string

Returns null | CallRecord

dispose

Returns void

Settings

Member Visibility

Theme

On This Page

`Optional` fromNumber?: string

`Optional` mode?: CallMode

`Optional` message?: string

`Optional` seedId?: string

`Optional` providerName?: VoiceProviderName

`Optional` seedId?: string