O componente pré-criado de troca de pedidos 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 trocar vários artigos numa encomenda e selecionar opções, incluindo métodos de reembolso e envio. Este componente usa o componente predefinido Autenticação do Retail para autenticar os utilizadores. O componente também usa geradores para resumos e Perguntas frequentes 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.
Troca em loja de artigo com defeito
O utilizador final foi autenticado anteriormente. O agente confirma que artigos da encomenda mais recente devem ser trocados e recolhe o motivo da troca. O utilizador seleciona a opção de trocar os artigos numa loja e o agente fornece uma lista das lojas mais próximas. O utilizador seleciona uma loja e o agente gera uma etiqueta de envio que é enviada para os canais registados do utilizador.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Está a ligar relativamente à sua encomenda mais recente com o número terminado em 12375, que contém 2 lâmpadas, 2 Pixels e 10 outros produtos, feita a 10/11/2023? | |
| sim | |
| Encontrámos alguns produtos elegíveis na sua encomenda. Indique-nos o produto que quer trocar. Produto 1: lâmpada Google, produto 2: Google Pixel, produto 3: luz LED Google. Diga ou introduza o número do produto do artigo que quer selecionar ou diga seguinte para mostrar mais produtos. |
|
| 1 | |
| Para confirmar, tem interesse em trocar a lâmpada Google. Isto está correto? | |
| sim | |
| Podemos ver que a quantidade disponível do produto que selecionou é 2. Especifique a quantidade de produtos que quer trocar. | |
| Dois | |
| Especifique o motivo da troca. Pode dizer algo como: o artigo está defeituoso ou não funciona, o tamanho ou o ajuste não é adequado, a encomenda está incompleta, o estilo não é o correto, a cor está incorreta ou dizer outra coisa. | |
| Artigo defeituoso | |
| Obrigado por nos informar. Como último passo, como quer trocar o produto? Pode dizer algo como: Trocar numa loja ou Agendar recolha. |
|
| Quero fazer uma troca numa loja | |
| Vamos encontrar uma loja perto de si. | |
| O agente recolhe o código postal através do componente pré-criado Recolha de código postal | |
| Segue-se a lista de localizações perto do código postal que introduziu. Morada 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, EUA. Morada 2: Google California, 19510 Jamboree Road, Irvine, California 92612, EUA. Diga ou introduza o número da morada que quer selecionar, ou diga "seguinte" para mostrar mais moradas de lojas. |
|
| A primeira loja | |
| Para confirmar, selecionou Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, EUA. Está correto? | |
| sim | |
| Perfeito. Enviámos uma etiqueta de envio e um número do pedido para o seu número de telefone e email registados. Imprima-o, coloque-o na embalagem e entregue a troca no prazo de 30 dias. Após a receção do artigo no nosso armazém, a troca, se aplicável, é apresentada na sua conta no prazo de 3 a 5 dias úteis. Nota: o valor do reembolso exclui os custos de envio e processamento. O produto de troca tem um valor superior. A diferença de preço é de 20$. Vai receber o link de pagamento em breve no seu número de telemóvel registado. Faça o pagamento no prazo de 24 horas para efetuar a troca. Quer trocar outra encomenda? |
|
| não, é isso | |
| Obrigado por ligar. |
Reembolso pela diferença de preço
O utilizador final foi autenticado anteriormente. O agente recolhe o número da encomenda, o produto a ser trocado e o motivo da troca. O utilizador opta por trocar os artigos por um tamanho diferente e agenda uma recolha. O agente identifica que o artigo trocado tem um preço inferior ao do novo artigo e confirma com o utilizador o método de pagamento para um reembolso.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Está a ligar sobre a sua encomenda mais recente com o número que termina em 12345 e que contém 2 lâmpadas feitas a 10/11/2023? | |
| Não | |
| Quer trocar outra encomenda? | |
| Sim | |
| Pode indicar os últimos 5 dígitos do ID da encomenda que quer trocar? | |
| 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. Encontrámos alguns produtos elegíveis na sua encomenda. Indique-nos o produto que quer trocar. 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. |
|
| Dois | |
| Para validar que tem interesse em trocar a t-shirt da Google. Isto está correto? | |
| Sim | |
| Especifique o motivo da troca. Pode dizer algo como: o artigo está defeituoso ou não funciona, o tamanho ou o ajuste não é adequado, a encomenda está incompleta, o estilo não é o correto, a cor está incorreta ou dizer outra coisa. | |
| Problema de tamanho ou encaixe | |
| Agradecemos que nos indique o motivo da troca. Pode indicar-nos o tamanho pelo qual quer trocar? Temos os seguintes tamanhos disponíveis: diga 1 para pequeno. Diga 2 para médio. Diga 3 para grande. Diga 4 para muito grande. Diga 5 para muito, muito grande. |
|
| 1 | |
| Como último passo, como quer trocar o produto? Pode dizer algo como: Trocar numa loja ou Agendar recolha. | |
| Agende a recolha | |
| Perfeito. Enviámos uma etiqueta de envio para o seu número de telefone e email registados. Imprima-o e anexe-o ao pacote. A nossa equipa vai entrar em contacto consigo nas próximas 24 a 48 horas para agendar um levantamento. Assim que recebermos o artigo no nosso armazém, o reembolso da troca demora entre 3 e 5 dias úteis a aparecer na sua conta. O produto trocado tem um valor inferior e é elegível para um reembolso de 5 €. Informe-nos onde quer receber o reembolso. Pode dizer algo como crédito da loja ou conta de origem. |
|
| Crédito da Store | |
| Agradecemos a confirmação de que quer que o reembolso seja devolvido à carteira. Quer trocar outra encomenda? |
|
| não | |
| Obrigado por ligar. |
Encomenda não elegível
O utilizador final foi autenticado anteriormente. O agente verifica a encomenda mais recente e não encontra produtos elegíveis para troca. O agente recolhe um número de encomenda do utilizador e verifica que a encomenda fornecida não tem produtos elegíveis.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Não encontrámos produtos na sua encomenda mais recente elegíveis para troca. Quer trocar outra encomenda? |
|
| sim | |
| Pode indicar os últimos 5 dígitos do ID da encomenda que quer trocar? | |
| 23487 | |
| Os últimos cinco dígitos do ID da encomenda que recebemos são 23487. Está correto? | |
| sim | |
| Ótimo, terminámos a recolha do ID da encomenda. | |
| Lamentamos, mas não existem produtos na sua encomenda elegíveis para troca com base nas nossas políticas. Pode encontrar mais informações sobre a nossa política de troca no nosso Website. Quer trocar outra encomenda? |
|
| não | |
| Obrigado por ligar. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Estado da encomenda |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_exchange_order_location |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_exchange_order:get_product_exchange_availability |
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 | Especifica o número de novas tentativas permitidas quando seleciona se quer continuar com uma conta alternativa. O valor predefinido é 3. |
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 é 3. |
número inteiro |
| $flow.max_retry_another_order | Especifica o número de novas tentativas permitidas quando seleciona outra encomenda para devolução nos casos em que o ID da encomenda não é encontrado ou a encomenda não é elegível para a troca. 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 da encomenda completo nos casos em que mais do que uma encomenda partilha os mesmos últimos cinco dígitos. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_exchange_reason | Especifica o número de novas tentativas permitidas quando fornece o motivo da troca. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_exchange_reason_counter | Especifica o número de novas tentativas permitidas ao confirmar o motivo da troca. O valor predefinido é 2. |
número inteiro |
| $flow.order_product_exchange_reason_others | Especifica o valor da entidade prebuilt_components_exchange_order_reason que indica que o utilizador selecionou o motivo de troca "outros". O valor predefinido é "others". |
de string |
| $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_product_exchange_confirm | 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_product_number_counter | Especifica o número máximo de novas tentativas permitidas ao selecionar um produto para troca. O valor predefinido é 3. |
número inteiro |
| $flow.max_retry_select_quantity | Especifica o número máximo de novas tentativas permitidas ao selecionar a quantidade de produto a trocar. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_size_number_counter | Especifica o número máximo de novas tentativas permitidas ao selecionar o tamanho a trocar. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_another_zip_code | Especifica o número máximo de novas tentativas permitidas quando fornece um código postal. O valor predefinido é 2. |
número inteiro |
| $flow.max_store_display_counter | Especifica o número máximo de lojas a apresentar num único turno. O valor predefinido é 1. |
número inteiro |
| $flow.max_store_display | Especifica o número máximo de lojas a apresentar durante toda a conversa. O valor predefinido é 10. |
número inteiro |
| $flow.max_retry_store_number_counter | Especifica o número máximo de novas tentativas permitidas ao selecionar uma loja. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_store_selection | Especifica o número de novas tentativas permitidas ao confirmar a seleção da loja. O valor predefinido é 3. |
número inteiro |
| $flow.max_available_address_reselection_counter | Especifica o número de novas tentativas permitidas ao confirmar se o utilizador quer selecionar uma morada da loja diferente. 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 |
| $flow.order_refund_mode_source_account | Especifica o valor da entidade prebuilt_components_exchange_order_refund_mode que indica que o utilizador selecionou o reembolso para a respetiva conta de origem. O valor predefinido é source_account. |
de string |
| $flow.order_exchange_location_scheduled_for_pickup | Especifica o valor da entidade prebuilt_components_exchange_order_location que indica que o utilizador selecionou agendar uma recolha para a troca. O valor predefinido é scheduled_for_pickup. |
de string |
Para configurar os parâmetros de entrada deste componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Criar.
- Clique no componente importado na secção Fluxos.
- Clique na página inicial na secção Páginas.
- Clique no percurso verdadeiro na página inicial.
- Na janela Route, edite os valores de Predefinições de parâmetros conforme necessário.
- 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) |
| 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.
Perguntas frequentes
O gerador FAQ é usado para processar perguntas frequentes sobre devoluções e trocas, incluindo:
- Existe um prazo para o processo de devolução?
- Posso trocar um artigo de presente?
- O preço do produto e o valor do reembolso são diferentes. Porquê?
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:
- Importe o componente pré-criado.
- 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_exchange_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_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 |
| exchangeable_product_id | Lista de IDs dos produtos para troca na encomenda. | Lista (string) |
| exchangeable_product_name | Lista de nomes de produtos para produtos substituíveis na encomenda. | Lista (string) |
| exchangeable_product_brand_name | Lista de nomes de marcas de produtos substituíveis na encomenda. | Lista (string) |
| exchangeable_product_quantity | Lista de quantidades de produtos trocáveis na encomenda. | Lista (string) |
| exchangeable_product_price | Lista de preços dos produtos trocáveis na encomenda. | Lista (string) |
Para configurar o webhook Get order details para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:get_order_details.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- 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.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_retail_services:get_duplicate_order_details.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha o tamanho de troca disponível
O webhook prebuilt_components_exchange_order:get_available_exchange_size é usado pelo componente para obter os tamanhos disponíveis para troca nos casos em que o utilizador quer trocar um artigo devido a problemas de tamanho ou ajuste.
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.selected_order_product_id | ID do produto que o utilizador quer trocar. | 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 |
|---|---|---|
| product_available_sizes | Lista de tamanhos disponíveis para o produto selecionado. | Lista (string) |
Para configurar o webhook Get available exchange size para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:get_available_exchange_size.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha a disponibilidade de troca de produtos
O webhook é usado pelo componente para verificar se o produto, a quantidade e o tamanho opcional selecionados pelo utilizador estão disponíveis para troca.prebuilt_components_exchange_order:get_product_exchange_availability
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 |
| $flow.selected_order_product_id | ID do produto que o utilizador quer trocar. | de string |
| $flow.order_product_quantity_exchange_count | Quantidade do produto que o utilizador quer trocar. | número inteiro |
| $flow.product_selected_size | Tamanho do produto pelo qual o utilizador quer trocar. | 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 |
|---|---|---|
| product_exchange_availability | Indica se o produto, a quantidade e o tamanho selecionados estão disponíveis para troca. | booleano |
| product_exchange_price | Indica o preço de troca de um único artigo do produto e tamanho selecionados. | número |
Para configurar o webhook Get product exchange availability para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:get_product_exchange_availability.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Crie um pedido de encomenda incompleta
O webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket é usado pelo componente para criar um pedido quando o utilizador quer trocar um produto numa encomenda por estar incompleto.
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.selected_order_product_id | ID do produto que o utilizador quer trocar. | de string |
| $flow.order_product_quantity_exchange_count | Quantidade do produto que o utilizador quer trocar. | número inteiro |
| $flow.order_product_exchange_reason | O motivo pelo qual o utilizador quer trocar o produto. | de string |
Para configurar o webhook de pedido de ordem incompleta para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha detalhes da loja
O webhook prebuilt_components_exchange_order:get_store_details é usado pelo componente para obter a lista de lojas perto do código postal fornecido pelo utilizador.
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.zip_code | Código postal para pesquisar lojas nas proximidades. | 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 |
|---|---|---|
| store_id | Lista de IDs das lojas. | Lista (string) |
| store_address | Lista de moradas de lojas correspondentes a cada elemento de store_id. |
Lista (string) |
Para configurar o webhook Get store details para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:get_store_details.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Detalhes da troca de publicações
O webhook prebuilt_components_exchange_order:post_exchange_details é usado pelo componente para enviar uma troca.
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.selected_order_product_id | ID do produto que o utilizador quer trocar. | de string |
| $flow.order_product_quantity_exchange_count | Quantidade do produto que o utilizador quer trocar. | número inteiro |
| $flow.product_selected_size | Tamanho do produto pelo qual o utilizador quer trocar. | de string |
| $flow.order_product_exchange_reason | O motivo pelo qual o utilizador quer trocar o produto. | de string |
| $flow.order_exchange_location | O modo selecionado para a troca. Os valores válidos são definidos pela entidade prebuilt_components_exchange_order_location. |
de string |
| $flow.order_exchange_store_id | O ID da loja selecionada pelo utilizador para uma troca de loja. | de string |
| $flow.order_refund_mode | O modo de pagamento para o reembolso, se aplicável. Os valores válidos são definidos pela entidade prebuilt_components_exchange_order_refund_mode. Se não for necessário um reembolso, este valor é null. |
de string |
| $flow.total_refund_amount | O valor a reembolsar, se o preço do produto substituível for superior ao do novo produto. Se não for necessário um reembolso, este valor é null. |
número inteiro |
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_exchange_ticket_id | ID do pedido para a troca enviada. | de string |
Para configurar o webhook de detalhes de postagem de câmbios para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:post_exchange_details.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Envie informações de reembolso de COD
O webhook prebuilt_components_exchange_order:send_COD_refund_information é usado pelo componente para enviar informações de pagamento relacionadas com a troca a um utilizador.
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.channel | O canal específico para o qual enviar informações. Os valores válidos são definidos pela entidade prebuilt_components_channel_email_phone. Por predefinição, são suportados os formatos phone e email. |
de string |
Para configurar o webhook Enviar informações de reembolso de COD para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_exchange_order:send_COD_refund_information.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Concluído
O seu agente e os respetivos webhooks já devem estar configurados e prontos para teste.