O componente pré-criado de pedido de cancelamento verifica o nível de autenticação de um usuário. Depois que o usuário é autenticado, o componente fornece informações sobre os pedidos mais recentes ou anteriores do usuário. O usuário pode cancelar um pedido inteiro ou itens específicos de um pedido. Ele usa o componente pré-criado autenticação do Retail para autenticar usuários. O componente também usa geradores para o resumo pós-chamada.
Limitações
Além das limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- Este componente não criptografa nenhum dado.
Exemplos de diálogos
As caixas de diálogo de amostra abaixo demonstram cenários comuns processados por esse componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado usando telefonia, que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.
Cancelar um único produto em um pedido recente
O usuário final já foi autenticado anteriormente. O agente confirma quais itens do pedido mais recente precisam ser cancelados. O agente verifica a forma de pagamento original e confirma os detalhes do cancelamento com o usuário.
| Entrada do usuário | Resposta do agente |
|---|---|
| Você está ligando para falar sobre seu pedido mais recente com número 12978, que contém cinco garrafas de água e 1 camiseta feita em 09-11-2023 às 20h? | |
| sim | |
| Encontramos alguns produtos qualificados no seu pedido. Diga qual produto você quer cancelar. Produto 1: garrafa de água do Google, Produto 2: camiseta do Google. Diga ou digite o número do produto que você quer selecionar ou diga "próximo" para mostrar mais produtos. |
|
| próxima | |
| Não encontramos nenhum outro item em nossos registros. Escolha na lista compartilhada. Produto 1: garrafa de água do Google, Produto 2: camiseta do Google. Diga ou digite o número do produto que você quer selecionar ou diga "próximo" para mostrar mais produtos. |
|
| 1 | |
| Para verificar, você quer cancelar a garrafa de água do Google. É isso mesmo? | |
| sim | |
| Podemos ver que a quantidade disponível do produto que você selecionou é 5. Especifique a quantidade de produtos que você quer cancelar. | |
| 4 | |
| Especifique o motivo do cancelamento. Diga algo como: mudei de ideia, não preciso mais, quero comprar outro item, atraso na entrega, comprei por engano, quero mudar a forma de pagamento ou fale sobre outras informações. | |
| Quero comprar outro item | |
| Agradecemos a informação. Quer cancelar outro produto? |
|
| não | |
| Os reembolsos são creditados na carteira ou na conta de crédito da Google Store para compras feitas com ela. O reembolso levará de três a cinco dias úteis para aparecer na sua conta. O valor do reembolso não inclui as cobranças de frete e manuseio. |
Cancelar todo o pedido
O usuário final já foi autenticado anteriormente. O agente confirma que o usuário quer cancelar um pedido específico e, em seguida, coleta o motivo do cancelamento. O agente verifica a forma de pagamento original e confirma os detalhes do cancelamento com o usuário.
| Entrada do usuário | Resposta do agente |
|---|---|
| Você está ligando para falar sobre o número do seu pedido mais recente, 12345, que contém 1 camisa feita em 10/11/2023 às 18h? | |
| não | |
| Quer cancelar outro pedido? | |
| sim | |
| Você poderia informar os últimos cinco dígitos do ID do pedido que gostaria de rastrear? | |
| 12346 | |
| Os últimos cinco dígitos do ID do pedido que recebemos são 12346, correto? | |
| sim | |
| Ótimo, terminamos de coletar o código do pedido. Quer cancelar todo o pedido? |
|
| sim | |
| Especifique o motivo do cancelamento. Diga algo como: mudei de ideia, não preciso mais, quero comprar outro item, atraso na entrega, comprei por engano, quero mudar a forma de pagamento ou fale sobre outras informações. | |
| não preciso mais disso | |
| Agradecemos a informação. Sua solicitação de cancelamento foi gerada. |
Convenções de nomeação
Esse componente pré-criado usa as seguintes convenções de nomenclatura:
| Engenharia de | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | Cancelar pedido |
| Tipo da entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_cancel_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_cancel_order:post_cancellation_details |
Parâmetros de entrada
Os parâmetros de entrada são usados para configurar determinados comportamentos do componente. Os parâmetros sã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 definidos na página inicial do componente. Os parâmetros no escopo da sessão podem ser definidos por um fluxo de chamada ou na página inicial desse componente.
Esse componente pré-criado aceita os seguintes parâmetros de entrada:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $session.params.phone_number | (Opcional) Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| $session.params.all_recent_order_id | (Opcional) Este parâmetro lista os IDs de pedido associados ao usuário autenticado, classificados pela data de posicionamento do pedido em ordem decrescente. O primeiro elemento da matriz representa o pedido mais recente. Se um usuário não tiver pedidos, o valor desse parâmetro será null. |
Lista (string) |
| $session.params.email | (opcional) O e-mail registrado na conta. | string |
| $session.params.user_first_name | (Opcional) Nome do usuário, usado para dar as boas-vindas e confirmar a propriedade da conta. | string |
Esse componente pré-criado permite que os parâmetros opcionais a seguir configurem o comportamento do componente, incluindo novas tentativas.
| Nome do parâmetro | Descrição | Formato |
|---|---|---|
| $flow.max_retry_another_account_counter | Especifica o número de novas tentativas permitidas ao selecionar se você quer continuar com uma conta alternativa. O valor padrão é 2. |
integer |
| $flow.max_retry_order_number | Especifica o número de novas tentativas permitidas ao fornecer os últimos cinco dígitos de um número de pedido. O valor padrão é 2. |
integer |
| $flow.max_retry_another_order | Especifica o número de novas tentativas permitidas ao selecionar outro pedido nos casos em que o ID do pedido não é encontrado ou o pedido não está qualificado para cancelamento. O valor padrão é 2. |
integer |
| $flow.max_retry_select_order_number | Especifica o número de novas tentativas permitidas ao fornecer o número completo do pedido nos casos em que vários pedidos compartilham os mesmos últimos cinco dígitos. O valor padrão é 2. |
integer |
| $flow.max_product_display_counter | Especifica o número máximo de produtos a serem apresentados em uma única rodada. O valor padrão é 2. |
integer |
| $flow.max_product_display | Especifica o número máximo de produtos a serem apresentados durante toda a conversa. O valor padrão é 9. |
integer |
| $flow.max_retry_product_number_counter | Especifica o número máximo de novas tentativas permitidas ao selecionar um produto para cancelar. O valor padrão é 2. |
integer |
| $flow.max_product_cancel_confirm_counter | Especifica o número máximo de novas tentativas permitidas ao confirmar o produto selecionado. O valor padrão é 2. |
integer |
| $flow.max_retry_select_quantity | Especifica o número máximo de tentativas permitidas ao selecionar a quantidade de produto a ser cancelada. O valor padrão é 2. |
integer |
| $flow.order_product_cancel_reason_others | Especifica o valor da entidade prebuilt_components_product_cancel_reason indicando que o usuário selecionou o motivo de cancelamento "outros". O valor padrão é "others". |
string |
| $flow.max_retry_cancel_reason | Especifica o número de novas tentativas permitidas ao confirmar o motivo do cancelamento. O valor padrão é 2. |
integer |
| $flow.order_payment_mode_COD | Especifica o valor do campo order_payment_mode retornado pelo webhook de get_order_details, indicando uma forma de pagamento em dinheiro na entrega (COD, na sigla em inglês). O valor padrão é "COD". |
string |
| $flow.order_payment_mode_store_credit | Especifica o valor do campo order_payment_mode retornado pelo webhook de get_order_details, indicando uma forma de pagamento de crédito da Google Store. O valor padrão é "store_credit". |
string |
Para configurar os parâmetros de entrada desse componente, expanda para conferir as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Build.
- Clique no componente importado na seção Fluxos.
- Clique na página inicial na seção Páginas.
- Clique na rota true na página inicial.
- Na janela "Rota", edite os valores de Presets 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 pré-criado fornece valores para os seguintes parâmetros de saída:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificá-lo. | string |
| all_recent_order_id | Esse parâmetro lista os IDs de pedido associados ao usuário autenticado, classificados pela data de posicionamento do pedido em ordem decrescente. O primeiro elemento da matriz representa o pedido mais recente. Se um usuário não tiver pedidos, o valor desse parâmetro será null. |
Lista (string) |
| O e-mail registrado na conta. | string | |
| user_first_name | Nome do usuário, usado para cumprimentar e confirmar a propriedade da conta. | string |
| transfer_reason | Esse parâmetro indica o motivo da saída do fluxo, se não tiver sido bem-sucedido. O valor retornado é um destes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final se recusou a compartilhar informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de tentativas para eventos sem entrada. Consulte eventos integrados sem entrada.max_no_match: a conversa atingiu o número máximo de 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: não foi possível acessar um URL do webhook. Consulte webhook.error.not-found built-in event. |
string |
Geradores
Esse componente usa Geradores para ativar partes específicas da conversa.
Geração de resumos
O gerador Summarization é usado para gerar um resumo pós-chamada descrevendo
a conversa processada pelo componente.
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure os Webhooks flexíveis fornecidos com a configuração que descreve os serviços externos do Dialogflow. Consulte Configuração do Webhook.
Configuração do webhook
Para usar esse componente, configure os webhooks flexíveis incluídos para recuperar as informações necessárias dos serviços externos.
Autenticação
Se você ainda não tiver configurado serviços externos necessários para autenticação, configure-os para ativar a autenticação de usuários para esse componente. Consulte Configuração do webhook de autenticação do Retail para instruções detalhadas.
Mais detalhes do pedido
O webhook prebuilt_components_cancel_order:get_order_details é usado
pelo componente para recuperar detalhes de um pedido especificado.
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 |
|---|---|---|
| ID do pedido | ID do pedido para o qual recuperar detalhes. | string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| order_date | Data em que o pedido foi feito, no formato YYYY-MM-DD. |
string |
| order_time | Hora em que o pedido foi feito, no formato HH:MM. |
string |
| order_product_count | O número de produtos exclusivos em um pedido. | integer |
| order_payment_mode | Indica a forma de pagamento usada ao fazer o pedido. | string |
| cancelable_product_id | Lista de IDs de produtos para produtos canceláveis no pedido. | Lista (string) |
| cancelable_product_name | Lista de nomes de produtos para produtos canceláveis no pedido. | Lista (string) |
| cancelable_product_brand_name | Lista de nomes de marcas de produtos canceláveis no pedido. | Lista (string) |
| cancelable_product_quantity | Lista de quantidades de produtos canceláveis no pedido. | Lista (string) |
Para configurar o webhook "Ver detalhes do pedido" 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 pré-build_components_cancel_order:get_order_details.
- Substitua o URL no campo URL do webhook do Dialogflow 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 o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Receber detalhes do pedido duplicados
O webhook prebuilt_components_retail_services:get_duplicate_order_details é usado
pelo componente para extrair informações detalhadas e distinguir entre
ordens quando vários números de pedido têm os mesmos últimos cinco dígitos.
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 |
|---|---|---|
| ID do pedido $flow.duplicada | Lista contendo os últimos cinco dígitos dos números de pedido compartilhados entre um ou mais pedidos do usuário. | Lista (string) |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| all_order_date | Lista de datas para pedidos duplicados com os últimos cinco dígitos especificados no formato YYYY-MM-DD. Cada elemento nessa matriz corresponde ao mesmo elemento na matriz all_order_time. |
Lista (string) |
| all_order_time | Lista de horários para pedidos duplicados com os últimos cinco dígitos especificados no formato HH:MM. Cada elemento nessa matriz corresponde ao mesmo elemento na matriz all_order_date. |
Lista (string) |
Para configurar o webhook "Receber detalhes do pedido duplicados" 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_retail_services:get_duplicate_order_details.
- Substitua o URL no campo URL do webhook do Dialogflow 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 o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Detalhes do cancelamento da postagem
O webhook prebuilt_components_cancel_order:post_cancellation_details é usado
pelo componente para enviar uma solicitação de cancelamento.
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, utilizado para identificá-lo. | string |
| ID do pedido | ID do pedido para o qual enviar um tíquete. | string |
| $flow.cancel_product_id_list | Lista de IDs de produtos que o usuário quer cancelar. | Lista (string) |
| $flow.cancel_product_quantity_list | Lista de quantidades de produtos que o usuário quer cancelar, correspondente a cada elemento em $flow.cancel_product_id_list. |
Lista (string) |
| $flow.cancel_reason_list | Lista de motivos de cancelamento de cada produto, correspondente a cada elemento em $flow.cancel_product_id_list. |
Lista (string) |
| $flow.order_refund_mode | A forma de pagamento do reembolso. Os valores válidos são definidos pela entidade prebuilt_components_cancel_mode_of_refund. |
string |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| order_cancellation_ticket_id | ID do tíquete para o cancelamento enviado. | string |
Para configurar o webhook "Detalhes do cancelamento de postagem" 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 pré-build_components_cancel_order:post_removals_details.
- Substitua o URL no campo URL do webhook do Dialogflow 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 o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Completos
Seu agente e os webhooks dele agora precisam estar configurados e prontos para serem testados.