Developer Documentation Library > Dialer SDK > UNICOM Intelligence Dialer SDK components > Features > Group dialing > Hook status/call status
 
Hook status/call status
Call status reporting is important for updating the Phone Participants interface. Hook status is more important for the dialing provider itself. The dialing provider is responsible for checking the hook status, removing the interviewer from the dialing group, and backing off on over-dial if the interviewer goes on hook. This might actually happen in the dialer itself. The dialing provider is also responsible for providing error messages indicating that the interviewer is on hook.
The session engine requests hook/call status using the IDialingProvider.GetCallStatus method. The session engine can pass a time-out value of 0 to retrieve the current call status, or it can pass a longer time-out value to block until a change of call status.
It is important that the provider report interviewer on hook, off hook, connected states, changes in state, and also report a change in state if the respondent hangs up.
See also
Group dialing