Date of birth collection prebuilt component

This prebuilt component captures and validates a date of birth by collecting month, date, and year.

Limitations

In addition to the common prebuilt component limitations, this prebuilt component has the following limitations:

• This component does not support verification of end-user's date of birth via ID verification.

Recommended agent settings

Enable DTMF to allow users to input numeric values using the telephone keypad.

Additional functionalities

The following additional functionalities are provided by this prebuilt component:

• Repeat
• Waiting room
• Playback

Sample dialogs

The following sample dialogs demonstrate common scenarios handled by this prebuilt component. The sample dialogs demonstrate behavior when the component is called via telephony, which triggers the Default Welcome Intent and the first agent response at the start of the conversation.

Full date of birth

End-user provides complete date of birth in one turn; agent successfully accepts it.

Partial date of birth

End-user provides date of birth by saying month first followed by date and year; agent successfully accepts it.

Future date validation

This scenario assumes the current date is March 22, 2023. End-user provides a future date of birth; agent validates it and re-prompts end-user to provide the correct date of birth.

Invalid date

End-user provides an invalid date of birth such as February 30th 1999 or April 31st 1999; agent validates it and re-prompts end-user to provide the correct date of birth.

Unrecognized input

Component exits the flow after the end-user provides unrecognized input three times.

Date of birth validation

This prebuilt component uses the IS_DATE and IS_FUTURE_DATE system functions to check whether a collected date is valid and in the past. In addition:

• Inputs such as "this month", "next month" or "last month" are converted into the appropriate months. For example, if the end-user is interacting with the agent in March, then "this month", "next month" and "last month" are converted into "March", "April" and "February" respectively.
• Validates that the year should be four digits. If the year input contains only two digits, the component converts it into a four-digit year. For example, "98" is converted to "1998".
• Input such as "this Thursday", "last Thursday", and "next Thursday" are captured as the appropriate month and day and the agent prompts to provide the year. For example, if end-user is interacting with the agent on March 22, 2023, which is a Wednesday, then "this Thursday", "last Thursday", and "next Thursday" are converted into "March 23", "March 16", and "March 30" respectively.

Naming conventions

This prebuilt component uses the following naming conventions:

Output parameters

Output parameters are session parameters that will remain active after exiting the component. These parameters contain important information collected by the component. This prebuilt component provides values for the following output parameters:

{
  "year": integer,
  "month": integer,
  "day": integer
}

Basic setup

To set up this prebuilt component:

1. Import the prebuilt component.

Complete

Your agent and should now be set up and ready to test.