Componente pré-criado do registro de cartão de crédito

A inscrição do cartão de crédito componente pré-criado permite que clientes novos e existentes solicitem um novo cartão de crédito.

O componente começa coletando o número de telefone do usuário final para identificar se ele é um cliente novo ou existente. Para um novo usuário, o componente vai coletar os detalhes necessários, incluindo a renda mensal e a categoria de despesas ou os benefícios do cartão que o usuário está solicitando. Depois que todas as informações necessárias forem coletados, o componente organiza um retorno de chamada e fornece o número da solicitação para o usuário.

Para um cliente atual, o componente vai extrair as informações do usuário registrado e apresentar as opções de cartão disponíveis ao usuário final com base nas preferências e nas informações extraídas, incluindo a pontuação de crédito. Depois que o cliente seleciona uma opção de cartão, o componente envia um link para concluir o procedimento de inscrição pelos canais registrados, incluindo WhatsApp ou SMS.

Esse componente usa os componentes predefinidos Coleção de números de telefone e Coleção de CEPs para coletar e validar os detalhes do usuário.

Limitações

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

  • Esse componente não criptografa dados.

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.

Novo usuário

O componente verifica se o usuário está ligando usando um número de telefone registrado e identifica se ele é um novo usuário. O componente coleta a categoria de cartão que o usuário quer inscrever e informações para identificá-lo, incluindo CEP e número de telefone. O componente então organiza uma chamada e informa ao usuário o número da solicitação.

Entrada do usuário Resposta do agente
Você pode confirmar se já é cliente do nosso banco?
Não
Ficamos felizes em saber que você quer solicitar um cartão de crédito. Temos uma grande variedade de cartões de crédito que são adequados para você.

Para oferecer os melhores cartões disponíveis, você poderia declarar sua renda mensal em dólares americanos?
5.000 dólares
Em quais despesas ou benefícios você tem interesse? Temos uma variedade de opções disponíveis, como viagem, combustível e compras.
Gosto de fazer compras
A resposta selecionada se enquadra na categoria de compras. Se quiser continuar, diga "Sim".
Sim
O agente coleta o CEP do usuário usando o componente pré-criado Coleção de CEPs.
Você mencionou que o CEP é 10011, correto?
Sim, é isso mesmo
Ótimo, já coletamos o CEP.
O agente coleta o número de telefone do usuário usando o componente predefinido Coletar número de telefone
Ok. O número que você mencionou é mais 1 6502530000, correto?
Sim
Ótimo, terminamos de coletar o número de telefone.

Um dos nossos representantes vai ligar de volta para você para falar sobre os cards relacionados com base nos seus critérios. O número da sua solicitação é 993835.

Cliente atual

O componente identifica o cliente registrado usando o número de telefone dele. O componente então solicita informações como a categoria e o tipo de cartão que o usuário quer se inscrever. Depois que essas informações são confirmadas, o componente pede que o cliente selecione um canal para concluir o processo de inscrição e envia o link para o canal registrado do cliente.

Entrada do usuário Resposta do agente
Ficamos felizes por você continuar selecionando nossos produtos e serviços. Temos várias opções de cartões de crédito adequadas para você.

Em quais despesas ou benefícios você tem interesse? Temos várias opções disponíveis, como viagens, combustível e compras.
Quero um cartão para usar nas próximas férias
A resposta selecionada se enquadra na categoria de viagem. Se quiser continuar, clique em "Sim".
Sim
Há três tipos de cartão para atender ao seu tipo de solicitação: cartão de viagem platina, ouro e clássico. Você quer saber informações sobre todos os cards ou sobre um específico? Por exemplo, se você estiver procurando especificamente um cartão clássico, diga "cartão clássico".
Pode me falar sobre o cartão Platina?
Claro! Para um cartão de viagem Platina, a tarifa anual é de 95 dólares. Os benefícios incluem: 10.000 milhas de bônus por ano, 2 milhas por todas as outras compras, milhas fáceis de ganhar e de usar. Confira mais informações sobre benefícios e bônus no nosso site.

Confirme se você quer se inscrever para receber o cartão de viagem Platina.
Sim, vamos fazer isso
Vamos compartilhar um link com as etapas do procedimento de inscrição. Quer compartilhar os detalhes do cartão com seu número de celular por SMS ou WhatsApp?
SMS, por favor
Ok, estamos enviando o link para seu número de celular registrado. Esta ação pode levar alguns segundos. Você pode confirmar se recebeu o link respondendo com "sim" ou "não"?
Entendido
Ótimo, agora você pode abrir o link e conferir os detalhes da inscrição do cartão. Depois de completar os dados, a emissão do novo cartão será iniciada e enviada para seu endereço atual.

Negação de informação

O usuário se recusa a fornecer as informações necessárias para se inscrever em um cartão de crédito. O componente sai com uma mensagem de falha.

Entrada do usuário Resposta do agente
Você pode confirmar se já é cliente do nosso banco?
Não, não estou
Ficamos felizes em saber que você quer solicitar um cartão de crédito. Temos uma ampla variedade de cartões de crédito que podem ser adequados para você.

Para oferecer os melhores cartões disponíveis, informe sua renda mensal em USD.
Não quero informar essas informações
Agradecemos sua ligação. No momento, não podemos prosseguir sem as informações solicitadas.

Convenções de nomenclatura

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

Recurso Formato Exemplo
Fluxo [Component Name] Registro de cartão de crédito
Intent específica do componente prebuilt_components_[component_name]_[intent_name] prebuilt_components_cc_enroll_collect_cardtype
Tipo da entidade prebuilt_components_[component_name]_[entity_type] prebuilt_components_cc_enroll_expense_category
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_credit_card_enrollment:get_available_card

Parâmetros de entrada

Os parâmetros de entrada são usados para configurar determinados comportamentos do componente. Os parâmetros serão usados por uma ou mais condições no fluxo para determinar como o componente vai se comportar. Os parâmetros no escopo do fluxo precisam ser definidos na página inicial do componente, conforme descrito abaixo. No escopo da sessão podem ser definidos por um fluxo de chamada ou no início página desse componente.

Esse componente predefinido aceita os seguintes parâmetros de entrada:

Nome do parâmetro Descrição Formato da entrada
$session.params.auth_level (opcional) Indica o nível de autenticação atual do usuário final. integer
$session.params.phone_number (Opcional) Número de telefone do usuário final. Se esse parâmetro não for fornecido, o componente vai coletar o número de telefone do usuário final. string
$flow.max_retry_count Especifica o número de novas tentativas dadas ao usuário final. O valor padrão é 3. integer
$flow.currency_name Especifica a moeda esperada ao coletar detalhes da renda mensal. O valor padrão é "USD". string

Para configurar os parâmetros de entrada deste componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Build.
  5. Clique no componente importado na seção Fluxos.
  6. Clique na "Página inicial" na seção Páginas.
  7. Clique na rota true na página inicial.
  8. Na janela "Rota", edite os valores das Predefinições de parâmetro conforme necessário.
  9. Clique em Salvar.

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
phone_number Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. string
transfer_reason Esse parâmetro indica o motivo da saída do fluxo, se não foi bem-sucedido. O valor retornado é um destes:

agent: o usuário final solicitou um agente humano em algum momento durante a conversa.

denial_of_information: o usuário final recusou-se a compartilhar as informações solicitadas pelo componente.

max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem entrada. Consulte Eventos integrados sem entrada.

max_no_match: a conversa atingiu o número máximo de novas tentativas para eventos sem correspondência. Consulte Eventos integrados sem correspondência.

webhook_error: ocorreu um erro de webhook. Consulte o evento integrado webhook.error.

webhook_not_found: um URL de webhook não pode ser acessado. Consulte evento integrado webhook.error.not-found.
string

Configuração básica

Para configurar esse componente pré-criado:

  1. Importe o componente pré-criado.
  2. Configure os webhooks flexíveis com que descreva os serviços externos, consulte Webhook configuração abaixo.

Configuração do webhook

Para usar este componente, você precisa configurar o webhooks flexíveis para recuperar informações necessárias dos serviços externos.

Acessar detalhes da conta

O webhook prebuilt_components_credit_card_enrollment:get_account_details é usada pelo componente para recuperar os detalhes da conta do usuário, caso ela exista.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$session.params.phone_number Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. string

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
account_count O número de contas associadas ao número de telefone registrado. integer
credit_score O score de crédito registrado do usuário. integer

Para configurar o webhook "Ver detalhes da conta" para este componente, expanda para ver instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:get_account_details.
  7. Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Conferir número de cartões

O webhook prebuilt_components_credit_card_enrollment:get_card_count é usada pelo componente para recuperar o número de cartões de crédito associados a um contas do usuário registrado.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$session.params.phone_number Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. string

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
card_count O número total de cartões de crédito nas contas de um usuário registrado. integer

Para configurar o webhook "Get card count" para esse componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:get_card_count.
  7. Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Receber cards disponíveis

O webhook prebuilt_components_credit_card_enrollment:get_available_card é usada pelo componente para recuperar a lista de cards disponíveis para o usuário uma categoria específica com base no score de crédito do usuário.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$flow.expense_category A categoria de despesa em que o usuário selecionou para se inscrever. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_expense_category. Por padrão, fuel, shopping e travel são compatíveis. string
$flow.credit_score O score de crédito do usuário, recuperado pelo componente, usando o webhook Ver detalhes da conta. integer

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
available_card_names Lista de cards disponíveis para o usuário, por exemplo, ["gold shopping card","classic shopping card"]. Lista (string)
cards_count O número de cartões disponíveis para o usuário. integer

Para configurar o webhook "Acessar cards disponíveis" para esse componente, expanda para conferir instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:get_available_card.
  7. Substitua o URL no campo Webhook URL dos Agentes de conversa (Dialogflow CX) pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Conferir os detalhes do cartão selecionado

O webhook prebuilt_components_credit_card_enrollment:get_selected_card é usado pelo componente para extrair taxas anuais e benefícios do cartão selecionado.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$flow.card_type O tipo de cartão que o usuário escolheu para se inscrever. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_card_type. Por padrão, classic, gold e platinum são compatíveis. string
$flow.expense_category A categoria de despesa em que o usuário selecionou para se inscrever. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_expense_category. Por padrão, fuel, shopping e travel são compatíveis. string
$flow.credit_score O score de crédito do usuário, recuperado pelo componente usando o webhook Get account details. integer

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
selected_card_benefits Informações sobre os benefícios do cartão selecionado. string
selected_card_annual_fee A taxa anual do cartão selecionado. integer
selected_card_name O nome do cartão selecionado. string

Para configurar o webhook "Ver detalhes do card selecionado" para este componente, expanda para conferir as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:get_selected_card.
  7. Substitua o URL no campo Webhook URL dos Agentes de conversa (Dialogflow CX) pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Enviar pedido de inscrição

O webhook prebuilt_components_credit_card_enrollment:submit_enroll é usado pelo componente para criar uma solicitação de registro de cartão com base nas preferências e nos detalhes do novo usuário.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$session.params.phone_number Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. string
$flow.zipcode CEP fornecido pelo usuário. string
$flow.monthly_salary Salário mensal informado pelo usuário. integer
$flow.currency_name Moeda do salário mensal, configurada nos parâmetros de entrada do componente. Consulte parâmetros de entrada. string

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
request_number Número da solicitação para o registro bem-sucedido da solicitação de registro do cartão. integer

Para configurar o webhook "Enviar solicitação de inscrição" para este componente, expanda para conferir instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:submit_enroll.
  7. Substitua o URL no campo URL do webhook dos agentes de conversação (Dialogflow CX) pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Enviar mensagem

O webhook prebuilt_components_credit_card_enrollment:send_message é usado pelo componente para enviar uma mensagem contendo um link para preencher o formulário de a inscrição dos clientes.

Parâmetros de solicitação de API

Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.

Nome do parâmetro Descrição Formato da entrada
$session.params.phone_number Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. string
$flow.channel O canal que o usuário selecionou para receber a mensagem. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_channel. Por padrão, SMS e WhatsApp são compatíveis. string
$flow.selected_card_name Lista de cards selecionados pelo usuário, por exemplo, ["gold shopping card","classic shopping card"]. Lista (string)

Parâmetros de resposta da API

Os parâmetros a seguir são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
message_sent Indica se a mensagem foi enviada com sucesso ao canal especificado pelo usuário. booleano

Para configurar o webhook de envio de mensagens para esse componente, expanda para ver instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_credit_card_enrollment:send_message.
  7. Substitua o URL no campo Webhook URL dos Agentes de conversa (Dialogflow CX) pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do seu webhook. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Concluído

Seu agente e os webhooks dele estão configurados e prontos para testes.