O componente pré-criado de inscrição de cartão de crédito permite que clientes novos e atuais solicitem um novo cartão de crédito.
O componente começa coletando o número de telefone do usuário para identificar se ele é um cliente novo ou atual. Para um novo usuário, o componente coleta os detalhes necessários, incluindo a renda mensal e a categoria de despesas ou benefícios do cartão que ele quer. Depois que todas as informações necessárias forem coletadas, o componente vai organizar um retorno de chamada e fornecer o número da solicitação ao usuário.
Para um cliente atual, o componente recupera as informações do usuário registrado e apresenta as opções de cartão disponíveis com base nas preferências e informações recuperadas, incluindo o score 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 usando canais registrados, incluindo WhatsApp ou SMS.
Esse componente usa os componentes Coleta de número de telefone e Coleta de CEP para coletar e validar os detalhes do usuário.
Limitações
Além das limitações comuns de componentes pré-criados, este componente tem as seguintes limitações:
- Esse componente não criptografa dados.
Diálogos de exemplo
Os diálogos de exemplo mostram cenários comuns que esse componente pré-criado processa. Eles demonstram o comportamento quando o usuário chama o componente usando telefonia, o que aciona a intent de recepção padrão e a primeira resposta do agente no início da conversa.
Novo usuário
- O componente verifica se o usuário está ligando de um número de telefone registrado para identificar se ele é um novo usuário.
- O componente coleta a categoria do cartão que você quer registrar e informações para identificar o usuário, incluindo o CEP e o número de telefone.
- O componente organiza uma chamada de retorno e fornece o número da solicitação.
| Entrada do usuário | Resposta do agente |
|---|---|
| Você pode confirmar se já é cliente do nosso banco? | |
| Não estou | |
| Ficamos felizes que você queira solicitar um cartão de crédito conosco. Temos uma grande variedade de cartões de crédito que são adequados para você. Para oferecer os melhores cartões disponíveis, informe sua renda mensal em dólares americanos. |
|
| 5.000 dólares | |
| Quais despesas ou benefícios são do seu interesse? Temos várias opções disponíveis, como viagens, combustível e compras. | |
| Gosto de fazer compras | |
| Sua 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 Coleta de CEP. | |
| Você mencionou que o CEP é 10011, certo? | |
| Sim, isso mesmo | |
| Ótimo, terminamos de coletar o CEP. | |
| O agente coleta o número de telefone do usuário usando o componente pré-criado Coleta de número de telefone. | |
| Entendi. O número que você mencionou é +16502530000, correto? | |
| Sim | |
| Ótimo, já temos o número de telefone. Um dos nossos representantes vai ligar para você para falar sobre os cartões relacionados com base nos seus critérios. O número da sua solicitação é 993835. |
Cliente atual
- O componente identifica um cliente registrado usando o número de telefone dele e solicita informações como a categoria e o tipo de cartão que o usuário quer registrar.
- Depois que o usuário confirma essas informações, o componente solicita que ele selecione um canal para concluir o processo de inscrição e envia o link para o canal registrado.
| Entrada do usuário | Resposta do agente |
|---|---|
| Ficamos felizes que você continue escolhendo nossos produtos e serviços. Temos uma grande variedade de cartões de crédito que são adequados para você. Quais despesas ou benefícios são do seu interesse? Temos várias opções disponíveis, como viagens, combustível e compras. |
|
| Quero um cartão para usar nas minhas próximas férias | |
| Sua resposta se enquadra na categoria de viagens. Se quiser continuar, diga sim. | |
| Sim | |
| Há três tipos de cartões para atender ao seu tipo de solicitação: cartão de viagem Platinum, cartão de viagem Gold e cartão de viagem Classic. Você quer saber informações sobre todos os cartões ou um específico? Por exemplo, se você estiver procurando especificamente por um cartão clássico, diga "cartão clássico". | |
| Você pode me falar sobre o cartão Platinum? | |
| Claro, para um cartão de viagem Platinum, a taxa anual é de 95 dólares. Os benefícios incluem: ganhe 10.000 milhas de bônus todos os anos, ganhe 2x milhas ilimitadas em todas as outras compras, as milhas são fáceis de ganhar e de usar. Você pode encontrar mais informações sobre benefícios ou bônus no nosso site. Confirme se você quer se inscrever no cartão de viagem Platinum. |
|
| Sim, vamos fazer isso | |
| Vamos compartilhar um link com as etapas do procedimento de inscrição. Quer que enviemos os detalhes do cartão para seu número de celular por SMS ou WhatsApp? | |
| SMS, por favor | |
| Certo, estamos enviando o link para seu número de celular registrado. Essa ação pode levar alguns segundos. Você pode confirmar se recebeu o link dizendo "sim" ou "não"? | |
| Entendi | |
| Ótimo, agora você pode abrir o link e conferir os detalhes do registro do cartão. Depois que os dados forem preenchidos, a emissão do novo cartão será iniciada e ele será enviado para seu endereço atual. |
Negação de informações
Quando o usuário se recusa a fornecer as informações necessárias para se inscrever em um cartão de crédito, o componente é encerrado 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 que você queira solicitar um cartão de crédito conosco. Temos uma grande variedade de cartões de crédito que são adequados para você. Para oferecer os melhores cartões disponíveis, informe sua renda mensal em dólares americanos. |
|
| Não quero informar isso | |
| Agradecemos sua ligação. Infelizmente, não podemos continuar sem as informações solicitadas. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formatar | Exemplo |
|---|---|---|
| Flow | [Component Name] | Registro de cartões de crédito |
| Intenção 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 configuram comportamentos específicos do componente. Uma ou mais condições no fluxo usam esses parâmetros para determinar o comportamento do componente. É necessário definir parâmetros com escopo de fluxo na página inicial do componente, conforme descrito na tabela a seguir. Um fluxo de chamada ou a página inicial desse componente pode definir parâmetros no escopo da sessão.
Esse componente pré-criado usa 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. | integer |
| $session.params.phone_number | (Opcional) O número de telefone do usuário. Se esse parâmetro não for fornecido, o componente vai coletar o número de telefone do usuário. | string |
| $flow.max_retry_count | Especifica o número de novas tentativas dadas ao usuário. 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 desse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Build.
- Clique no componente importado na seção Fluxos.
- Clique na página inicial na seção Páginas.
- Clique na rota true na página inicial.
- Na janela "Rota", edite os valores de Predefinições de parâmetros conforme necessário.
- Clique em Salvar.
Parâmetros de saída
Os parâmetros de saída são parâmetros de sessão que permanecem ativos depois que você sai do componente. Esses parâmetros contêm informações importantes que o componente coleta.
Esse componente pré-criado fornece valores para os seguintes parâmetros de saída:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| phone_number | O número de telefone local do usuário, sem o código do país, usado para identificá-lo. | string |
| transfer_reason | Esse parâmetro indica o motivo pelo qual o fluxo foi encerrado, se não tiver sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário solicitou um agente humano em algum momento da conversa.denial_of_information: o usuário se recusou 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 do webhook não estava acessível. Consulte o evento integrado webhook.error.not-found. |
string |
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado (consulte Importar o componente pré-criado).
- Configure os webhooks flexíveis fornecidos para descrever seus serviços externos. Consulte Configuração de webhook.
Configuração do webhook
Para usar esse componente, configure os webhooks flexíveis incluídos para recuperar as informações necessárias dos seus serviços externos.
Acessar detalhes da conta
O componente usa o webhook prebuilt_components_credit_card_enrollment:get_account_details para recuperar os detalhes da conta do usuário, se houver uma.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros como entradas para a solicitação de API:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | O número de telefone local do usuário, sem o código do país, usado para identificá-lo. | string |
Parâmetros de resposta da API
O componente recupera os seguintes parâmetros da resposta da API:
| 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 "Receber detalhes da conta" para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_account_details.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber contagem de cartões
O componente usa o
webhook prebuilt_components_credit_card_enrollment:get_card_count para recuperar
o número de cartões de crédito associados à conta de usuário registrada.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros como entradas para a solicitação de API:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | O número de telefone local do usuário, sem o código do país, usado para identificá-lo. | string |
Parâmetros de resposta da API
O componente recupera os seguintes parâmetros da resposta da API:
| 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 de contagem de cartões para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_card_count.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber cartões disponíveis
O componente usa o webhook
prebuilt_components_credit_card_enrollment:get_available_card para
recuperar a lista de cartões disponíveis para o usuário em uma categoria específica com base
no score de crédito dele.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros como entradas para a solicitação de API:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $flow.expense_category | A categoria de despesa 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
O componente recupera os seguintes parâmetros da resposta da API:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| available_card_names | Uma lista de cartões 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 "Receber cartões disponíveis" para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_available_card.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber detalhes do cartão selecionado
O componente usa o webhook prebuilt_components_credit_card_enrollment:get_selected_card para recuperar as taxas anuais e os benefícios do cartão selecionado.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros 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 selecionou para registrar. 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 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
O componente recupera os seguintes parâmetros da resposta da API:
| 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 "Receber detalhes do card selecionado" para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_selected_card.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Enviar pedido de inscrição
O componente usa o webhook prebuilt_components_credit_card_enrollment:submit_enroll
para criar uma solicitação de inscrição de cartão de crédito com base nas preferências
e nos detalhes fornecidos pelo novo usuário.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros como entradas para a solicitação de API:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | O número de telefone local do usuário, sem o código do país, usado para identificá-lo. | string |
| $flow.zipcode | O CEP fornecido pelo usuário. | string |
| $flow.monthly_salary | O 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
O componente recupera os seguintes parâmetros da resposta da API:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| request_number | O número da solicitação de registro bem-sucedido do cartão. | integer |
Para configurar o webhook de envio de solicitação de inscrição para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:submit_enroll.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Enviar mensagem
O componente usa o webhook prebuilt_components_credit_card_enrollment:send_message
para enviar uma mensagem com um link para que os clientes atuais concluam o cadastro
do cartão de crédito.
Parâmetros de solicitação de API
O componente fornece os seguintes parâmetros como entradas para a solicitação de API:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | O número de telefone local do usuário, sem o código do país, usado para identificá-lo. | 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 aceitos. |
string |
| $flow.selected_card_name | Uma lista de cartões selecionados pelo usuário, por exemplo, ["gold shopping card","classic shopping card"]. |
Lista (string) |
Parâmetros de resposta da API
O componente recupera os seguintes parâmetros da resposta da API:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| message_sent | Indica se a mensagem foi enviada ao canal especificado pelo usuário. | booleano |
Para configurar o webhook de envio de mensagem para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:send_message.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Concluído
O componente pré-criado de registro de cartão de crédito e os webhooks dele estão configurados e prontos para teste.