Howto:Integrate External Apps in innovaphone UC clients

From innovaphone wiki
Jump to navigation Jump to search

Applies to

Following native innovaphone UC clients:

  • myPBX for Windows since firmware version 10
  • myApps for Windows since firmware version 13r1
  • myApps for MacOS since firmware version 13r2

More Information

External applications can be integrated in innovaphone UC clients myPBX and myApps.

Those can be locally installed PC-applications as well as web applications.

Upon incoming and outgoing call, such applications may be opened and call-parameters can be handed over optionally.

Configuration

myPBX

  • Right Click on myPBX – Configuration – External Application
  • Enter the name of the external app (which will be seen as tooltip of the external app button).
  • Paste the path of the external app into the field “Path”. It can be both the URL of a web application (http://crm.example.com/customer-by-number/$n) or the path of a desktop application installed on the local computer (C:\Program Files (x86)\Google\Chrome\Application\chrome.exe)
  • Optionally specify command line parameters for Desktop Apps into the field “Parameters”.
  • Save the changes.

Mypbx Konfigurationen1.jpg

The Path and the Parameters may contain placeholders that are replaced by phone call information.

   $n - phone number of the caller
   $u - uri of the caller
   $d - display name of the caller
   $c - conference ID (a global ID for the call) 

Now you will get the "start external application" button in every conversation or interaction field.

Eigener Screenshot mit Buttonhinweis EN.jpg


myApps

  • Settings via burger menu / Settings / More / External Applications
  • Several may be configured in parallel
  • Set name which is displayed in PhoneApp-button upon call
  • Set URL or path to application
  • Set parameter string
  • Optionally choose if application shall be autostarted upon call

For help, press questionmark icon

MyApps external applications.png

Examples

3rd party input
this is 3rd party content not provided by innovaphone, see history for authors.

Outlook Journal

Tested with: myPBX V11 / Outlook 2010

   Path: ...\Microsoft Office\Office14\OUTLOOK.EXE
   Parameters:  /c ipm.activity /m bla?subject=Telefongespräch%20mit%20$n

Firefox

Tested with: myPBX V11 / Firefox V.38

   Path: ...\Mozilla Firefox\firefox.exe
   Parameters e.G.:  http://xxxx/$n/xxxx

Notepad

Tested with: myPBX V11 / Windows 7

   Path: ...\Windows\notepad.exe
   Parameters e.G.:  C:\$d.txt

Open the default email client during a call and use the callinfo in the email

Tested with: myPBX V12, V13 and myApps V13r1 / Windows 10

   Path: mailto:receivers@email.com?subject=Telephony notification from $u $d tel:$n&body=Hello, %0A%0APlease call back to $u $d tel:$n  %0A%0AKind regards, %0AYour Name

Open WhatsApp during a call to send a message to your caller during or after the call using the available callinfo and a personal note

Tested with: myApps V13r2 / Windows 10 / WhatsApp Windows (web version not possible)

   Path: https://api.whatsapp.com/send?phone=$N&text=Hi+$d%21+Thank+you+for+your+call++++We+keep+in+touch&app_absent=0

Open a webbased CRM or Public website to search on a number

Tested with: myPBX V12, V13 and myApps V13r1 / Windows 10

   General example             Path: https://www.unknownphone.com/search.php?num=$n
   Deutschland Das Telefonbuch Path: https://www.dastelefonbuch.de/R%C3%BCckw%C3%A4rts-Suche/$n
               Das Oertliche   Path: https://www.dasoertliche.de/rueckwaertssuche/?ph=$n
   Nederland Gebeld.NL (*)     Path: C:\Program Files\Google\Chrome\Application\chrome.exe
                               parameters: "http://www.gebeld.nl/index.php?page=1&queryfield1=$n&searchfield1=fullnumber&action=Zoeken"
   Schweiz Search.ch           Path: https://tel.search.ch/?tel=$n
   Östenreich Herold.at        Path: https://www.herold.at/telefonbuch/telefon_$n
   Danmark  KRAK.dk            Path: https://www.krak.dk/$n/firmaer

(*) URLs containing "&" have to be executes via chrome.exe and to be put in quotes to avoid interpretation by chromium.

Open the Outlook client during a call and use the callinfo in the Calendar appointment

Tested with: V13 and myApps V13r1 / Windows 10

   Path e.g. : C:\Program Files (x86)\Microsoft Office\root\Office16\OUTLOOK.EXE 
   Parameters e.G.: /c ipm.appointment /m "youremail@domain.com ?subject=call to tel:$I &body=Can we meet please call to tel:$I"

Open a customer chart in Microsoft Dynamics Navision (local installed client application) during a call or with the start of the call

Tested with: myApps V13r1sr21 / Windows 10 and Microsoft Dynamics NAV 2018 Version BE Dynamics NAV 11.0 11.0.28629.0

   Path e.g. : dynamicsnav://customername-nav:7146/customername_live/customername/runpage?page=21&$filter='Phone No.' IS '$I'

$I at the end of the line is the variable that represents the telephone number in international format E164 eg 3164133xxxx

Search on telephone number within CRM or other application on zoho.eu

Tested with: myApps V13r1sr26 / Windows 10 and already logged-in on the website zoho.eu

   Path to search within all zoho applications e.g. :  https://crm.zoho.eu/crm/org12345678901234/search?searchword=$I    replace /org12345678901234/ with your own organisation-id
   Path to search within your zoho CRM contacts only e.g. :  https://search.zoho.eu/search?q=$I&s=crm

$I at the end of the line is the variable that represents the telephone number in international format E164 e.g. 31653394xxx


Search on telephone number within HALO or HALOPSA on halopsa.com

Tested with: myApps V13r3 / Windows 10 and already logged-in on the website halopsa.com

HALOPSA LINK
   Path to search within all HALO CRM applications, e.g. :  https://karlsnl.halopsa.com/call?showmenu=false&callerid=@callerid    replace @callerid with $I
 

$I at the end of the line is the variable that represents the telephone number in international format E164 e.g. 31653394xxx

Example where to find the right integration link in HALOPSA, look under Configuration, Call Management, General Settings. There are several options for the opened webpage that you can choose from.

Related articles