O componente pré-criado de ofertas e promoções verifica se a pessoa que está a ligar é um utilizador registado. Se o utilizador tiver uma conta registada, o componente pode fornecer informações sobre ofertas e promoções específicas do utilizador. O utilizador também pode obter detalhes sobre ofertas e promoções gerais ou comunicar problemas com um código de cupão específico. Este componente usa o componente pré-criado Recolha alfanumérica para recolher códigos de cupões. O componente também usa geradores para o resumo pós-chamada, as Perguntas frequentes e os detalhes da oferta.
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.
Ofertas e promoções gerais e específicas do utilizador
O utilizador final foi autenticado anteriormente. O utilizador pede as suas ofertas mais recentes e o agente apresenta uma lista de ofertas específicas para o utilizador. O utilizador faz algumas perguntas sobre as ofertas e, em seguida, pede ofertas numa categoria específica. O agente apresenta a lista de ofertas na categoria. O agente oferece-se para enviar os detalhes da oferta ao utilizador, e o utilizador recusa.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Damos-lhe as boas-vindas! Quer explorar as nossas ofertas mais recentes ou está a ter problemas com um código de cupão específico? | |
| Quero ver as ofertas mais recentes | |
| Para confirmar, está à procura de ofertas. Está correto? | |
| sim | |
| Encontrámos as seguintes ofertas para si. Seguem-se os detalhes: Oferta 1: receba 5% de desconto em vestuário. Use o código APPARELS5, válido até 28/03/2024. Oferta 2: receba 15% de desconto em mercearia. Use o código GROCERY500, válido até 28/03/2024.8. Esperamos que ache estas ofertas interessantes. Tem alguma dúvida sobre ofertas ou promoções que possamos esclarecer? |
|
| Existe um valor mínimo de compra para a oferta de supermercado? | |
| Sim, existe um valor mínimo de compra de 10 € para usufruir do desconto de 15% em mercearia. Use o código GROCERY500 para resgatar esta oferta, válida até 28/03/2024. Esperamos poder fornecer-lhe os detalhes de que necessita. Tem alguma dúvida sobre ofertas ou promoções que possamos esclarecer? |
|
| Têm alguma oferta para eletrónica? | |
| Claro! Seguem-se os detalhes da oferta: Oferta 1: usufrua de 5% de desconto em eletrónica com o código ELECTRIC5. Oferta válida até 28/03/2024. Oferta 2: usufrua de 15% de desconto em eletrónica com o código ELECTRIC15. Oferta válida até 28/03/2024. Esperamos poder facultar-lhe os detalhes de que necessita. Tem alguma dúvida sobre ofertas ou promoções que possamos esclarecer? |
|
| Não, terminei | |
| Quer que os detalhes da oferta sejam partilhados no seu telemóvel ou email registado? | |
| Não | |
| Obrigado por ligar. |
Problema com um código de cupão
O utilizador final foi autenticado anteriormente. O utilizador menciona que tem um problema com um código de cupão. O agente recolhe o código do cupão e faculta ao utilizador detalhes sobre o resgate do código do cupão. O utilizador confirma que está a ter um problema com o código de cupão e o agente envia um pedido para comunicar o problema.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Damos-lhe as boas-vindas! Quer explorar as nossas ofertas mais recentes ou está a ter problemas com um código de cupão específico? | |
| Estou a ter problemas com um código de cupão | |
| Para confirmar, está à procura de códigos de cupões. Está correto? | |
| sim | |
| Lamentamos esta situação. Pode partilhar o código de cupão que está a usar? | |
| O agente recolhe o código do cupão através do componente pré-criado Recolha alfanumérica | |
| O código da oferta APPARELS5 associado a vestuário precisava de um valor de compra mínimo de 100$ e era válido até 28/03/2024. Certifique-se de que cumpre as condições, como o requisito de compra mínima. Estas informações foram úteis? |
|
| não | |
| Especifique o problema que está a ter. Pode dizer algo como o meu código de cupão não está a funcionar ou o código não está a funcionar na minha área. | |
| O código de cupão não está a funcionar | |
| Para confirmar, o problema do código de cupão indicado é que o código de cupão não está a funcionar. Isto está correto? | |
| sim | |
| Criámos um pedido para comunicar o seu problema. Obrigado por ligar. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Ofertas e promoções |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_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 |
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_concern_type | Especifica o número de novas tentativas permitidas quando seleciona se o utilizador quer ouvir ofertas ou comunicar um problema com um código de cupão. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_offers_category | Especifica o número de novas tentativas permitidas quando fornece uma categoria para ouvir ofertas. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_another_coupon_code | Especifica o número de novas tentativas permitidas quando fornece o código de cupão específico com o qual o utilizador está a ter um problema. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_coupon_code_issue_counter | Especifica o número de novas tentativas permitidas quando fornece o problema que o utilizador está a ter com um código de cupão. O valor predefinido é 2. |
número inteiro |
| $flow.max_retry_message_confirm_channel | Especifica o número de novas tentativas permitidas quando fornece um canal para receber detalhes da oferta. O valor predefinido é 2. |
número inteiro |
| $flow.valid_coupon_code_status | Especifica o valor do campo coupon_code_status devolvido pelo get_coupon_code_details webhook que indica que o código de cupão é válido. O valor predefinido é "valid". |
de string |
| $flow.invalid_coupon_code_status | Especifica o valor do campo coupon_code_status devolvido pelo get_coupon_code_details webhook que indica que o código do cupão é inválido. O valor predefinido é "invalid". |
de string |
| $flow.expired_coupon_code_status | Especifica o valor do campo coupon_code_status devolvido pelo get_coupon_code_details webhook que indica que o código de cupão expirou. O valor predefinido é "expired". |
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 |
| 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.
Perguntas frequentes gerais
O gerador General FAQ é usado para processar perguntas frequentes relacionadas com
descontos, vendas, compras e programas de fidelidade.
- Posso devolver produtos em promoção se mudar de ideias?
- Posso receber amostras ou presentes gratuitos com a compra de determinados produtos?
- Oferecem ajustes de preços se o artigo que comprei entrar em promoção mais tarde?
- Existe um limite de tempo para resgatar recompensas do programa de fidelidade?
Detalhes da oferta específicos do utilizador
O gerador User-specific offer details é usado para fornecer detalhes sobre ofertas específicas do utilizador com base nas informações fornecidas pelo get_offers_details
webhook.
Detalhes de ofertas e ofertas especiais
O gerador Offers and deals details é usado para fornecer detalhes sobre ofertas gerais e promoções com base nas informações fornecidas pelo get_offers_details
webhook.
O utilizador pode perguntar sobre ofertas numa categoria específica ou pedir mais detalhes sobre ofertas específicas.
Perguntas frequentes sobre ofertas e ofertas especiais
O gerador Offers and deals FAQ é usado para processar perguntas frequentes
relacionadas com ofertas e promoções.
- Existem ofertas especiais para novos clientes?
- Como posso receber notificações sobre acordos futuros?
- Existem promoções disponíveis exclusivamente na loja ou online?
- Com que frequência são adicionadas novas ofertas à sua plataforma?
Perguntas frequentes sobre descontos e códigos promocionais
O Discount and promo code FAQ é usado para processar perguntas frequentes relacionadas com descontos e códigos promocionais.
- Posso usar um código de desconto mais do que uma vez?
- Posso usar vários descontos numa única encomenda?
- Como posso resgatar um código de desconto durante o pagamento?
- E se me esquecer de aplicar um código de desconto durante o pagamento?
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.
Obtenha detalhes das ofertas
O webhook prebuilt_components_offers_and_deals:get_offers_details é usado pelo componente para obter detalhes sobre ofertas gerais e específicas do 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 para obter os detalhes da oferta. | 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 |
|---|---|---|
| active_category | Lista de categorias de ofertas disponíveis para o utilizador. Os valores válidos são definidos pela entidade prebuilt_components_offers_and_deals_category. |
Lista (string) |
| user_email | Email registado na conta fornecida, usado para enviar detalhes da oferta. | de string |
| user_offer | Lista de detalhes da oferta específicos do utilizador. Cada elemento da lista representa uma única oferta, com pares de chave-valor que descrevem diferentes atributos da oferta, por exemplo, {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}. |
Lista (objeto) |
| all_offers | Lista de detalhes gerais da oferta. Cada elemento da lista representa uma única oferta, seguindo o mesmo formato que o campo user_offer. |
Lista (objeto) |
Para configurar o webhook Get offers 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_offers_and_deals:get_offers_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 do código de cupão
O webhook prebuilt_components_offers_and_deals:get_coupon_code_details é usado
pelo componente para obter detalhes sobre um código de cupão específico com o qual um utilizador
comunicou problemas.
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.coupon_code | Código do cupão para obter detalhes. | de string |
| $session.params.phone_number | Número de telefone associado à conta do utilizador. | 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 |
|---|---|---|
| offer_id | ID da oferta do código de cupão. | de string |
| offer_category_name | Categoria do código de cupão. Os valores válidos são definidos pela entidade prebuilt_components_offers_and_deals_category. |
de string |
| coupon_code_status | Estado do código de cupão. Os valores válidos são definidos pelos $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status e $flow.valid_coupon_code_status parâmetros de entrada. |
de string |
| valid_until | Data até à qual o código de cupão é válido, no formato YYYY-MM-DD. |
de string |
| minimum_order_value | Valor de encomenda mínimo para o código do cupão. | de string |
Para configurar o webhook Get coupon code 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_offers_and_deals:get_coupon_code_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.
Enviar mensagem
O webhook prebuilt_components_offers_and_deals:send_message é usado pelo componente para enviar uma mensagem com detalhes da oferta para o canal selecionado 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 |
|---|---|---|
| $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.confirmation_channel | Canal que o utilizador selecionou para receber detalhes da oferta. Os valores válidos são definidos pela entidade prebuilt_components_channel_email_phone. |
de string |
Para configurar o webhook Enviar mensagem 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_offers_and_deals:send_message.
- 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
O webhook prebuilt_components_offers_and_deals:raise_ticket é usado
pelo componente para enviar um pedido a comunicar um problema do utilizador com um código de cupão.
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.coupon_code | Código de cupão para o qual o utilizador comunicou um problema. | de string |
| $flow.offer_id | ID da oferta para o código de cupão fornecido. | de string |
| $flow.coupon_code_issue | O problema indicado pelo utilizador para o código de cupão. | de string |
Para configurar o webhook Raise ticket 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 rebuilt_components_offers_and_deals:raise_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.
Concluído
O seu agente e os respetivos webhooks já devem estar configurados e prontos para teste.