O componente pré-criado abrir conta permite que os utilizadores novos e existentes abram uma nova conta ou verifiquem o estado das candidaturas existentes. Este componente usa os componentes predefinidos de recolha da data de nascimento, recolha do nome e recolha do número de telefone para recolher informações do utilizador para registar uma nova conta.
Tipos de contas
Por predefinição, este componente suporta os seguintes tipos de contas:
- Contas-poupança
- Contas-correntes
- Contas Demat
- Contas salariais
Os tipos de contas suportados podem ser adicionados ou removidos modificando a entidade personalizada prebuilt_components_open_account_account_type.
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 agente recolhe o número de telefone do utilizador e identifica que o utilizador não está registado numa conta. Em seguida, o agente recolhe detalhes, incluindo o nome completo e a data de nascimento do utilizador, e gera uma aplicação que é enviada para o número de telefone fornecido pelo utilizador.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Indique-nos o número de telefone para fins de validação. | |
| O agente recolhe o número de telefone do utilizador através do componente pré-criado Recolha de número de telefone | |
| Ótimo, terminámos de recolher o número de telefone. Ficamos contentes por querer abrir uma conta connosco. |
|
| O agente recolhe o nome completo do utilizador através do componente pré-criado Recolha de nomes | |
| Obrigado, João Pinto. | |
| O agente recolhe o número de telefone do utilizador através do componente pré-criado Recolha da data de nascimento | |
| Ótimo, recolhemos a sua data de nascimento. Que tipo de conta quer abrir? Pode dizer poupança, corrente, salário ou conta de investimento. |
|
| Conta atual | |
| Para confirmar, quer abrir uma nova conta à ordem. Está correto? | |
| Sim | |
| Agradecemos as informações. Aguarde enquanto geramos a sua aplicação. O ID da sua aplicação é 81037. Conclua a sua candidatura clicando no link disponibilizado no seu número de telemóvel registado. |
Utilizador existente
O agente identifica que o utilizador foi autenticado anteriormente e confirma que tipo de conta o utilizador quer abrir. O agente cria uma aplicação para o utilizador e envia instruções para o número de telefone registado do utilizador.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Ficamos contentes por querer abrir uma nova conta connosco. Que tipo de conta quer abrir? Pode dizer poupança, corrente, salário ou conta de investimento. |
|
| Conta poupança, por favor | |
| Para confirmar, quer abrir uma nova conta poupança. É correto? | |
| Sim, é isso mesmo | |
| Agradecemos as informações. Aguarde enquanto geramos a sua aplicação. O ID da sua aplicação é 21430. Conclua a sua candidatura clicando no link disponibilizado no seu número de telemóvel registado. |
Aplicação existente
O agente identifica que o utilizador abriu anteriormente uma única aplicação e apresenta o estado atual ao utilizador. O utilizador recusa-se a abrir outra aplicação para uma nova conta.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Indique-nos o número de telefone para fins de validação. | |
| O agente recolhe o número de telefone do utilizador através do componente pré-criado Recolha de número de telefone | |
| Ótimo, terminámos de recolher o número de telefone. A sua candidatura com o ID 12234 para abrir uma conta de poupança está em curso. Quer abrir outra conta? |
|
| Não | |
| OK. Obrigado por nos contactar. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Abrir conta |
| Intenção específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
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 do autor da chamada. | número inteiro |
| $session.params.phone_number | (Opcional) Número de telefone registado do cliente usado para autenticação. | de string |
| $session.params.min_age_limit | Especifica a idade mínima permitida para os utilizadores que estão a abrir uma nova conta. O valor predefinido é 18. |
número inteiro |
| $session.params.max_age_limit | Especifica a idade máxima permitida para os utilizadores que estão a abrir uma nova conta. O valor predefinido é 100. |
número inteiro |
| $flow.max_dob_retry_count | Especifica o número de novas tentativas permitidas ao recolher uma data de nascimento válida. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_account_type | Especifica o número de novas tentativas permitidas ao recolher o tipo de conta que o utilizador quer abrir. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_another_account | Especifica o número de novas tentativas permitidas quando o utilizador quer alterar o tipo de conta que selecionou. O valor predefinido é 2. |
número inteiro |
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.
Validação por telefone
O webhook prebuilt_components_open_account:telephone_verification é usado pelo componente para obter informações sobre contas registadas e aplicações anteriores associadas ao número de telefone 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 |
|---|---|---|
| $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. Estas contas incluem contas próprias e contas para as quais o utilizador tem procuração. Se não existirem contas associadas ao número de telefone indicado, este valor é null. |
número inteiro |
| user_first_name | O nome próprio do utilizador registado. Se o número de telefone não estiver associado a uma conta registada, este valor é null. |
de string |
| user_last_name | O apelido do utilizador registado. Se o número de telefone não estiver associado a uma conta registada, este valor é null. |
de string |
| user_dob | A data de nascimento do utilizador registado no formato "AAAA-MM-DD". Se o número de telefone não estiver associado a uma conta registada, este valor é null. |
de string |
| application_count | O número de aplicações associadas ao número de telefone registado. Se não existirem aplicações associadas ao número de telefone indicado, este valor é null. |
número inteiro |
| application_id | Lista que contém o ID da aplicação de cada aplicação associada ao número de telefone indicado, por exemplo, ["00000", "11111", "22222"]. Cada elemento nesta lista representa a mesma aplicação que o elemento com o mesmo índice em account_type e application_status. Se não existirem aplicações associadas ao número de telefone indicado, este valor é null. |
Lista (string) |
| account_type | Lista que contém o tipo de conta de cada aplicação associada ao número de telefone indicado, por exemplo, ["savings", "checking", "demat"]. Cada elemento nesta lista representa a mesma aplicação que o elemento com o mesmo índice em application_id e application_status. Se não existirem aplicações associadas ao número de telefone indicado, este valor é null. |
Lista (string) |
| application_status | Lista que contém o estado de cada aplicação associada ao número de telefone indicado, por exemplo, ["in progress", "on hold", "completed"]. Cada elemento nesta lista representa a mesma aplicação que o elemento com o mesmo índice em application_id e account_type. Se não existirem aplicações associadas ao número de telefone indicado, este valor é null. |
Lista (string) |
Para configurar o webhook de validação por telefone 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_open_account:telephone_verification.
- 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.
Gere uma candidatura
O webhook prebuilt_components_open_account:generate_application é usado pelo componente para gerar uma candidatura para uma nova 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 |
| user_first_name | Nome próprio do utilizador. | de string |
| user_last_name | Apelido do utilizador. | de string |
| user_dob | Data de nascimento do utilizador no formato "AAAA-MM-DD". | 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 |
|---|---|---|
| application_id | ID da aplicação gerado para a nova candidatura à conta. | de string |
Para configurar o webhook da aplicação Generate 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_open_account:generate_application.
- 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.