O componente pré-criado de fazer um pagamento valida o utilizador e permite-lhe fazer um pagamento. Este componente usa uma versão personalizada do componente pré-criado Authentication para autenticar titulares de contas e titulares de cartões. O componente também usa os componentes predefinidos Recolha de nomes, Recolha da data de validade do cartão de crédito e Recolha do CVV do cartão de crédito para recolher as informações necessárias para fazer pagamentos.
Tipos de pagamento
Este componente suporta pagamentos de faturas de cartões de crédito e contas de beneficiários. Para as faturas de cartões de crédito, os utilizadores podem optar por pagar o valor mínimo, o valor total ou um valor personalizado da fatura. O utilizador pode fazer pagamentos a partir da respetiva conta bancária, cartão de débito ou crédito, ou pagamento móvel.
| Tipo de pagamento | Métodos de pagamento disponíveis | Valores de pagamento disponíveis |
|---|---|---|
| Fatura do cartão de crédito | Conta bancária, cartão de débito, pagamento móvel | Valor mínimo, total e personalizado |
| Conta do beneficiário | Conta bancária, cartão de crédito, cartão de débito, pagamento móvel | Valor personalizado |
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.
Pagamento da conta do beneficiário
O agente identifica que o utilizador não foi autenticado anteriormente e recolhe informações para verificar se o utilizador é um utilizador registado. O utilizador indica que quer fazer um pagamento a uma conta beneficiária e o agente recolhe as informações necessárias, incluindo o nome do beneficiário, e confirma o número de conta. Por fim, o utilizador seleciona a opção de fazer um pagamento com o seu cartão de débito. Assim, o agente recolhe o número do cartão de débito, a data de validade e o CVV, e confirma o pagamento.
| 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. | |
| Quer pagar a fatura do seu cartão de crédito registado ou fazer um pagamento a uma conta de beneficiário existente? | |
| Beneficiário | |
| O agente recolhe o nome do beneficiário através do componente pré-criado Recolha de nomes | |
| Obrigado. Recolhemos o nome do beneficiário. Com base nos nossos registos, temos o número de conta que termina em 7821. Diga sim para confirmar o número de conta. |
|
| Sim | |
| Confirme o valor que quer pagar. Por exemplo, se quiser pagar 100,30 €, diga 100 ponto 30. | |
| 50 dólares | |
| Quer pagar através da sua conta bancária, cartão de débito, cartão de crédito ou pagamento móvel? | |
| Débito | |
| Pode indicar-nos os últimos 4 dígitos do número do cartão de débito a que se refere? | |
| 1234 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 1234. Está correto? | |
| Sim, é isso mesmo | |
| O agente recolhe a data de validade do cartão de débito através do componente pré-criado Recolha da data de validade do cartão de crédito | |
| Ótimo, terminámos a recolha da data de validade do cartão de débito. | |
| O agente recolhe o CVV do cartão de débito através do componente pré-criado Recolha do CVV do cartão de crédito | |
| Ótimo, terminámos a recolha do CVV. | |
| OK. Vamos fazer um pagamento de 50 € à Joana com o número do cartão de débito terminado em 1234. Confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar-lhe um código. Prefere receber o código por telefone ou email? | |
| Enviar email | |
| Enviámos um código para o seu email registado john.doe@google.com. Este processo pode demorar alguns segundos. Pode confirmar o código? | |
| 123456 | |
| OK. Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento da conta do beneficiário foi feito com êxito. |
Pagamento de fatura por cartão de crédito
O agente identifica que o utilizador não foi autenticado anteriormente e recolhe informações para verificar se o utilizador é um utilizador registado. O utilizador indica que quer fazer um pagamento da fatura do cartão de crédito com a respetiva conta bancária. O agente confirma os detalhes do valor e do método de pagamento e conclui o pagamento.
| 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. | |
| Quer pagar a fatura do seu cartão de crédito registado ou fazer um pagamento a uma conta de beneficiário existente? | |
| Fatura do cartão de crédito | |
| Pode indicar-nos os últimos 4 dígitos do número do cartão de crédito a que se refere? | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321. Está correto? | |
| Sim | |
| O valor total em dívida é de 300 $e o pagamento mínimo é de 20 $. Quer pagar o valor total, o valor mínimo ou qualquer outro valor? | |
| Valor total | |
| Quer pagar através da sua conta bancária, cartão de débito ou pagamento móvel? | |
| Conta poupança | |
| Constatámos que existem 2 contas associadas ao seu número. Pode ajudar-nos com os últimos 4 dígitos da conta a que se refere? | |
| 1001 | |
| Os últimos quatro dígitos do número de conta que recebemos são 1001. Está correto? | |
| Sim | |
| OK. Vamos fazer um pagamento de 300 € para a fatura do seu cartão de crédito terminado em 4321 com o número de conta terminado em 1001. Confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar-lhe um código. Prefere receber o código por telefone ou email? | |
| Envia-o para o meu email | |
| Enviámos um código para o seu email registado john.doe@google.com. Este processo pode demorar alguns segundos. Pode confirmar o código? | |
| 123456 | |
| OK. Aguarde alguns segundos enquanto fazemos o pagamento. O pagamento com cartão de crédito foi bem-sucedido. |
Fundos ou limites insuficientes
O agente identifica que o utilizador não foi autenticado anteriormente e recolhe informações para verificar se o utilizador é um utilizador registado. O utilizador tenta fazer pagamentos da fatura do cartão de crédito com a conta bancária e o cartão de débito, mas ambos os pagamentos são recusados devido a fundos ou limites insuficientes. Por último, o utilizador opta por fazer um pagamento móvel e o agente envia-lhe um link para concluir o pagamento através do telemóvel.
| 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. | |
| Quer pagar a fatura do seu cartão de crédito registado ou fazer um pagamento a uma conta de beneficiário existente? | |
| Cartão de crédito | |
| Pode indicar-nos os últimos 4 dígitos do número do cartão de crédito a que se refere? | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321. Está correto? | |
| Sim | |
| O valor total em dívida é de 300 $e o pagamento mínimo é de 20 $. Quer pagar o valor total, o valor mínimo ou qualquer outro valor? | |
| Valor total | |
| Quer pagar através da sua conta bancária, cartão de débito ou pagamento móvel? | |
| Poupança | |
| Constatámos que existem 2 contas associadas ao seu número. Pode ajudar-nos com os últimos 4 dígitos da conta a que se refere? | |
| 1002 | |
| Os últimos quatro dígitos do número de conta que recebemos são 1002. Está correto? | |
| Sim | |
| OK. Vamos fazer um pagamento de 300 € para a fatura do seu cartão de crédito terminado em 4321 com o número de conta terminado em 1002. Confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar-lhe um código. Prefere receber o código por telefone ou email? | |
| Enviámos um código para o seu email registado john.doe@google.com. Este processo pode demorar alguns segundos. Pode confirmar o código? | |
| 123456 | |
| OK. Aguarde alguns segundos enquanto fazemos o pagamento. O seu pagamento falhou devido a fundos insuficientes na conta. Quer tentar novamente o pagamento com outro método de pagamento? |
|
| Sim | |
| Quer pagar através da sua conta bancária, cartão de débito ou pagamento móvel? | |
| Cartão de débito | |
| Pode indicar-nos os últimos 4 dígitos do número do cartão de débito a que se refere? | |
| 2345 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 2345. Está correto? | |
| Sim | |
| O agente recolhe a data de validade do cartão de débito através do componente pré-criado Recolha da data de validade do cartão de crédito | |
| Ótimo, terminámos a recolha da data de validade do cartão de débito. | |
| O agente recolhe o CVV do cartão de débito através do componente pré-criado Recolha do CVV do cartão de crédito | |
| Ótimo, terminámos a recolha do CVV. | |
| OK. Vamos fazer um pagamento de 300 € para a fatura do seu cartão de crédito terminado em 4321 com o número do cartão de débito terminado em 2345. Confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar-lhe um código. Prefere receber o código por telefone ou email? | |
| Enviámos um código para o seu email registado john.doe@google.com. Este processo pode demorar alguns segundos. Pode confirmar o código? | |
| 123456 | |
| OK. Aguarde alguns segundos enquanto fazemos o pagamento. O seu pagamento falhou porque o limite foi excedido no cartão de débito. Quer tentar novamente o pagamento com outro método de pagamento? |
|
| Sim | |
| Quer pagar através da sua conta bancária, cartão de débito ou pagamento móvel? | |
| Dispositivos móveis | |
| OK. Estamos a enviar o link de pagamento para o seu número de telemóvel registado. Esta ação pode demorar alguns segundos. Diga sim para confirmar se o recebeu. | |
| Sim | |
| Ótimo. Já pode abrir o link e continuar o pagamento. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Fazer um pagamento |
| Intenção específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_make_a_payment_payment_mode |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_make_a_payment:process_payment_credit_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 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 é true. |
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 é false. |
booleano |
| $session.params.phone_number | (Opcional) Número de telefone registado do cliente usado para autenticação. | de string |
| $flow.payment_success_code | Especifica o valor do campo payment_status_code devolvido pelos process_payment webhooks que indica que o pagamento foi bem-sucedido. Por predefinição, este valor é "200". |
de string |
| $flow.insufficient_fund_code | Especifica o valor do campo payment_status_code devolvido pelos process_payment webhooks que indica que não foi possível concluir o pagamento devido a fundos insuficientes. Por predefinição, este valor é "400". |
de string |
| $flow.limit_exceed_code | Especifica o valor do campo payment_status_code devolvido pelos process_payment webhooks que indica que não foi possível concluir o pagamento devido ao limite diário ter sido excedido. Por predefinição, este valor é "401". |
de string |
| $flow.max_retry_mop_counter | Especifica o número de vezes que um utilizador pode alterar o respetivo método de pagamento. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_credit_card_payment | Especifica o número de novas tentativas permitidas ao tentar fazer um pagamento com um cartão de crédito como método de pagamento. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_mobile_payment_counter | Especifica o número de novas tentativas permitidas ao tentar fazer um pagamento através do pagamento móvel como método de pagamento. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_creditcard_count | Especifica o número de novas tentativas permitidas quando recolhe um número de cartão de crédito válido para fazer um pagamento. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_acc_number | Especifica o número de novas tentativas permitidas quando recolhe detalhes da conta válidos para fazer um pagamento. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_debit_card_details | Especifica o número de novas tentativas permitidas quando recolhe detalhes válidos do cartão de débito para fazer um pagamento. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_credit_card_details | Especifica o número de novas tentativas permitidas quando recolhe detalhes válidos do cartão de crédito para fazer um pagamento. O valor predefinido é 3. |
número inteiro |
| $flow.otp_length | Especifica o comprimento esperado da palavra-passe de utilização única enviada ao utilizador. O valor predefinido é 6. |
número inteiro |
| $flow.max_retry_otp_count | Especifica o número de novas tentativas permitidas ao recolher uma palavra-passe única (OTP) válida do utilizador. O valor predefinido é 3. |
número inteiro |
| $flow.max_waiting_room_counter | Especifica o número de vezes que o utilizador pode pedir ao agente para aguardar enquanto recebe o link para pagamento móvel. 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 |
|---|---|---|
| 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 |
| 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.
Valide a conta
O webhook prebuilt_components_account_services:validate_account é usado pelo componente para verificar se existe uma conta com base no número de telefone registado do utilizador e nos últimos quatro dígitos do número de conta fornecido.
O webhook também devolve o saldo da conta, 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 |
| $session.params.last_four_digit_of_account_number | Os últimos quatro dígitos do número de conta que o utilizador selecionou e confirmou para fazer um pagamento. | 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_found | Indica se existe uma conta com os últimos quatro dígitos fornecidos para a conta registada do utilizador. | booleano |
| saldo | O valor do saldo atual na conta, se existir. | número |
Para configurar o webhook de validação da conta 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:validate_account.
- 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.
Detalhes do cartão do utilizador
O webhook prebuilt_components_make_a_payment:user_card_details é usado
pelo componente para obter detalhes dos cartões de débito e crédito 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 |
|---|---|---|
| credit_card_count | Número de cartões de crédito associados ao número de telefone registado. | número inteiro |
| last_four_digit_of_credit_card_number | Os últimos quatro dígitos do cartão de crédito do utilizador. Se o cliente tiver vários cartões de crédito, este valor é null. |
de string |
| debit_card_count | Número de cartões de débito associados ao número de telefone registado. | número inteiro |
| last_four_digit_of_debit_card_number | Os últimos quatro dígitos do cartão de débito do utilizador. Se o cliente tiver vários cartões de débito, este valor é null. |
de string |
Para configurar o webhook de detalhes do cartão de utilizador 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_make_a_payment:user_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 nome do beneficiário
O webhook prebuilt_components_make_a_payment:verify_beneficiary_name é usado pelo componente para verificar se existe uma conta beneficiária para o nome fornecido pelo 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.name_collection_first_name | Nome próprio do beneficiário. | de string |
| $session.params.name_collection_last_name | Apelido do beneficiário. | de string |
| $session.params.name_collection_middle_name | Segundo nome do beneficiário. | 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 |
|---|---|---|
| beneficiary_account_number | Últimos quatro dígitos do número de conta do beneficiário para o nome do beneficiário indicado. Se não for encontrada uma conta beneficiária para o nome fornecido, o valor é null. |
de string |
Para configurar o webhook de validação do nome do beneficiário 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_make_a_payment:verify_beneficiary_name.
- 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.
Valor em dívida
O webhook é usado pelo componente para obter informações sobre o valor mínimo e total em dívida da fatura do cartão de crédito do utilizador.prebuilt_components_make_a_payment:get_due_amount
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.user_credit_card_number | Os últimos quatro dígitos do cartão de crédito 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 |
|---|---|---|
| minimum_amount | Valor mínimo em dívida para a fatura do cartão de crédito especificada. | número |
| total_amount | Valor total em dívida da fatura do cartão de crédito especificado. | número |
Para configurar o webhook Get due amount 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_make_a_payment:get_due_amount.
- 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 número do cartão de crédito
O webhook prebuilt_components_make_a_payment:verify_credit_card_number é usado pelo componente para verificar se o número do cartão de crédito fornecido está registado na conta 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 |
| $flow.user_credit_card_number | Os últimos quatro dígitos do cartão de crédito 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 |
|---|---|---|
| card_found | Indica se o cartão de crédito fornecido foi encontrado. | booleano |
Para configurar o webhook de validação do número do cartão de crédito 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_make_a_payment:verify_credit_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.
Valide os detalhes do cartão de crédito
O webhook prebuilt_components_make_a_payment:verify_credit_card_details é usado pelo componente para verificar se os detalhes fornecidos, incluindo a data de validade e o CVV, são válidos para o cartão de crédito fornecido pelo 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 |
| $flow.credit_card_number | Os últimos quatro dígitos do cartão de crédito do utilizador. | de string |
| $flow.credit_card_exp_date | Data de validade do cartão de crédito fornecida pelo utilizador para o cartão de crédito específico. | { |
| $flow.credit_card_cvv_code | Código CVV fornecido pelo utilizador para o cartão de crédito especificado. | 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 |
|---|---|---|
| creditcard_verification_status | Indica se os detalhes do cartão de crédito fornecidos foram validados. | booleano |
Para configurar o webhook Verify credit 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_make_a_payment:verify_credit_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 os detalhes do cartão de débito
O webhook prebuilt_components_make_a_payment:verify_debit_card_details é usado pelo componente para verificar se os detalhes fornecidos, incluindo a data de validade e o CVV, são válidos para o cartão de débito fornecido pelo 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 |
| $flow.debit_card_number | Os últimos quatro dígitos do cartão de débito do utilizador. | de string |
| $flow.debit_card_exp_date | Data de validade do cartão de débito fornecida pelo utilizador para o cartão de débito especificado. | { |
| $flow.debit_card_cvv_code | Código CVV fornecido pelo utilizador para o cartão de débito especificado. | 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 |
|---|---|---|
| debitcard_verification_status | Indica se os detalhes do cartão de débito fornecidos foram validados. | booleano |
Para configurar o webhook Verify debit 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_make_a_payment:verify_debit_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.
Processe o pagamento com cartão de crédito
O webhook prebuilt_components_make_a_payment:process_payment_credit_card é usado pelo componente para processar um pagamento através dos detalhes do cartão de crédito 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.payee_number | Últimos quatro dígitos do número de conta do beneficiário para o pagamento. | de string |
| $flow.payment_type | Tipo de pagamento do pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por predefinição, este componente suporta "beneficiary_pay" e "credit_card_pay". |
de string |
| $flow.credit_card_number | Os últimos quatro dígitos do cartão de crédito do utilizador. | de string |
| $flow.credit_card_exp_date | Data de validade do cartão de crédito fornecida pelo utilizador para o cartão de crédito especificado. | { |
| $flow.credit_card_cvv_code | Código CVV fornecido pelo utilizador para o cartão de crédito especificado. | de string |
| $flow.payment_amount | O valor que o utilizador optou por pagar. | número |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code parâmetros de entrada configuráveis. |
de string |
Para configurar o webhook de pagamento com cartão de crédito do processo 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_make_a_payment:process_payment_credit_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.
Processar pagamento com cartão de débito
O webhook prebuilt_components_make_a_payment:process_payment_debit_card é usado pelo componente para processar um pagamento através dos detalhes do cartão de débito 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.payee_number | Últimos quatro dígitos do número de conta do beneficiário para o pagamento. | de string |
| $flow.payment_type | Tipo de pagamento do pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por predefinição, este componente suporta "beneficiary_pay" e "credit_card_pay". |
de string |
| $flow.debit_card_number | Os últimos quatro dígitos do cartão de débito do utilizador. | de string |
| $flow.debit_card_exp_date | Data de validade do cartão de débito fornecida pelo utilizador para o cartão de débito especificado. | { |
| $flow.debit_card_cvv_code | Código CVV fornecido pelo utilizador para o cartão de débito especificado. | de string |
| $flow.payment_amount | O valor que o utilizador optou por pagar. | número |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code parâmetros de entrada configuráveis. |
de string |
Para configurar o webhook de pagamento com cartão de débito Process 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_make_a_payment:process_payment_debit_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.
Processar pagamento da conta
O webhook prebuilt_components_make_a_payment:process_payment_account é usado pelo componente para processar um pagamento através dos detalhes da conta 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.payee_number | Últimos quatro dígitos do número de conta do beneficiário para o pagamento. | de string |
| $flow.payment_type | Tipo de pagamento do pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por predefinição, este componente suporta "beneficiary_pay" e "credit_card_pay". |
de string |
| $session.params.last_four_digit_of_account_number | Últimos quatro dígitos da conta do utilizador. | de string |
| $flow.payment_amount | O valor que o utilizador optou por pagar. | número |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code parâmetros de entrada configuráveis. |
de string |
Para configurar o webhook de pagamento da conta de processamento 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_make_a_payment:process_payment_account.
- 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.
Processe pagamentos móveis
O webhook prebuilt_components_make_a_payment:process_payment_mobile é usado pelo componente para gerar e enviar um link de pagamento móvel para os detalhes de pagamento selecionados pelo 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 |
| $flow.payee_number | Últimos quatro dígitos do número de conta do beneficiário para o pagamento. | de string |
| $flow.payment_type | Tipo de pagamento do pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por predefinição, este componente suporta "beneficiary_pay" e "credit_card_pay". |
de string |
| $flow.payment_amount | O valor que o utilizador optou por pagar. | número |
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 |
|---|---|---|
| payment_link_generated | Indica se o link de pagamento para dispositivos móveis foi gerado e enviado com êxito ao utilizador. | booleano |
Para configurar o webhook de pagamento para dispositivos móveis de processamento 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_make_a_payment:process_payment_mobile.
- 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.