Componente pré-criado de ofertas e promoções

O componente predefinido de ofertas e promoções verifica se o autor da chamada é um usuário registrado. Se o usuário tiver uma conta registrada, o componente poderá fornecer informações sobre ofertas e condições específicas do usuário. O usuário também pode receber detalhes sobre ofertas e promoções gerais ou informar problemas com um código de cupom específico. Esse componente usa o componente pré-criado Alphanumeric collection para coletar códigos de cupom. O componente também usa Geradores para resumo pós-chamada, perguntas frequentes e detalhes da oferta.

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

As caixas de diálogo de exemplo a seguir demonstram cenários comuns processados por esse 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.

Ofertas e promoções gerais e específicas do usuário

O usuário final foi autenticado anteriormente. O usuário pede as ofertas mais recentes e o agente apresenta uma lista de ofertas específicas para o usuário. O usuário faz algumas perguntas sobre as ofertas e depois pede ofertas em uma categoria específica. O agente apresenta a lista de ofertas na categoria. O agente oferece para enviar os detalhes da oferta ao usuário, que recusa.

Entrada do usuário Resposta do agente
Olá! Quer conferir nossas ofertas mais recentes ou está com problemas com um código de cupom específico?
Quero ver as ofertas mais recentes
Para confirmar, você está procurando ofertas. É isso mesmo?
sim
Encontramos as seguintes ofertas para você. Confira os detalhes:
Oferta 1: ganhe 5% de desconto em vestuários. Use o código APPARELS5, válido até 28/03/2024.
Oferta 2: ganhe 15% de desconto em compras de supermercado. Use o código GROCERY500, válido até 28/03/2024.

Esperamos que você goste dessas ofertas. Você tem alguma dúvida sobre ofertas ou promoções que possamos responder?
Há um valor mínimo de compra para a oferta de supermercado?
Sim, há um valor mínimo de compra de R$ 10 para aproveitar o desconto de 15% em compras de supermercado. Use o código GROCERY500 para resgatar esta oferta, válida até 28/03/2024.

Esperamos ter fornecido os detalhes necessários. Você tem alguma dúvida sobre ofertas ou promoções que possamos responder?
Você tem ofertas de eletrônicos?
Com certeza! Confira os detalhes da oferta:
Oferta 1: aproveite 5% de desconto em eletrônicos, use o código ELECTRIC5, válido até 28/03/2024.
Oferta 2: ganhe 15% de desconto em eletrônicos, use o código ELECTRIC15, válido até 28/03/2024.

Esperamos ter fornecido os detalhes necessários. Você tem alguma dúvida sobre ofertas ou promoções que possamos responder?
Não, terminei
Você quer que os detalhes da oferta sejam compartilhados no seu celular ou e-mail registrado?
Agora não
Agradecemos sua ligação.

Problema com um código de cupom

O usuário final foi autenticado anteriormente. O usuário menciona que tem um problema com um código de cupom. O agente coleta o código do cupom e fornece ao usuário detalhes sobre o resgate do código do cupom. O usuário confirma que está com um problema com o código do cupom, e o agente envia um tíquete para informar o problema.

Entrada do usuário Resposta do agente
Olá! Quer conferir nossas ofertas mais recentes ou está com problemas com um código de cupom específico?
Estou com problemas com um código de cupom
Para confirmar, você está procurando códigos de cupom. É isso mesmo?
sim
Lamentamos que você esteja enfrentando esse problema. Poderia informar o código do cupom que você está usando?
O agente coleta o código do cupom usando o componente predefinido Coleção alfanumérica
O código de oferta APPARELS5 associado a vestuários precisava de um valor mínimo de compra de US$ 100 e é válido até 28 de março de 2024. Verifique se as condições, como o requisito mínimo de compra, foram atendidas.

Essas informações foram úteis?
não
Especifique o problema. Você pode dizer algo como "Meu código de cupom não está funcionando na minha região".
O código do cupom não funciona
Para confirmar, o problema do código do cupom fornecido é que ele não está funcionando. É isso mesmo?
sim
Enviamos um tíquete para informar o problema. Agradecemos sua ligação.

Convenções de nomenclatura

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

Recurso Formato Exemplo
Fluxo [Nome do componente] Ofertas e promoções
Tipo da 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 usados para configurar determinados comportamentos 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 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

Esse componente predefinido permite que os parâmetros opcionais a seguir 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 ao selecionar se o usuário quer ouvir ofertas ou informar um problema com um código de cupom. O valor padrão é 2. integer
$flow.max_retry_offers_category Especifica o número de novas tentativas permitidas ao fornecer uma categoria para ouvir ofertas. O valor padrão é 2. integer
$flow.max_retry_another_coupon_code Especifica o número de novas tentativas permitidas ao fornecer o código do cupom específico que está causando problemas ao usuário. O valor padrão é 2. integer
$flow.max_retry_coupon_code_issue_counter Especifica o número de novas tentativas permitidas ao informar o problema que o usuário está tendo com um código de cupom. O valor padrão é 2. integer
$flow.max_retry_message_confirm_channel Especifica o número de novas tentativas permitidas ao fornecer um canal para receber detalhes da oferta. O valor padrão é 2. integer
$flow.valid_coupon_code_status Especifica o valor do campo coupon_code_status retornado pelo webhook get_coupon_code_details, indicando que o código do cupom é válido. O valor padrão é "valid". string
$flow.invalid_coupon_code_status Especifica o valor do campo coupon_code_status retornado pelo webhook get_coupon_code_details, indicando que o código do cupom é inválido. O valor padrão é "invalid". string
$flow.expired_coupon_code_status Especifica o valor do campo coupon_code_status retornado pelo webhook get_coupon_code_details, indicando que o código do cupom expirou. O valor padrão é "expired". string

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 predefinido fornece valores para os seguintes parâmetros de saída:

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, usado para identificar o usuário. string
transfer_reason Esse parâmetro indica o motivo da saída do fluxo, se não foi 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. Consulte 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 webhook.error built-in event.

webhook_not_found: um URL de webhook não pode ser acessado. Consulte Webhook.error.not-found built-in event.
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.

Perguntas frequentes gerais

O gerador de General FAQ é usado para lidar com perguntas frequentes relacionadas a descontos, vendas, compras e programas de fidelidade.

  • Posso devolver produtos em promoção se mudar de ideia?
  • Posso receber amostras ou brindes gratuitos com a compra de determinados produtos?
  • Você oferece ajustes de preço se o item que comprei entrar em promoção mais tarde?
  • Há um limite de tempo para resgatar recompensas do programa de fidelidade?

Detalhes da oferta específicos do usuário

O gerador de User-specific offer details é usado para fornecer detalhes sobre ofertas específicas do usuário com base nas informações fornecidas pelo webhook get_offers_details.

Detalhes das ofertas

O gerador de Offers and deals details é usado para fornecer detalhes sobre ofertas e transações gerais com base nas informações fornecidas pelo webhook get_offers_details. O usuário pode perguntar sobre ofertas em uma categoria específica ou pedir mais detalhes sobre ofertas específicas.

Perguntas frequentes sobre ofertas e promoções

O gerador de Offers and deals FAQ é usado para lidar com perguntas frequentes relacionadas a ofertas e transações.

  • Há ofertas especiais para novos clientes?
  • Como posso receber notificações sobre as próximas ofertas?
  • Há ofertas disponíveis exclusivamente na loja física ou on-line?
  • Com que frequência novas transações são adicionadas à sua plataforma?

Perguntas frequentes sobre descontos e códigos promocionais

O Discount and promo code FAQ é usado para lidar com perguntas frequentes relacionadas a descontos e códigos promocionais.

  • Posso usar um código de desconto mais de uma vez?
  • Posso usar vários descontos em um único pedido?
  • Como posso resgatar um código de desconto durante a finalização da compra?
  • E se eu me esquecer de aplicar um código de desconto durante a finalização da compra?

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 esse componente, você precisa configurar os webhooks flexíveis incluídos para extrair as informações necessárias dos seus serviços externos.

Conferir detalhes das ofertas

O webhook prebuilt_components_offers_and_deals:get_offers_details é usado pelo componente para extrair detalhes sobre ofertas gerais e específicas do 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 para recuperar os detalhes da oferta. 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
active_category Lista de categorias de ofertas disponíveis para o usuário. Os valores válidos são definidos pela entidade prebuilt_components_offers_and_deals_category. Lista (string)
user_email E-mail registrado na conta fornecida, usado para enviar detalhes da oferta. string
user_offer Lista de detalhes da oferta específicos do usuário. 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 do campo user_offer. Lista (objeto)

Para configurar o webhook "Get offers details" 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_offers_and_deals:get_offers_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, porque eles são necessários para que o componente acesse os valores de campo retornados.
  10. Revise e atualize as configurações de autenticação conforme necessário.
  11. Clique em Salvar.

Receber detalhes do código do cupom

O webhook prebuilt_components_offers_and_deals:get_coupon_code_details é usado pelo componente para extrair detalhes sobre um código de cupom específico que um usuário informou ter problemas.

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.coupon_code Código do cupom para recuperar detalhes. string
$session.params.phone_number Número de telefone associado à conta do usuário. 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
offer_id ID da oferta do código do cupom. string
offer_category_name Categoria do código do cupom. Os valores válidos são definidos pela entidade prebuilt_components_offers_and_deals_category. string
coupon_code_status Status do código do cupom. Os valores válidos são definidos pelos parâmetros de entrada $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status e $flow.valid_coupon_code_status. string
valid_until Data de validade do código do cupom no formato YYYY-MM-DD. string
minimum_order_value Valor mínimo do pedido para o código do cupom. string

Para configurar o webhook "Receber detalhes do código do cupom" 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_offers_and_deals:get_coupon_code_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, porque eles são necessários para que o componente acesse os valores de campo retornados.
  10. Revise e atualize as configurações de autenticação conforme necessário.
  11. Clique em Salvar.

Enviar mensagem

O webhook prebuilt_components_offers_and_deals:send_message é usado pelo componente para enviar uma mensagem com detalhes da oferta ao canal selecionado pelo 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.confirmation_channel Canal que o usuário selecionou para receber detalhes da oferta. Os valores válidos são definidos pela entidade prebuilt_components_channel_email_phone. string

Para configurar o webhook "Enviar mensagem" 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_offers_and_deals:send_message.
  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, porque eles são necessários para que o componente acesse os valores de campo retornados.
  10. Revise e atualize as configurações de autenticação conforme necessário.
  11. Clique em Salvar.

Abrir tíquete

O webhook prebuilt_components_offers_and_deals:raise_ticket é usado pelo componente para enviar um tíquete informando um problema do usuário com um código de cupom.

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.coupon_code Código do cupom em que o usuário relatou um problema. string
$flow.offer_id ID da oferta do código do cupom fornecido. string
$flow.coupon_code_issue O usuário informou o problema do código do cupom. string

Para configurar o webhook de tíquetes do Raise 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 rebuilt_components_offers_and_deals:raise_ticket.
  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, porque eles são necessários para que o componente acesse os valores de campo retornados.
  10. Revise e atualize as configurações de autenticação conforme necessário.
  11. Clique em Salvar.

Concluído

Seu agente e os webhooks dele estão configurados e prontos para testes.