Componente pré-criado para 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.

Outros recursos

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

Exemplos de diálogos

As caixas de diálogo de exemplo 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 uma 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 pelo ano.
27/01
A data de validade do cartão de crédito é 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 uma 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, ou seja, data, mês ou ano completa, e solicita que informe esses detalhes outra vez.

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 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 você quiser mudar a data inteira ou mudar o mês ou ano.
mês
Lamentamos o inconveniente. Diga ou insira o mês de validade do seu cartão de crédito.
fev.
O mês de validade do cartão de crédito foi recebido como fevereiro. É isso mesmo?
sim
A data de validade do cartão de crédito é 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 uma data de validade na primeira tentativa. O agente divide essa data e pede um mês seguido por 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 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 validade do seu cartão de crédito.
1
O mês de vencimento do cartão de crédito foi enviado como 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
A data de validade do cartão de crédito é 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 seguido pelo ano.
Tudo bem
Sinto muito. Não entendi. Informe a data de validade do cartão de crédito, por favor.
Bem-estar
Humm, ainda não consegui entender. Verifique se você está informando 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 precisam ser inseridos como um número inteiro entre "01" e "12" ou uma string que represente 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 com quatro dígitos, por exemplo, "25" se torna "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í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_parâmetro] expiration_date

Parâmetros de saída

Os parâmetros de saída são parâmetros de sessão que permanecerão 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
credit_card_expiration_date_collection_credit_card_expiration_date Esse parâmetro retorna o objeto dos tipos de elementos de expiração que serão capturados durante a sessão do fluxo da conversa.

{
"year": integer,
"month": integer
}

Configuração básica

Para configurar esse componente pré-criado:

  1. Importe o componente pré-criado.

Concluído

O agente está configurado e pronto para o teste.