Partilhar via

Adicionar um chatbot a uma página

Nota

Os portais Power Apps permitem-lhe adicionar um chatbot Power Virtual Agents para responder a perguntas publicadas por um visitante na página dos seus portais. Um chatbot (bot) configurado com diferentes tópicos e expressões de acionamento pode responder automaticamente às perguntas publicadas por um visitante numa conversa do chat.

Nota

A capacidade de adicionar um chatbot através do novo estúdio de design do Power Pages não é suportada. Consulte Como: Incorporar um chatbot numa página Web sobre como incorporar um chatbot num site do Power Pages.

Pré-requisitos

Antes de poder adicionar um bot Power Virtual Agents a uma página de portais Power Apps, tem de criar primeiro um bot. Se ainda não tiver um bot disponível ou um que se adapte às suas necessidades, terá a opção em portais para ir a Power Virtual Agents para criar um. Para aprender a criar um bot, vá à Criar e eliminar bots Power Virtual Agents.

Importante

Esta funcionalidade requer as seguintes versões para um pacote de portal de iniciação e um sistema anfitrião do portal:

Adicionar componente de chatbot

Uma vez criado um chatbot, pode adicionar este componente a uma página de portais com os seguintes passos:

  1. Ir para o Power Apps.

  2. Selecione Aplicações no painel esquerdo.

  3. Selecionar o portal.

  4. Selecione Editar para abrir o Studio dos portais.

  5. Selecione Componentes no painel esquerdo.

  6. Selecione o componente Chatbot.

    Adicionar um componente de chatbot a uma página.

  7. Selecione o seu bot.

    Selecione o seu bot.

    Nota

    Se não tiver um bot já criado ou pretender criar um novo bot a utilizar nos portais, selecione Power Virtual Agents. Depois de criar o seu bot, selecione Sincronizar configuração dentro dos portais Studio para refletir as alterações do bot.

  8. Selecione se o bot aparece em todas as páginas do seu portal ou em páginas específicas.

  9. Se selecionar Páginas específicas, utilize Gerir bots em páginas para controlar as páginas que podem utilizar este bot.

Pode adicionar mais bots do seu ambiente em diferentes páginas de um portal. Por exemplo, um bot que responda a questões relacionadas com o local de trabalho pode ser adicionado a uma página de RH. Ou um bot que responda a consultas básicas de folha de pagamento pode ser adicionado a uma página de Finanças. No entanto, não é possível utilizar mais do que um bot por página.

Configuração avançada

O componente chatbot é renderizado usando um modelo web chamado Power Virtual Agents.

Modelo Web do chatbot.

Pode alterar os valores para os parâmetros seguintes dentro da função "window.PvaEmbeddedWebChat.renderWebChat()".

Chatbot com cada secção numerada para referência. Widget Chatbot com cada parte numerada para referência.

Número Parâmetro Valor
1 largura Utiliza a variável "chatWidth". Para alterar, atualize a largura em pixels:
let chatWidth = "320px";
2 altura Utiliza a variável "chatHeight". Para alterar, atualize a altura em pixels:
let chatHeight = "480px";
3 headerText Título do bot. Por predefinição, isto usa o nome do bot. Para alterar, adicione o parâmetro "headerText" com o valor do cabeçalho do bot:
"headerText": 'Contoso chatbot';
4: fontColor
5: backgroundColor		 webChatHeaderStyleOptions Determina o estilo do cabeçalho para o componente chatbot, como a cor do tipo de letra e o fundo. Para alterar, atualize o parâmetro "webChatHeaderStyleOptions" com os valores para as propriedades "fontColor" e "backgroundColor":
"webChatHeaderStyleOptions": {"fontColor":'black',"backgroundColor":'white'}
6: backgroundColor
7: bubbleBackgroundcolor
8: bubbleTextColor
9: bubbleFromUserBackground
10: bubbleFromUserTextColor		 webChatCanvasStyleOptions Determina o estilo de tela de chat para o componente chatbot, como o fundo e fundos da bolha do chatbot e do utilizador. Para alterar, atualize os parâmetros "webChatCanvasStyleOptions" com os valores para propriedades "backgroundColor", "bubbleBackgroundcolor", "bubbleTextColor", "bubbleFromUserBackground" e "bubbleFromUserTextColor":
"webChatCanvasStyleOptions": {"backgroundColor": "#123FFF","bubbleBackground":"#2340F0","bubbleTextColor": "#323130","bubbleFromUserBackground": "#412644","bubbleFromUserTextColor": "#F345FF"}
11: backgroundColor
12: iconColor		 webChatWidgetStyleOptions Determina o estilo do ChatWidget, como a cor do ícone e o fundo. Para alterar, atualize o parâmetro "webChatWidgetStyleOptions" com os valores para as propriedades "backgroundColor" e "iconColor":
"webChatWidgetStyleOptions": {"backgroundColor": "#486744","iconColor": "#DF234F"}

Depois de alterar o modelo web, certifique-se de que seleciona Sincronizar configuração para atualizar a configuração e refletir as alterações.

Nota

Quaisquer alterações ao modelo Web do Power Virtual Agents além dos parâmetros acima explicados não são suportadas.

Considerações adicionais

Considere o seguinte ao utilizar um chatbot Power Virtual Agents dentro de portais:

Versão do modelo do portal

Esta funcionalidade requer a versão 9.2.2103.x do portal de arranque ou posterior. Se o modelo do portal não for atualizado para adicionar suporte para o componente chatbot, verá a seguinte mensagem quando tentar adicionar o componente:

"Atualização de portal necessária: É necessária uma atualização para utilizar esta funcionalidade no portal. Se atualizar o portal, certifique-se de que Sincroniza a Configuração para atualizar a sessão atual do Portal Studio com o novo pacote de portais."

Quando esta mensagem aparecer, atualize o seu pacote de portal. Para obter mais informações , consulte Atualizar solução de portais.

Nota

A atualização do pacote do portal de arranque permitirá quaisquer portais adicionais no seu ambiente com a capacidade de utilizar o componente chatbot. Mais informações: Atualizações do pacote de portal de iniciação

Eliminação da solução

Esta funcionalidade vem com um solução de portal chamada MicrosoftPortalBot com o nome a apresentar de Portais do Dynamics 365 - Bot. O seu portal deixará de funcionar se eliminar esta solução e não executar as seguintes ações.

Se eliminar a solução MicrosoftPortalBot tem de reiniciar o seu portal para garantir que o portal funciona corretamente.

Para reiniciar o portal:

  1. Abra o Centro de administração do Power Platform para o seu portal.

  2. No painel esquerdo, selecione Ações do Portal.

  3. Selecione Reiniciar para reiniciar o portal.

    Importante

    Reiniciar o portal fará com que este fique indisponível durante vários minutos e os utilizadores não conseguirão aceder ao URL do portal durante este período.

  4. Selecione Reiniciar para confirmar o reinício do portal.

Consulte também

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).