A opção para efetuar um pagamento componente pré-criado autentica o usuário e permite que ele faça um pagamento. Este componente usa uma versão personalizada do Autenticação pré-criado para autenticar titulares de contas e titulares de cartões. O componente também usa os componentes predefinidos Coleção de nome, Coleção de data de validade do cartão de crédito e Coleção de CVV do cartão de crédito para coletar as informações necessárias para fazer pagamentos.
Tipos de pagamento
Esse componente aceita pagamentos de contas de cartão de crédito e contas de beneficiário. Para faturas de cartão de crédito, os usuários podem optar por pagar o valor mínimo, total ou um valor na fatura. O usuário pode fazer pagamentos de sua conta bancária, cartão de débito, crédito ou pagamento com celular.
| Tipo de pagamento | Formas 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 com celular | Valor mínimo, total e personalizado |
| Conta do beneficiário | Conta bancária, cartão de crédito, cartão de débito, pagamento com dispositivo móvel | Valor personalizado |
Limitações
Além da seção limitações comuns de componentes pré-criados, esse componente pré-criado 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 a resposta do agente no início da conversa.
Pagamento da conta do beneficiário
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é um usuário registrado. O usuário indique que gostaria de fazer um pagamento para uma conta de beneficiário e a de segurança coleta as informações necessárias, incluindo o nome do beneficiário, e confirma a o número da conta de serviço. Por fim, o usuário seleciona a opção de fazer um pagamento usando o cartão de débito. Então, o agente coleta o número do cartão de débito, a data de validade, o CVV e confirma o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário com o componente pré-criado do Authentication | |
| Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário existente? | |
| Beneficiário | |
| O agente coleta o nome do beneficiário usando o componente predefinido Coleção de nomes | |
| Obrigado. Coletamos o nome do beneficiário. OK, com base nos nossos registros, temos o número da conta com final 7821. Diga "Sim" para confirmar o número da conta. |
|
| Sim | |
| Confirme o valor que você quer pagar. Por exemplo, se você quiser pagar R$ 100,30, diga 100 ponto 30. | |
| 50 dólares | |
| Quer pagar com conta bancária, cartão de débito, cartão de crédito ou pagamento com dispositivo móvel? | |
| Débito | |
| Informe os quatro últimos dígitos do número do cartão de débito a que você se refere. | |
| 1234 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 1234, correto? | |
| Sim, está correto | |
| O agente coleta a data de validade do cartão de débito usando o componente pré-criado Coleta de data de validade do cartão de crédito | |
| Ótimo, já coletamos a data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente predefinido Coleta de CVV do cartão de crédito | |
| Ótimo, terminamos de coletar o CVV. | |
| Ok, vamos fazer um pagamento de $50 para Jane com o número do cartão de débito com final 1234. Você confirma essa ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você prefere receber o código por telefone ou e-mail? | |
| Por e-mail, por favor | |
| Enviamos um código para o e-mail registrado john.doe@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto efetuamos o pagamento. O pagamento da sua conta de beneficiário foi concluído. |
Pagamento de fatura de cartão de crédito
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é um usuário registrado. O usuário indica que gostaria de fazer um pagamento da fatura do cartão de crédito usando a conta bancária. O agente confirma o valor e os detalhes da forma de pagamento e conclui o pagamento.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente predefinido Authentication | |
| Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário? | |
| Fatura do cartão de crédito | |
| Informe os quatro últimos dígitos do número do cartão de crédito a que você se refere. | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321, certo? | |
| Sim | |
| O valor total devido é de R $300,00 e o pagamento mínimo é de R $20,00. Quer pagar o valor total, mínimo ou qualquer outra quantia? | |
| Valor total | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Conta poupança | |
| Descobrimos que há duas contas associadas ao seu número. Informe os quatro últimos dígitos da conta a que você se refere. | |
| 1001 | |
| Os últimos quatro dígitos do número da conta que obtemos são 1001, correto? | |
| Sim | |
| Ok, vamos fazer um pagamento de $300 para a fatura do seu cartão de crédito com final 4321 e o número da conta termina em 1001. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você prefere receber o código por telefone ou e-mail? | |
| Enviar para meu e-mail | |
| Enviamos um código para o e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Ok. Aguarde alguns segundos enquanto efetuamos o pagamento. O pagamento com seu cartão de crédito foi concluído. |
Limites ou fundos insuficientes
O agente identifica que o usuário não foi autenticado anteriormente e coleta informações para verificar se o usuário é um usuário registrado. O usuário tenta fazer pagamentos da fatura do cartão de crédito usando 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 fim, o usuário opta por fazer um pagamento pelo celular, e o agente envia um link para concluir o pagamento pelo celular.
| Entrada do usuário | Resposta do agente |
|---|---|
| O agente autentica o usuário usando o componente predefinido Authentication | |
| Agradecemos. Sua autenticação foi concluída. | |
| Quer pagar a fatura do cartão de crédito registrado ou fazer um pagamento para uma conta de beneficiário existente? | |
| Cartão de crédito | |
| Informe os quatro últimos dígitos do número do cartão de crédito a que você se refere. | |
| 4321 | |
| Os últimos quatro dígitos do número do cartão de crédito que recebemos são 4321, certo? | |
| Sim | |
| O valor total devido é de R $300,00 e o pagamento mínimo é de R $20,00. Quer pagar o valor total, mínimo ou qualquer outra quantia? | |
| Valor total | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Poupança | |
| Descobrimos que há duas contas associadas ao seu número. Você pode nos informar os últimos quatro dígitos da conta a que você se refere? | |
| 1002 | |
| Os últimos quatro dígitos do número da conta que obtemos são 1002, correto? | |
| Sim | |
| Vamos fazer um pagamento de US$ 300 para a fatura do cartão de crédito com final 4321 e o número da conta com final 1002. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você prefere receber o código por telefone ou e-mail? | |
| Enviamos um código para o e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto efetuamos o pagamento. Não foi possível concluir o pagamento porque faltam fundos na conta. Quer tentar pagar de novo com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com conta bancária, cartão de débito ou pagamento com dispositivo móvel? | |
| Cartão de débito | |
| Informe os quatro últimos dígitos do número do cartão de débito a que você se refere. | |
| 2345 | |
| Os últimos quatro dígitos do número do cartão de débito que recebemos são 2345, certo? | |
| Sim | |
| O agente coleta a data de validade do cartão de débito usando o componente predefinido Coletar a data de validade do cartão de crédito | |
| Ótimo! Concluímos a coleta da data de validade do cartão de débito. | |
| O agente coleta o CVV do cartão de débito usando o componente predefinido Coleta de CVV do cartão de crédito | |
| Ótimo, já coletamos o CVV. | |
| Vamos fazer um pagamento de US$ 300 para a fatura do cartão de crédito com final 4321 e o número do cartão de débito com final 2345. Você confirma esta ação? | |
| Sim | |
| Para continuar, vamos enviar um código. Você prefere receber o código por telefone ou e-mail? | |
| Enviamos um código para o e-mail registrado joao.silva@google.com. Isso pode levar alguns segundos. Você pode confirmar o código? | |
| 123456 | |
| Certo. Aguarde alguns segundos enquanto fazemos o pagamento. Ocorreu uma falha no pagamento porque o limite do cartão de débito foi excedido. Você quer tentar o pagamento com outra forma de pagamento? |
|
| Sim | |
| Você quer pagar com sua conta bancária, cartão de débito ou pagamento por celular? | |
| Dispositivo móvel | |
| Vamos enviar o link de pagamento para o número de celular registrado. Essa ação pode levar alguns segundos. Confirme dizendo "sim", caso tenha recebido. | |
| Sim | |
| Ótimo, agora você pode abrir o link e continuar o pagamento. |
Convenções de nomenclatura
Esse componente predefinido usa as seguintes convenções de nomenclatura:
| Recurso | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | Fazer um pagamento |
| Intent específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| Tipo da 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
Parâmetros de entrada são parâmetros usados para configurar certos comportamentos de 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 com escopo de fluxo precisam ser definido na página inicial do componente, conforme descrito abaixo. No escopo da sessão podem ser definidos por um fluxo de chamada ou no início página desse 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 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 histórico de transações. Esse valor é configurado nas predefinições de parâmetros do fulfillment de entrada de 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 deve ser autenticado como proprietário de uma conta, conforme descrito em Tipos de autenticação. Esse valor é configurado nas predefinições de parâmetros do fulfillment de entrada de 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 de página na check auth level página. Por padrão, esse valor é false. |
booleano |
| $session.params.phone_number | (opcional) Número de telefone registrado do cliente usado para autenticação. | string |
| $flow.payment_success_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment, indicando que o pagamento foi bem-sucedido. Por padrão, esse
valor é "200". |
string |
| $flow.insufficient_fund_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment, indicando que não foi possível concluir o pagamento devido a fundos insuficientes. Por padrão, esse
valor é "400". |
string |
| $flow.limit_exceed_code | Especifica o valor do campo payment_status_code retornado pelos webhooks process_payment, indicando que não foi possível concluir o pagamento devido ao limite diário ter sido excedido. Por padrão, esse
valor é "401". |
string |
| $flow.max_retry_mop_counter | Especifica o número de vezes que um usuário pode mudar o método de pagamento. O valor padrão é 2. |
integer |
| $flow.max_retry_credit_card_payment | Especifica o número de novas tentativas permitidas ao tentar efetuar um pagamento usando um cartão de crédito como forma de pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_mobile_payment_counter | Especifica o número de novas tentativas permitidas ao tentar efetuar um pagamento usando o pagamento com dispositivo móvel. O valor padrão é 2. |
integer |
| $flow.max_retry_creditcard_count | Especifica o número de novas tentativas permitidas ao coletar um número de cartão de crédito válido para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_acc_number | Especifica o número de novas tentativas permitidas ao coletar detalhes de conta válidos para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_debit_card_details | Especifica o número de novas tentativas permitidas ao coletar detalhes válidos do cartão de débito para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.max_retry_credit_card_details | Especifica o número de novas tentativas permitidas ao coletar detalhes de cartão de crédito válidos para fazer um pagamento. O valor padrão é 3. |
integer |
| $flow.otp_length | Especifica o tamanho esperado da senha única enviada ao usuário. O valor padrão é 6. |
integer |
| $flow.max_retry_otp_count | Especifica o número de novas tentativas permitidas ao coletar uma senha única (OTP) válida do usuário. O valor padrão é 3. |
integer |
| $flow.max_waiting_room_counter | Especifica o número de vezes que o usuário pode pedir para o agente esperar enquanto recebe o link para pagamento por dispositivo móvel. O valor padrão é 2. |
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 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 |
|---|---|---|
| auth_level | Indica o nível de autenticação do autor da chamada. | integer |
| phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| transfer_reason | Esse parâmetro indica o motivo da saída do fluxo, caso não tenha sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final recusou o compartilhamento de 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 de webhook não pode ser acessado. Consulte evento integrado 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 com que descreva os serviços externos, consulte Webhook configuração abaixo.
Configuração do webhook
Para usar este componente, você precisa configurar o webhooks flexíveis para recuperar informações necessárias dos serviços externos.
Autenticação
Se você não configurou os serviços externos necessários para você precisará configurá-los para ativar a autenticação de usuários para esse componente. Consulte Configuração do webhook de autenticação. para ver instruções detalhadas.
Validar conta
O webhook prebuilt_components_account_services:validate_account é usado
pelo componente para verificar se existe uma conta com base nas informações
número de telefone registrado e os últimos quatro dígitos do número da conta fornecido.
O webhook também retorna o saldo da conta, se ela existir.
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 |
| $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 efetuar um pagamento. | 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_found | Indica se uma conta com os últimos quatro dígitos fornecidos existe para a conta registrada do usuário. | booleano |
| saldo | O valor do saldo atual da conta, se houver. | number |
Para configurar o webhook da conta "Validar a conta" para este componente, expanda para conferir 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 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Detalhes do card de usuário
O webhook prebuilt_components_make_a_payment:user_card_details é usado
pelo componente para receber detalhes dos cartões de débito e crédito de um usuário registrado.
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 |
|---|---|---|
| credit_card_count | Número de cartões de crédito associados ao número de telefone registrado. | integer |
| last_four_digit_of_credit_card_number | Últimos quatro dígitos do cartão de crédito do usuário. Se o cliente tiver vários cartões de crédito, esse valor será null. |
string |
| debit_card_count | Número de cartões de débito associados ao número de telefone registrado. | integer |
| last_four_digit_of_debit_card_number | Últimos quatro dígitos do cartão de débito do usuário. Se o cliente tiver vários cartões de débito, esse valor será null. |
string |
Para configurar o webhook de detalhes do cartão do usuário 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_make_a_payment:user_card_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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Verificar o nome do beneficiário
O webhook prebuilt_components_make_a_payment:verify_beneficiary_name é usado
pelo componente para verificar se uma conta de beneficiário existe para o nome
fornecido pelo 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 |
| $session.params.name_collection_first_name | Nome do beneficiário. | string |
| $session.params.name_collection_last_name | Sobrenome do beneficiário. | string |
| $session.params.name_collection_middle_name | Nome do meio do beneficiá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 |
|---|---|---|
| beneficiary_account_number | Os últimos quatro dígitos do número da conta do beneficiário fornecido no nome do beneficiário. Se não for encontrada uma conta de beneficiário para o nome fornecido, o valor será null. |
string |
Para configurar o webhook de verificação do nome do beneficiário 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_make_a_payment:verify_beneficiary_name.
- 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber valor devido
O webhook prebuilt_components_make_a_payment:get_due_amount é usado
pelo componente para receber informações sobre o valor mínimo e total devido para
a fatura do cartã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 |
|---|---|---|
| $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.user_credit_card_number | Últimos quatro dígitos do cartão de crédito do 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 |
|---|---|---|
| minimum_amount | Valor mínimo devido para a fatura do cartão de crédito especificada. | number |
| total_amount | Valor total devido para a fatura do cartão de crédito especificada. | number |
Para configurar o webhook "Receber valor devido" para esse componente, expanda para conferir 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_make_a_payment:get_due_amount.
- 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Verificar 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á registrado
à conta 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 |
|---|---|---|
| $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.user_credit_card_number | Últimos quatro dígitos do cartão de crédito do 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_found | Indica se o cartão de crédito fornecido foi encontrado. | booleano |
Para configurar o webhook de verificação do número do cartão de crédito 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_make_a_payment:verify_credit_card_number.
- Substitua o URL no campo Webhook URL dos Agentes de conversa (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 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Verificar os detalhes do cartão de crédito
O webhook prebuilt_components_make_a_payment:verify_credit_card_details é usado
para verificar se os detalhes fornecidos, incluindo a data de validade
e o CSC são válidos para o cartão de crédito informado.
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.credit_card_number | Últimos quatro dígitos do cartão de crédito do usuário. | string |
| $flow.credit_card_exp_date | A data de validade informada pelo usuário para o cartão de crédito específico. | { |
| $flow.credit_card_cvv_code | Código de segurança do cartão (CSC) fornecido pelo usuário para o cartão de crédito especificado. | 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 |
|---|---|---|
| creditcard_verification_status | Indica se os detalhes do cartão de crédito fornecidos foram validados. | booleano |
Para configurar o webhook "Verificar detalhes do cartão de crédito" para este componente, expanda para ver 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_make_a_payment:verify_credit_card_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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Verificar 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 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.debit_card_number | Últimos quatro dígitos do cartão de débito do usuário. | string |
| $flow.debit_card_exp_date | A data de validade do cartão de débito especificado pelo usuário. | { |
| $flow.debit_card_cvv_code | Código de segurança do cartão (CSC) fornecido pelo usuário para o cartão de débito especificado. | 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 |
|---|---|---|
| debitcard_verification_status | Indica se os detalhes do cartão de débito fornecido foram validados. | booleano |
Para configurar o webhook "Verificar detalhes do cartão de débito" para este componente, expanda para ver 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_make_a_payment:verify_debit_card_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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar 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 usando os detalhes do cartão de crédito fornecidos.
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.payee_number | Últimos quatro dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.credit_card_number | Últimos quatro dígitos do cartão de crédito do usuário. | string |
| $flow.credit_card_exp_date | Data de validade do cartão de crédito fornecida pelo usuário para o cartão de crédito especificado. | { |
| $flow.credit_card_cvv_code | Código de segurança do cartão (CSC) fornecido pelo usuário para o cartão de crédito especificado. | string |
| $flow.payment_amount | O valor que o usuário optou por pagar. | number |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook "Processar pagamentos com cartão de crédito" para este componente, expanda para ver 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_make_a_payment:process_payment_credit_card.
- Substitua o URL no campo Webhook URL dos Agentes de conversa (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 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar pagamentos com cartão de débito
O webhook prebuilt_components_make_a_payment:process_payment_debit_card é usado
pelo componente para processar um pagamento usando os detalhes do cartão de débito fornecidos.
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.payee_number | Últimos quatro dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.debit_card_number | Últimos quatro dígitos do cartão de débito do usuário. | string |
| $flow.debit_card_exp_date | A data de validade do cartão de débito especificado pelo usuário. | { |
| $flow.debit_card_cvv_code | Código de segurança do cartão (CSC) fornecido pelo usuário para o cartão de débito especificado. | string |
| $flow.payment_amount | O valor que o usuário optou por pagar. | number |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi bem-sucedido. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook "Processar pagamentos com cartão de débito" para este componente, expanda para ver 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_make_a_payment:process_payment_payment_card.
- Substitua o URL no campo Webhook URL dos Agentes de conversa (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 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar o pagamento da conta
O webhook prebuilt_components_make_a_payment:process_payment_account
é usado pelo componente para processar um pagamento usando os detalhes da conta fornecidos.
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.payee_number | Últimos quatro dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $session.params.last_four_digit_of_account_number | Últimos quatro dígitos da conta do usuário. | string |
| $flow.payment_amount | O valor que o usuário optou por pagar. | number |
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 |
|---|---|---|
| payment_status_code | Indica se o pagamento foi concluído. Os valores válidos são definidos pelos parâmetros de entrada configuráveis $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code. |
string |
Para configurar o webhook de pagamento da conta de processamento 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_make_a_payment:process_payment_account.
- 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Processar pagamento com dispositivo móvel
O webhook prebuilt_components_make_a_payment:process_payment_mobile
é usado pelo componente para gerar e enviar um link de pagamento para dispositivos móveis para os
detalhes de pagamento selecionados pelo 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.payee_number | Últimos quatro dígitos do número da conta do beneficiário para o pagamento. | string |
| $flow.payment_type | Tipo de pagamento. Os valores válidos são definidos pela entidade personalizada prebuilt_components_make_a_payment_payment_type. Por padrão, esse componente oferece suporte a "beneficiary_pay" e "credit_card_pay". |
string |
| $flow.payment_amount | O valor que o usuário optou por pagar. | number |
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 |
|---|---|---|
| payment_link_generated | Indica se o link de pagamento para dispositivos móveis foi gerado e enviado ao usuário. | booleano |
Para configurar o webhook "Processar pagamento para dispositivos móveis" para este componente, expanda para ver 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_make_a_payment:process_payment_mobile.
- 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.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Concluído
Seu agente e os respectivos webhooks devem estar configurados e prontos para teste.