O cartão de bloqueio componente pré-criado autentica o utilizador, obtém os cartões registados no utilizador e permite que o utilizador bloqueie um cartão temporariamente, bloqueie um cartão permanentemente ou reative um cartão. Depois de confirmar um cartão bloqueado, o componente permite que o utilizador peça um novo cartão. Este componente usa uma versão personalizada do componente predefinido de autenticação para autenticar os titulares dos cartões.
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.
Utilizador não autenticado com vários cartões
O agente identifica que o utilizador não foi autenticado anteriormente e recolhe informações para validar que o utilizador é um titular de cartão registado. Depois de o utilizador se autenticar, o agente obtém informações sobre os cartões registados no utilizador. O utilizador confirma que quer bloquear temporariamente um cartão selecionado e o agente gera o pedido de bloqueio do cartão.
| Introdução do utilizador | Resposta do agente |
|---|---|
| O agente autentica o utilizador através do componente pré-criado Autenticação | |
| Obrigado. A sua identidade foi validada com êxito. | |
| Aguarde enquanto obtemos os detalhes do seu cartão. Encontrámos vários cartões registados com o seu número. Temos um cartão Visa terminado em 5555, um cartão Visa terminado em 6666, um cartão MasterCard terminado em 4444 e um cartão MasterCard terminado em 4449. Indique-nos os últimos 4 dígitos do cartão que quer bloquear ou reativar. |
|
| 4444 | |
| Os últimos quatro dígitos do número do cartão que recebemos são 4444. Está correto? | |
| Sim | |
| Quer bloquear o cartão temporária ou permanentemente? | |
| Quero bloqueá-lo temporariamente | |
| Indique-nos o motivo pelo qual está a bloquear o seu cartão. Pode escolher entre opções como danificado, roubado, perdido ou outras. | |
| Foi danificado | |
| Lamento saber disso. Por motivos de segurança, temos de validar a sua identidade. Por isso, vamos enviar-lhe um código. Prefere receber o código por telefone ou por email? | |
| Envia para o meu telemóvel | |
| OK. Antes de continuar, vamos enviar um código para o seu número de telemóvel registado. Pode confirmar o seu código para validar o pedido? | |
| 123456 | |
| OK. O seu cartão terminado em 4444 vai ser bloqueado temporariamente. Depois de bloqueado, não pode fazer transações online nem em máquinas de PDV com esse cartão. Confirma esta ação? | |
| Sim | |
| O seu cartão foi bloqueado com êxito. O número do seu pedido é 9711485 e foi partilhado com êxito com o seu número de telemóvel registado. |
Utilizador autenticado com um único cartão
O agente identifica que o utilizador foi autenticado anteriormente e obtém informações sobre o cartão registado no utilizador. O utilizador seleciona a opção para bloquear o cartão permanentemente e o agente gera o pedido de bloqueio permanente do cartão. Em seguida, o agente pergunta ao utilizador se quer reemitir um novo cartão para o cartão bloqueado permanentemente e cria um pedido de reemissão para o cartão.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Aguarde enquanto obtemos os detalhes do seu cartão. Encontrámos o seu cartão MasterCard terminado em 4444. Quer bloquear o cartão temporária ou permanentemente? |
|
| Permanentemente | |
| Indique-nos o motivo pelo qual está a bloquear o seu cartão. Pode escolher entre opções como danificado, roubado, perdido ou outras. | |
| Estiver danificado | |
| Lamento saber disso. Não se preocupe, vamos bloquear permanentemente o seu cartão. Pode confirmar se o cartão termina em 4444? | |
| Sim | |
| OK. Antes de continuar, vamos enviar um código para o seu número de telemóvel registado. Pode confirmar o seu código para validar o pedido? | |
| 123456 | |
| OK. O seu cartão terminado em 4444 vai ser bloqueado temporariamente. Depois de bloqueado, não pode fazer transações online nem em máquinas de PDV com esse cartão. Confirma esta ação? | |
| Sim | |
| O seu cartão foi bloqueado com êxito. O número do seu pedido é 6108410 e foi partilhado com êxito com o seu número de telemóvel registado. Quer reemitir um novo cartão? |
|
| Sim | |
| Enviamos o cartão para a sua morada registada. Pode confirmar o código postal da sua morada de entrega, 12345? | |
| Está correto | |
| OK. Aguarde alguns segundos enquanto apresentamos o pedido de reemissão de um novo cartão. O pedido de reemissão do novo cartão foi bem-sucedido. O número do seu pedido é 3808109 e foi partilhado com êxito com o seu número de telemóvel registado. O cartão é entregue na sua morada registada no prazo de 3 dias úteis. Para usar o cartão, siga as instruções partilhadas com o mesmo. |
Reative o cartão
O agente identifica que o utilizador requer autenticação adicional e envia uma palavra-passe de utilização única para validar a identidade do utilizador. O utilizador pede a reativação de um cartão e o agente transfere o pedido para um agente humano para continuar.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Por motivos de segurança, temos de validar a sua identidade. Por isso, vamos enviar-lhe um código. Prefere receber o código por telefone? | |
| Sim | |
| Enviámos um código para o seu número de telefone registado que termina em 5041. Pode demorar alguns segundos. Pode confirmar o código? | |
| 123456 | |
| Obrigado. A validação foi concluída com êxito. Aguarde enquanto obtemos os detalhes do seu cartão. Encontrámos vários cartões registados com o seu número. Temos um cartão Visa que termina em 1456, um cartão MasterCard que termina em 1457, um cartão American Express que termina em 1345 e um cartão Visa que termina em 3456. Indique-nos os últimos 4 dígitos do cartão que quer bloquear ou reativar. |
|
| 1456 | |
| Os últimos quatro dígitos do número do cartão que recebemos são 1456. Está correto? | |
| Sim | |
| O cartão pedido já está num estado de bloqueio temporário. Quer reativar o cartão ou bloqueá-lo permanentemente? | |
| Reative-o | |
| Aguarde enquanto transferimos a sua chamada para que possamos ajudar melhor. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Bloquear cartão |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lock_card_locked_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lock_card:lock_card_ticket_number |
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.auth_level_req | Indica o nível de autenticação necessário antes de um utilizador poder aceder ao respetivo histórico de transações. Este valor é configurado nas predefinições de parâmetros do preenchimento de entradas de páginas na página check auth level. Por predefinição, este valor é 1. |
número inteiro |
| $session.params.account_auth_enabled | Indica se o utilizador deve ser autenticado como titular da conta, conforme descrito em Tipos de autenticação. Este valor é configurado nas predefinições de parâmetros do preenchimento de entradas de páginas na página check auth level. Por predefinição, este valor é false. |
booleano |
| $session.params.card_auth_enabled | Indica se o utilizador deve ser autenticado como titular do cartão, conforme descrito em Tipos de autenticação. Este valor é configurado nas predefinições de parâmetros do preenchimento de entradas de páginas na página check auth level. Por predefinição, este valor é true. |
booleano |
| $session.params.phone_number | (Opcional) Número de telefone registado do cliente usado para autenticação. | de string |
| $session.params.card_count | (opcional) Número de cartões de crédito associados ao utilizador autenticado. | número inteiro |
| $flow.card_status_active | Especifica o valor do parâmetro devolvido pelo webhook de validação do cartão para indicar que o cartão selecionado está atualmente ativo. Por predefinição, o valor é "active". |
de string |
| $flow.card_status_lock_temp | Especifica o valor do parâmetro devolvido pelo webhook do cartão de validação para indicar que o cartão selecionado está temporariamente bloqueado. Por predefinição, o valor é "inactive". |
de string |
| $flow.card_status_lock_permanent | Especifica o valor do parâmetro devolvido pelo webhook de validação do cartão para indicar que o cartão selecionado está permanentemente bloqueado. Por predefinição, o valor é "blocked". |
de string |
| $flow.card_status_reactivate | Especifica o valor do parâmetro devolvido pelo webhook do cartão de validação para indicar que o cartão selecionado foi reativado. Por predefinição, o valor é "reactivate". |
de string |
| $flow.max_retry_card_number | Especifica o número de novas tentativas permitidas ao recolher os últimos quatro dígitos do cartão de crédito. O valor predefinido é 3. |
número inteiro |
| $flow.max_otp_retry_count | Especifica o número de novas tentativas permitidas ao recolher a palavra-passe única (OTP) do utilizador. O valor predefinido é 3. |
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 |
|---|---|---|
| auth_level | Indica o nível de autenticação do autor da chamada. | número inteiro |
| phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| card_count | O número de cartões associados ao número de telefone registado. | número inteiro |
| last_four_digit_of_card_number | Se um utilizador tiver um único cartão, são devolvidos os últimos quatro dígitos do número do cartão. Se um utilizador tiver mais do que um cartão, o valor deste parâmetro são os últimos quatro dígitos do cartão que o utilizador selecionou para bloquear ou emitir um novo cartão. | 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.
Autenticação
Se não tiver configurado anteriormente os serviços externos necessários para a autenticação, tem de configurá-los para ativar a autenticação de utilizadores para este componente. Consulte o artigo Configuração do webhook de autenticação para ver instruções detalhadas.
Obtenha detalhes do cartão
O webhook prebuilt_components_account_services:get_card_details é usado pelo componente para obter informações sobre os cartões registados num 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 |
|---|---|---|
| last_four_digit_of_all_cards | Lista com os últimos quatro dígitos de cada cartão registado no utilizador, por exemplo, ["0000", "1111", "2222"]. Cada elemento nesta lista representa o mesmo cartão que o elemento com o mesmo índice em card_vendor_all. |
Lista (string) |
| card_vendor_all | Lista com o fornecedor do cartão de crédito de cada cartão registado no utilizador, por exemplo, ["Visa", "Mastercard", "Discover"]. Cada elemento nesta lista representa o mesmo cartão que o elemento com o mesmo índice em last_four_digit_of_all_cards. |
Lista (string) |
| card_count | Número de cartões associados ao utilizador autenticado. | número inteiro |
Para configurar o webhook Get 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_account_services:get_card_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.
Valide o cartão
O webhook prebuilt_components_lock_card:validate_card é usado
pelo componente para obter informações sobre um cartão específico registado na conta de um 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 |
| $session.params.last_four_digit_of_card_number | Os últimos quatro dígitos do número do cartão que o utilizador pediu para bloquear. | 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 |
|---|---|---|
| zip_code | Código postal registado na conta do utilizador. | de string |
| card_vendor | O fornecedor do cartão de crédito para o cartão selecionado. | de string |
| card_status | Indica o estado atual do cartão. Por predefinição, os valores válidos são ativo, bloqueado temporariamente ou bloqueado permanentemente. Estes estados são especificados pelos parâmetros $flow.card_status_active, $flow.card_status_lock_temp e $flow.card_status_lock_permanent. Veja os parâmetros de entrada. |
de string |
Para configurar o webhook de validação de cartã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_lock_card:validate_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.
Bloquear cartão
O webhook prebuilt_components_lock_card:lock_card_ticket_numberé usado pelo componente para criar um pedido de bloqueio de um 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 |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| $session.params.last_four_digit_of_card_number | Os últimos quatro dígitos do número do cartão que o utilizador pediu para bloquear. | de string |
| $flow.lock_type | Indica o tipo de bloqueio a aplicar ao cartão do utilizador. Os valores válidos são definidos pela entidade personalizada prebuilt_components_lock_card_lock_type_active. Por predefinição, são suportados os ícones "blocked" (bloqueio permanente) e "inactive (bloqueio temporário). |
de string |
| $flow.lock_reason | Indica o motivo pelo qual o utilizador pediu o bloqueio do cartão. Os valores válidos são definidos pela entidade personalizada prebuilt_components_lock_card_locked_reason. Por predefinição, são suportados os formatos "damaged", "stolen", "lost" e "others". |
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 |
|---|---|---|
| ticket_number | O número do pedido de cartão de bloqueio criado. | número inteiro |
Para configurar o webhook do cartão de bloqueio 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_lock_card:lock_card_ticket_number.
- 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.
Reemita o cartão
O webhook prebuilt_components_lock_card:reissue_card_number é usado pelo componente para criar um pedido de reemissão de um cartão novo ou atualizado.
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 |
| $session.params.last_four_digit_of_card_number | Os últimos quatro dígitos do número do cartão que o utilizador pediu para bloquear. | de string |
| zip_code | Código postal registado na conta do 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 |
|---|---|---|
| acknowledgement_number | O número do pedido de emissão de cartão criado. | número inteiro |
Para configurar o webhook de reemissão de cartões 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_lock_card:reissue_card_number.
- 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.