Adicionar chatbot a uma página

Os portais do Power Apps permitem que você adicione um chatbot do Power Virtual Agents para responder às perguntas postadas por um visitante em sua página de portais. Um chatbot (bot) configurado com diferentes tópicos e frases de gatilho pode responder automaticamente às perguntas postadas por um visitante em uma conversa de chat.

Pré-requisitos

Antes de poder adicionar um bot do Power Virtual Agents à uma página de portais do Power Apps, você deverá criar um bot primeiro. Se ainda não tiver um bot disponível ou que atenda às suas necessidades, você terá a opção de acessar os portais do Power Virtual Agents para criar um. Para aprender a criar um bot, acesse Criar e excluir bots do Power Virtual Agents.

Importante

Este recurso requer as seguintes versões do pacote do portal do iniciante e do host do portal:

• Versão do host do portal 9.3.4.x ou posterior.
• Versão do pacote do portal do iniciante 9.2.2103.x ou posterior. Mais informações: considerações adicionais

Adicionar componente de chatbot

Depois de criar um chatbot, você poderá adicionar esse componente a uma página de portais com as seguintes etapas:

1. Vá para Power Apps.

2. Selecione Aplicativos no painel esquerdo.

3. Selecione seu portal.

4. Selecione Editar para abrir o Studio de portais.

5. Selecione Componentes no painel esquerdo.

6. Selecione o componente Chatbot.

   

7. Selecione o bot.

   

   Observação

   Se você ainda não tem um bot criado, ou deseja criar um novo bot para usar em portais, selecione Power Virtual Agents. Depois de criar seu bot, selecione Configuração de sincronização dentro do Estúdio de portais para refletir as alterações do bot.

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

9. Se você selecionar Páginas específicas, use Gerenciar bots em páginas para controlar as páginas que poderão usar esse bot.

Você pode adicionar mais bots do seu ambiente em diferentes páginas de um portal. Por exemplo, um bot que responda a perguntas relacionadas ao 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, uma página não pode usar mais de um bot.

Configuração avançada

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

Você pode alterar os valores dos seguintes parâmetros dentro da função "window.PvaEmbeddedWebChat.renderWebChat()".

Número	Parâmetro	Valor
1	largura	Usa a variável "chatWidth". Para alterar, atualize a largura em pixels: let chatWidth = "320px";
2	altura	Usa a variável "chatHeight". Para alterar, atualize a altura em pixels: let chatHeight = "480px";
3	headerText	Título do bot. Por padrão, ele 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 do componente chatbot, como a cor da fonte e o plano de fundo. Para alterar, atualize o parâmetro "webChatHeaderStyleOptions" com os valores das propriedades "fontColor" e "backgroundColor": "webChatHeaderStyleOptions": {"fontColor":'black',"backgroundColor":'white'}
6: backgroundColor 7: bubbleBackgroundcolor 8: bubbleTextColor 9: bubbleFromUserBackground 10: bubbleFromUserTextColor	webChatCanvasStyleOptions	Determina o estilo da tela do chat para o componente do chatbot, como o plano de fundo e os planos de fundo da bolha do chatbot e do usuário. Para alterar, atualize os parâmetros "webChatCanvasStyleOptions" com os valores das 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 componente ChatWidget, como a cor do ícone e o plano de fundo. Para alterar, atualize o parâmetro "webChatWidgetStyleOptions" com os valores das propriedades "backgroundColor" e "iconColor": "webChatWidgetStyleOptions": {"backgroundColor": "#486744","iconColor": "#DF234F"}

Depois de alterar o modelo da web, selecione Configuração de sincronização para atualizar a configuração e refletir as alterações.

Observação

Quaisquer alterações no modelo da Web do Power Virtual Agents diferentes dos parâmetros explicados acima não têm suporte.

Considerações adicionais

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

Versão do modelo de portal

Este recurso requer a versão do pacote do portal inicial 9.2.2103.x ou posterior. Se o seu modelo de portal não for atualizado para adicionar suporte ao componente chatbot, você verá a seguinte mensagem ao tentar adicionar o componente:

"Atualização de portal necessária: é necessária uma atualização para usar este recurso em seu portal. Se você atualizar o portal, verifique se a Configuração de Sincronização atualiza sua sessão do Estúdio de portais com o novo pacote de portais."

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

Observação

A atualização do pacote do portal inicial habilitará quaisquer portais adicionais em seu ambiente com a capacidade de usar o componente chatbot. Mais informações: Atualizações do pacote do portal do iniciante

Exclusão da solução

Este recurso vem com um solução de portal chamada MicrosoftPortalBot com o nome de exibição Portais do Dynamics 365 - Bot. Seu portal irá parar de funcionar se você excluir essa solução e não realizar a ação a seguir.

Se excluir a solução MicrosoftPortalBot, você deverá reiniciar seu portal para garantir que ele funcione corretamente.

Para reiniciar o portal:

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

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

3. Selecione Reiniciar para reiniciar o portal.

   Importante

   A reinicialização do portal o tornará indisponível por vários minutos, e os usuários não conseguirão acessar a URL do portal durante esse período.

4. Selecione Reiniciar para confirmar a reinicialização do portal.

Consulte também

• Adicionar o bot ao seu site ativo

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).