Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por esse
componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é
chamado por telefonia, o que aciona a intent de boas-vindas padrão e a primeira
resposta do agente no início da conversa.
Data de nascimento completa
O usuário final informa a data de nascimento completa em uma vez; o agente a aceita.
Entrada do usuário
Resposta do agente
Informe sua data de nascimento. Diga o mês, o dia e o ano de nascimento.
9 de setembro de 1995
Certo, sua data de nascimento é 9 de setembro de 1995. É isso mesmo?
sim
Ótimo, coletei sua data de nascimento.
Data de nascimento parcial
O usuário final informa a data de nascimento dizendo primeiro o mês, seguido pela data e pelo ano. O agente aceita a informação.
Entrada do usuário
Resposta do agente
Informe sua data de nascimento. Diga o mês, o dia e o ano de nascimento.
Março
Em que dia você nasceu?
12
Em que ano você nasceu?
1999
Certo, sua data de nascimento é 12 de março de 1999. É isso mesmo?
sim
Ótimo, coletei sua data de nascimento.
Validação de data futura
Este cenário pressupõe que a data atual seja 22 de março de 2023. O usuário final informa uma
data de nascimento futura. O agente a valida e solicita novamente que o usuário informe a
data de nascimento correta.
Entrada do usuário
Resposta do agente
Informe sua data de nascimento. Diga o mês, o dia e o ano de nascimento.
9 de setembro de 2023
Em que ano você nasceu?
2023
Certo, sua data de nascimento é 9 de setembro de 2023. É isso mesmo?
sim
Você informou uma data futura. Vamos começar de novo. Em que mês você nasceu?
Março
Em que dia você nasceu?
12
Em que ano você nasceu?
1999
Certo, sua data de nascimento é 12 de março de 1999. É isso mesmo?
sim
Ótimo, coletei sua data de nascimento.
Data inválida
O usuário final informa uma data de nascimento inválida, como 30 de fevereiro de 1999 ou 31 de abril de 1999. O agente valida e solicita novamente que o usuário informe a data de nascimento correta.
Entrada do usuário
Resposta do agente
Informe sua data de nascimento. Diga o mês, o dia e o ano de nascimento.
30 de fevereiro de 1999
Certo, sua data de nascimento é 30 de fevereiro de 1999. É isso mesmo?
sim
A data informada é inválida. Vamos começar de novo. Em que mês você nasceu?
Março
Em que dia você nasceu?
12
Em que ano você nasceu?
1999
Certo, sua data de nascimento é 12 de março de 1999. É isso mesmo?
sim
Ótimo, coletei sua data de nascimento.
Entrada não reconhecida
O componente sai do fluxo depois que o usuário final fornece uma entrada não reconhecida três vezes.
Entrada do usuário
Resposta do agente
Informe sua data de nascimento. Diga o mês, o dia e o ano de nascimento.
Não tem problema
Sinto muito. Não entendi. Você pode dizer ou inserir sua data de nascimento novamente?
legal
Não recebi sua data de nascimento. Vamos começar com o mês. Em que mês você nasceu?
good
Sinto muito. Não entendi. Você pode dizer ou inserir o número do mês novamente?
legal
Não consegui fazer isso. Informe o mês. Se eu tiver problemas para ouvir você, também é possível usar o teclado para inserir o número do mês.
legal
Não estou conseguindo entender sua resposta.
Validação da data de nascimento
Esse componente pré-criado usa as funções do sistema IS_DATE
e IS_FUTURE_DATE para
verificar se uma data coletada é válida e está no passado. Além disso:
Entradas como "este mês", "próximo mês" ou "mês passado" são convertidas nos meses apropriados. Por exemplo, se o usuário final estiver interagindo com o agente em março, "este mês", "próximo mês" e "mês passado" serão convertidos em "março", "abril" e "fevereiro", respectivamente.
Valida se o ano tem quatro dígitos. Se a entrada do ano tiver apenas dois dígitos, o componente vai convertê-la em um ano de quatro dígitos. Por exemplo, "98" é convertido em "1998".
Entradas como "esta quinta-feira", "quinta-feira passada" e "quinta-feira que vem" são capturadas como o mês e o dia apropriados, e o agente solicita o ano. Por exemplo, se o usuário final estiver interagindo com o agente em 22 de março de 2023, que é uma quarta-feira, "esta quinta-feira", "quinta-feira passada" e "quinta-feira que vem" serão convertidos em "23 de março", "16 de março" e "30 de março", respectivamente.
Convenções de nomenclatura
Esse componente predefinido usa as seguintes convenções de nomenclatura:
Os parâmetros de saída são parâmetros de sessão que permanecem ativos após a saída
do componente. Esses parâmetros contêm informações importantes coletadas pelo
componente. Esse componente predefinido fornece valores para os seguintes parâmetros de saída:
Nome do parâmetro
Descrição
Formato da saída
dob_collection_dob
Esse parâmetro retorna um objeto com elementos de data de nascimento: dia, mês e ano
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis prebuilt component is designed to collect and validate a user's date of birth, including the month, day, and year.\u003c/p\u003e\n"],["\u003cp\u003eThe component can handle complete or partial date inputs, as well as future or invalid dates, by re-prompting the user for correct information.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes system functions \u003ccode\u003eIS_DATE\u003c/code\u003e and \u003ccode\u003eIS_FUTURE_DATE\u003c/code\u003e to ensure date validity and checks that the date is in the past.\u003c/p\u003e\n"],["\u003cp\u003eThe prebuilt component is limited in that it does not offer ID verification to verify the user's date of birth, and uses specific naming conventions for flows, intents, parameters and entity types.\u003c/p\u003e\n"],["\u003cp\u003eThe component provides a \u003ccode\u003edob_collection_dob\u003c/code\u003e output parameter containing an object with the collected day, month, and year, and also offers repeat, waiting room, and playback functionalities.\u003c/p\u003e\n"]]],[],null,["# Date of birth collection prebuilt component\n\nThis\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\ncaptures and validates a date of birth by collecting month, date, and year.\n\nLimitations\n-----------\n\nIn addition to the\n[common prebuilt component limitations](/dialogflow/cx/docs/concept/prebuilt-component#limits),\nthis prebuilt component has the following limitations:\n\n- This component does not support verification of end-user's date of birth via ID verification.\n\nRecommended agent settings\n--------------------------\n\n[Enable DTMF](/dialogflow/cx/docs/concept/parameter#dtmf) to allow users to input numeric values using the telephone keypad.\n\nAdditional functionalities\n--------------------------\n\nThe following additional functionalities are provided by this prebuilt component:\n\n- [Repeat](/dialogflow/cx/docs/concept/prebuilt-component#repeat-functionality)\n- [Waiting room](/dialogflow/cx/docs/concept/prebuilt-component#waiting-room-functionality)\n- [Playback](/dialogflow/cx/docs/concept/prebuilt-component#playback-functionality)\n\nSample dialogs\n--------------\n\nThe following sample dialogs demonstrate common scenarios handled by this\nprebuilt component. The sample dialogs demonstrate behavior when the component is\ncalled via telephony, which triggers the Default Welcome Intent and the first\nagent response at the start of the conversation.\n\n### Full date of birth\n\nEnd-user provides complete date of birth in one turn; agent successfully accepts it.\n\n### Partial date of birth\n\nEnd-user provides date of birth by saying month first followed by date and year;\nagent successfully accepts it.\n\n### Future date validation\n\nThis scenario assumes the current date is March 22, 2023. End-user provides a\nfuture date of birth; agent validates it and re-prompts end-user to provide the\ncorrect date of birth.\n\n### Invalid date\n\nEnd-user provides an invalid date of birth such as February 30th 1999 or April\n31st 1999; agent validates it and re-prompts end-user to provide the correct\ndate of birth.\n\n### Unrecognized input\n\nComponent exits the flow after the end-user provides unrecognized input three times.\n\nDate of birth validation\n------------------------\n\nThis prebuilt component uses the [IS_DATE](/dialogflow/cx/docs/reference/system-functions#func-isdate)\nand [IS_FUTURE_DATE](/dialogflow/cx/docs/reference/system-functions#func-isfuturedate) system functions to\ncheck whether a collected date is valid and in the past. In addition:\n\n- 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.\n- 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\".\n- 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.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\nOutput parameters\n-----------------\n\nOutput parameters are session parameters that will remain active after exiting\nthe component. These parameters contain important information collected by the\ncomponent. This prebuilt component provides values for the following output\nparameters:\n\nBasic setup\n-----------\n\nTo set up this prebuilt component:\n\n1. [Import the prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component#import).\n\n### Complete\n\nYour agent and should now be set up and ready to test."]]
