How can we help?

Talkdesk Voice Platform: SIP Devices
Published • Last Updated

We've enabled the integration of Session Initiation Protocol (SIP) endpoints to provide flexible communication options across an organization. Admins can register and manage both physical hardware and virtual softphone applications through a centralized interface. By generating unique authentication credentials, Admins ensure that every device is securely connected to the Talkdesk infrastructure.

The objective of this guide is to provide the necessary procedures for provisioning and configuring SIP devices within the Talkdesk Workspace. This includes defining operational modes, creating unique device profiles, and completing the registration process for standard softphone applications to ensure reliable media anchoring and call control.

 

Table of Contents

What are SIP Devices?

SIP devices are physical hardware phones or virtual softphone applications that connect to the Talkdesk infrastructure to handle voice media while maintaining digital call control. Admins can register and manage both physical hardware and virtual softphone applications through a centralized Devices workspace application within Talkdesk Admin.

 

Operational Modes

SIP devices are configured in one of three primary modes:

  • User (Companion Mode): The device is paired with a user, such that the SIP device functions as an additional endpoint.
  • Site (Common Area): The device is assigned to a specific Site and functions as a common area phone. It has its own extension, Default Outbound Caller ID, Call Restrictions, and Call Pattern access, all of which can be inherited from the Site or customized.
  • Unassigned: The device is not associated with a user or Site. Calls from devices in this mode will fail.

 

Creating a SIP Device

To create a device, follow these steps:

  1. Navigate to Admin [1] 
  2. Select Devices [2] 
  3. Click the Create Device [3] button.

The following fields are mandatory for device identification and authentication:

  • Device Name: A unique identifier for the device.
  • MAC Address: The unique Media Access Control address of the hardware.
  • SIP User: The username required for SIP Digest Authentication.
  • SIP Password: The password required for SIP Digest Authentication.

Notes: 

  • Talkdesk pre-generates a portion of the SIP User name; the administrator must enter the remaining characters to ensure successful registration.
  • Note down the Password at this stage. It is typically shown only once during creation and is required for softphone login.

Upon clicking Create, the device page appears. By default, the "Assignment" type is set to "No Assignment".

 

Registering a SIP Device

After creating a device, the SIP credentials generated during creation are used to register softphone applications to Talkdesk. The following sections describe the setup process for Linphone and Zoiper 5.

Note: For customers using SIP Device Management, device registration is automatically handled by the SIP Device Management platform using device configurations provided during onboarding. Administrators do not need to manually complete the steps below.

 

Linphone Setup


1. Download and Installation

image-20251103-174715.png

image-20251103-174814.png

  1. Configuring Registration
    • Launch Linphone: Open the Linphone application on your device.
    • Access the Setup Wizard: Navigate the application using the following sequence:
      "Home" → "ASSISTANT" -> "USE A SIP ACCOUNT"
    • Enter Account Credentials: Fill in the required data fields using the values captured during the Device creation.

image-20251103-174959.png

  • Username: Enter the <SIP user> ID you noted earlier.
  • SIP Domain: Is always sip.talkdeskapp.com.
  • Password: Enter the Password captured during the device creation step.
  • Select Transport Protocol: default option: "TLS" (Transport Layer Security).

After completing these steps, the Linphone client will attempt to send a SIP REGISTER request over TLS to the specified SIP Domain, using the provided credentials.

  1. Verification of Status

image-20251103-175056.png

  • Linphone Client Status (Client Side):
    Linphone application will turn Green. This visually confirms that the client has successfully sent the REGISTER request and received a 200 OK response from the SIP proxy

image-20251103-174522.png

  • Talkdesk UI Status (Server Side):
    In the Talkdesk Admin URL, under the specific Device you configured, the status will update to "Registered.
  1. Deregistration Steps

image-20251103-175253.png

  • Access Account Preferences: In the Linphone client, navigate to the configuration settings: Linphone →  Settings -> Preferences
  • Select Device: Choose the specific SIP account (Device) you wish to deregister from the list.

image-20251103-175402.png

image-20251103-175543.png

  • Edit Registration Duration: Select Edit on the account and change the Registration Duration (or Expires value) to 0 and Save.
  • Verification of Status: In the Talkdesk Admin URL, under the specific Device you configured, the status will update to "Unregistered".

 

Zoiper 5 Setup

  1. Download and Installation

image-20251107-121819.png

image-20251107-121906.png

image-20251107-121944.png

image-20251107-122052.png

image-20251107-122206.png

  1. Configuring Registration
    • Launch Zoiper: Open the Zoiper application.
    • Create Account Credentials.
      • Username: <SIP user>@<SIP Domain>
      • Password: Enter the Password captured during the device creation step.

image-20251104-052553.png

  1. Update Account Credentials: 
    • Navigate the application using the following sequence:
      "Setting" → "Accounts" -> "Click on the Existing Account".
      Fill in the required data fields using the values captured during the Device creation.
      • Username: Enter the <SIP user> ID you noted earlier.
      • Domain: Enter sip.talkdeskapp.com
      • Password: Enter the Password captured during the device creation step.
    • After completing these steps, the Zoiper client will attempt to send a SIP REGISTER request over TCP to the specified SIP Domain, using the provided credentials.
       
  2. Verification of Status
    • Zoiper Client Status (Client Side): Zoiper application will turn Green Tick. This visually confirms that the client has successfully sent the REGISTER request and received a 200 OK response from the SIP proxy
    • Talkdesk UI Status (Server Side): In the Talkdesk Admin URL, under the specific Device you configured, the status will update to "Registered.

Note: If the Registration is not successful or does not show the status, exit the Zoiper Client and Relaunch.

 

Configuring a SIP Device

Once a device is registered to Talkdesk (registration status is visible on the physical device or on the Devices listing page), administrators can assign it to a User or to a Site.

 

Assigning a Device to a User

Devices assigned to users function in Companion Mode: Call controls reside in the Conversations application while media is anchored on the SIP device, and is applicable only for calls delivered from the contact center, not extension calls.

  1. Navigate to the Device page and click on the device you want to edit. 

  1. Click Edit.

  1. Navigate to the Assignment sub-section and click the User tab.
  2. Select the user to whom the device should be assigned.

Note: Only users assigned to a Site will appear in the selection list.

  1. To complete the configuration, the assigned user must navigate to their Conversations Settings page and, under the External Devices section, select SIP Phone.

 

Assigning a Device to a Site

  1. Navigate to the Device page and click on the device you want to edit. 

  1. Click Edit. 

  1. Navigate to the Assignment sub-section and click the Site tab.
  2. Assign the device to a configured Site.
  3. Configure the following:
  • Extension: A unique extension for the device within the Site.
  • Default Outbound Caller ID: Inherited from the Site or set to a custom value.
  • Call Restrictions: Inherited from the Site or overridden with custom values.
  • Call Patterns: Patterns inherited from the Site are enabled by default.

To assign or manage Call Patterns for the device, navigate to the Patterns tab of the device. By default, the Call Patterns associated with the Site are enabled for the device.

Dedicated PSTN Lines for Common Area Devices

Admins can assign dedicated PSTN lines directly to common area SIP devices. When a number is assigned as a dedicated line, inbound calls to that number route directly to the device without traversing Talkdesk Studio.

Before assigning a dedicated line, note the following:

  • Numbers already assigned to a Studio Flow will not be available for assignment as a dedicated line.
  • Numbers already assigned as dedicated lines to another device will not be available for assignment.

 

Assigning a Dedicated Line

  1. Navigate to the Device page and click on the device you want to edit. 

  1. Click Edit. 

  1. Navigate to the Dedicated Lines section.
  2. Select one of the available numbers from the drop-down list.

Note: Numbers already assigned to Studio Flows or as dedicated lines will not appear in the drop-down list.

After selecting a number, the assignment will enter a Pending state.

Within a few minutes, the assignment will transition to a final state:

  • Active: The dedicated line has been successfully assigned to the device.
  • Failed: The assignment was unsuccessful. Administrators are encouraged to open a support ticket with Talkdesk.
All Articles ""
Please sign in to submit a request.

Related to