Interviewer - Server > Architecture > Interview Service tier > Dialer Interface component > Project and interview properties for autodialing
 
Project and interview properties for autodialing
Project and interview properties are used to store various parameters that control the way calls and recordings are made. You can specify values for these properties in DPM and some can also be changed on a per-project basis using the Project Editor or Interviewing Options activities.
Caller identification
Caller identification lets you know who is calling before you pick up the phone. When using the dialer, your company may choose whether or not to send caller identification as part of the call. Each interview has a CallerID property that determines whether this information is sent. This is set globally for all interviews in a project using the CallerID project property.
How long to try dialing a number?
The AutoDialTimeout property determines the number of seconds that auto-dialing should continue trying to dial numbers for an Interviewer. The default is 600 seconds (10 minutes). If this property is not defined the dialer will try until it achieves a connection.
How long to let the phone ring?
The dialer normally allows the phone to ring for 15 seconds before deciding that the call will not be answered. You can set this value on a project basis using the NoAnswerTimeout property in DPM and you can change it for individual interviews in the sample management script. For example, you might want to increase the time-out for records in the RECALL queue.
For countries that require it, the MinimumRingTime project property specifies the minimum amount of time the phone must ring before the call is disconnected. The default is 0.
What to record
The dialer normally records entire calls right from the moment a call is answered. The RecordInterviewOnly project property lets you restrict recording to just the interview portion of each call.
Percentage of calls to record
The PercentCallsRecorded project property lets you specify what percentage of calls/interviews should be recorded for a project.
Participant disallows recording
Each interview has a RecordingProhibited property that is set whenever a participant declines to be recorded. If recording has already started, it then stops immediately.
Number of records to return from sample management
It is more efficient to return a large number of records at one time than to call Get multiple times. When group dialing, the predictive algorithm will set the SMRecordsRequired property based on the number of additional records required to dial. However, by default MaxRecordsRequired should be set to 1 and it should be left to the predictive algorithm to control the SMRecordsRequired property. The SMRecordsRequired property is set as the batch size if its value is greater than NumSampleRecsInBatch with a maximum value as defined by the MaxRecordsInBatch property value (the maximum value defaults to 25 when MaxRecordsInBatch is not defined).
Multiple calls to Get may be required in order to retrieve records that meet different sets of interviewer qualifications. Records are retrieved from sample management, as follows, when an Interviewer retrieves the next contact:
1 GetSampleRec is called to return a single preview record for the Interviewer.
2 If the record that is returned requires preview, it is returned immediately to the Interviewer to be previewed and the extension is dialed.
3 If the record does not require preview, it is used for group dialing (this is done to minimize the number of calls to GetSampleRec by the group dial process).
4 If additional records are required by group dialing, GetSampleRec is again called. SMRecordsRequired is set to return the number of additional records required for the group as determined by the predictive algorithm. The GroupDial property is used to ensure that preview records are not returned.
Do recordings exist for this interview?
The RecordCall interview property is set automatically whenever a call is selected for recording to indicate that a recording exists for that call/interview. This property is not reset if the respondent declines to be recorded. Instead, RecordingProhibited is set to 1, which overrides the RecordCall setting.
Which interviewers have which qualifications
Interviewers may have qualifications that identify the types of calls they can receive. Interviewers are grouped according to their qualifications so that, for example, anyone who can speak French is in one group and anyone who can speak French and Spanish is in another group. The InterviewerQualGroup interviewer property names the qualifications group to which an interviewer belongs. When a connection is made, the dialing component checks which qualifications are required for that call and allocates it to an appropriately qualified interviewer. Calls with no qualifications requirements are allocated to the interviewer who has been waiting the longest regardless of his/her qualifications.
Message to play for silent calls
When dialing predictively, it is possible that connections may be made when there is no interviewer free to take the call. When this happens, the dialer can play a sound recording to the respondent explaining what has happened. The SilentCallAudioFile project property names the file that is to be played for the current project.
Note All dialers on a project must use the same message file. Message files must be stored in the appropriate location. This location is configurable, and can be on the dialer's disk or on a disk that is available to the dialer. Users who set up interviewing projects will need to know where message files are stored.
See also
Dialer Interface component