> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# autoMapSipUsernames

> Automatically register common SIP usernames derived from the agent's name and route.

[ref-agentbase]: /docs/server-sdks/reference/typescript/agents/agent-base

[enable-sip-routing]: /docs/server-sdks/reference/typescript/agents/agent-base/enable-sip-routing

[register-sip-username]: /docs/server-sdks/reference/typescript/agents/agent-base/register-sip-username

Automatically register SIP usernames based on the agent's `name` and `route`
properties. Convenience method that derives common username variations so callers
can reach the agent via SIP without manual registration.

The method registers:

* A lowercase, alphanumeric-only version of the agent name (e.g., `"supportagent"`)
* A lowercase, alphanumeric-only version of the route when different from the name
* A vowel-stripped abbreviation of the name when the cleaned name is longer than
  3 characters and the stripped result is longer than 2 characters

<Note>
  [`enableSipRouting()`][enable-sip-routing] calls this method automatically when
  invoked without arguments. You only need to call `autoMapSipUsernames()` directly
  to trigger it after disabling auto-mapping.
</Note>

## **Parameters**

None.

## **Returns**

[`AgentBase`][ref-agentbase] -- Returns `this` for method chaining.

## **Example**

```typescript {5}
import { AgentBase } from '@signalwire/sdk';

const agent = new AgentBase({ name: 'Support Agent', route: '/support' });
agent.setPromptText('You are a support assistant.');
agent.autoMapSipUsernames();
// Registers: "supportagent", "support", "spprtgnt"
await agent.serve();
```

To register specific usernames instead, use
[`registerSipUsername()`][register-sip-username]:

```typescript {2-3}
agent.registerSipUsername('helpdesk');
agent.registerSipUsername('support');
```