Componente predefinido de coleta da data de validade do cartão de crédito

Esse componente predefinido captura a data de validade do cartão de crédito de um usuário final.

Limitações

Além das limitações comuns de componentes predefinidos, este componente predefinido tem as seguintes limitações:

  • A integração do gateway de pagamento não está incluída neste componente.

Ativar DTMF para permitir que os usuários insiram valores numéricos usando o teclado do telefone.

Outras funcionalidades

Este componente pré-criado oferece as seguintes funcionalidades adicionais:

Exemplos de diálogos

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.

Entrada concluída

O usuário final fornece a data de validade na primeira tentativa, e o agente a aceita.

Entrada do usuário Resposta do agente
Diga ou insira a data de validade do cartão de crédito, começando pelo mês seguido do ano.
27/01
Recebi a data de validade do cartão de crédito como janeiro de 2027. É isso mesmo?
sim
Ótimo, já coletei a data de validade do cartão de crédito.

Novas tentativas

O usuário final fornece a data de validade na primeira tentativa. Na confirmação do agente sobre a data de validade coletada, o usuário final diz que "está errado". O agente pede ao usuário final que confirme qual parte da data de validade está incorreta: data completa, mês ou ano, e solicita novamente que ele forneça esses detalhes.

Entrada do usuário Resposta do agente
Diga ou insira a data de validade do cartão de crédito, começando pelo mês seguido do ano.
27/01
Recebi a data de validade do cartão de crédito como janeiro de 2027. É isso mesmo?
Está errado
Sinto muito. Não entendi. Informe se você quer mudar a data inteira ou apenas o mês ou o ano.
mês
Lamentamos o inconveniente. Diga ou insira o mês de vencimento do seu cartão de crédito.
fev.
Recebi o mês de vencimento do cartão de crédito como fevereiro. É isso mesmo?
sim
Recebi a data de validade do cartão de crédito como fevereiro de 2027. É isso mesmo?
sim
Ótimo, já coletei a data de validade do cartão de crédito.

Entrada parcial

Cenário: o usuário final não consegue informar a data de validade na primeira tentativa. O agente divide a data de validade e pede um mês seguido do ano. O usuário final fornece a entrada corretamente desta vez, e o agente a aceita.

Entrada do usuário Resposta do agente
Diga ou insira a data de validade do cartão de crédito, começando pelo mês seguido do ano.
13
A data de validade não parece correta. Vamos tentar capturar o mês novamente.

Diga ou insira o mês de validade do seu cartão de crédito.
1
O mês de expiração do cartão de crédito é janeiro. É isso mesmo?
Sim, certo
Diga ou insira o ano de validade do seu cartão de crédito.
26
O ano de validade do cartão de crédito é 2026. É isso mesmo?
sim
Recebi a data de validade do cartão de crédito como janeiro de 2026. É isso mesmo?
sim
Ótimo, já coletei a data de validade do cartão de crédito.

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
Diga ou insira a data de validade do cartão de crédito, começando pelo mês seguido do ano.
Não tem problema
Sinto muito. Não entendi. Você pode dizer ou inserir a data de validade do cartão de crédito novamente?
legal
Não consegui fazer isso. Verifique se você informou a data de validade do cartão de crédito. Também é possível usar o teclado para inserir a data de validade do cartão de crédito.
good
Não estou conseguindo entender sua resposta.

Validação da data de validade do cartão de crédito

Os meses de validade do cartão de crédito precisam ser inseridos como um número inteiro entre '01' e '12' ou uma string que represente um mês entre 'January' e 'December'.

O ano de validade do cartão de crédito precisa ter quatro dígitos. Se a entrada tiver dois dígitos, ela será convertida em um ano de quatro dígitos. Por exemplo, "25" se torna "2025". Além disso, o ano não pode ser mais de 10 anos a partir do atual.

A data de validade do cartão de crédito, incluindo mês e ano, precisa ser uma data futura considerando o mês e o ano atuais.

Convenções de nomenclatura

Esse componente predefinido usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Fluxo [Nome do componente] Coleta da data de validade do cartão de crédito
Intent específica do componente prebuilt_components_[component_name]_[intent_name] prebuilt_components_credit_card_expiration_date_collection_collect_date
Tipo da entidade prebuilt_components_[component_name]_[entity_type_name] prebuilt_components_credit_card_expiration_date_collection_month
Parâmetro [param_name] expiration_date

Parâmetros de saída

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
credit_card_expiration_date_collection_credit_card_expiration_date Esse parâmetro retorna o objeto de tipos de elementos de expiração que serão capturados durante a sessão do fluxo de conversa.
{
"year": integer,
"month": integer
}

Configuração básica

Para configurar esse componente pré-criado:

  1. Importe o componente pré-criado.

Concluído

Seu agente está configurado e pronto para ser testado.