getDigits

A POST request with the following fields will be sent to the actionUrl provided in your GetDigits command.

Request Parameter

Type

Description

requestType

string

Context or reason why this request is being made. Will be getDigits - The GetDigits command has completed and its actionUrl is being invoked.

callId

string

Unique identifier for this Call, generated by FreeClimb.

accountId

string

Account ID associated with your account.

from

string

Phone number of the party that initiated the Call (in E.164 format).

to

string

Phone number provisioned to the customer and to which this Call is directed (in E.164 format).

callStatus

string

Descriptive status for the Call. Valid values are:
ringing - Call is currently ringing.
inProgress - Call was answered and is currently in progress (not queued, not in conference).
completed - Call ended normally.
busy - Caller received a busy signal.
failed - Call could not be completed as dialed (most likely because the phone number was non-existent).
noAnswer - Call ended without being answered.
canceled - Call was canceled via the REST API while queued or ringing.

direction

string

String describing the direction of the Call – inbound for inbound calls, outbound for calls initiated via the REST API, or outboundDial for calls initiated by the PerCL OutDial command.

conferenceId

string

This is only populated if request pertains to a conference. Otherwise, it is set to null.

queueId

string

This is only populated if the request pertains to a queue. Otherwise, it is set to null.

digits

string

String of digits entered by the Caller, excluding the terminating digit (if used). The string of digits will be replaced by "xxxxx" when privacyMode is set to true. This field will be empty if digits collection failed because of timeout, hangup, or minDigits not reached. When the digits field is populated, it signifies a successful collection of digits, and the reason can be: timeout, finishKey, or maxDigits. Also, if the finishKey was received before minDigits was reached, the field will still be empty and the reason will be finishKey.

`reason

string

This field explains how the GetDigits action ended. The value is one of the below:
finishKey - The finish key as specified had been pressed by the caller. Digit string has all keys up to, but not including, the finish key.
timeout - The timeout limit was reached prior to any other criteria being met. If any digits were collected, they will be included.
maxDigits - The maximum number of digits was reached and digit collection ended.
tone - Answering machine or fax tone detection occurred, interrupting digit collection. Any digits received up to this point are included in this webhook.

parentCallId

string

ID of the Call that created this leg (child call).