O componente pré-criado de saldo da conta verifica o nível de autenticação de um cliente e fornece informações de saldo da conta para um cliente autenticado. Se o cliente tiver várias contas, o componente confirmará a conta específica para a qual o cliente quer recuperar o saldo da conta. Esse componente usa o componente pré-criado de autenticação para autenticar usuários.
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
Esses exemplos de diálogos ilustram cenários comuns que esse componente pré-criado processa. Eles mostram o comportamento quando você chama o componente usando telefonia, o que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.
Conta exclusiva
O usuário tem uma única conta e recebe o saldo da conta.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente pré-criado de autenticação. | |
| Agradecemos a confirmação. Sua autenticação foi concluída. | |
| Aguarde enquanto os detalhes da conta são buscados. O saldo associado à conta com final 4567 é de $50,00. |
Várias contas
Se o usuário tiver várias contas, o agente vai solicitar e confirmar os últimos quatro dígitos do número da conta e informar o saldo da conta.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente pré-criado de autenticação. | |
| Agradecemos sua atenção. A autenticação foi concluída. | |
| Aguarde enquanto buscamos os detalhes da sua conta. Encontramos duas contas associadas ao seu número. Você poderia informar os últimos quatro dígitos da conta em questão? |
|
| 2002 | |
| Os últimos quatro dígitos do número da conta que recebemos são 2002, correto? | |
| sim | |
| O saldo associado ao número da conta que termina com 2002 é de US $5.000. |
Várias contas com contexto
Se o usuário tiver várias contas, o número da conta referenciada será mantido da intent anterior, e o usuário receberá o saldo da conta.
| Entrada do usuário | Resposta do agente |
|---|---|
| Aguarde enquanto buscamos os detalhes da sua conta. Encontramos 3 contas associadas ao seu número. Você está procurando o número da conta que termina com 4567? |
|
| Sim | |
| O saldo associado ao número da conta que termina com 4567 é de $50. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formatar | Exemplo |
|---|---|---|
| Flow | Nome do componente | Saldo da conta |
| Intenção específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
Parâmetros de entrada
Os parâmetros de entrada configuram comportamentos específicos do componente. Uma ou mais condições no fluxo usam os parâmetros para determinar como o componente se comporta. O usuário precisa configurar os parâmetros com escopo de fluxo na página inicial do componente, conforme descrito na tabela a seguir. O usuário também pode definir parâmetros no escopo da sessão 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 do autor da chamada. | integer |
| $session.params.auth_level_req | Indica o nível de autenticação necessário para que um usuário possa acessar o saldo da conta. Esse valor é configurado nas predefinições de parâmetro do fulfillment de entrada da página na página check auth level. Por padrão, esse valor é 1. |
integer |
| $session.params.account_auth_enabled | Indica se o usuário precisa ser autenticado como proprietário da conta, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetro do fulfillment de entrada da página na página check auth level. Por padrão, esse valor é true. |
booleano |
| $session.params.card_auth_enabled | Indica se o usuário precisa ser autenticado como titular do cartão, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetro do fulfillment de entrada da página na página check auth level. Por padrão, esse valor é false. |
booleano |
| $session.params.phone_number | (Opcional) Número de telefone registrado do cliente usado para autenticação. | string |
| $session.params.account_count | (Opcional) Número de contas associadas ao usuário autenticado. | integer |
| $session.params.last_four_digit_of_account_number | (Opcional) Os últimos quatro dígitos do número da conta do cliente para que o saldo seja fornecido. Se o cliente tiver uma única conta, essas informações serão recuperadas automaticamente após a autenticação. Se o cliente tiver várias contas, o número da conta específica será coletado do cliente. | string |
| $flow.max_retry_acc_number | Especifica o número de novas tentativas permitidas ao coletar os últimos quatro dígitos do número da conta do usuário. O valor padrão é 3. |
integer |
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 o usuário 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 |
|---|---|---|
| auth_level | Indica o nível de autenticação do autor da chamada. | integer |
| phone_number | O número de telefone local do autor da chamada, sem o código do país, usado para identificar o usuário. | string |
| account_count | O número de contas associadas ao número de telefone registrado. Isso inclui contas próprias e contas para as quais o usuário tem procuração. | integer |
| last_four_digit_of_account_number | Se um usuário tiver uma única conta, os últimos quatro dígitos do número da conta serão retornados. Se um usuário tiver mais de uma conta, o valor desse parâmetro será os últimos quatro dígitos do número da conta que o usuário selecionou para receber informações sobre o saldo da conta. | 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 o componente pré-criado, siga estas etapas:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com as configurações que descrevem seus serviços externos. Para mais informações, consulte a seção Configuração do webhook.
Configuração do webhook
Para usar esse componente, é necessário configurar os webhooks flexíveis incluídos para recuperar as informações necessárias dos seus serviços externos.
Autenticação
Se você ainda não configurou os serviços externos necessários para autenticação, configure-os para permitir a autenticação de usuários para esse componente. Para mais informações sobre a configuração do webhook, consulte Configuração do webhook de autenticação.
Validar conta
O componente usa o webhook prebuilt_components_account_services:validate_account
para verificar se uma conta existe com base no número de telefone registrado do usuário
e nos últimos quatro dígitos do número da conta fornecido. O webhook
também retorna o saldo da conta, 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 autor da chamada, sem o código do país, usado para identificar o usuário. | string |
| $session.params.last_four_digit_of_account_number | Os últimos quatro dígitos do número da conta que o usuário selecionou e confirmou para receber informações sobre o saldo da conta. | string |
Parâmetros de resposta da API
O componente extrai os seguintes parâmetros da resposta da API:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| account_found | Indica se existe uma conta com os últimos quatro dígitos fornecidos para a conta registrada do usuário. | booleano |
| saldo | O valor do saldo atual na conta, se houver. | número |
Para configurar o webhook de validação de 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_account_services:validate_account.
- 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 e os webhooks dele estão configurados e prontos para teste.