SIP Channel
Create a SIP Channel and route calls from your PBX or SIP provider to its SIP URI. The Channel assigns those calls to an Assistant.
How it works
Creating a SIP Channel provisions a LiveKit inbound trunk and dispatch rule. Reecall uses the Channel's Assistant assignment and whitelists to configure call routing.
Call flow
For each incoming call:
- Caller initiates a phone call through their phone system
- Your SIP Trunk (your SIP provider or PBX) routes the call to Reecall
- Livekit SIP Trunk receives the call, validates it against your configured whitelists, and routes it to the assigned Assistant
- Assistant receives the call and begins the conversation
Configuring your SIP trunk
Configure your PBX or SIP provider to forward calls to Reecall's SIP endpoint.
Reecall SIP endpoint
Copy the SIP URI shown for your Assistant's SIP Channel in the portal. The endpoint depends on the deployment. Route calls to that URI, for example:
Code
Configuration steps
- Access your SIP trunk settings in your PBX or SIP provider's admin panel
- Create an outbound route or trunk pointing to Reecall's SIP URI
- Configure call forwarding rules to route specific numbers or all calls to this trunk
- Whitelist Reecall's endpoint if your system requires it for outbound SIP traffic
Important
Provide at least one non-empty whitelist. If you configure both, the destination number must match inboundNumbersWhitelist and the source IP must satisfy the configured address restriction. IP enforcement also requires enablement on the LiveKit project; confirm it with Reecall before relying on it. See LiveKit's inbound trunk documentation.
Generic PBX configuration
Configure your PBX or SIP provider with these settings:
| Setting | Value |
|---|---|
| Trunk Type | SIP |
| Remote Host | Host from the SIP URI shown in the portal |
| Transport | UDP or TCP |
| Port | 5060 |
Refer to your specific PBX or SIP provider documentation for exact configuration steps.
Creating a SIP Channel
Required fields
| Field | Required | Description |
|---|---|---|
name | Yes | Display name for the Channel |
type | Yes | Must be SIP for SIP Channels |
assistantId | Yes | The Assistant to handle calls on this Channel |
inboundNumbersWhitelist | One needed | Provider phone numbers this trunk accepts calls for (E.164 format) |
inboundAddressesWhitelist | One needed | IP addresses allowed to send SIP traffic |
Important
At least one of inboundNumbersWhitelist or inboundAddressesWhitelist must contain an entry.
Create request
Use a project-scoped API key, or include projectId in the payload with an organization-scoped key. Data API paths below are relative to the server URL in the API reference, which includes /data_next.
Code
Response
Code
Configuration options
Using phone number whitelist
Specify which provider phone numbers (destination numbers you own) this trunk should accept calls for. If none are specified, the trunk accepts calls to any number. Use E.164 format:
Code
Using IP address whitelist
Restrict SIP traffic to the source IP addresses or CIDR ranges used by your PBX or SIP provider. Confirm that IP enforcement is enabled on the LiveKit project before relying on this restriction:
Code
Combining both whitelists
You can configure both restrictions together: calls must match the destination number and the enforced source IP restriction:
Code
Updating a Channel
Update Channel properties using PATCH. Changes to whitelist configurations are automatically synchronised with the underlying SIP infrastructure.
Code
Deleting a Channel
When you delete a Channel, the system automatically cleans up all associated SIP infrastructure.
Code
Constraints
-
An Assistant can have one SIP Channel and one WebRTC Channel. Creating a second Channel of the same type for that Assistant returns an error.
-
Whitelist requirement: SIP Channels must have at least one entry in either
inboundNumbersWhitelistorinboundAddressesWhitelist.