Componente pré-criado para a coleta da data de validade do cartão de crédito

Esse componente pré-criado captura uma data de validade do cartão de crédito de um usuário final.

Limitações

Além das limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:

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

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

Funcionalidades adicionais

As seguintes funcionalidades adicionais são fornecidas por esse componente pré-criado:

Exemplos de diálogos

Os exemplos de caixas de diálogo abaixo 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 bem-sucedida

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

Entrada do usuário Resposta do agente
Diga ou insira a data de validade do cartão de crédito, começando com o mês seguido pelo ano.
27/01
O cartão de crédito expira em janeiro de 2027. É isso mesmo?
sim
Ótimo, terminei a coleta da data de validade do cartão de crédito.

Novas tentativas

O usuário final informa a data de validade na primeira tentativa. Na nova confirmação do agente sobre a data de validade coletada, o usuário final diz "está errado". O agente pede que o usuário final confirme qual parte da data de validade está incorreta (data, mês ou ano completa) e pede essas informações novamente.

Entrada do usuário Resposta do agente
Diga ou insira a data de validade do cartão de crédito, começando com o mês seguido pelo ano.
27/01
O cartão de crédito expira em janeiro de 2027. É isso mesmo?
Está errado
Não entendi. Informe se você quer mudar toda a data ou se prefere mudar o mês ou 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 validade do cartão de crédito como fevereiro. É isso mesmo?
sim
O cartão de crédito expira em fevereiro de 2027. É isso mesmo?
sim
Ótimo, terminei a coleta da 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 solicita um mês seguido por ano. Dessa vez, o usuário final vai fornecer a entrada corretamente, e o agente vai aceitar.

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

Informe ou insira o mês de vencimento do seu cartão de crédito.
1
Recebi o mês de validade do cartão de crédito como janeiro. É isso mesmo?
Sim, certo
Diga ou insira o ano de vencimento do seu cartão de crédito.
26
Recebi o ano de validade do cartão de crédito como 2026. É isso mesmo?
sim
Recebi a data de validade do cartão de crédito como janeiro de 2026. É isso mesmo?
sim
Ótimo, terminei a coleta da 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 com o mês seguido pelo ano.
Razoável
Sinto muito. Não entendi. Pode informar novamente a data de validade do cartão de crédito?
Bem-estar
Humm, ainda não consegui entender. Verifique se você está informando a data de validade do cartão de crédito. Também é possível usar o teclado para digitar 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 da data de validade do cartão de crédito precisam ser inseridos como um número inteiro entre "01" e "12" ou uma string que representa um mês entre "Janeiro" e "Dezembro".

O ano da data de validade do cartão de crédito deve ter quatro dígitos. Se a entrada tiver dois dígitos, será convertida em um ano de quatro dígitos, por exemplo, “25” passa a ser “2025”. Além disso, o ano não pode ser mais de 10 anos no futuro a partir do ano 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 nomeação

Esse componente pré-criado 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ífico do componente pré-build_components_[component_name]_[intent_name] pré-build_components_credit_card_expiration_date_collection_collect_date
Tipo da entidade pré-build_components_[component_name]_[nome_do_tipo_da_entidade] prebuilt_components_credit_card_expiration_date_collection_month
Parâmetro [nome_do_parâmetro] data_de_expiração

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 pré-criado fornece valores para os seguintes parâmetros de saída:

Nome do parâmetro Descrição Formato da saída
data de validade do cartão de crédito Este parâmetro retorna o objeto dos 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

Agora seu agente está configurado e pronto para o teste.