> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringingo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Set Up SIP Devices

> Register SIP endpoints for agents and managers in Ringingo so they can place and receive calls from softphones or IP phones.

SIP Devices are registered voice endpoints linked to user and manager accounts. Each device is a SIP-registered endpoint (typically a WebRTC browser client or physical desk phone) that the platform uses to route calls to the account holder.

<Steps>
  <Step title="Open SIP Devices">
    Navigate to **Users → SIP Devices** in the left sidebar menu.
  </Step>

  <Step title="Create a new device">
    Click **+ Create SIP Device**.
  </Step>

  <Step title="Fill in the device form">
    | Field                  | Description                                                                                                                                      |
    | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
    | Device Name (required) | A descriptive label for this device (e.g. "Agent-Desk-01"). Visible in the admin portal and dropdown selectors.                                  |
    | User Name (required)   | The SIP username used by the softphone or desk phone to register with the Ringingo SIP server. Must be unique across all devices on the account. |
    | Password (required)    | The SIP authentication password. Enter this into the softphone alongside the username and SIP server domain.                                     |
    | Caller ID Name         | The display name shown on the called party's screen when this device places a call.                                                              |
    | Caller ID Number       | The outbound CLI number displayed to called parties. Selected from a dropdown of configured numbers.                                             |
    | User (required)        | The agent or manager account this device is assigned to.                                                                                         |
    | Status                 | Enable to activate the device registration immediately. Disable to save without registering.                                                     |
  </Step>

  <Step title="Save the device">
    Click **Save**. The device is now available in the SIP Devices list.
  </Step>
</Steps>

<Warning>
  SIP device credentials (Username and Password) are sensitive. Never share them over plain-text channels. A compromised SIP credential can be used to place unauthorised calls on the account, resulting in unexpected charges.
</Warning>

<Tip>
  When creating a new user or manager account, ensure a SIP Device is created and assigned before the account goes live. Without a registered SIP device, the user is unable to make or receive calls on the platform.
</Tip>

<Note>
  Each agent needs their own SIP device. Repeat this process for every agent who is receiving calls routed by the IVR or campaigns.
</Note>
