NethVoice integration with custom APIs

[Stell0]

There is the need to integrate NethVoice with external products and interact using REST APIs

1. Resolve name of incoming/outgoing calls using a custom REST API instead of the default mysql

   • search for custom scripts in /usr/src/nethvoice/lookup.d
   • if a custom scrip is found, call it with the number to resolve as parameter
   • custom script should output a JSON with this format {"company"=>"foo","name"=>"bar","number"=>"123456789"}
   • if no custom script exists, or if scripts doesn't return company and name, mysql should be used as before

2. Add more variables to Parameterized URLs calling an external API

   • create a sample PHP page that takes Parameterized URL parameters ($CALLER_NUMBER, $CALLER_NAME, $CALLED, $UNIQUEID) and use those to retrieve the "customer code" using a REST API and then does a redirect to another page with customer code as argument

3. call a POST at the end of a call with CDR data

   • create a custom CTI CdrScript that makes a POST sending its parameters

4. Documentation:

   1. Create a sample script that uses an external API (this can be delayed to use the first real world case as example)
   2. Create a sample page with comments and instructions
   3. Create a sample script with comments and instructions

[Stell0]

Test case:

• after installing package, navigate to /usr/src/nethvoice/samples/ directory
• [x] try dummy lookup for incoming and outgoing calls (instruction inside file)
  • [x] all inbound and outbound calls should be resolved as "Foo Bar" from "Dummy Company SPA" company
  • [x] modify dummy_lookup.php to return an empty name and company, then verify that calls are resolved from standard mysql phonebook
• [x] install Parameterized URL sample and verify that it works correctly (instruction inside file and here)
• [x] Try send_cdr_data.php as CdrScript (instruction inside file and here)

[nethbot]

in 7.9.2009/nethesis-testing:

• nethserver-nethvoice14-14.17.1-1.2.g8bd4cb8.ns7.noarch.rpm x86_64

[nethbot]

in 7.9.2009/nethesis-testing:

• nethserver-nethvoice14-14.17.1-1.3.gac73d02.ns7.noarch.rpm x86_64

[nethbot]

in 7.9.2009/nethesis-testing:

• nethserver-nethvoice14-14.17.1-1.4.g4a9b17f.ns7.noarch.rpm x86_64

[nethbot]

in 7.9.2009/nethesis-updates:

• nethserver-nethvoice14-14.18.0-1.ns7.noarch.rpm x86_64