Cancele a encomenda de um componente pré-criado

O componente pré-criado de cancelamento de encomenda verifica o nível de autenticação de um utilizador. Assim que o utilizador for autenticado, o componente fornece informações sobre as encomendas mais recentes ou anteriores do utilizador. Em seguida, o utilizador pode optar por cancelar uma encomenda completa ou cancelar itens específicos numa encomenda. Este componente usa o componente predefinido Autenticação do Retail para autenticar os utilizadores. O componente também usa geradores para o resumo após a chamada.

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.

Cancele um único produto numa encomenda recente

O utilizador final foi autenticado anteriormente. O agente confirma que itens da encomenda mais recente devem ser cancelados. O agente verifica o método de pagamento original e confirma os detalhes do cancelamento com o utilizador.

Introdução do utilizador	Resposta do agente
	Está a ligar relativamente à sua encomenda mais recente com o número que termina em 12978, que contém 5 garrafas de água e 1 t-shirt, feita a 09/11/2023 às 20:00?
sim
	Encontrámos alguns produtos elegíveis na sua encomenda. Indique-nos o produto que quer cancelar. Produto 1: garrafa de água Google, Produto 2: t-shirt Google. Diga ou introduza o número do produto do artigo que quer selecionar ou diga "seguinte" para mostrar mais produtos.
próximo
	Não encontrámos outros itens nos nossos registos. Escolha a partir da lista partilhada. Produto 1: garrafa de água google, Produto 2: t-shirt google. Diga ou introduza o número do produto do artigo que quer selecionar, ou diga "seguinte" para mostrar mais produtos.
1
	Para confirmar que tem interesse em cancelar a garrafa de água da Google. Isto está correto?
sim
	Podemos ver que a quantidade disponível do produto que selecionou é 5. Especifique a quantidade de produtos que quer cancelar.
4
	Especifique o motivo do cancelamento. Pode dizer algo como: mudei de ideias, já não preciso, quero comprar outro artigo, entrega atrasada, comprei por engano, quero alterar o método de pagamento ou dizer outras coisas.
Quero comprar outro artigo
	Agradecemos a sua mensagem acerca desta situação. Quer cancelar outro produto?
não
	Para compras feitas através da sua carteira, os reembolsos são creditados na carteira ou na conta de crédito da loja. O reembolso demora 3 a 5 dias úteis a aparecer na sua conta. Tenha em atenção que o valor do reembolso exclui os encargos de envio e manutenção.

Cancele a totalidade da encomenda

O utilizador final foi autenticado anteriormente. O agente confirma que o utilizador quer cancelar uma encomenda específica e, em seguida, recolhe o motivo do cancelamento. O agente verifica o método de pagamento original e confirma os detalhes do cancelamento com o utilizador.

Introdução do utilizador	Resposta do agente
	Está a ligar sobre a sua encomenda mais recente com o número terminado em 12345, que contém 1 camisa e foi feita a 10/11/2023 às 18:00?
não
	Quer cancelar outra encomenda?
sim
	Pode indicar os últimos 5 dígitos do ID da encomenda que quer acompanhar?
12346
	Os últimos cinco dígitos do ID da encomenda que recebemos são 12346. Está correto?
sim
	Ótimo, terminámos de recolher o ID da encomenda. Quer cancelar toda a encomenda?
sim
	Especifique o motivo do cancelamento. Pode dizer algo como: mudei de ideias, já não preciso, quero comprar outro artigo, entrega atrasada, comprei por engano, quero alterar o método de pagamento ou dizer outras coisas.
já não é necessário
	Agradecemos a sua informação. O seu pedido de cancelamento foi gerado.

Convenções de nomenclatura

Este componente pré-criado usa as seguintes convenções de nomenclatura:

Funcionalidade	Formato	Exemplo
Flow	[Component Name]	Cancelar encomenda
Tipo de 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 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 de início do componente. 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.phone_number	(opcional) Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador.	de string
$session.params.all_recent_order_id	(opcional) Este parâmetro apresenta os IDs das encomendas associados ao utilizador autenticado, ordenados pela data de colocação da encomenda por ordem descendente. O primeiro elemento da matriz representa a encomenda mais recente. Se um utilizador não tiver encomendas, o valor deste parâmetro é null.	Lista (string)
$session.params.email	(opcional) O email registado na conta.	de string
$session.params.user_first_name	(Opcional) Nome próprio do utilizador, usado para o cumprimentar e confirmar a propriedade da conta.	de string

Este componente pré-criado permite que os seguintes parâmetros opcionais configurem o comportamento do componente, incluindo as novas tentativas.

Nome do parâmetro	Descrição	Formato
$flow.max_retry_another_account_counter	Especifica o número de novas tentativas permitidas quando seleciona se quer continuar com uma conta alternativa. O valor predefinido é 2.	número inteiro
$flow.max_retry_order_number	Especifica o número de novas tentativas permitidas quando fornece os últimos cinco dígitos de um número de encomenda. O valor predefinido é 2.	número inteiro
$flow.max_retry_another_order	Especifica o número de novas tentativas permitidas quando seleciona outra encomenda nos casos em que o ID da encomenda não é encontrado ou a encomenda não é elegível para cancelamento. O valor predefinido é 2.	número inteiro
$flow.max_retry_select_order_number	Especifica o número de novas tentativas permitidas quando fornece o número de encomenda completo nos casos em que várias encomendas partilham os mesmos últimos cinco dígitos. O valor predefinido é 2.	número inteiro
$flow.max_product_display_counter	Especifica o número máximo de produtos a apresentar num único turno. O valor predefinido é 2.	número inteiro
$flow.max_product_display	Especifica o número máximo de produtos a apresentar durante toda a conversa. O valor predefinido é 9.	número inteiro
$flow.max_retry_product_number_counter	Especifica o número máximo de novas tentativas permitidas ao selecionar um produto para cancelar. O valor predefinido é 2.	número inteiro
$flow.max_product_cancel_confirm_counter	Especifica o número máximo de novas tentativas permitidas ao confirmar o produto selecionado. O valor predefinido é 2.	número inteiro
$flow.max_retry_select_quantity	Especifica o número máximo de novas tentativas permitidas ao selecionar a quantidade de produtos a cancelar. O valor predefinido é 2.	número inteiro
$flow.order_product_cancel_reason_others	Especifica o valor da entidade prebuilt_components_product_cancel_reason que indica que o utilizador selecionou o motivo de cancelamento "outros". O valor predefinido é "others".	de string
$flow.max_retry_cancel_reason	Especifica o número de novas tentativas permitidas ao confirmar o motivo do cancelamento. O valor predefinido é 2.	número inteiro
$flow.order_payment_mode_COD	Especifica o valor do campo order_payment_mode devolvido pelo get_order_details webhook que indica um método de pagamento à cobrança (COD). O valor predefinido é "COD".	de string
$flow.order_payment_mode_store_credit	Especifica o valor do campo order_payment_mode devolvido pelo get_order_details webhook que indica um método de pagamento de Crédito da Store. O valor predefinido é "store_credit".	de string

Para configurar os parâmetros de entrada deste componente, expanda para ver as instruções.

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Criar.
5. Clique no componente importado na secção Fluxos.
6. Clique na página inicial na secção Páginas.
7. Clique no percurso verdadeiro na página inicial.
8. Na janela Route, edite os valores de Predefinições de parâmetros conforme necessário.
9. 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
phone_number	Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador.	de string
all_recent_order_id	Este parâmetro apresenta os IDs de encomendas associados ao utilizador autenticado, ordenados pela data de colocação da encomenda por ordem descendente. O primeiro elemento da matriz representa a encomenda mais recente. Se um utilizador não tiver encomendas, o valor deste parâmetro é null.	Lista (string)
email	O email registado na conta.	de string
user_first_name	Nome próprio do utilizador, usado para cumprimentar e confirmar a propriedade da conta.	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

Geradores

Este 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 este componente pré-criado:

1. Importe o componente pré-criado.
2. Configure os webhooks flexíveis fornecidos com a configuração que descreve os seus serviços externos. Consulte a configuração do webhook.

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 de retalho para ver instruções detalhadas.

Ver detalhes da encomenda

O webhook prebuilt_components_cancel_order:get_order_details é usado pelo componente para obter detalhes da encomenda para uma encomenda especificada.

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
$flow.order_id	ID da encomenda para obter detalhes.	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
order_date	Data em que a encomenda foi feita, no formato YYYY-MM-DD.	de string
order_time	Hora em que a encomenda foi feita, no formato HH:MM.	de string
order_product_count	O número de produtos únicos numa encomenda.	número inteiro
order_payment_mode	Indica o modo de pagamento usado ao fazer a encomenda.	de string
cancelable_product_id	Lista de IDs dos produtos canceláveis na encomenda.	Lista (string)
cancelable_product_name	Lista de nomes de produtos canceláveis na encomenda.	Lista (string)
cancelable_product_brand_name	Lista de nomes de marcas de produtos canceláveis na encomenda.	Lista (string)
cancelable_product_quantity	Lista de quantidades de produtos canceláveis na encomenda.	Lista (string)

Para configurar o webhook Get order details para este componente, expanda para ver as instruções.

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Gerir.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_cancel_order:get_order_details.
7. 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.
8. Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
9. 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.
10. Reveja e atualize as definições de autenticação, conforme necessário.
11. Clique em Guardar.

Obtenha detalhes de encomendas duplicadas

O webhook prebuilt_components_retail_services:get_duplicate_order_detailsé usado pelo componente para obter informações detalhadas de forma a distinguir entre encomendas quando vários números de encomenda têm os mesmos últimos cinco dígitos.

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
$flow.duplicate_order_id	Lista que contém os últimos cinco dígitos dos números de encomendas partilhados entre uma ou mais encomendas do utilizador.	Lista (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
all_order_date	Lista de datas de encomendas duplicadas 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 horas de encomenda para encomendas duplicadas com os últimos cinco dígitos especificados no formato HH:MM. Cada elemento nesta matriz corresponde ao mesmo elemento na matriz all_order_date.	Lista (string)

Para configurar o webhook Get duplicate order details para este componente, expanda para ver as instruções.

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Gerir.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_retail_services:get_duplicate_order_details.
7. 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.
8. Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
9. 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.
10. Reveja e atualize as definições de autenticação, conforme necessário.
11. Clique em Guardar.

Detalhes após o cancelamento

O webhook prebuilt_components_cancel_order:post_cancellation_details é usado pelo componente para enviar uma solicitação de cancelamento.

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.order_id	ID da encomenda para a qual quer enviar um pedido.	de string
$flow.cancel_product_id_list	Lista de IDs dos produtos que o utilizador quer cancelar.	Lista (string)
$flow.cancel_product_quantity_list	Lista das quantidades de produtos que o utilizador quer cancelar, correspondente a cada elemento em $flow.cancel_product_id_list.	Lista (string)
$flow.cancel_reason_list	Lista de motivos de cancelamento para cada produto cancelado, correspondente a cada elemento em $flow.cancel_product_id_list.	Lista (string)
$flow.order_refund_mode	O modo de pagamento do reembolso. Os valores válidos são definidos pela entidade prebuilt_components_cancel_mode_of_refund.	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
order_cancellation_ticket_id	ID do pedido para o cancelamento enviado.	de string

Para configurar o webhook de detalhes de cancelamento de publicações para este componente, expanda para ver as instruções.

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Gerir.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_cancel_order:post_cancellation_details.
7. 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.
8. Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
9. 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.
10. Reveja e atualize as definições de autenticação, conforme necessário.
11. Clique em Guardar.

Concluído

O seu agente e os respetivos webhooks já devem estar configurados e prontos para teste.