extractSipUsername

Static utility method that extracts the username portion from the call.to field of a parsed request body. Handles three input formats:

• sip:username@domain (or sips:...) — strips the scheme and @domain suffix, returning the username
• tel:+1234567890 — strips the tel: scheme, returning the phone number
• Plain string — returned as-is

Commonly paired with registerRoutingCallback() to route SIP traffic based on the dialed user.

Parameters

Returns

string | null — The extracted username or phone number, or null if the call.to field is missing or cannot be parsed.

Examples

Extract from SIP URI

1
import { SWMLService } from '@signalwire/sdk';
2
3
const body = { call: { to: 'sip:sales@example.sip.signalwire.com' } };
4
const username = SWMLService.extractSipUsername(body);
5
// "sales"

Extract from TEL URI

1
import { SWMLService } from '@signalwire/sdk';
2
3
const body = { call: { to: 'tel:+15551234567' } };
4
const number = SWMLService.extractSipUsername(body);
5
// "+15551234567"