Skip to content

route outbound SIP calls by cluster using participant attributes#4517

Open
rafallezanko wants to merge 1 commit into
livekit:masterfrom
rafallezanko:feat/sip-cluster-routing
Open

route outbound SIP calls by cluster using participant attributes#4517
rafallezanko wants to merge 1 commit into
livekit:masterfrom
rafallezanko:feat/sip-cluster-routing

Conversation

@rafallezanko

@rafallezanko rafallezanko commented May 11, 2026

Copy link
Copy Markdown

Summary

  • Allow routing outbound SIP calls to specific livekit-sip instances based on the sip.cluster participant attribute
  • When sip.cluster is set in ParticipantAttributes, its value is used as the psrpc topic for CreateSIPParticipant, targeting only SIP nodes registered with a matching cluster_id
  • When unset, the default behavior (empty topic = any available SIP node) is preserved

Usage

Agent sets participant attribute when creating an outbound SIP call:

{
  "participant_attributes": {
    "sip.cluster": "klient_A"
  }
}

livekit-sip instances register with matching cluster_id in their config:

cluster_id: klient_A

Test plan

  • Verify outbound calls without sip.cluster attribute still route to any SIP node (backward compatibility)
  • Verify outbound calls with sip.cluster: X only reach SIP nodes with cluster_id: X
  • Verify inbound calls are unaffected (they use IOInfoClient, not SIPInternal)

Allow routing outbound SIP calls to specific livekit-sip instances
based on the "sip.cluster" participant attribute. When set, the value
is used as the psrpc topic for CreateSIPParticipant, targeting only
SIP nodes registered with a matching cluster_id. When unset, the
default behavior (any available SIP node) is preserved.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@boks1971 boks1971 requested a review from a team May 11, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant