O componente pré-criado de registro de cartão de crédito permite que clientes novos e atuais solicitem um novo cartão.
O componente começa coletando o número de telefone do usuário final para identificar se ele é um cliente novo ou atual. Para um novo usuário, o componente coletará os detalhes necessários, incluindo a renda mensal e a categoria de despesas ou benefícios do cartão solicitados. Depois que todas as informações necessárias forem coletadas, o componente vai organizar um retorno de chamada e informar o número da solicitação ao usuário.
Para um cliente atual, o componente recuperará 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 nos dados recuperados, incluindo o score de crédito. Depois que o cliente selecionar uma opção de cartão, o componente vai enviar um link para concluir o procedimento de inscrição por canais registrados, incluindo WhatsApp ou SMS.
Esse componente usa os componentes pré-criados da coleta de números de telefone e coleta de CEP para coletar e validar detalhes do usuário.
Limitações
Além das limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- Este componente não criptografa nenhum dado.
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.
Novo usuário
O componente verifica se o usuário está ligando usando um número de telefone registrado e identifica que é um novo usuário. O componente coleta a categoria de cartão em que o usuário quer se inscrever e informações para identificar o usuário, incluindo CEP e número de telefone. Em seguida, o componente organiza um retorno de 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 estou | |
| Estamos felizes por você querer solicitar um cartão de crédito conosco. Temos uma grande variedade de cartões de crédito adequados para você. Para oferecer os melhores cartões disponíveis, poderia informar sua renda mensal em dólares americanos? |
|
| 5.000 dólares | |
| Em quais despesas ou benefícios você tem interesse? Temos várias opções disponíveis, como viagem, combustível e compras. | |
| Eu 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 Coleção de CEP | |
| Você mencionou que o CEP é 10011, correto? | |
| 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úmeros de telefone | |
| Ok. O número que você mencionou é mais 1 6502530000, correto? | |
| Sim | |
| Ótimo, acabamos de coletar o número de telefone. Um dos nossos representantes vai retornar a ligação para você sobre os cartões 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. Em seguida, o componente solicita informações como a categoria e o tipo de card em que o usuário quer se inscrever. Depois que essas informações forem confirmadas, o componente solicitará que o cliente selecione um canal para concluir o processo de inscrição e enviará 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 uma grande variedade de cartões de crédito ideais para você. Em quais despesas ou benefícios você tem interesse? Temos várias opções disponíveis, como viagem, combustível e compras. |
|
| Quero um cartão para usar nas minhas próximas férias | |
| Sua resposta selecionada se enquadra na categoria de viagem. Se quiser continuar, diga "sim". | |
| Sim | |
| Há 3 tipos de cartões que se adaptam ao seu tipo de solicitação: cartão de viagem platina, cartão de viagem ouro e cartão de viagem clássico. 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! A taxa anual para um cartão de viagem Platina é de USD 95. Os benefícios incluem: 10.000 milhas de bônus por ano e o dobro de 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 em nosso site. Confirme se você quer receber o cartão de viagem Platina. |
|
| Sim, vou fazer isso | |
| Vamos compartilhar um link com as etapas do procedimento de inscrição. Você quer compartilharmos os detalhes do cartão com seu número de celular por SMS ou WhatsApp? | |
| Envie um SMS | |
| Certo, estamos enviando o link para seu número de celular registrado. Isso pode levar alguns segundos. Diga "Sim" ou "Não" para confirmar se você recebeu o link. | |
| Entendi | |
| Ótimo! Agora você pode abrir o link e verificar os detalhes de registro do cartão. Quando os dados forem concluídos, 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 registrar 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 estou | |
| Estamos felizes por você querer solicitar um cartão de crédito conosco. Temos uma grande variedade de cartões de crédito adequados para você. Para oferecer os melhores cartões disponíveis, poderia informar sua renda mensal em dólares americanos? |
|
| Não quero passar essa informação | |
| Agradecemos sua ligação. Infelizmente, não é possível prosseguir sem as informações solicitadas no momento. |
Convenções de nomeação
Esse componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | 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 são usados por uma ou mais condições no fluxo para determinar como o componente vai se comportar. Os parâmetros com escopo de fluxo precisam ser definidos na página inicial do componente, conforme descrito abaixo. Os parâmetros no escopo da sessão podem ser definidos por um fluxo de chamada ou na página inicial desse componente.
Esse componente pré-criado 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 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 mensais de renda. O valor padrão é "USD". |
string |
Para configurar os parâmetros de entrada desse componente, abra para conferir 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 Save.
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 |
|---|---|---|
| phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| transfer_reason | Esse parâmetro indica o motivo pelo qual o fluxo saiu, se não tiver sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final se recusou a compartilhar as informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de tentativas para eventos sem entrada. Veja os eventos integrados sem entrada.max_no_match: a conversa atingiu o número máximo de 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: não foi possível acessar um URL do webhook. Consulte o evento integrado webhook.error.not-found. |
string |
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com a configuração que descreve os serviços externos do Dialogflow. Consulte "Configuração do webhook" abaixo.
Configuração do webhook
Para usar esse componente, é preciso configurar os webhooks flexíveis incluídos para recuperar as informações necessárias dos serviços externos.
Mais detalhes da conta
O webhook prebuilt_components_credit_card_enrollment:get_account_details é
usado pelo componente para recuperar os detalhes da conta do usuário, se houver uma.
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, utilizado 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 a ser usado 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, 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Ver o número de cartões
O webhook prebuilt_components_credit_card_enrollment:get_card_count é
usado pelo componente para recuperar o número de cartões de crédito associados às
contas de um 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, utilizado 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 a ser usado 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 "Ver contagem de cards" deste componente, abra para ver 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Ver cards disponíveis
O webhook prebuilt_components_credit_card_enrollment:get_available_card é
usado pelo componente 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 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 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 a ser usado 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 "Ver cards disponíveis" para este componente, abra para ver 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Conferir detalhes do cartão selecionado
O webhook prebuilt_components_credit_card_enrollment:get_selected_card é
usado pelo componente para recuperar 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 selecionou 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 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 a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| selected_card_benefits | Informações sobre os benefícios do card selecionado. | string |
| selected_card_annual_fee | A tarifa anual do cartão selecionado. | integer |
| selected_card_name | O nome do cartão selecionado. | string |
Para configurar o webhook "Ver os detalhes do card selecionados" para este 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
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 usuário fornecidos pelo 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, utilizado para identificar o usuário. | string |
| $flow.zipcode | CEP fornecido pelo usuário. | string |
| $flow.monthly_salary | Salário mensal fornecido pelo usuário. | integer |
| $flow.currency_name | Moeda do salário mensal, configurada nos parâmetros de entrada do componente. Consulte os parâmetros de entrada. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| request_number | Número de solicitação do registro bem-sucedido da solicitação de inscrição do cartão. | integer |
Para configurar o webhook "Enviar solicitação de inscrição" para este 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Enviar mensagem
O webhook prebuilt_components_credit_card_enrollment:send_message é usado
pelo componente para enviar uma mensagem contendo um link que conclui a inscrição do cartão
de crédito dos clientes atuais.
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, utilizado 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 a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| message_sent | Indica se a mensagem foi enviada ao canal especificado pelo usuário. | boolean |
Para configurar o webhook "Enviar mensagem" para este componente, abra para ver 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 Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o 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 exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Concluído
Seu agente e os webhooks dele agora estão configurados e prontos para teste.