O componente predefinido de cancelamento de pedidos verifica o nível de autenticação de um usuário. Depois da autenticação do usuário, o O componente fornece informações sobre os pedidos mais recentes ou anteriores do usuário. O o usuário pode, então, optar por cancelar um pedido inteiro ou cancelar itens específicos de uma ordem. Esse componente usa o Autenticação do varejo pré-criado para autenticar usuários. O componente também usa Geradores para resumo pós-chamada.
Limitações
Além das limitações comuns de componentes predefinidos, este componente predefinido tem as seguintes limitações:
- Esse componente não criptografa dados.
Exemplos de diálogos
Os exemplos de caixas de diálogo a seguir demonstram cenários comuns tratados por este um componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado usando telefonia, o que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.
Cancelar um único produto no pedido recente
O usuário final foi autenticado anteriormente. O agente confirma quais itens do pedido mais recente devem ser cancelados. O agente verifica o método 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 de pedido mais recente terminado em 12978, que contém cinco garrafas de água e uma camiseta feita em 09/11/2023 às 20h? | |
| sim | |
| Encontramos alguns produtos qualificados no seu pedido. Informe 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óxima" 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 insira o número do produto do item que você quer selecionar ou diga "próximo" para mostrar mais produtos. |
|
| 1 | |
| Para confirmar, você quer cancelar a garrafa de água do Google. É isso mesmo? | |
| sim | |
| A quantidade disponível do produto selecionado é 5. Especifique a quantidade de produtos que você quer cancelar. | |
| 4 | |
| Especifique o motivo do cancelamento. Você pode dizer algo como: mudou de ideia, não preciso mais, gostaria de comprar outro item, atrasou a entrega, comprei por engano, quero mudar a forma de pagamento ou diga outras pessoas. | |
| Quero comprar outro item | |
| Agradecemos o aviso. Quer cancelar outro produto? |
|
| não | |
| Para compras feitas com a Carteira, os reembolsos são creditados na carteira ou na conta de crédito da Google Store. O reembolso levará de três a cinco dias úteis para aparecer na sua conta. O valor do reembolso não inclui as taxas de frete e manuseio. |
Cancelar todo o pedido
O usuário final foi autenticado anteriormente. O agente confirma que o usuário deseja cancelar um pedido específico e depois coleta o motivo do cancelamento. O o agente verifica a forma de pagamento original e confirma o cancelamento detalhes com o usuário.
| Entrada do usuário | Resposta do agente |
|---|---|
| Você está ligando para falar sobre o número de pedido mais recente terminado em 12345 com 1 camisa feita em 10/11/2023 às 18h? | |
| não | |
| Gostaria de cancelar outro pedido? | |
| sim | |
| Poderia informar os últimos cinco dígitos do código do pedido que você quer rastrear? | |
| 12346 | |
| Os últimos cinco dígitos do código do pedido que recebemos são 12346, certo? | |
| sim | |
| Ótimo, já coletamos o código do pedido. Você quer cancelar o pedido inteiro? |
|
| sim | |
| Especifique o motivo do cancelamento. Você pode dizer algo como: "Mudei de ideia", "Não preciso mais", "Quero comprar outro item", "Entrega atrasada", "Comprei por engano", "Quero mudar a forma de pagamento" ou outras opções. | |
| não é mais necessário | |
| Agradecemos por nos informar. Sua solicitação de cancelamento foi gerada. |
Convenções de nomenclatura
Esse componente predefinido usa as seguintes convenções de nomenclatura:
| Recurso | 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
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 dentro do para determinar como o componente deve se comportar. Os parâmetros com escopo de fluxo precisam ser definido na página inicial do componente. 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.phone_number | (opcional) Número de telefone local do usuário, sem o código do país, usado para identificar o usuário. | string |
| $session.params.all_recent_order_id | (opcional) Este parâmetro lista os IDs de pedidos associados ao usuário autenticado, classificados em ordem decrescente pela data de realização do pedido. O primeiro elemento da matriz representa a ordem 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 saudar e confirmar a propriedade da conta. | string |
Esse componente pré-criado permite que os seguintes parâmetros opcionais 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 informar 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 se 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 cancelamento. 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 novas tentativas permitidas ao selecionar a quantidade de produtos a serem cancelados. 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 "outros". motivo do cancelamento. 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 get_order_details, indicando uma forma de pagamento 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 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 deste 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 de sessão que permanecerão ativos depois de sair. do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado fornece valores para a saída a seguir parâmetros:
| 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 identificar o usuário. | string |
| all_recent_order_id | Esse parâmetro lista os códigos de pedido associados ao usuário autenticado, classificados por data de veiculação do pedido em ordem decrescente. O primeiro elemento da matriz representa a ordem 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 | O 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, 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. Confira 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 estava inacessível. Consulte Webhook.error.not-found. |
string |
Geradores
Esse componente usa Geradores para ativar partes específicas da conversa.
Resumo
O gerador Summarization é usado para gerar um resumo pós-chamada que descreve
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 com que descreva os serviços externos, consulte Webhook configuração da infraestrutura.
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 tiver configurado anteriormente 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 de varejo. para ver instruções detalhadas.
Confira detalhes dos pedidos
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 |
|---|---|---|
| $flow.order_id | ID do pedido para o qual os detalhes serão recuperados. | 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 |
|---|---|---|
| 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 únicos em um pedido. | integer |
| order_payment_mode | Indica o modo de pagamento usado ao realizar o pedido. | string |
| cancelable_product_id | Lista de IDs dos produtos que podem ser cancelados 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 para produtos canceláveis no pedido. | Lista (string) |
| cancelable_product_quantity | Lista de quantidades para produtos canceláveis do 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 prebuilt_components_cancel_order:get_order_details.
- Substitua o URL no campo URL do webhook do 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, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Conferir detalhes de pedidos duplicados
O webhook prebuilt_components_retail_services:get_duplicate_order_details é usado
pelo componente para recuperar informações detalhadas a fim de distinguir entre
pedidos 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 |
|---|---|---|
| $flow.duplicate_order_id | 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 para serem usados pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| all_order_date | Lista de datas de pedidos duplicados com os últimos cinco dígitos especificados no formato YYYY-MM-DD. Cada elemento nesta 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 dessa matriz corresponde ao mesmo elemento na matriz all_order_date. |
Lista (string) |
Para configurar o webhook "Acessar detalhes do pedido duplicado" para este 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 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 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, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 identificar o usuário. | string |
| $flow.order_id | 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, correspondentes a cada elemento em $flow.cancel_product_id_list. |
Lista (string) |
| $flow.cancel_reason_list | Lista de motivos para cada produto cancelado, correspondente a cada elemento em $flow.cancel_product_id_list. |
Lista (string) |
| $flow.order_refund_mode | A forma de pagamento para 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 para serem usados 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 de detalhes após o cancelamento deste 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_cancel_order:post_cancellation_details.
- Substitua o URL no campo URL do webhook do 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, pois eles são exigidos pelo componente para acessar 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.