TUTORIAL Yealink PhoneBook

DoctorJ

Member
Joined
Jul 14, 2015
Messages
41
Reaction score
13
Running Incredible PBX 13 on CentOS at Digital Ocean. Using Yealink phones at the office, which have a great remote phonebook feature. Simply need an .xml file hosted on a server. Phones download the file automatically using URL.

Just found this: http://labs.octivi.com/yealink-phone-book-manager-released/

Any recommendations on how to implement this on my remote PBX? I'm still new with linux, and i don't want to mess up the apache files the control the Incredible GUI, avantfax, etc.

If implementation is tough, how would I host a static .xml file so that I could access it from the phones?

Thanks!
 

krzykat

Guru
Joined
Aug 2, 2008
Messages
1,487
Reaction score
390
Location
South Florida
I place it in a file called phonebook.xml and place it in a folder /var/www/html/phonebook. I then use the auto-provision feature and tell it where to find the phonebook file.
 
  • Like
Reactions: DoctorJ

DoctorJ

Member
Joined
Jul 14, 2015
Messages
41
Reaction score
13
OK... so krzykat provided the information that I needed. Specifically, in which directory to place web files.
-----
If you simply want to host an .xml file, place it in /var/www/html/phonebook.

How to do it:
  1. SSH into your PBX
  2. Make the phonebook directory: mkdir /var/www/html/phonebook
  3. Create the .xml file readable by the Yealink phones
    1. http://support.888voip.com/index.php?/Knowledgebase/Article/View/177/0/how-to-create-an-xml-phonebook-for-yealink-phones
  4. Place the .xml file in the phonebook directory
    1. Easiest method: Use SFTP and copy the file to the directory
      1. Mac: Cyberduck
      2. Windows: Filezilla
    2. Somewhat more complicated: use "scp" (secure copy) from the command line / terminal
      1. Examples: http://www.hypexr.org/linux_scp_help.php
  5. In the web interface for your Yealink phone, add the URL for the contacts.xml file (or whatever you named it) to Directory --> Remote Phone Book --> URL (and then give it a name)
    1. In our example: http://PBX-SERVER-IP/phonebook/contacts.xml
-----
If you want the web interface for the phone book, so that the your users can update in real time the remote directories for your entire organization:

  1. SSH into your PBX
  2. Make the phonebook directory: mkdir /var/www/html/phonebook
  3. Download the latest zip file from here: https://github.com/octivi/yealink-phonebook/releases/tag/v1.0
  4. Unzip the package
  5. Using SFTP or scp as described above, copy the contents of the downloaded folder unedited to /var/www/html/phonebook
    1. Make sure to copy the contents, not the directory itself
    2. In other words, copy the individual files (index.php, license, pb, readme.md, yealink-phonebook.phar) to your phonebook directory on your PBX
  6. Change the directory permissions: chmod 777 -R /var/www/html/phonebook
    1. This is clearly not secure
    2. If anyone has instructions how to use the .htaccess file for authentication, that would be helpful
    3. I'm not overly concerned, as the PBX is locked down to only the IP address of my office, so the phonebook directory can only be reached from within my office
  7. In the web interface for your Yealink phone, add the URL for the contacts.xml file to Directory --> Remote Phone Book --> URL (and then give it a name)
    1. In our example: http://PBX-SERVER-IP/phonebook/pb/contacts.xml
  8. To access your web based phonebook, go here: http://PBX-SERVER-IP/phonebook/index.php
-----
This worked like a charm on my server. All of my Yealink phones now have an always updated phone directory. In addition, anyone in the office can add new contacts as needed.

One issue: I've noticed that if you add a contact incorrectly the first time, editing it doesn't seem to work. You have to delete the contact and then add it again.

Cheers!
 
Last edited:
  • Like
Reactions: wardmundy

PBXOK

New Member
Joined
Feb 8, 2016
Messages
9
Reaction score
4
The web interface has stopped working for me. Anyone know how to fix it?
 

atsak

Guru
Joined
Sep 7, 2009
Messages
1,774
Reaction score
169
The web interface has stopped working for me. Anyone know how to fix it?
You'll need to help us a bit. What does "stopped working" mean - and which web interface are you referring to.
 

atsak

Guru
Joined
Sep 7, 2009
Messages
1,774
Reaction score
169
Well, I guess then you'll need to grab the web logs and see if you can see any errors in there. The simple stuff is solved. Assume you have also tried rebooting (I'm primarily a Windows guy and I know Linux isn't supposed to need that but yet I have fixed things that way . . .)
 

Members online

PIAF 5 - Powered by 3CX

Forum statistics

Threads
22,274
Messages
136,543
Members
14,505
Latest member
athan