O componente predefinido 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 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 coletadas, o componente vai agendar uma chamada de retorno e fornecer o número da solicitação ao 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 selecionar uma opção de cartão, o componente vai enviar 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
As caixas de diálogo de exemplo a seguir 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 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. Em seguida, o componente organiza uma chamada de retorno 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 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. |
|
| 5.000 dólares | |
| Em quais despesas ou benefícios você tem interesse? Temos várias opções disponíveis, como viagens, combustível e compras. | |
| Eu 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 predefinido Coleção de CEP | |
| Você mencionou que o CEP é 10011. Isso está correto? | |
| Sim, está correto | |
| Ó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 é 1 6502530000, certo? | |
| Sim | |
| Ótimo, já coletamos o número de telefone. Um de 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 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 ao cliente que 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 em saber que você continua escolhendo nossos produtos e serviços. Temos uma ampla variedade de cartões de crédito que podem ser adequados 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 que possa usar nas minhas próximas férias | |
| A resposta selecionada se enquadra na categoria de viagens. Se quiser continuar, diga "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 cartões ou um específico? Por exemplo, se você estiver procurando especificamente um cartão clássico, diga "cartão clássico". | |
| Você pode me contar sobre o cartão Platinum? | |
| Claro, para um cartão de viagem platina, a taxa anual é de US$ 95. 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. 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. Você quer que esses detalhes do cartão sejam compartilhados com seu número de celular por SMS ou WhatsApp? | |
| SMS, por favor | |
| Vamos enviar o link para o número de celular registrado. Essa ação pode levar alguns segundos. Você pode confirmar se recebeu o link? | |
| Entendido | |
| Ótimo, agora você pode abrir o link e conferir os detalhes da inscrição do cartão. Depois que os dados forem preenchidos, a emissão do novo cartão será iniciada e enviada para seu endereço atual. |
Negação de informações
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ê 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. Não é possível continuar sem as informações solicitadas no momento. |
Convenções de nomenclatura
Esse componente predefinido 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 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. Os parâmetros no escopo da sessão podem ser definidos por um fluxo de chamada ou na página inicial do 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 de 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 das configurações predefinidas 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 após a saída 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 webhook.error built-in event. webhook_not_found: um URL de webhook não pode ser acessado. Consulte 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 seus serviços externos. Consulte a configuração de webhook abaixo.
Configuração do webhook
Para usar esse componente, você precisa configurar os webhooks flexíveis incluídos para extrair as informações necessárias dos seus serviços externos.
Acessar os 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 conta.
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 "Pegar 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 dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- 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, 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 webhook prebuilt_components_credit_card_enrollment:get_card_count é
usado pelo componente para extrair o número de cartões de crédito associados a
contas de usuários registrados.
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.
- 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 dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- 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, 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 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 na pontuação 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 despesas 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 |
|---|---|---|
| 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 "Get available cards" 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_available_card.
- 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.
- Revise e atualize o corpo da solicitação para formar 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 seu 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.
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 selecionou para inscrição. 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 despesas 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 "Get selected card details" 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 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.
- Revise e atualize o corpo da solicitação para formar 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 seu 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 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 | Código postal 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 do pedido de registro do cartão. | integer |
Para configurar o webhook de envio de solicitações 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 dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- 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, 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 webhook prebuilt_components_credit_card_enrollment:send_message é usado
pelo componente para enviar uma mensagem com um link para concluir a inscrição
de cartão de crédito para 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, 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 aceitos. |
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 ao canal especificado pelo usuário. | booleano |
Para configurar o webhook "Enviar 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 dos agentes de conversação (Dialogflow CX) 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 seu webhook.
- 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, 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
Seu agente e os webhooks dele estão configurados e prontos para testes.