ログイン名 Logged in as: ログイン
検索:
このページは2009年 6月 8日, 13:36に更新されました by Admin

HUDウェブランチャー

    2024年 5月 4日, 20:15 現在の版

    この版へ。

    版の一覧 に戻る。

    現在の版を閲覧

    HUD includes a feature called 'web launcher' that can automatically open any website you specify within the Settings page as soon as you answer a call.  Or the window can be configured to open as soon as you hangup a call.  Or you can manually launch it at any time during a call - it's all up to you!

    1. 1. Manually Execute the Web Launcher
    2. 2. Configure the Web Launcher
      1. 2.1. Web Launcher Profiles
      2. 2.2. Variables
    3. 3. Can I add my own Web Launcher Profiles?
      1. 3.1. Adding a profile from the Admin Panel
      2. 3.2. Adding a profile from the command line
      3. 3.3. Editing an existing web launcher profile
    4. 4. SugarCRM & Web Launcher

    Manually Execute the Web Launcher

    Most often, the web launcher function is set to automatically execute the web launcher URL on an incoming or outgoing call.  However, if you have disabled the auto-execute feature, you can still choose to manually execute the web launcher by clicking the WWW icon on the desktop alert:

    Picture 5.jpg

    Configure the Web Launcher

    To configure HUD Web Launcher:

    1. Click on File --> Settings
    2. Select Web Launcher from the left-hand menu
    3. Fill in the URL of the web page you would like to open in one of the boxes under either Inbound or Outbound

      Picture 47.jpg

    4. Tick the Auto-Launch box if you want the page to open automatically for every call of the appropriate type
    5. Tick the Silent box if you want the page to open in the background (typically for reporting purposes - some sites log the information in the URL string automatically)
    6. Click Apply at the bottom to save your settings
    Web Launcher Profiles

    Choose from a list of pre-configured URLs:

    1. Click File --> settings
    2. Select Web Launcher from the left-hand menu
    3. Click the drop-down menu next to Web Launcher Profiles
    4. Select one of the pre-configured profiles included with HUD

      Picture 48.jpg

    5. Once you select a profile, the URL boxes automatically populate

      Picture 49 copy.jpg

    Variables

    Fonality also provides variables for URL strings in case a site requires elements like a Username or Password:

    1. Click File --> settings
    2. Select Web Launcher from the left-hand menu
    3. You can use any and/or all of the variables listed

      Picture 50.jpg

    A fully configured URL string may look like this:

    http://intranet.fonality.com/support_lander.cgi?ticket_id=%%caller_name%%&type=%%type%%

    Can I add my own Web Launcher Profiles?

    Absolutely!  We have instructions below for adding web launcher profiles via the Admin Panel and for adding profiles via the command line (if you prefer the command line approach)

    Adding a profile from the Admin Panel

    In this example, we will use the custom URL shown for the Inbound Calls :: During New Call URL field

    https://uae.fonality.com/fonality_call_assistant.php?phone=%%caller_number%%&direction=%%type%%&un=%%username%%&pw=%%password%%

    Please study construction of the URL carefully.  Every variable requires an ampersand as a delimeter (un=%%username%% & pw=%%password%% for example).  A web launcher with an incorrectly formatted URL will fail to do anything.

    The example only shows a web launcher profile for INBOUND calls, but you can construct any web launcher profile you like to function for OUTBOUND calls as well (or any type of call!)

    1. Click on Options --> HUD
    2. Click the + icon next to Create New Web Launcher
    3. Fill out all of the sections marked with a red dot in the image below.  The image displays an example web launcher profile - you should not copy the information presented in the image.
      weblauncher1.png
      1. Name - the name of this web launcher profile as it will appear within the HUD client web launcher settings panel
      2. Password - if your URL requires a password, set the password encoding (plain text, md5, none)
      3. Launch ... answered - this web launcher will only execute if a user answers a call
      4. Outbound/Inbound - web launchers can be executed when the phone rings, when a user answers, or after a call has ended for both inbound calls and outbound calls
      5. Silent - when you select 'yes', a web page will not open, but data included in your URL can be posted silently in the background (to a CGI programmed to gather statistics for example)
      6. Auto-launch - configures a web browser to open automatically when set to 'yes'
    4. Once you have filled out all the required settings for a new web launcher, click Apply All Changes at the bottom of the page.  The page will refresh, and your web launcher profile will be displayed under Showing X Web Launcher Profiles
      weblauncher2.png
    5. Click the red X to delete a web launcher profile (circled in the image above)
       
    Adding a profile from the command line
    1. Login to your system as the root user
    2. Type: cd /etc/asterisk/ <enter>
    3. Use vi or nano or your favorite text editor and open w3.xml
    4. Follow the XML structure of the other Web Launcher Profiles and add your own
      1. If your URL string requires a Username and Password to access a secure site, specify account="________" within the launcher line of code.  
      2. Choose from among two account types: Plain or MD5
    5. Save your changes
    6. Now open the HUD Client software on your computer
    7. Use the steps above under Configure the Web Launcher to add your URL string
    8. When you add the %%username%% and %%password%% variables, make you enter a plain-text password if you chose account="plain" for your profile.  If you chose MD5, insert the MD5 hash of the correct password
    9. Click Apply at the bottom
    10. Test your configuration!
    Editing an existing web launcher profile
    1. Click on Options --> HUD
    2. Click on the + icon next to Showing X Web Launcher Profiles
    3. Click on the name of any web launcher profile to edit that profile

    SugarCRM & Web Launcher

    So let's say that you have your own SugarCRM implementation.  You would like to open a contact or opportunity by the incoming Caller ID if it matches something already in your Sugar database.

    The search string for this type of search would be like:

    http://crm.fonality.com/index.php?module=Home&action=UnifiedSearch&query_string=%%caller_number%%

    In the string above, crm.fonality.com should be changed to YOUR COMPANY'S SUGAR URL.

    Now let's take a moment to discuss the pitfalls here:

    1. The phone number stored in Sugar must match exactly the Caller ID information sent by your phone company.
      1. If you have a phone number like 310-861-4300 (with dashes), but the phone company sends 3108614300 - the number won't match.
    2. Sugar may find more than one match, and return a list of possible results instead of an exact contact or opportunity.  This may or may not be what you want - but it's important to be aware of the possibility.

    You could, instead of the above URL, send the call to a CGI that formats the number for you as you have information stored in Sugar.  So you could write a simple CGI that runs a PERL script to perform some simple formatting on the phone number so that it will match your Sugar input.

    Powered by MindTouch Core