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

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

Limitações

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

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

Ative o DTMF para permitir que os usuários insiram valores numéricos usando o teclado telefônico.

Funcionalidades adicionais

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

Diálogos de exemplo

Os diálogos de exemplo a seguir demonstram cenários comuns processados por esse componente pré-criado. Os diálogos 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 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 e depois o ano.
01/27
Recebi a data de validade do cartão de crédito como janeiro de 2027. É isso mesmo?
sim
Ótimo, terminei de coletar a data de validade do cartão de crédito.

Novas tentativas

O usuário final informa a data de validade na primeira tentativa. Na confirmação do agente sobre a data de validade coletada, o usuário final diz "está errado". O agente pede ao usuário final para confirmar qual parte da data de validade está incorreta (data inteira, 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 e depois o ano.
01/27
Recebi a data de validade do cartão de crédito como janeiro de 2027. É isso mesmo?
Está errado
Desculpe, não entendi direito. Avise se quiser mudar a data inteira ou se quiser mudar o mês ou o ano.
mês
Lamentamos o inconveniente. Diga ou insira o mês de validade do cartão de crédito.
fev
Recebi o mês de validade 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, terminei de coletar 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 e depois o ano.
13
Desculpe, a data de validade não parece correta. Vamos tentar capturar o mês novamente.

Diga ou insira o mês de validade do 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 validade do 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 de coletar 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 e depois o ano.
Está tudo bem
Sinto muito. Não entendi. Você pode dizer ou inserir a data de validade do cartão de crédito novamente?
legal
Hmm, ainda não consegui entender. Confira se você está dizendo 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
Desculpe, estou com dificuldade para 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 representa um mês entre "janeiro" e "dezembro".

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 no futuro 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 nomenclatura

Esse componente pré-criado usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Flow [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 [nome_do_param] 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 sair 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
credit_card_expiration_date_collection_credit_card_expiration_date Esse parâmetro retorna o objeto de tipos de elementos de validade que serão capturados durante a sessão de 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 agora está configurado e pronto para ser testado.