Ofertas e promoções componente pré-criado verifica se o autor da chamada é um usuário registrado. Se o usuário tiver um registro o componente pode fornecer informações sobre ofertas específicas do usuário e negócios. O usuário também pode conferir detalhes sobre ofertas gerais e promoções ou relatórios problemas com um código de cupom específico. Esse componente usa o Coleção alfanumérica pré-criado para coletar códigos de cupom. O componente também usa Geradores para pós-reunião resumo, perguntas frequentes e detalhes da oferta.
Limitações
Além da seção limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- Este componente não criptografa dados.
Exemplos de diálogos
Os exemplos de caixas de diálogo a seguir demonstram cenários comuns tratados por este um componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado usando a telefonia, o que aciona a intent de boas-vindas padrão e a primeira a resposta do agente no início da conversa.
Ofertas e ofertas gerais e específicas do usuário
O usuário final já foi autenticado anteriormente. O usuário pergunta as ofertas mais recentes e o agente apresenta uma lista de ofertas específicas para o usuário. O usuário faz algumas perguntas perguntas sobre as ofertas e, em seguida, solicita ofertas de uma categoria específica. O apresenta a lista de ofertas na categoria. O agente se oferece para enviar detalhes da oferta para o usuário, e ele se recusa a fazer isso.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá! Gostaria de explorar nossas últimas ofertas ou está enfrentando algum problema 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 roupas, use o código APPARELS5, válido até 28/03/2024. Oferta 2: ganhe 15% de desconto em supermercados.Use o código GROCERY500, válido até 28/03/2024. Você tem alguma dúvida sobre ofertas ou promoções que podemos responder para você? |
|
| Existe um valor mínimo de compra para a oferta do mercado? | |
| Sim, há um valor de compra mínimo de 10 para aproveitar o desconto de 15% no mercado. Use o código GROCERY500 para resgatar esta oferta, válida até 28/03/2024. Confira as informações necessárias. Você tem alguma dúvida sobre ofertas ou promoções que podemos responder para você? |
|
| Você tem alguma oferta de eletrônicos? | |
| Com certeza! Veja 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: receba 15% de desconto em eletrônicos. Use o código ELECTRIC15, válido até 28/03/2024. Esperamos fornecer os detalhes que você precisa. Você tem alguma dúvida sobre ofertas ou promoções que podemos responder para você? |
|
| Não, terminei | |
| Quer compartilhar os detalhes da oferta 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 já foi autenticado anteriormente. O usuário menciona que tem problema com um código de cupom. O agente coleta o código do cupom e informa usuário com detalhes sobre o resgate do código do cupom. O usuário confirma que ele estão tendo um problema com o código do cupom e o agente envia um tíquete para informe o problema.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá! Gostaria de explorar nossas últimas ofertas ou está enfrentando algum problema com um código de cupom específico? | |
| Estou tendo 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. Informe o código do cupom que você está usando. | |
| O agente coleta o código do cupom usando o componente pré-criado de coleção alfanumérica | |
| O código de oferta APPARELS5 associado a roupas precisa de um valor mínimo de compra de US$ 100 e é válido até 28/03/2024. Verifique se as condições, como o requisito mínimo de compra, foram atendidas. Essas informações foram úteis para você? |
|
| não | |
| Especifique o problema que você está enfrentando. Você pode dizer que algo como meu código do cupom não está funcionando ou que o código não está funcionando na minha área. | |
| o código do cupom não está funcionando | |
| Para confirmar, o problema com o código do cupom informado é que o código não está funcionando. É isso mesmo? | |
| sim | |
| Criamos um tíquete para informar seu problema. Agradecemos sua ligação. |
Convenções de nomenclatura
Esse componente pré-criado 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
Parâmetros de entrada são parâmetros usados para configurar certos comportamentos de do componente. Os parâmetros serão usados por uma ou mais condições dentro do para determinar como o componente deve se comportar. Os parâmetros com escopo de fluxo precisam ser definido na página inicial do componente. No escopo da sessão podem ser definidos por um fluxo de chamada ou no início página 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, utilizado 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 | 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 informar o código do cupom específico que está apresentando problemas para o 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 deste 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 das Predefinições de parâmetro conforme necessário.
- Clique em Salvar.
Parâmetros de saída
Os parâmetros de saída são de sessão que permanecerão ativos depois de sair. do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado fornece valores para a saída a seguir parâmetros:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| phone_number | Número de telefone local do usuário, sem o código do país, utilizado para identificar o usuário. | string |
| transfer_reason | Esse parâmetro indica o motivo da saída do fluxo, caso não tenha sido bem-sucedido. O valor retornado é um dos seguintes:agent: o usuário final solicitou um agente humano em algum momento durante a conversa.denial_of_information: o usuário final recusou o compartilhamento de informações solicitadas pelo componente.max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem entrada. Confira eventos integrados sem entrada.max_no_match: a conversa atingiu o número máximo de novas tentativas para eventos sem correspondência. Consulte eventos integrados sem correspondência.webhook_error: ocorreu um erro de webhook. Consulte o evento integrado webhook.error. webhook_not_found: um URL de webhook estava inacessível. Consulte 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 processar perguntas frequentes relacionadas ao
a descontos, vendas, compras e programas de fidelidade.
- Posso devolver os produtos vendidos se eu mudar de ideia?
- Posso ganhar amostras grátis ou presentes em determinadas compras de produtos?
- Vocês oferecem ajustes de preço se o item que eu 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 User-specific offer details é usado para fornecer detalhes sobre
Ofertas específicas do usuário com base nas informações enviadas pelo get_offers_details
webhook.
Detalhes de ofertas e promoções
O gerador Offers and deals details é usado para fornecer detalhes sobre
Ofertas gerais e promoções com base nas informações enviadas pelo get_offers_details
webhook.
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 ofertas
O gerador Offers and deals FAQ é usado para processar perguntas frequentes.
relacionadas a ofertas e negócios.
- Há ofertas especiais para novos clientes?
- Como posso saber sobre as próximas ofertas?
- Há ofertas disponíveis exclusivamente na loja ou on-line?
- Com que frequência novas ofertas são adicionadas à sua plataforma?
Perguntas frequentes sobre descontos e códigos promocionais
O Discount and promo code FAQ é usado para processar 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 ao finalizar a compra?
- E se eu me esquecer de aplicar um código de desconto ao finalizar a compra?
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis com que descreve os serviços externos do Dialogflow, consulte Webhook setup.
Configuração do webhook
Para usar este componente, você precisa configurar o webhooks flexíveis para recuperar informações necessárias dos serviços externos.
Receber 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 oferta 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 "Ver detalhes das ofertas" para esse componente, expanda para ver 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 Webhook URL do Dialogflow 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 formar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Ver 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 de 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 o qual 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 para o 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 em que o código do cupom é válido até, 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 "Ver detalhes do código do cupom" para este componente, expanda para conferir 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 Webhook URL do Dialogflow 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 formar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 contendo detalhes da oferta para o
canal selecionado.
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, utilizado para identificar o usuário. | string |
| $flow.confirmation_channel | Canal sobre o qual o usuário selecionou 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, expanda para ver 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 Webhook URL do Dialogflow 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 formar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise 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 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, utilizado para identificar o usuário. | string |
| $flow.coupon_code | Código do cupom relacionado ao problema relatado pelo usuário. | string |
| $flow.offer_id | ID da oferta para o código do cupom fornecido. | string |
| $flow.coupon_code_issue | Problema informado pelo usuário para o código do cupom. | string |
Para configurar o webhook "Aumentar tíquetes" para esse componente, expanda para conferir 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 Webhook URL do Dialogflow 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 formar o formato de solicitação adequado para seu webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos do objeto. resposta. Não modifique os nomes dos parâmetros, pois eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações de Autenticação conforme necessário.
- Clique em Salvar.
Concluído
Seu agente e os respectivos webhooks devem estar configurados e prontos para teste.