O componente pré-criado de inscrição de cartão de crédito permite que os clientes novos e existentes se candidatem a um novo cartão de crédito.
O componente começa por recolher o número de telefone do utilizador final para identificar se é um cliente novo ou existente. Para um novo utilizador, o componente recolhe os detalhes necessários, incluindo o rendimento mensal e a categoria de despesas ou as vantagens do cartão que o utilizador está a pedir. Assim que todas as informações necessárias forem recolhidas, o componente organiza uma chamada de retorno e faculta o número do pedido ao utilizador.
Para um cliente existente, o componente vai obter as informações do utilizador registado e apresentar as opções de cartão disponíveis ao utilizador final com base nas respetivas preferências e informações obtidas, incluindo a respetiva classificação de crédito. Assim que o cliente selecionar uma opção de cartão, o componente envia um link para concluir o procedimento de inscrição através de canais registados, incluindo o WhatsApp ou SMS.
Este componente usa os componentes predefinidos de recolha de números de telefone e recolha de códigos postais para recolher e validar os detalhes do utilizador.
Limitações
Além das limitações comuns dos componentes pré-criados, este componente pré-criado tem as seguintes limitações:
- Este componente não encripta dados.
Exemplos de caixas de diálogo
Os exemplos de caixas de diálogo seguintes demonstram cenários comuns processados por este componente pré-criado. Os diálogos de exemplo demonstram o comportamento quando o componente é chamado através da telefonia, o que aciona a intenção de boas-vindas predefinida e a primeira resposta do agente no início da conversa.
Novo utilizador
O componente verifica se o utilizador está a ligar através de um número de telefone registado e identifica que é um novo utilizador. O componente recolhe a categoria do cartão para a qual o utilizador quer inscrever-se e recolhe informações para identificar o utilizador, incluindo o código postal e o número de telefone. Em seguida, o componente organiza uma chamada de retorno e dá ao utilizador o número do pedido.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Pode confirmar se é cliente do nosso banco? | |
| Não estou | |
| Ficamos contentes por querer candidatar-se a um cartão de crédito connosco. Temos uma vasta gama de cartões de crédito adequados para si. Para lhe oferecer os melhores cartões disponíveis, pode indicar o seu rendimento mensal em USD? |
|
| 5000 dólares | |
| Em que despesas ou benefícios tem interesse? Temos uma variedade de opções disponíveis, como viagens, combustível e compras. | |
| Gosto de fazer compras | |
| A resposta selecionada enquadra-se na categoria de compras. Se quiser continuar, diga sim. | |
| Sim | |
| O agente recolhe o código postal do utilizador através do componente pré-criado Recolha de código postal | |
| Indicou que o código postal é 10011. Esta informação está correta? | |
| Sim, é isso mesmo | |
| Ótimo, terminámos a recolha do código postal. | |
| O agente recolhe o número de telefone do utilizador através do componente pré-criado Recolha de número de telefone | |
| OK. O número que mencionou é +1 6502530000. Está correto? | |
| Sim | |
| Ótimo, terminámos de recolher o número de telefone. Um dos nossos representantes vai entrar em contacto consigo relativamente aos cartões relacionados com base nos seus critérios. O número do seu pedido é 993835. |
Cliente existente
O componente identifica o cliente registado através do respetivo número de telefone. Em seguida, o componente pede informações como a categoria e o tipo de cartão para o qual o utilizador quer inscrever-se. Depois de confirmar estas informações, o componente pede ao cliente que selecione um canal no qual concluir o processo de inscrição e envia o link para o canal registado do cliente.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Ficamos contentes por continuar a selecionar os nossos produtos e serviços. Temos uma vasta gama de cartões de crédito adequados para si. Em que despesas ou vantagens tem interesse? Temos uma variedade de opções disponíveis, como viagens, combustível e compras. |
|
| Quero um cartão que possa usar nas minhas próximas férias | |
| A resposta selecionada enquadra-se na categoria de viagens. Se quiser continuar, diga sim. | |
| Sim | |
| Existem 3 tipos de cartões adequados ao seu tipo de pedido: cartão de viagem platinum, cartão de viagem gold e cartão de viagem classic. Gostaria de saber informações sobre todos os cartões ou um específico? Por exemplo, se estiver à procura especificamente de um cartão clássico, diga cartão clássico. | |
| Pode falar-me sobre o cartão Platinum? | |
| Claro, para um cartão de viagens platinum, a taxa anual é de 95 dólares. As vantagens incluem: receba 10 000 milhas de bónus todos os anos, ganhe um número ilimitado de 2x milhas em todas as outras compras, as milhas são fáceis de ganhar e fáceis de usar. Pode encontrar mais informações sobre vantagens ou bónus no nosso Website. Confirme se quer inscrever-se no cartão de viagens Platinum. |
|
| Sim, vamos fazê-lo | |
| Vamos partilhar um link com os passos do procedimento de inscrição. Quer que partilhemos estes detalhes do cartão com o seu número de telemóvel através de SMS ou do WhatsApp? | |
| SMS, por favor | |
| OK. Estamos a enviar o link para o seu número de telemóvel registado. Esta ação pode demorar alguns segundos. Pode confirmar se recebeu o link dizendo sim ou não? | |
| OK | |
| Ótimo. Agora, pode abrir o link e verificar os detalhes de inscrição do cartão. Assim que os dados estiverem completos, a emissão do novo cartão é iniciada e este é enviado para a sua morada atual. |
Negação de informações
O utilizador recusa-se a fornecer as informações necessárias para se inscrever num cartão de crédito. O componente termina com uma mensagem de falha.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Pode confirmar se é cliente do nosso banco? | |
| Não | |
| Ficamos contentes por querer candidatar-se a um cartão de crédito connosco. Temos uma vasta gama de cartões de crédito adequados para si. Para lhe oferecer os melhores cartões disponíveis, pode indicar o seu rendimento mensal em USD? |
|
| Não quero dizer-te essa informação | |
| Obrigado por ligar. Lamentamos, mas não podemos avançar sem as informações solicitadas neste momento. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Inscrição do cartão de crédito |
| Intenção específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_cc_enroll_collect_cardtype |
| Tipo de 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 parâmetros usados para configurar determinados comportamentos do componente. Os parâmetros vão ser usados por uma ou mais condições no fluxo para determinar o comportamento do componente. Os parâmetros ao nível do fluxo têm de ser definidos na página inicial do componente, conforme descrito abaixo. Os parâmetros ao nível da sessão podem ser definidos por um fluxo de chamadas ou na página de início deste componente.
Este componente pré-criado aceita os seguintes parâmetros de entrada:
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $session.params.auth_level | (Opcional) Indica o nível de autenticação atual do utilizador final. | número inteiro |
| $session.params.phone_number | (opcional) Número de telefone do utilizador final. Se este parâmetro não for fornecido, o componente recolhe o número de telefone do utilizador final. | de string |
| $flow.max_retry_count | Especifica o número de novas tentativas dadas ao utilizador final. O valor predefinido é 3. |
número inteiro |
| $flow.currency_name | Especifica a moeda esperada quando recolhe detalhes de rendimentos mensais. O valor predefinido é "USD". |
de string |
Para configurar os parâmetros de entrada deste componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Criar.
- Clique no componente importado na secção Fluxos.
- Clique na página inicial na secção Páginas.
- Clique no percurso verdadeiro na página inicial.
- Na janela Route, edite os valores de Predefinições de parâmetros conforme necessário.
- Clique em Guardar.
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. Estes parâmetros contêm informações importantes recolhidas pelo componente. Este componente pré-criado fornece valores para os seguintes parâmetros de saída:
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| transfer_reason | Este parâmetro indica o motivo pelo qual o fluxo foi terminado, se não tiver sido bem-sucedido. O valor devolvido é um dos seguintes:agent: o utilizador final pediu um agente humano em algum momento durante a conversa.denial_of_information: o utilizador final recusou-se a partilhar informações pedidas pelo componente.max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem introdução. Consulte os eventos incorporados sem entrada.max_no_match: a conversa atingiu o número máximo de novas tentativas para eventos sem correspondência. Consulte os eventos incorporados sem correspondência.webhook_error: ocorreu um erro de webhook. Veja o evento incorporado webhook.error. webhook_not_found: não foi possível aceder a um URL de webhook. Veja o evento incorporado webhook.error.not-found. |
de string |
Configuração básica
Para configurar este componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com a configuração que descreve os seus serviços externos. Consulte a configuração do webhook abaixo.
Configuração do webhook
Para usar este componente, tem de configurar os webhooks flexíveis incluídos para obter as informações necessárias dos seus serviços externos.
Obtenha os detalhes da conta
O webhook prebuilt_components_credit_card_enrollment:get_account_details é usado pelo componente para obter os detalhes da conta do utilizador, se existir uma conta.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| account_count | O número de contas associadas ao número de telefone registado. | número inteiro |
| credit_score | A pontuação de crédito registada do utilizador. | número inteiro |
Para configurar o webhook Get account details para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_account_details.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha a contagem de cartões
O webhook prebuilt_components_credit_card_enrollment:get_card_count é usado pelo componente para obter o número de cartões de crédito associados às contas de um utilizador registado.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| card_count | O número total de cartões de crédito nas contas de um utilizador registado. | número inteiro |
Para configurar o webhook Get card count para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_card_count.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha cartões disponíveis
O webhook prebuilt_components_credit_card_enrollment:get_available_card é usado pelo componente para obter a lista de cartões disponíveis para o utilizador para uma categoria específica com base na classificação de crédito do utilizador.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $flow.expense_category | A categoria de despesas na qual o utilizador se inscreveu. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_expense_category. Por predefinição, são suportados os formatos fuel, shopping e travel. |
de string |
| $flow.credit_score | A pontuação de crédito do utilizador, obtida pelo componente através do webhook Get account details. | número inteiro |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| available_card_names | Lista de cartões disponíveis para o utilizador, por exemplo, ["gold shopping card","classic shopping card"]. |
Lista (string) |
| cards_count | O número de cartões disponíveis para o utilizador. | número inteiro |
Para configurar o webhook Get available cards para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_available_card.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha os detalhes do cartão selecionado
O webhook prebuilt_components_credit_card_enrollment:get_selected_card é usado pelo componente para obter taxas anuais e vantagens para o cartão selecionado.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $flow.card_type | O tipo de cartão que o utilizador selecionou para se inscrever. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_card_type. Por predefinição, são suportados os formatos classic, gold e platinum. |
de string |
| $flow.expense_category | A categoria de despesas na qual o utilizador se inscreveu. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_expense_category. Por predefinição, são suportados os formatos fuel, shopping e travel. |
de string |
| $flow.credit_score | A pontuação de crédito do utilizador, obtida pelo componente através do webhook Get account details. | número inteiro |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| selected_card_benefits | Informações sobre as vantagens do cartão selecionado. | de string |
| selected_card_annual_fee | A anuidade do cartão selecionado. | número inteiro |
| selected_card_name | O nome do cartão selecionado. | de string |
Para configurar o webhook Get selected card details para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:get_selected_card.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Envie o pedido de inscrição
O webhook prebuilt_components_credit_card_enrollment:submit_enroll é usado pelo componente para criar um pedido de inscrição de cartão com base nas preferências e nos detalhes do novo utilizador fornecidos.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| $flow.zipcode | Código postal fornecido pelo utilizador. | de string |
| $flow.monthly_salary | Salário mensal fornecido pelo utilizador. | número inteiro |
| $flow.currency_name | Moeda do salário mensal, configurada nos parâmetros de entrada do componente. Veja os parâmetros de entrada. | de string |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| request_number | Número do pedido para o registo bem-sucedido do pedido de inscrição do cartão. | número inteiro |
Para configurar o webhook de envio do pedido de inscrição para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:submit_enroll.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Enviar mensagem
O webhook prebuilt_components_credit_card_enrollment:send_messageé usado
pelo componente para enviar uma mensagem com um link para concluir a inscrição do cartão de crédito
para clientes existentes.
Parâmetros de pedidos de API
Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.
| Nome do parâmetro | Descrição | Formato de entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| $flow.channel | O canal que o utilizador selecionou para receber a mensagem. Os valores válidos são definidos pela entidade personalizada prebuilt_components_cc_enroll_channel. Por predefinição, são suportados os formatos SMS e WhatsApp. |
de string |
| $flow.selected_card_name | Lista de cartões selecionados pelo utilizador, por exemplo, ["gold shopping card","classic shopping card"]. |
Lista (string) |
Parâmetros de resposta da API
Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato de saída |
|---|---|---|
| message_sent | Indica se a mensagem foi enviada com êxito para o canal especificado pelo utilizador. | booleano |
Para configurar o webhook Enviar mensagem para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_credit_card_enrollment:send_message.
- Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Concluído
O seu agente e os respetivos webhooks já devem estar configurados e prontos para teste.