1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

TUTORIAL Yealink PhoneBook

Discussion in 'Endpoints' started by DoctorJ, Sep 22, 2017.

  1. DoctorJ

    DoctorJ Member

    Joined:
    Jul 14, 2015
    Messages:
    32
    Likes Received:
    10
    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!
     
  2. krzykat

    krzykat Guru

    Joined:
    Aug 2, 2008
    Messages:
    1,258
    Likes Received:
    300
    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.
     
    DoctorJ likes this.
  3. DoctorJ

    DoctorJ Member

    Joined:
    Jul 14, 2015
    Messages:
    32
    Likes Received:
    10
    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.ph...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!
     
    #3 DoctorJ, Sep 23, 2017
    Last edited: Jan 12, 2018
    wardmundy likes this.
  4. PBXOK

    PBXOK New Member

    Joined:
    Feb 8, 2016
    Messages:
    3
    Likes Received:
    3
    DoctorJ and wardmundy like this.
  5. DoctorJ

    DoctorJ Member

    Joined:
    Jul 14, 2015
    Messages:
    32
    Likes Received:
    10

Share This Page