Telephones

Overview

A Telephone in XCALLY is a PBX extension used to manage inbound and outbound voice interactions. Each Telephone account is dedicated to the Voice channel.

You can manage telephones under the Staff menu in the Admin Panel.

In the section, you can easily search, filter, and sort to quickly find and manage the pbx you need.

Open

Creating a Telephone

To create a new Telephone:

1. Go to Staff → Telephones

2. Click on Add button and fill in the required fields:

Open

• Account Name

• Username

• Email

• Password: 🔐 Password Requirements (when Security Suite is enabled): must be at least 8 characters including 1 lowercase letter, 1 uppercase letter, 1 number, 1 special characters ~!@#$%^&-_=+[{]}.

• optional description

• option to modify or auto generate internal number

• option Voicemail to automatically create a voicemail box (Optional)

Click Add. 

Once created, the Telephone is listed and available for SIP hard/soft phone registration using the assigned username and password.

Editing a telephone

To modify a telephone, click the 3 dots next to the Telephone and you can:

• delete → permanently remove the telephone

• edit → update Account and Voice settings:

  • in the Account tab you can update the Account Name, Email, Description or add Phone and Mobile numbers

  • in voice tab you can configure SIP and telephony parameters:

    • Transport: supported protocols UDP, TCP, WS, WSS, TLS

    • NAT: Asterisk NAT behavior. Choose a value among the following: yes, no, force_rport, comedia, never, route

    • Allowed Codecs: supported audio codecs. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus

    • Caller ID: the default caller id shown to call recipients (format is "Caller Name" <Caller Number>)

    • Context: defines SIP context (default: from-sip)

    • Call Group: a call to the telephone is placed in one or several call groups 

    • Pickup Group: the telephone will be able to pick up an incoming call if the call’s call group matches telephone’s pick up group 

    • Video support: this option enable the H264 video codec. In any case, the video channel is not supported

    • Encryption: enable/disable SRTP (Secure Realtime Protocol) Encryption

On edit tab, if necessary, click Change Password inside the edit panel.
🔐 Password Requirements (when Security Suite is enabled): must be at least 8 characters including 1 lowercase letter, 1 uppercase letter, 1 number, 1 special characters ~!@#$%^&-_=+[{]}.

Call Pickup feature

Call Pickup allows one extension to answer a call ringing on another phone in the same group.

This is the basic functionality:

• A call is placed in one or several call groups

• If a phone belongs in a pickup group that matches one of the call's call groups, that phone may pickup the incoming call by calling *8 on his phone

Enable the Call Pickup feature

The call pickup feature is disabled by default. To enable it, you need to uncomment the following rows into the file /etc/asterisk/features.conf

Then reload Asterisk configuration by running the command:

in the Motion SSH console

Set the call group and the pickup group

To use Call Pickup:

• Set CallGroup and PickupGroup values in the agent or telephone profile.

• Example:
  phone01 → member of CallGroup = 1, allowed to pickup the calls of the same group PickupGroup = 1
  pickupexten = *8 ;
  pickupsound = beep ; to indicate a successful pickup (default: no sound)
  pickupfailsound = beeperr ; to indicate that the pickup failed (default: no sound)

How to pickup a call

Once configured, an agent can pick up a ringing call by dialing *8