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

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

Limitações

Além da seção limitações comuns de componentes pré-criados, esse componente pré-criado 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

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

Exemplos de diálogos

Os exemplos de caixas de diálogo a seguir demonstram cenários comuns tratados por este um 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 a resposta do agente no início da conversa.

Entrada concluída

o usuário final informar uma data de validade na primeira tentativa; o agente aceitar a solicitação.

Entrada do usuário Resposta do agente
Informe ou insira a data de validade do cartão de crédito, começando pelo mês seguido pelo ano.
27/01
A data de validade do cartão de crédito é 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 para confirmar qual parte da data de validade está incorreta (data, mês ou ano inteiro) e solicita novamente que informe esses detalhes.

Entrada do usuário Resposta do agente
Informe ou insira a data de validade do cartão de crédito, começando pelo mês seguido pelo ano.
27/01
A data de validade do cartão de crédito é janeiro de 2027. É isso mesmo?
Está errado
Sinto muito. Não entendi. Avise se quiser mudar a data inteira ou mudar 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, e o agente a aceita.

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

Diga ou insira o mês de vencimento do seu cartão de crédito.
1
Recebi o mês de vencimento do cartão de crédito em janeiro. É isso mesmo?
Sim, certo
Diga ou insira o ano de validade 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, 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
Informe ou insira a data de validade do cartão de crédito, começando pelo mês seguido pelo ano.
Não tem problema
Sinto muito. Não entendi. Você poderia informar ou inserir a data de validade do cartão de crédito novamente?
legal
Hmm, ainda não consegui entender. Verifique se você informou a data de validade do cartão de crédito. Você também pode usar o teclado para inserir a data de validade do cartão de crédito.
good
Estou com dificuldades para 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 devem 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, ela será convertida em um ano de quatro dígitos. Por exemplo, "25" se torna "2025". Além disso, o ano não deve ser mais de 10 anos no futuro a partir da 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 nomenclatura

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í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 de sessão que permanecerão ativos depois de sair. 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

Agora o agente está configurado e pronto para testes.