O componente pré-criado 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 promoções específicas para ele. O usuário também pode receber detalhes sobre ofertas e promoções gerais ou reportar problemas com um código do cupom específico. Esse componente usa o componente pré-criado Coleção alfanumérica para coletar códigos do cupom. O componente também usa geradores para resumos pós-chamada, perguntas frequentes e detalhes da oferta.
Limitações
Além das limitações comuns de componentes pré-criados, este componente tem as seguintes limitações:
- Esse componente não criptografa dados.
Diálogos de exemplo
Os exemplos de diálogos 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 para o usuário
O usuário final já foi autenticado. O usuário pede as ofertas mais recentes, e o agente apresenta uma lista de ofertas específicas para ele. O usuário faz algumas perguntas sobre as ofertas e, em seguida, pede ofertas em uma categoria específica. O agente apresenta a lista de ofertas na categoria. O agente se oferece para enviar os detalhes da oferta ao usuário, que recusa.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá! Quer conhecer nossas ofertas mais recentes ou está com problemas com um código do 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 roupas, use o código APPARELS5, válido até 28/03/2024. Oferta 2: ganhe 15% de desconto em compras de mercado, 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 mercado? | |
| Sim, há um valor mínimo de compra de 10 para aproveitar o desconto de 15% em compras de mercado. Use o código GROCERY500 para resgatar essa oferta, válida até 28/03/2024. Esperamos que essas informações sejam úteis. Você tem alguma dúvida sobre ofertas ou promoções que possamos responder? |
|
| Você tem alguma oferta de eletrônicos? | |
| Claro! Confira os detalhes das ofertas: Oferta 1: aproveite 5% de desconto em eletrônicos com o código ELECTRIC5, válido até 28/03/2024. Oferta 2: ganhe 15% de desconto em eletrônicos com o código ELECTRIC15, válido até 28/03/2024. Esperamos que essas informações sejam úteis. Você tem alguma dúvida sobre ofertas ou promoções que possamos responder? |
|
| Não, já terminei | |
| Quer que os detalhes da oferta sejam enviados para seu celular ou e-mail registrado? | |
| Agora não | |
| Agradecemos sua ligação. |
Problema com um código do cupom
O usuário final já foi autenticado. O usuário menciona que tem um problema com um código do cupom. O agente coleta o código do cupom e fornece ao usuário detalhes sobre o resgate. 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 conhecer nossas ofertas mais recentes ou está com problemas com um código do cupom específico? | |
| Estou com problemas com um código do cupom | |
| Para confirmar, você está procurando códigos do 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 pré-criado Coleta alfanumérica | |
| O código da oferta APPARELS5 associado a roupas exige um valor mínimo de compra de US$ 100 e é válido até 28/03/2024. Verifique se as condições, como o requisito de compra mínima, foram atendidas. Essas informações foram úteis? |
|
| não | |
| Especifique o problema que você está enfrentando. Você pode dizer algo como "Meu código do cupom não está funcionando" ou "O código não está funcionando na minha região". | |
| O código do cupom não está funcionando | |
| Para confirmar, o problema com o código do cupom informado é que ele não está funcionando. É isso mesmo? | |
| sim | |
| Abrimos um tíquete para informar seu problema. Agradecemos sua ligação. |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formatar | Exemplo |
|---|---|---|
| Flow | [Nome do componente] | Promoções e ofertas |
| 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 deve se comportar. Os parâmetros com escopo de 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 desse 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, usado para identificar o usuário. | string |
Esse componente pré-criado permite que os seguintes parâmetros opcionais configurem o comportamento do componente, incluindo novas tentativas.
| Nome do parâmetro | Descrição | Formatar |
|---|---|---|
| $flow.max_retry_concern_type | Especifica o número de novas tentativas permitidas ao selecionar se o usuário quer ouvir ofertas ou reportar um problema com um código do 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 com que o usuário está tendo problemas. 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 do 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.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Build.
- Clique no componente importado na seção Fluxos.
- Clique na página inicial na seção Páginas.
- Clique na rota true na página inicial.
- Na janela "Rota", edite os valores de Predefinições de parâmetros conforme necessário.
- 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 sair do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado 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 tiver sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário final solicitou um agente humano em algum momento da conversa.denial_of_information: o usuário final se recusou 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 o evento integrado webhook.error. webhook_not_found: um URL do webhook estava inacessível. Consulte o evento integrado webhook.error.not-found. |
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 General FAQ é usado para lidar com perguntas frequentes relacionadas a descontos, vendas, compras e programas de fidelidade.
- Posso devolver produtos em promoção se eu mudar de ideia?
- Posso receber amostras sem custo financeiro ou brindes ao comprar determinados produtos?
- Vocês oferecem ajustes de preço se o item que comprei entrar em promoção depois?
- Há um limite de tempo para resgatar as recompensas do programa de fidelidade?
Detalhes da oferta específica do usuário
O gerador 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 de promoções e ofertas
O gerador Offers and deals details é usado para fornecer detalhes sobre
ofertas e promoçõ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 promoções e ofertas
O gerador Offers and deals FAQ é usado para lidar com perguntas frequentes
relacionadas a ofertas e promoções.
- Há ofertas especiais para novos clientes?
- Como posso receber notificações sobre as próximas ofertas?
- Há ofertas disponíveis exclusivamente na loja ou on-line?
- Com que frequência novas ofertas são adicionadas à 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 esquecer de aplicar um código de desconto durante a finalização da compra?
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com a configuração que descreve seus serviços externos. Consulte a configuração do webhook.
Configuração do webhook
Para usar esse componente, você precisa configurar os webhooks flexíveis incluídos para recuperar as informações necessárias dos seus serviços externos.
Ver detalhes das ofertas
O webhook prebuilt_components_offers_and_deals:get_offers_details é usado
pelo componente para recuperar 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 dela, 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"}. |
List (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. |
List (objeto) |
Para configurar o webhook de detalhes das ofertas para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_offers_and_deals:get_offers_details.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do 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.
- Revise e atualize as configurações de Autenticação conforme necessário.
- 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 recuperar detalhes sobre um código do cupom específico que um usuário
relatou 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.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_offers_and_deals:get_coupon_code_details.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do 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.
- Revise e atualize as configurações de Autenticação conforme necessário.
- 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 de envio de mensagem para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_offers_and_deals:send_message.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do 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.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Abrir tíquete
O webhook prebuilt_components_offers_and_deals:raise_ticket é usado
pelo componente para enviar um tíquete relatando um problema do usuário com um código do 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 que o usuário informou que está com problema. | string |
| $flow.offer_id | ID da oferta para o código do cupom fornecido. | string |
| $flow.coupon_code_issue | Problema informado pelo usuário com o código do cupom. | string |
Para configurar o webhook de abertura de tíquete para esse componente, abra as instruções.
- Abra o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook rebuilt_components_offers_and_deals:raise_ticket.
- Substitua o URL no campo URL do webhook do Dialogflow CX pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
- Revise e atualize o corpo da solicitação para criar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do 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.
- Revise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Concluído
Seu agente e os webhooks dele agora devem estar configurados e prontos para teste.