Componente pré-criado de status do pedido

O status do pedido componente pré-criado verifica o nível de autenticação do cliente e fornece informações sobre a pedidos mais recentes ou anteriores do usuário para um cliente autenticado. Este 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:

  • Este 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 a resposta do agente no início da conversa.

Pedido recente

O usuário final liga de um número não registrado. O agente autentica o usuário e fornece informações detalhadas sobre os envios no pedido. O usuário confirma que gostaria de receber um SMS no número de telefone registrado com mais detalhes.

Entrada do usuário Resposta do agente
O agente autentica o usuário usando o componente pré-criado de autenticação de varejo
Certo, John. Você está ligando sobre o pedido mais recente de João da Silva, que contém uma luminária, uma camisa e outros 10 itens feitos em 10/11/2023 às 18h?
Sim
Seu pedido tem dois envios, que serão entregues até 2024-01-15.

Quer saber mais sobre esses envios?
Sim
O Frete 1, que contém jeans, cinto e outros dois itens, está em trânsito e será entregue até 12/01/2024.

O Frete 2, que contém uma lâmpada, uma camisa e outros seis itens, foi entregue em 12/11/2023.

Você quer receber um SMS com mais detalhes sobre seus itens?
Sim
Enviamos um SMS com um link para acompanhar o status de todos os seus envios. Agradecemos sua ligação.

Pedidos duplicados

O usuário final já foi autenticado anteriormente. O usuário solicita informações sobre um pedido e fornece os últimos cinco dígitos do pedido. O agente identifica vários pedidos feitos por esse usuário compartilham os mesmos últimos cinco dígitos, por isso confirma de qual pedido o usuário gostaria de saber o status e fornece a do pedido ao usuário.

Entrada do usuário Resposta do agente
Ok, Amber. Você está ligando sobre o pedido mais recente de Amber Doe, que contém uma luminária, uma camisa e outros dois itens feitos em 10/11/2023 às 18h?
Não
Poderia informar os últimos cinco dígitos do ID do pedido que você quer rastrear?
12355
Os últimos cinco dígitos do ID do pedido que recebemos são 12355, correto?
Sim, é isso mesmo
Ótimo, já coletamos o código do pedido.
De acordo com nossos registros, encontramos dois pedidos que terminam com os mesmos 5 dígitos e 12355. Qual pedido você está procurando?

O número 1, feito em 2023-11-10 às 18h ou o número 2, feito em 2023-11-09 às 20h?

Para selecionar o pedido número 1, diga 1. Para selecionar o pedido número 2, diga 2. Caso contrário, diga "Não".
Pedir um
Seu pedido tem dois envios, que serão entregues até 2024-01-15.

Quer saber mais sobre esses envios?
Sim
O Frete 1, que contém jeans, está em trânsito e será entregue até 2024-01-15.

O Frete 2, que contém uma lâmpada, uma camisa e mais um item, foi cancelado.

Você quer receber um SMS com mais detalhes sobre seus itens?
Não, só isso.
Agradecemos sua ligação.

Convenções de nomenclatura

Esse componente predefinido usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Fluxo [Component Name] Status do pedido
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_order_status:get_order_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 no fluxo para determinar como o componente vai se comportar. Os parâmetros no escopo do 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 do 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 códigos de pedido associados ao usuário autenticado, classificados por data de posicionamento 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)
$session.params.email (opcional) O e-mail registrado na conta. string
$session.params.user_first_name (opcional) O nome do usuário, usado para cumprimentar e confirmar a propriedade da conta. string
$flow.max_shipment Especifica o número de remessas exibidas ao usuário em um determinado momento. O valor padrão é 2. integer
$flow.tracking_status_deliveryed Especifica o valor retornado pelo webhook indicando um status de pedido entregue. O valor padrão é "delivered". string
$flow.tracking_status_cancelled Especifica o valor retornado pelo webhook indicando um status de pedido cancelado. O valor padrão é "cancelled". string
$flow.tracking_status_returned Especifica o valor retornado pelo webhook indicando um status de devolução do pedido. O valor padrão é "returned". string
$flow.tracking_status_partially_returned Especifica o valor retornado pelo webhook indicando um status do pedido parcialmente retornado. O valor padrão é "partially returned". string
$flow.max_retry_alternate_profile Especifica o número de novas tentativas permitidas ao solicitar o status do pedido de um número de telefone ou perfil alternativo não registrado. O valor padrão é 3. integer
$flow.max_retry_order_number Especifica o número de novas tentativas permitidas ao fornecer um número de pedido. O valor padrão é 3. integer
$flow.max_retry_another_order_id Especifica o número de novas tentativas permitidas após fornecer um número de pedido inválido. O valor padrão é 3. integer

Para configurar os parâmetros de entrada desse componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Build.
  5. Clique no componente importado na seção Fluxos.
  6. Clique na "Página inicial" na seção Páginas.
  7. Clique na rota true na página inicial.
  8. Na janela "Rota", edite os valores das configurações predefinidas de parâmetros conforme necessário.
  9. 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 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 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)
e-mail 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 destes:

agent: o usuário final solicitou um agente humano em algum momento durante a conversa.

denial_of_information: o usuário final recusou-se a compartilhar as 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 Evento integrado webhook.error.

webhook_not_found: um URL de webhook estava inacessível. Consulte Webhook.error.not-found.
string

Configuração básica

Para configurar esse componente pré-criado:

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

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 os serviços externos necessários para autenticação, será necessário fazer isso 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_order_status:get_order_details é usado pelo componente para recuperar detalhes de um pedido específico.

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_status Indica o status do pedido. Exemplos de valores incluem "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". string
order_product_name Lista de nomes de produtos no pedido. Lista (string)
order_product_quantity Contagem total do número de produtos pedidos para cada produto em um pedido. integer
order_product_count O número de produtos exclusivos em um pedido. integer
order_status_notification Indica se as notificações estão ativadas para esse pedido. booleano
return_eligibility_date Lista de datas em que cada produto no pedido estará qualificado para devolução, no formato YYYY-MM-DD. Lista (string)
order_customer_billing_name Nome do cliente para faturamento do pedido. string
order_latest_delivery_date A data de entrega mais recente de todas as datas de entrega estimadas dos envios no pedido, no formato YYYY-MM-DD. string
order_shipment_multiple Indica se o pedido contém vários envios. booleano
order_shipment_count O número de envios no pedido. integer
order_shipment_product_count Contagem total de produtos em cada envio no pedido. Lista (número inteiro)
order_shipment_product_name Lista dos nomes dos produtos em cada envio do pedido. Lista (string)
order_estimated_delivery_date Lista de datas de entrega estimadas para cada frete no pedido, no formato YYYY-MM-DD. Lista (string)
order_shipment_status Lista que indica o status de cada envio no pedido. Exemplos de valores incluem "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". Lista (string)

Para configurar o webhook "Pegar detalhes do pedido" para esse componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_order_status:get_order_details.
  7. 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.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. 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.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Receber pedidos duplicados

O webhook prebuilt_components_retail_services:get_duplicate_order é usado pelo componente para extrair informações detalhadas e distinguir entre pedidos quando vários números de pedidos têm os mesmos cinco últimos 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 com os últimos cinco dígitos dos números de pedidos 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 dessa matriz corresponde ao mesmo elemento na matriz all_order_time. booleano
all_order_time Lista de horários de pedidos para pedidos duplicados com os últimos cinco dígitos especificados no formato HH:MM. Cada elemento nesta matriz corresponde ao mesmo elemento na matriz all_order_date. number

Para configurar o webhook "Receber pedidos duplicados" para este componente, expanda para ver instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_retail_services:get_Duplicate_order.
  7. 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.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. 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.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Enviar SMS

O webhook prebuilt_components_order_status:send_sms é usado pelo componente para enviar detalhes do pedido ao número de telefone especificado usando SMS.

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.order_id ID do pedido para enviar detalhes. string

Para configurar o webhook "Enviar SMS" para esse componente, expanda para ver instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_order_status:send_sms.
  7. 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.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. 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.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Ativar notificações

O webhook prebuilt_components_order_status:enable_notification é usado pelo componente para ativar as notificações do número de telefone registrado de um 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.order_notification Indica se as notificações precisam ser ativadas para o usuário. booleano

Para configurar o webhook "Ativar notificações" para este componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_order_status:enable_notification.
  7. 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.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. 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.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Concluído

Seu agente e os respectivos webhooks devem estar configurados e prontos para teste.