AvayaCTIAdapterSalesforce.

com Integration InstallationandConfigurationGuide

DocumentChangeControl
Document Title Comments File Name AvayaCTIAdapter-InstConfGuide.doc REVISION HISTORY Rev 1.0 1.1 1.2 1.3 1.4 1.5 1.6 2.0 2.1 Type New Update Update Update Update Update Update Update Update Date 10/03/09 22/05/09 22/06/09 19/07/09 24/07/09 02/10/09 11/02/10 15/03/10 27/04/10 Author Mike West / Alexandre Melo Mike West Mike West Mike West Mike West Mike West Mike West Mike West Mike West Remarks Draft Version Update to Advanced Search Update for new config items Removed an old reference Added detail to New Reason Update for new config items. Even more config items. More config items. Softphone layout section added. More config items. Expanded the login screen examples. Added Firefox support. Icon menu. Listed config defaults. Enhanced call log config items. Installation and Configuration Guide

2.2 2.3

Update Update

25/05/10 22/07/10

Mike West Mike West

 2008 Avaya Inc. All Rights Reserved. Notice While reasonable efforts were made to ensure that the information in this document was complete and accurate at the time of printing, Avaya Inc. can assume no liability for any errors. Changes and corrections to the information in this document might be incorporated in future releases. Documentation disclaimer Avaya Inc. is not responsible for any modifications, additions, or deletions to the original published version of this documentation unless such modifications, additions, or deletions were performed by Avaya. Customer and/or End User agree to indemnify and hold harmless Avaya, Avayas agents, servants and employees against all claims, lawsuits, demands and judgments arising out of, or in connection with, subsequent modifications, additions or deletions to this documentation to the extent made by the Customer or End User. Link disclaimer Avaya Inc. is not responsible for the contents or reliability of any linked Web sites referenced elsewhere within this documentation, and Avaya does not necessarily endorse the products, services, or information described or offered within them. We cannot guarantee that these links will work all the time and we have no control over the availability of the linked pages. Warranty Avaya Inc. provides a limited warranty on this product. Refer to your sales agreement to establish the terms of the limited warranty. In addition, Avayas standard warranty language, as well as information regarding support for this product, while under warranty, is available through the Avaya Support Web site: http://www.avaya.com/support License USE OR INSTALLATION OF THE PRODUCT INDICATES THE END USERS ACCEPTANCE OF THE TERMS SET FORTH HEREIN AND THE GENERAL LICENSE TERMS AVAILABLE ON THE AVAYA WEB SITE http://support.avaya.com/LicenseInfo/ ("GENERAL LICENSE TERMS"). IFYOU DO NOT WISH TO BE BOUND BY THESE TERMS, YOU MUST RETURN THE PRODUCT(S) TO THE POINT OF PURCHASE WITHIN TEN (10) DAYS OF DELIVERY FOR A REFUND OR CREDIT. Avaya grants End User a license within the scope of the license types described below. The applicable number of licenses and units of capacity for which the license is granted will be one (1), unless a different number of licenses or units of capacity is specified in the Documentation or other materials available to End User. "Designated Processor" means a single stand-alone computing device. "Server" means a Designated Processor that hosts a software application to be accessed by multiple users. "Software" means the computer programs in object code, originally licensed by Avaya and ultimately utilized by End User, whether as stand-alone Products or pre-installed on Hardware. "Hardware" means the standard hardware Products, originally sold by Avaya and ultimately utilized by End User. License type(s) Designated System(s) License (DS). End User may install and use each copy of the Software on only one Designated Processor, unless a different number of Designated Processors is indicated in the Documentation or other materials available to End User. Avaya may require the Designated Processor(s) to be identified by type, serial number, feature key, location or other specific designation, or to be provided by End User to Avaya through electronic means established by Avaya specifically for this purpose. Concurrent User License (CU). End User may install and use the Software on multiple Designated Processors or one or more Servers, so long as only the licensed number of Units are accessing and using the Software at any given time. A "Unit" means the unit on which Avaya, at its sole discretion, bases the pricing of its licenses and can be, without limitation, an agent, port or user, an e-mail or voice mail account in the name of a person or corporate function (e.g., webmaster or helpdesk), or a directory entry in the administrative database utilized by the Product that permits one user to interface with the Software. Units may be linked to a specific, identified Server. Database License (DL). Customer may install and use each copy of the Software on one Server or on multiple Servers provided that each of the Servers on which the Software is

installed communicate with no more than a single instance of the same database. CPU License (CP). End User may install and use each copy of the Software on a number of Servers up to the number indicated by Avaya provided that the performance capacity of the Server(s) does not exceed the performance capacity specified for the Software. End User may not re-install or operate the Software on Server(s) with a larger performance capacity without Avayas prior consent and payment of an upgrade fee. Named User License (NU). Customer may: (i) install and use the Software on a single Designated Processor or Server per authorized Named User (defined below); or (ii) install and use the Software on a Server so long as only authorized Named Users access and use the Software. "Named User," means a user or device that has been expressly authorized by Avaya to access and use the Software. At Avayas sole discretion, a "Named User" may be, without limitation, designated by name, corporate function (e.g., webmaster or helpdesk), an e-mail or voice mail account in the name of a person or corporate function, or a directory entry in the administrative database utilized by the Product that permits one user to interface with the Product. Shrinkwrap License (SR). With respect to Software that contains elements provided by third party suppliers, End User may install and use the Software in accordance with the terms and conditions of the applicable license agreements, such as "shrinkwrap" or "clickwrap" license accompanying or applicable to the Software ("Shrinkwrap License"). The text of the Shrinkwrap License will be available from Avaya upon End User's request (see .Third-party Components" for more information). Copyright Except where expressly stated otherwise, the Product is protected by copyright and other laws respecting proprietary rights. Unauthorized reproduction, transfer, and or use can be a criminal, as well as a civil, offense under the applicable law. Third-party components Certain software programs or portions thereof included in the Product may contain software distributed under third party agreements ("Third Party Components"), which may contain terms that expand or limit rights to use certain portions of the Product ("Third Party Terms"). Information identifying Third Party Components and the Third Party Terms that apply to them is available on the Avaya Support Web site: http://support.avaya.com/ThirdPartyLicense/ Preventing toll fraud "Toll fraud" is the unauthorized use of your telecommunications system by an unauthorized party (for example, a person who is not a corporate employee, agent, subcontractor, or is not working on your companys behalf). Be aware that there can be a risk of toll fraud associated with your system and that, if toll fraud occurs, it can result in substantial additional charges for your telecommunications services. Avaya fraud intervention If you suspect that you are being victimized by toll fraud and you need technical assistance or support, call Technical Service Center Toll Fraud Intervention Hotline at +1-800-6432353 for the United States and Canada. For additional support telephone numbers, see the Avaya Support Web site: http://www.avaya.com/support Trademarks Avaya is a registered trademark of Avaya Inc. MultiVantage is a trademark of Avaya Inc. All non-Avaya trademarks are the property of their respective owners. Downloading documents For the most current versions of documentation, see the Avaya Support Web site: http://www.avaya.com/support Avaya support Avaya provides a telephone number for you to use to report problems or to ask questions about your product. The support telephone number is 1-800-242-2121 in the United States. For additional support telephone numbers, see the Avaya Support Web site: http://www.avaya.com/support

TableofContents

AVAYACTIADAPTERINSTALLATION ............................................................................................ 5
Scope................................................................................................................................................................. 5 References......................................................................................................................................................... 5 Acronyms........................................................................................................................................................... 5

INSTALLATIONPREREQUISITES ...................................................................................................... 6 ENVIRONMENTCONFIGURATION.................................................................................................... 7

PreRequisitesCheckList .................................................................................................................................... 7 BeginningtheInstallation .................................................................................................................................. 8 FirefoxSupport .................................................................................................................................................10

CTIADAPTERCONFIGURATION .....................................................................................................11
AESSetup .........................................................................................................................................................11 SalesforceSetup ...............................................................................................................................................11 Import......................................................................................................................................................................13 Edit ..........................................................................................................................................................................13 ManageUsers..........................................................................................................................................................25 CustomActivityFields .............................................................................................................................................27 SoftphoneLayout ....................................................................................................................................................29 PersonalSetting ......................................................................................................................................................34

CTIADAPTERUSE ...............................................................................................................................35
Running ............................................................................................................................................................35 Login.................................................................................................................................................................36 Calls..................................................................................................................................................................39 CallLog .............................................................................................................................................................41

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

AvayaCTIAdapterInstallation

AvayaCTIAdapterInstallation
ThisdocumentwillprovidequalifiedAvayaassociatesandpartnerswiththeguidancetoinstalland configuretheAvayaCTIAdapterforSalesforce.com.

Scope
ThisdocumentcoversallelementsofinstallationandconfigurationfortheAvayaCTIdriverfor Salesforce.com.

References
CTIToolkitDevelopersGuidefromSalesforce.com

Acronyms
ACDAutomaticCallDistribution AESAvayaApplicationEnablementServer ANIAutomaticNumberIdentification(CallerID) APEXSalesforce.comApplicationExchange CMAvayaCommunicationManager CTIComputerTelecommunicationIntegration DNISDialedNumberIdentificationService SFDCSalesforce.com TSAPITelephonyServicesApplicationProgrammersInterface UUIUsertoUserInformation

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

InstallationPrerequisites
Thissectioncontainsproceduresthatmustbefollowedbeforeyoubegininstalling,configuring,and administeringthesoftware. TheAvayaCTIAdapterforSalesforce.comisaclientresidentapplication.ItisanActiveXapplication thatexposesanActiveXinterface.TheSalesforce.comapplicationwillsearchforandrecognizethe interfacewhenpresent.Ifpresent,theSalesforce.comapplicationwillactivateasoftphone interfaceandusetheAvayaCTIAdaptertointerfacewiththeswitch. Thisdocumentincludesapreinstallchecklistalongwithinstructionsoninstallationintoanyagent desktop.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

EnvironmentConfiguration
PreRequisitesCheckList
ThisdocumentassumesthattheApplicationEnablementServices(AES)serverhasalreadybeen installedandthataccesshasbeenprovidedbythecustomertotheserverandthataclientPCis available.TheAESmustbeatleastversion3.1.xorbetter.Thefollowingchecklistshouldbeused. PreRequisite AESTSAPIClientmustbeavailable IPaddressofyourAESserverthatwillbeused NOTE:MakesurethatanypreviousversionoftheAvayaCTIAdapterisnotrunning. BeforeinstallingtheAvayaCTIAdapter,theAESTSAPIClientmustbeinstalled.Itisrecommended thatthelatestversionoftheTSAPIClient(currently4.2.1build338)isused.Duringtheinstallation, itwillaskforyourtelephonyserverinformation.ThisiseitherthefullyqualifieddomainnameorIP addressofyourAESserverthatwillbeused.Enterthatinformation,andthencontinuethe installation.Otherthanthatpieceofinformation,alldefaultsmaybeselected. ThisinformationisstoredinafilenamedTSLIB.INI,whichisstoredintheTSAPIClientinstall directory.IftheIPinformationwasenteredincorrectly,oreventuallyneedstobechanged,the TSLIB.INIfilecaneasilybechanged.Whenchanged,itwillbenecessarytorestarttheadapter applicationtorereadthenewvalue(s). OncetheTSAPIClientisinstalled,installtheAvayaCTIAdapterforSalesforce.Runthesetup programtoinstalltheAdapter.Simplyselectingthedefaultsaresufficient.Itwillalsoinstalla shortcutintoyourProgramsmenu. AsidefromassigningtheIPaddressoftheAESserverintheTSLIB.INIfile(eitherthroughtheinstall processoftheAESTSAPIClient,ordirectlybyeditingtheTSLIB.INIfile),thereisnoconfiguration thatneedstobedoneontheclientdesktop.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

BeginningtheInstallation
Runtheinstallationwizardfromthepathwheretheexecutablefilewasplaced.Youcanrunthe installerbysimplydoubleclickingintheinstallationwizardiconnamed AvayaCTIAdapterInstaller.msi. YouwillseetheWelcomeSetupscreenbelow:

InsertFigure01Welcomescreen

BeforestarttheinstallationselecttheBinFolderwherethedriverwillbelocated.

Figure02LocationofInstallationBinFolder CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 ThenSelectNextbutton.TheInstallationDestinationFolderwillbedisplayed.Bydefault, C:\ProgramFiles\Avaya\AvayaCTIAdapter4Salesforce\pathisset. TheNextbuttonwillsaythattheinstallerisreadytoinstallallcomponentsofthesolution.

Figure03Installerreadytostart

Atransitionscreenwillbeshowedwiththeprogressbarindicatingtheprogressoftheinstallation.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Figure04TheinstallationComplete

ClickontheClosebuttontofinishtheinstallation

FirefoxSupport
ToenableFirefoxsupportfortheCTIAdapter,runthebatchfilesfdcffex.bat.Thisfilewill determinetheFirefoxrootdirectory,registertwoDLLs,andinvokeFirefoxtoregisteraplugin. Whenthefinalstepoccurs,Firefoxwillstartandasktoregistertheplugin.Simplysayyes,and thepluginwillregister.Whenfinished,anytimeFirefoxisstarted,asmallversionofthe Salesforce.comiconwillbeshowninthefarrightcorneroftheFirefoxstatusbaratthebottomof theapplicationwindow. ThetwoDLLsareSFDCFirefoxConnectorPS.dllandSFDCFirefoxConnector.dll.Thenameofthe pluginissfdcffextension.xpi. Now,theCTIAdaptercancommunicatewithFireFox.FireFoxmustbeversion3.5orgreaterforthis extensiontowork.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

10

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

CTIAdapterConfiguration
AESSetup
ACTIusermustalsobedefinedontheAESserver.TheconfigurationoftheCTIAdapterassumes thatasingleCTIuserwillbedefinedforusebyallusers.Thisrequirestheusertohaverightstoall stationsthatwillbecontrolledbyaninstanceoftheCTIAdapter.(Alternatively,ratherthan individuallyenteringallofthestationstobeused,thesingleusercanbegivenunrestrictedstation controlrightsintheAES.) Inaddition,theTLink(whichisastringthatdefinesthelinkthattheCTIAdapterwillusetotalkto aspecificAESandCMcombination)mustbeobtainedfromtheAES.Thisvalueisusedinthe Salesforce.comconfigurationstep.

SalesforceSetup
AlongwiththeAvayaCTIAdaptersetupfile,anXMLfileisalsoprovided.ThisXMLfileisusedby theSalesforceapplicationtoconfiguresiteinformationforusewiththeCTIAdapter.Salesforce callsthissiteinformationCallCenterConfiguration. ThisisjustthenameusedbySalesforce.ThisisnotmeanttoimplythattheAvayaCTIAdaptermay onlybeusedinacallcenterenvironment.Infact,itcanbeusedwhetheracallcenterisconfigured intheCommunicationManagerornot. Togetthetotheconfigurationscreens,firstclickontheSetupoptionshownbelow:

(Linkishighlightedbycursorhand.) Thiswillchangethewholescreentoshowthesetuppage.Ontheleftsideofthescreen,asseries oflinksarepresentedinamenuasshownbelow:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

11

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

GounderAppSettings,andusethe+boxtoexpandCallCenter.Withintheexpanded options,selectCallCentersasshownbythecursorhand. Oncethisisselected,alistofcurrentlydefinedcallcenterswillbedisplayed.Inthepicturebelow,a listofcurrentlyconfiguredcallcentersarelisted.Whenconfiguredforthefirsttime,therewillbe nolistshown.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

12

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Import
Tocreateanewcallcenterentry,clickontheImportbuttonshownabovebythecursorhand. Whenclicked,animportscreenwillbeshown:

UsetheBrowsebuttontosearchfortheXMLfileprovidedtoseedthecallcenterinformation. OncetheXMLfileisidentified,clickontheImportbutton.

Edit
AftertheXMLfileisimported,thecallcenterdefinitionwillbedisplayedineditmode.Thisscreen canbereachedbyclickingontheEditlinkwhenthecallcentersarelistedtwopicturesup.The callcenterinformationisdisplayedinseveralportions,eachofwhichisdealtwithindividually below.(Theyareallpresentedonasinglescreen,butitistoolongtoshowinonepieceinthis document.)
CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

13

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 Inallcasesbelow,theonlyvaluesthatmatterarethosethatarelisted.Ifsomeothervalueisever input,thenthatinputisignored,andthedefaultvalueisusedinitsplace.ForallY/Nstyle questions,casedoesnotmatter.Forentriesthatincludelabelordatabasevalues,casedoes matter. Inthecaseoflabels,ifnoentryismade,thedefaultvaluewillbeused.Forvaluesthatareprovided throughSalesforce.com,thesedefaultvalueswillbeinternationalized.Forvaluesthataredefined inonlythisCTIAdapter,thedefaultvaluesareonlyinEnglish.Forotherlanguagestobedisplayed, thelabelvaluesshouldhavesomethingappropriateinthedesiredlanguage.Anylabelentryforan itemthatisonlyinthisCTIAdapterwillbenotedinitsdescription. ThefirstsectionisGeneralInformation:

ChangeInternalNameandDisplayNametoreflectyourcircumstances.Ifmorethanonecall centeristobedefined,bothoftheseentriesmustbeuniquefromanyothercallcenterdefinition. Theotherthreefieldsshouldbeleftwiththeirdefaultvalues. ThenextsectionisCTIServerInformation:

HostAandHostBmustbevalidTLinks,asmentionedaboveintheAESConfigurationsection.The TLinkstringsmustbeexactlytranscribedintothesefields.IftherearetwoAESserversconfigured totalktothesameCommunicationManager,enterthetwodifferentTLinksforfailoverpurposes.If thereisonlyoneAES,thenenterthesameTLinkinbothfields. AESUserandAESPwdfieldsaresettobetheAESCTIUsernameandPasswordvaluesconfigured fortheAdapterbackintheAESConfigurationsection. ThenextsectionisDialingOptions:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

14

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

ThesevaluesaresettothedialingconfigurationdeterminedfromtheCommunicationManager. ThenextsectionisCallCenter:

Thesevaluesdeterminetheprimarycharacteristicsofthesoftphone. IsCallCenterdefinesifthecallcenterusesanACD.IfsettoYorS,theuserswillbeloggedinto theACDstationsothattheycanhavecallsautomaticallydistributedtothem.SettingYmeans thatCallCenterEliteisbeingused.ThisisskillsbasedroutingorAdvocate.Theuserlogsintoa specificAgentID,whichdefinestheskillsused.SettingSmeansthatCallCenterBasicisbeing used.Thisissplitrouting,wheretheuserlogsdirectlyintoaspecificqueue.IfsettoN,the usersdonotuseanACD,andonlyhavetelephonycontrolovertheirphones.Thedefaultvalueis N. NumberofLinesdefinesthenumberoffixedlinesthatthesoftphonewillhave.Itmusthaveat leastone,anditmayhaveuptosix.Thisnumbershouldmatchwhathasbeendefinedforthe physicalstations.Thedefaultvalueis1. ReadyTypedefineswhethertheAdapterwilluseAutoIn(byenteringA)orManualIn(by enteringM)whensettingtheagenttoReady.ThedefaultisA.(Notethatthisonlyappliesif WrapupReasonEnabled[seebelow]issettoN.IfWrapupReasonEnabledissettoY,only ManualInwillbeused,overridingthedefaultvalue.) NotReadyEnableddefineswhethertheoptionforNotReadyisdisplayedinthedropdownlist.A valueofNmeansthattheagentwillnotseetheoption.ThedefaultisY. WraupEnableddefineswhethertheoptionforWrapupisdisplayedinthedropdownlist.Avalue ofNmeansthattheagentwillnotseetheoption.ThedefaultisY.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

15

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 AutoAnswerIncomingCallssetswhethertheincomingcallsareautomaticallyansweredbytheCTI Adapter.AvalueofYindicatestoautomaticallyanswerincomingcalls.AvalueofNmeansthe agentwillanswercallsmanually.ThedefaultvalueisN.Iftheagentsstationsmustbesetto autoanswerincomingcalls,itisimportanttolettheCTIAdapterdothis,ratherthanthe CommunicationManager.ThereasonisbecausetheCommunicationManagerwillanswerthe phoneinstantaneously,andnotallowascreenpoptooccur.Whentheautoanswerisperformed bytheCTIAdapter,enoughtimewillbegiventoallowthescreenpoptowork. ClicktoConferenceEnabledsetswhetherclickingaphonelinkinSalesforcewillcreatea conference.Ifthestationisidle,andaphonelinkisclicked,anewcalwillbeplacedfromtheusers station.IfthisissettoY,andthestationisonacall,ifaphonelinkisclickedaconferencewillbe createdfromtheexistingcalltotheclickednumber.IfthisissettoN,theclickwillbeignoredany timethestationisnotidle.ThedefaultvalueisY. ThenextsectionisCallLogSettings:

Thesesettingscontrolthebehaviorofthecalllog. CallLogEnableddefineswhetheracalllogissavedforeachcompletedcall.AvalueofYmeans thatcalllogsaresaved;avalueofNmeansnocalllogsaresaved.ThedefaultisN. CallLogonIncompleteCallsdefineswhethercalllogsaresavedforunanswered(orabandoned) calls.AvalueofYmeansthesecalllogsaresaved;avalueofNmeansthatonlycompletedcall logsaresaved.ThedefaultisN.ThisshouldonlybesettoYifitisknownthatthisisa requirement. PreserveCallLogRelatedDataSelectiondefineshowthedefaultselectionofitemsrelatedtoacall logisdetermined.Thedefaultbehavioristhatanytimetheuserbrowsestoanobject,thatobject isrelatedtothecalllogandisselectedasthedefaultobjectthatwillbeusedwhenthecallends andthecalllogissaved.ThisistheprocedurethatischosenifthesettingisN.AvalueofYwill causethedefaultobjecttoremainwiththefirstselectedobject.Nomattertowhatobjectis browsed,thedefaultselectionwillnotchange.Theonlywaytochangethedefaultobjectisforthe usertoactivelyselectadifferentobjectinthecalllogdisplay.ThedefaultisN.
CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

16

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 LinkCallLogtoTasksetswhethercallsgeneratedfromataskarehardlinkedtothattask.Avalue ofYmeansthattheyarelinked,effectivelyturningthetaskintothecalllog.AvalueofNmeans theyremainseparateitems.ThedefaultisN.ThisshouldonlybesettoYifitisknownthatthis isarequirement. AutocompleteLinkedTaskonlyhasmeaningiftheprioritemissettoY.Inthatcase,avalueof Ymeansthatthelinkedtask/calllogissettoCompletewhenthecallends.AvalueofN meansthatthelinkedtask/callloghasitsstatusunchangedwhenthecallends.ThedefaultisN. Notethatthisonlyaffectslinkedtask/calllogs.Ordinarycalllogsarestillalwayssettoastatusof Completewhenthecallends.So,ifLinkCallLogtoTaskissettoN,thisvalueisnotused. UseCustomCallLogFieldsspecifieswhetherapresetsetofcustomfieldsinthecalllogistobe used.ThecustomfieldsareCaller,Called,andUCID.Allthreefieldsmustallbepresentfor thisfeaturetoworkproperly.Thesevaluesarethenstoredineverycalllog.AvalueofYmeans thesefieldsarepresentandtobeused;avalueofNmeansthatthesefieldsarenotdefinedand cannotbeused.ThedefaultisN.ThisshouldonlybesettoYifthefieldsarepresent.Ifsetto Ywithoutthefieldspresent,nocalllogswillbesaved. ThenextsectionisButtonSettings:

TransferButtonEnableddefineswhethertheTransferbuttonisavailable.AvalueofNmeans thatthebuttonisnotavailabletotheagent.ThedefaultisY. ConferenceButtonEnableddefineswhethertheConferencebuttonisavailable.AvalueofN meansthatthebuttonisnotavailabletotheagent.ThedefaultisY. FirstNewButtonTypedefineswhetheraNewItembuttonisdisplayedwhenacallisactive,and whatitstypeis.PossiblevaluesareCase,Contact,Account,Task,Lead,and Opportunity.Ifanyarespecified,abuttonwillbeshown,andwhenclicked,thescreenneededto definethatnewitemwillbepoppedintotheagentsdisplay.Ifanyvaluebuttheaboveisentered, orifthefieldisleftblank,nobuttonwillbedisplayed.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

17

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 FirstNewButtonLabeldefinesthelabeltouseforthefirstNewItembutton.Ifnotdefined,the defaultlabelforthatitemwillbeused.Thisvalueisignoredifthereisnotypedefinedforthis button.TheNewItembuttonlabelisanAvayacustomfield,andassuchthedefaultstringvalue isonlyinEnglish.InanyinstallationthatwillnotbeusingEnglish,itisveryimportantthatan appropriatestringintheinstalllanguagebeenteredinthisfield. SecondNewButtonTypedefineswhetherasecondNewItembuttonisdisplayed.Itsoperation andavailableoptionsarethesameastheFirstNewButtonType. SecondNewButtonLabeldefinesthelabeltouseforthesecondNewItembutton.Itsoperation isthesameastheFirstNewButtonLabel. ThirdNewButtonTypedefineswhetherathirdNewItembuttonisdisplayed.Itsoperationand availableoptionsarethesameastheFirstNewButtonType. ThirdNewButtonLabeldefinesthelabeltouseforthethirdNewItembutton.Itsoperationis thesameastheFirstNewButtonLabel. ThenextsectionisLabelsSettings:

MyReportLabelallowsforadifferentlabeltobeusedfortheDailyReportslink. URLReportpermitsacompletecustomURLtobespecifiedforthereportslink.TheURLmustbea fullURL,notapartialURL. LoginAgentNameallowsforadifferentlabeltobeshownontheloginscreenfortheAgent Namefield.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

18

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 LoginAgentPasswordallowsforadifferentlabeltobeshownontheloginscreenforthe Passwordfield.Settingthisto(twohyphencharacters)willpreventthePasswordfieldfrom beingshownontheloginscreen.TheuserwillonlyseetheAgentNamefieldandtheExtension field.(Thisisusefuliftheagentidshavenopasswordassignedtothem.) LoginExtensionallowsforadifferentlabeltobeshownontheloginscreenfortheExtension field. LoginQueueExtensionallowsforadifferentlabeltobeshownontheloginscreenforthe PeripheralIDfield.ThisfieldwillonlybeshownwhentheIsCallCenteroptionissettoS.This isthequeueextension(orhuntgroupextension)ofthesplitintowhichtheagentislogging. LoginAESUsernameallowsforadifferentlabeltobeshownontheloginscreenfortheCT Usernamefield. LoginAESPasswordallowsforadifferentlabeltobeshownontheloginscreenfortheCT Passwordfield. ReadyLabelallowsforadifferentlabeltobeusedintheagentstatepulldownlist.Ifleftempty, thedefaultvalueofReadyforCallswillbeused. NotReadyLabelallowsforadifferentlabeltobeusedintheagentstatepulldownlist.Ifleft empty,thedefaultvalueofNotReadyforCallswillbeused. NotReadyNewReasonLabelallowsforadifferentlabeltobeusedintheagentstatepulldown list.Ifleftempty,thedefaultvalueofNotReadyNewReasonwillbeused.UnliketheotherACD statesinthissection,NotReadyNewReasonisanAvayacustomfield,andassuchthedefault stringvalueisonlyinEnglish.InanyinstallationthatwillnotbeusingEnglish,itisveryimportant thatanappropriatestringintheinstalllanguagebeenteredinthisfield.(Ifthedefaultstringsare usedintheotherentries,Salesforcewilltakecareofusingthecorrectlanguage.) WrapupLabelallowsforadifferentlabeltobeusedintheagentstatepulldownlist.Ifleftempty, thedefaultvalueofWrapUpwillbeused. OnCallLabelallowsforadifferentlabeltobeusedintheagentstatepulldownlist.Ifleftempty, thedefaultvalueofOnaCallwillbeused. LogOutLabelallowsforadifferentlabeltobeusedintheagentstatepulldownlist.Ifleftempty, thedefaultvalueofLogOutwillbeused. ThenextsectionisReasonCodesEnabled:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

19

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Iftheparticularsetofreasoncodesistobeused,thenthefieldshouldbesettoY.Ifnot,thenset themtoN.Eachofthesesettingsisindependentoftheothers;theydonotneedtohavethe samevalues.ThedefaultvalueforallthreeisN. IfoneoftheseissettoY,butnocorrespondingreasoncodesaredefined,thenthisvalueis ignored,andthedefaultofNisused.Tocollectreasoncodesthefieldmustbeenabledandat leastonereasoncodemustbedefined. WrapupReasonCodesareusedwhenthecallendsandtheagententerstheWrapup(i.e.aftercall work)state.WrapupReasonCodesmaybeusedregardlessoftheIsCallCentervalue.Thedisplay valuegivenforthereasonissavedintheCallLogforthatcall.(Thenumberissimplytokeepthe possiblevaluesinorder.)IftheCallLogisnotbeingused(i.e.theCallLogEnabledentryissetto N),thenWrapupReasonCodesmaynotbeused,astherewouldbenowheretostorethem. LogoutReasonCodesareusedwhenanagenttriestologout.NotReadyReasonCodesareused whentheusergoestoNotReady(i.e.auxiliaryworkmode).LogoutandNotReadyReasonCodes aresavedbytheCommunicationManagerintheCallManagementSystem.Salesforce.comdoes notstoreorusethesetwotypesofreasoncodes.IfIsCallCenterissettoN,thenLogoutand AUXreasoncodesarenotused,andthesevaluesareignored,andbothvaluesdefaulttoN. Onlythoseentrieswithtextsuppliedwillbepresentedtotheuser.(So,intheexamplebelowfor WrapupReasonCodes,onlyfiveoptionswouldbepresentedtotheuser.) Thenextthreesectionsprovideameanstogivedisplaymessagesforeachtypeofreasoncodeto beused. FirstaretheWrapupReasonCodesdescriptions:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

20

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 NextaretheLogoutReasonCodesdescriptions:

AndthirdaretheNotReadyReasonCodesdescriptions:

ThefinalsectionisScreenPop,wherethescreenpopbehaviorisconfigured:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

21

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 ScreenpopscanbegeneratedfromCallerIdentification(ANI),theinternalnumberusedtoenter thesystem(DNIS),CTIdatainformationprovidedbyanotherCTIenabledsystem(UUI),ordigits collectedfromvectorstepsintheCommunicationManager(Digits).Inallofthesecases,thevalue placedinthefieldsisatableandfieldnamefromtheSalesforce.comdatabase.Ifthefieldisleft empty,thennomatchattemptismade.(ANIisaspecialcase.)Ifthefieldisfilled,thenthevalue receivedfromtheincomingcallwillbeusedtoattempttofindamatchinthespecifiedobject (table)andfieldintheSalesforce.comdatabase.So,forexample,intheimageabove,thefirstUUI fieldwillbematchedagainsttheAccountNumberfieldoftheAccountobjectintheSalesforce database. Sometimesitisnotdesiredforascreenpoptooccurontransferandconference.Tofacilitatethis, PoponTransferandConferencecanbeusedtocontrolthisbehavior.IfthevalueissettoY,then alltransfersandconferenceswillautomaticallypopwhenthecallarrivesatthedestinationstation. IfthevalueissettoN,thenthedestinationstationwillnotreceiveapoponatransferor conference.IfthevalueissettoD,thenthepopontransferandconferencearedelayeduntilthe transferorconferenceiscompleted.ThedefaultvalueisY,andthedefaultshouldbekeptunless thealternativebehaviorisknowntobeaspecificrequirement. NotethattheDsettingwillonlyworkproperlyiftransfersandconferencesaredonethroughthe Salesforcesoftphone.Ifcallsaretransferredorconferenceddirectlythroughthephoneset,the screenpopwillnotoperatecorrectly.Also,inthissetting,ifthecallisansweredpriortothe transfer(orconference)beingcompleted,themainscreenwillnotpop.Theuserwillneedtoclick ontheinformationlinkinthesoftphonetoupdatethemainscreen. UUISeparatorandUUIDataarespecialcharactersusedtoallowformultipleitemsintheUUI.The separatorcharacterisusedtoseparatethethreevaluesintheUUI.Ifthereisadditionaldatathatis nottobepoppedon,thatdataisprecededbythedatacharacter.Anycharactersmaybeselected, butobviouslythecharactersselectedshouldnotoccurintheactualdata.IfUUIisnotbeingused, thenthesevalueshavenomeaning. Bydefault,Salesforce.comwilltaketheprovidedcallerinformationandsearchallphonenumber fieldsinthesystemtotryandfindamatch.TheANIonlyneedstobesetifanondefaultsearchfor callerinformationisdesired.Thisfieldwillalmostalwaysbeempty. ANIalsohasaspecialuse.Setthefirsttwocharactersto,andanydigitsthatfollowwillbe usedtoobfuscatetheANI.(Ifnodigitsfollowthe,thentheANIwillbeobfuscatedwith 0000.)ThereasonthismightbedoneistosuppressthedefaultANIsearch.Thissearchcannotbe disabled,butbyobfuscatingtheANIvalue,thesearchwillbepreventedfromsucceeding.Theextra characterschangetheformoftheANItosomethingthatcannotbematched. Ifthescreenpopshouldbecontrolledbasedonthenumberthecallerdialed,thenDNISisused.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

22

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 IfnumericdataiscollectedusingthepromptandcollectcapabilitiesoftheCommunication Manager,thenDigitsisused.Ifcollecteddigitsaretobeused,anadditionalprogramcalledVDN Monitorwillneedtobeusedandconfiguredtoallowforcollecteddigitstoreachtheagent stationandbereadablebyCTI. ShowDigitswilldetermineifthecollecteddigitsareshownregardlessofanymatchwhendoing thepopsearch.IfsettoY,thenanycollecteddigitsarealwaysshownasaninfofieldnomatter what.IfsettoN,thenthedefaultdisplayisused,andthecollecteddigitswillonlybeseenwhen asuccessfulmatchoccurs.ThedefaultisN. IfthevalueofShowDigitsisY,thenDigitsLabelcontainsthestringthatisusedasthelabelfor thecollecteddigitsinfodisplay.ThedefaultlabelisonlyinEnglish,sothisvaluemustbedefinedfor anyotherlanguageifShowDigitsisY. IfthecallcontainsCTIdatainformationthatisprovidedbyanotherCTIenabledsystem(for example,aninteractivevoiceresponsesystem),thenusetheUUIfields(UUI1,UUI2,andUUI3).CTI datacanbedividedintouptothreeseparateitemsforscreenpop.Inaddition,therecanbeextra datathatisnottobepoppedon,butneedstobeintheCTIdata.(TheUUIstringprovidedbythe callrecordisdividedupbythecharactersspecifiedinthepreviouslymentionedUUISeparatorand UUIData.) Examples(assumingtheUUISeparatoris|,andtheUUIDatais;): Thereissomedatatobepoppedon,followedbydatathatisnotusedforapop: N32B877692;Forsomethingelse Twoseparatepiecesofdataforapop: FirstData|SecondData Threeseparatepiecesofdataforapop,followedbydatathatisnotusedforapop: First|Second|Third;Extra Dataonlyshownasinfo,andnotusedforpop: ;DisplayData Onlyonevaluewithnodisplaydata: PopWithMe ShowUUIDatawilldetermineifthedisplayonlyportionoftheUUIstring(everythingthatoccurs afterthecharacterspecifiedinUUIData)isshownasaninfofield.IfthevalueisY,thenitis shown.IfthevalueisN,thenitisnevershown.Normally,itisexpectedthattheUUIDatawould
CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

23

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 alwaysbeshown.However,therecouldbecaseswhereaconfigurationisdesiredsuchthattheUUI Dataisnotshown,anditwillbeusedbysomethinglaterinthecallchainafterthecallleavesthe usersphone.ThedefaultisN. ShowFullUUIwilldetermineifthefullUUIstringisshownregardlessofanymatchwhendoingthe popsearch.IfsettoY,thenthefullUUIstringisalwaysshownasaninfofieldnomatterwhat.If settoN,thenthefullUUIisnotshow,andonlytheelementsoftheUUIthathaveachieved matchesareshown.ThedefaultisN. IfthevalueofShowFullUUIisY,thenUUILabelcontainsthestringthatisusedasthelabelfor thefullUUIinfodisplay.ThedefaultlabelisonlyinEnglish,sothisvaluemustbedefinedforany otherlanguageifShowFullUUIisY. ThelasttwoitemsintheScreenPopsectionareAdvancedSearchURLandAdvancedSearch Parameters.Ifthefirstfieldisleftempty,thentheanyconfigurednormalsearchisperformed,and theseparametersareignored.(Havingavalueinthesecondmeansnothingifthereisnovaluein thefirstofthetwo.) Ifthefirstfieldisset,thenthenormalsearchesarenotperformed,andinsteadanadvancedsearch isused.ThisadvancedsearchisprovidedintheformofapartialURLasshownbelow:

Anexamplewouldbe: apex/CTIPagePop Thesecondparameterprovidesthelistofcalldatathatcanbesenttothesearch.Therearesix optionsthatcanbeused:A(ANI),D(DNIS),C(CollectedDigits),U1(firstUUIfield),U2(secondUUI field),andU3(thirdUUIfield).Tosetthefield,simplylistthedesiredelementslistedabove,each separatedbyacomma. ThedesignateddatawillbepassedontotheURLsothatitcanbehandledbythisadvancedsearch, ratherthanthenormalsearch.ThedesignateddatawillbeaddedtotheendoftheconfiguredURL. AssumingonlythefirsttwoUUIfieldsareused,theresultantformwouldlooklike: ?U1=12&U2=1234 ThatmeansthefullURLwouldenduplookinglike: apex/CTIPagePop?U1=12&U2=1234 Notethatthefulllistwillbeprovidedateverycall,evenifitcontainsnodata.So,thepagethatthe URLinvokesneedstoexpectallofthespecifiedparameterstobesenteverytime,anditneedsto CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010 24

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 beabletohandleemptyvalues.Asanexample,iftheonlyvaluepresentforaparticularcallisthe firstUUIfield,theURLwouldlooklike: apex/CustomerCTIPagePop?U1=12&U2= Finally,oncealloftheconfigurationdatahasbeenconfigured,clickontheSavebuttontosave thedata.

ManageUsers
Next,specificusersmustbeassignedtothiscallcenter.Nowthatthecallcenterhasbeendefined andsaved,itwillbepresentedinthelistofcallcenters.Clickonthenameofthenewcallcenter. Scrollallthewaytothebottomofthecallcenterdefinition,andanewsectionwillbeseen:

Tomanagetheusers,clickontheManageCallCenterUsersbutton.Allofthecurrently configureduserswillbedisplayed:

Toaddmoreusers(oraddthefirstusersiftheabovelistisempty),clickontheAddMoreUsers button.Doingsowillprovideadisplaythatallowsforthesearchforuserstoberestrictedinsome manner:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

25

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Setanydesiredparameters(orleavethemallunchangedforadefaultglobalsearch)andclickon theFindbutton.Thiswilldisplayallcurrentlyunassignedusers:

Onlyunassigneduserswillbeshown.Ifausermustmovecallcenters,theusermustfirstbe removedfromthecurrentcallcenterassignment,makingtheuserunassigned.Onlythenmaythe userbesearchforandsubsequentlyaddedtothenewcallcenter. CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010 26

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 Selecttheuserstoaddtothecallcenter:

AndclicktheAddtoCallCenterbutton. Whentheusersareadded,thedisplayisreturnedtotheuserlist,withthenewlyaddedusers included:

Nowthecallcenterisfullydefined,andhasusersassignedtoit.

CustomActivityFields
Ifthecustomfieldsareusedinthecalllog,theymustbedefinedintheSalesforceconfiguration. Thesecustomfieldswillstorecommoncallrelatedfieldsthatarenotnormallysavedinthecalllog. ThosefieldsareCaller,Called,andUCID.TheCallerfieldcontainsthecallingpartyofthecall (alsoknownasANI).TheCalledfieldcontainsthecalledpartofthecall(alsoknownasDNIS). TheUCIDfieldistheAvayaUniversalCallIDwhichisavaluethatuniquelyidentifiesthecallinthe AvayaCommunicationManagerovertimeandisoftenusedforreportingpurposes. Gobacktotheseriesoflinksinthemenuthatisshownontheleftsideofthescreen:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

27

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

GounderAppSettings,andusethe+boxtoexpandActivities.SelectActivityCustom Fields,whichistowardsthebottomofthesection. Oncethisisselected,alistofallcurrentlydefinedcustomfieldsisdisplayed.UsetheNewbutton tocreatethecustomfields.AllthreeofthesefieldsareoftypeText.CallerandCalledshould besetto50charactersinlength.UCIDshouldbesetto25charactersinlength.Oncethefields arecreated,youwillseethemwhenthelistingscreenisrefreshed:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

28

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

ItisveryimportantthattheFieldLabelbeenteredexactlyasshownabove.Iftheydontmatch,the attemptstosavethevalueswillfail,andnocalllogswillbesaved.

SoftphoneLayout
TheSoftphoneLayoutconfigurationdetermineshowscreenpopsareperformed.Itdefineswhat dataelementsareshown,whatdataelementsareretrievedonadefaultANIsearch,andhowdata isoperatedonwithdifferentsearchresults. Gobacktotheseriesoflinksinthemenuthatisshownontheleftsideofthescreen:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

29

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

GounderAppSettings,andusethe+boxtoexpandCallCenter(ifitisntstillexpanded).This time,selectSoftPhoneLayouts,whichisbelowCallCentersthatwejustfinishedusing. Oncethisisselected,alistofcurrentlydefinedsoftphonelayoutswillbedisplayed.Inthepicture below,alistofcurrentlyconfiguredsoftphonelayoutsarelisted.Whenconfiguredforthefirst time,therewillonlybethestandardsoftphonelayout.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

30

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 ClickontheEditlinkpointedtobythecursorinthepictureabove.Thiswillshowthefullsettings forthissoftphonelayout:

Thereareseveralaspectsofthesoftphonelayoutthatmaybemodified.Thefirstsectioncontrols whatitemswillalwaysbedisplayedforacallwhentheinformationisavailable.Thesecondsection controlswhatSalesforcedatabaseobjectswillbedisplayonasuccessfulscreenpop,andwhat fieldsinthoseobjectswillbedisplayed.Thethirdsectionistoconfigurethenewscreenpop featuresprovidedinthelatestversionoftheCTIAdapter. Thebasiccalldetailfieldsthataretoalwaysbedisplayedforacallareconfiguredinthefirstpiece. Thedefaultshouldalwaysbeused,astheothertwodataelementsthatcanbeconfiguredarenot usedbytheAvayaCTIAdapter. TheSalesforceobjecttobesearchedanddisplayedonscreenpopsisalsodefinedforthe softphonelayout.Foreveryobjectincludedonthescreenpopsearches,alistoffieldstodisplayis alsodefined.Forexample,theoptionsfortheContactobjectareshownbelow:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

31

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Inthiscase,onlytheNameandTitlefieldsaretobeshown.But,anyoftheotherfieldsinthe Contactobjectcanbeselectedandshown,too. TheScreenPopSettingsallowmoredefinitioninhowscreenpopsareshown.

Thefirstoptiondetermineswherethescreenpopwilloccur.Itcanpopwithintheexistingbrowser window,oritcanpopintoanewbrowsertab.(Ifthebrowserbeinguseddoesnotsupporttabs,it canpopintoanewbrowserwindowinstead.)

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

32

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Thesecondoptiondetermineswhatwillbedoneifnomatchesarefound.Thechoicesaretohave nopopatall,topoptoanewSalesforceobject(e.g.anewcase),ortopoptoaVisualForcepage.

Thethirdoptiondetermineswhattodowithauniquematch.Thechoicesaretonotpopatall,pop intothedetailpage,orpoptoaVisualForcepage.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

33

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 Thelastoptiondetermineswhattodowhenmultiplematcheshavebeenfound.Thechoicesareto notpopatall,poptoasearchpage,orpoptoaVisualForcepage. ThelastthreeoptionsallowforconfiguringadifferentVisualForcepageforeachofthethree options.Also,aVisualForcepagecouldbeusedforonlyasinglecondition,andnotfortheothers. ThisisdifferentthantheAdvancedSearchoptionintheCallCenterdefinition.AdvancedSearchwill alwaysuseasingleVisualForcepageinallcases,andwillbeusedinsteadofthenormalpop mechanism.However,italsoprovidesagreateramountofflexibilityinpassingthedatatoit.

PersonalSetting
Thereareacoupleofadditionalsettingsthataremanagedonanindividualuserlevel.Toaccess these,usethesameSetupmenubarasshownabove,butgointothePersonalSetupportion:

ClickingonMySoftPhoneSettingswillbringuptheoptionsavailableforuserstoset:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

34

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 Ifthefirstboxischecked,aftertheusersuccessfullylogsin,theuserwillbeautomaticallylogged intothesoftphoneusingthesamesettingseachtime. Thesecondoptiondetermineswhetherthescreenpopwillbeperformedornot.Evenifthe matchedrecordisnotautomaticallypopped,anymatchedrecordsarealwayspresentedasalink onthesoftphone.Clickingonsuchalinkwillbringuptherecord.

CTIAdapterUse
Running
TousetheAvayaCTIAdapter,theadapterprogrammustbestartedontheclientdesktop.Thiscan bedonemanuallybyusingtheshortcutprovidedintheWindowsStartmenu,orbycopyingthe shortcutintotheStartupfolder.Oncestarted,itsiconwillappearintheWindowssystemtray.

Whenrunning,rightclickingontheiconintheWindowssystemtraywillbringupasmallcontext menu.

ThismenuallowsthemanualterminationoftheCTIAdapter(usingtheExitmenuoption), showingversioninginformation,andsettingthelogginglevelsandthelocationofthelogfiles.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

35

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Bydefault,thelogfileswillalwaysbelocatedintheinstallationdirectory.Iftheyneedtobelocated somewhereelse,changetheentriesforthelogfiles.Itisrecommended,however,toleavethemin theinstallationdirectory. TheLogLeveldetermineshowmuchinformationisstoredinthelogfiles.Itishighlyrecommended thattheloglevelbekepttoLowunlessaspecificissuingisbeinginvestigated.Settingthelog leveltoHighwillcausethelogfiletogrowveryquickly. OncetheCTIAdapterisrunningonthedesktop,itisavailableforusewiththeSalesforce application.Startyourwebbrowser,gototheSalesforce.comloginpageandlogin.Whenlogged in,thesoftphoneapplicationwillbeseenstartingup.

Login
Afterafewmoments,thesoftphoneloginscreenwillbeseen.Ifconfiguredforafullcallcenter, thentheloginscreenwillaskforthreepiecesofinformation:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

36

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

AgentIDisthenumericIDusedtologtheagentintotheACD,andPasswordisthenumeric passwordassociatedwiththeID.Passwordcanbeblankifnopasswordisassignedintheagent definition.IfAgentIDisblank,thentheuserisloggedinasifthereisnocallcenter. Ifconfiguredforabasiccallcenter,anadditionalpieceofinformationisdisplayed:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3 July2010

37

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3 Withabasiccallcenter,theuserisloggingdirectlyintoasplit.ThePeripheralIDisthehuntgroup extensionforthesplit.Anagentmayonlylogintoasinglesplit;multisplitloginsarenot supportedbytheCTIAdapter. AgentIDistheBCMSIDcreatedfortheuser.PasswordisthepasswordfortheBCMSID.Bothfields couldbeblank,dependingonwhetheraBCMSIDisdefined,oriftheBCMSIDhasapassword specified. Whereas,ifthisisnotinacallcenter,onlyonepieceofinformationwillberequired:

Extensionistheextensionnumberofthephysicalstationatwhichtheuserwillreceivetheircalls. Thisistrueregardlessofwhatloginscreenispresentedtotheuser. Finally,iftheCTUsernameandPasswordarenotdefinedintheCallCenterdefinition,theuserwill bepromptedtoprovidethosepiecesofinformationontheloginscreen:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

38

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

InthiscaseCTUsernameistheusernameusedtoauthenticateagainsttheAES,andCTPasswordis theassociatedpassword.NotethatthisisshowingthemwiththeCallCenterlogininformation,but theycanbeusedwithanyoftheabovepossiblelogindialogs. Oncetheuserlogsin,theywillseethesoftphoneinitsidlestate:

Calls
Whenacallcomesin,thesoftphonewillshowthecallingparty,andallowthecalltobeanswered:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

39

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Ifanswered,thesoftphonewillchangetoallowforfurthercontrolofthenowconnectedcall:

Iftheincomingcallgetsamatch,thenthematchinginformationisshowninthesoftphone:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

40

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Inthiscase,thematchinginformationisforaContactnamedColdCall.Thisinformationisfully clickable,andthenamecanbeclickedtodisplaythematchingcontact.(Thisisonlynecessaryifthe userhasbeenconfiguredtonotautomaticallypopthematch.Iftheuserwasconfiguredto automaticallypopuniquematches,thecontactwillalreadybepresentedtotheuser.)

CallLog
Wheneveracallhasbeencompleted,theCallLoginformationisdisplayedaspartofthesoftphone:

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

41

AvayaCTIAdapterforSalesforce.comInstallationandConfigurationGuide2.3

Thelastobjectviewduringthiscallwillbesavedasanassociatedrecordforthecallinthecalllog. Also,thereisacommentareawheretheusercanenterfreeformtextforthiscall.

CTIAdapterforSalesforceInstallationandConfigurationGuide2.3

July2010

42