This articles focuses solely on call statuses. If you are looking for details about Call Detail Record (CDR), please check out our dedicated page.
Accessing call statuses
Call statuses are included in the CDRs when relevant (voice campaigns).
Call statuses overview
Calls can either go through (ANSWERED), fail (ERROR) or go through while not reaching the recipient's phone (ABSENT). Each of these three statuses has sub-statuses to inform you about the cause of the first status.
Call statuses are mutually exclusive: a call can only have one status at a time.
Successful calls are calls initiated without errors and picked up by the recipient (ANSWERED). They have two sub-statuses. Completion means the full broadcast of the message(s) defined while setting up the campaign.
- ANSWERED/COMPLETE: answered calls where the messages were fully broadcast to the recipient.
- ANSWERED/INCOMPLETE: answered calls where messages broadcast was incomplete. This can be due to the recipient hanging up.
Calls can also be successful, i.e., properly initiated and received by the recipient but not answered (ABSENT). They have three sub-statuses.
- ABSENT/BUSY: the recipient was successfully reached, but the call was not able to go through because he was already in a call.
- ABSENT/NO_ANSWER: the recipient was successfully reached but didn't answer the call.
- ABSENT/VOICEMAIL_DETECTED: the recipient was successfully reached, didn't answer the call, and an automated voicemail response message was detected.
Finally, calls can fail (ERROR) because of four main reasons described in the following sub-statuses. An error occurs when the call is not successfully originated or attempted but rejected by carriers.
- ERROR/BLACKLISTED: the call was not made because the number is blacklisted. Not initiated
- ERROR/REJECTED: the call was rejected by the recipient. The call is initiated by us but gets an error response from the carrier.
- ERROR/UNALLOCATED_NUMBER: the call was not able to go through because the recipient number is unallocated. The call is initiated by us but gets an error response from the carrier.
- ERROR/OTHER: calls failed with an unknown error.
Call result codes overview
Result codes are used to describe the outcome of a call that reached the recipient's phone (ANSWERED_COMPLETE, ANSWERED_INCOMPLETE AND ABSENT/VOICEMAIL_DETECTED). Here are the following call results code and their meaning:
- HANGUP: the recipient hung up
- VOICEMAIL_COMPLETE: the defined message was fully played to the recipient's voicemail
- VOICEMAIL_INCOMPLETE: the defined message was partially played to the recipient's voicemail.