Partilhar via

Adicionar um copiloto ao Facebook

  • Artigo

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Você pode adicionar seu copiloto ao Facebook Messenger e usar a experiência do Facebook para se envolver com seus usuários finais.

O Facebook Messenger e serviços relacionados estão sujeitos aos próprios termos e condições do Facebook. Para obter suporte relacionado ao Facebook Messenger, entre em contato diretamente com o Facebook.

Importante

Este artigo é destinado a profissionais de TI experientes que gerenciam a página do Facebook da sua organização.

Observação

Ao publicar seu copiloto em uma página do Facebook, alguns dos dados, como o conteúdo do copiloto e o conteúdo da conversa com o usuário final, serão compartilhados com o Facebook (o que significa que seus dados sairão dos limites geográficos ou regionais e de conformidade da sua organização).
Para obter mais informações, consulte as Políticas da Plataforma do Facebook.

Adicionar seu copiloto ao Facebook Messenger

Você precisa de um aplicativo Facebook e uma conta de desenvolvedor associada para conectar seu copiloto do Copilot Studio ao Facebook Messenger nas páginas do Facebook.

Para conectar seu copiloto ao Facebook Messenger:

  1. Configure as configurações do aplicativo Facebook: recupere as informações do aplicativo Facebook, habilite o acesso à API, adicione o Facebook Messenger ao seu aplicativo e configure as páginas do Facebook nas quais seu aplicativo deve aparecer.

  2. Configure o canal de publicação do Facebook no Copilot Studio.

  3. Conecte o aplicativo Facebook ao Copilot Studio usando webhooks.

Você precisará enviar o aplicativo para análise do Facebook para poder publicá-lo e torná-lo público.

Configurações do aplicativo Facebook

Recuperar as informações do aplicativo Facebook

  1. Entre no aplicativo Facebook ao qual você deseja adicionar o copiloto em Facebook para Desenvolvedores.

  2. Em Configurações no painel do menu lateral, selecione Básico.

  3. Copie a ID do Aplicativo e o Segredo do Aplicativo. Você precisará desses valores quando configurar o canal do Facebook no Copilot Studio.

    Obtenha a ID do aplicativo e o segredo do Facebook.

Habilitar o acesso à API para o aplicativo Facebook

  1. Entre no aplicativo Facebook ao qual você deseja adicionar o copiloto em Facebook para Desenvolvedores.

  2. Em Configurações no painel do menu lateral, selecione Avançado.

  3. Verifique se a opção Permitir acesso da API às configurações do aplicativo está configurada como Sim.

  4. Selecione Salvar alterações para confirmar as alterações.

    Permita o acesso da API às configurações do aplicativo.

Adicionar o Facebook Messenger ao aplicativo

  1. Entre no aplicativo Facebook ao qual você deseja adicionar o copiloto em Facebook para Desenvolvedores.

  2. Acesse o Painel. Na seção Adicionar um produto, selecione Configuração no bloco Messenger.

    Adicione o produto Messenger.

Configurar as páginas do Facebook

  1. Entre no aplicativo Facebook ao qual você deseja adicionar o copiloto em Facebook para Desenvolvedores.

  2. Selecione Configurações em Produtos e Messenger no painel do menu lateral.

  3. Adicione as páginas às quais você deseja adicionar o copiloto selecionando Adicionar ou remover páginas na seção Tokens de acesso. Você também pode criar uma nova página selecionando Criar nova página.

    Adicione a página do Facebook ao aplicativo Facebook.

  4. Ao adicionar páginas, verifique se a opção Gerenciar e acessar conversas da página no Messenger está configurada como Sim.

    Permissão do Messenger para a página.

  5. Copie o ID da página e o Token de cada página à qual você deseja adicionar o copiloto. Selecione Gerar Token para cada página. Você precisará dessas informações quando configurar o canal do Facebook no Copilot Studio.

    Obtenha a ID da página e o token.

Configurar o canal do Facebook no Copilot Studio

  1. Abra seu copiloto no Copilot Studio.

  2. Na barra de menus superior, selecione Canais.

  3. Selecione o bloco Facebook para abrir a janela de configuração.

  4. Cole o ID do aplicativo, o Segredo do Aplicativo, o ID da página e o Token recuperados anteriormente em seus respectivos campos.

    Forneça informações da página e do aplicativo Facebook.

  5. Pelo menos uma página é necessária, mas você pode selecionar Adicionar Página para adicionar mais páginas.

    Forneça informações de várias páginas do Facebook.

  6. Selecione Adicionar e aguarde a mensagem de confirmação. Quando a operação for bem-sucedida, copie a URL de retorno de chamada e Verificar token. Você precisará deles quando conectar seu aplicativo Facebook ao Copilot Studio.

    Obtenha informações do retorno de chamada para o Facebook.

Conectar seu aplicativo Facebook ao Copilot Studio

  1. Entre no aplicativo Facebook ao qual você deseja adicionar o copiloto em Facebook para Desenvolvedores.

  2. Selecione Configurações em Produtos e Messenger no painel do menu lateral.

  3. Na seção Webhooks, selecione Adicionar URL de retorno de chamada.

    Configure webhooks para o aplicativo Facebook.

  4. Forneça a URL de retorno de chamada e Verificar token da seção Configurar o canal do Facebook no Copilot Studio e selecione Verificar e salvar.

    Adicione a URL do retorno de chamada e verifique o token.

  5. Selecione Adicionar assinaturas para cada página à qual você deseja adicionar o copiloto.

    Adicione a assinatura de webhook.

  6. Selecione os seguintes campos:

    • messages
    • messaging_postbacks
    • messaging_optins
    • message_deliveries

  7. Selecione Salvar.

    Adicione campos de assinatura do webhook.

Enviar para análise do Facebook

Você precisará enviar seu aplicativo para análise do Facebook antes de tornar o aplicativo do Facebook público. O Facebook exige uma URL de Política de privacidade e uma de Termos de serviço. É necessário fornecê-las na página de configurações básicas do aplicativo Facebook (depois de entrar no aplicativo em Facebook para Desenvolvedores, selecione Básico em Configurações no painel do menu lateral).

A página de Código de conduta contém recursos de terceiros para ajudar a criar uma política de privacidade. A página de Termos de serviço contém exemplos de termos para ajudar a criar um documento apropriado de Termos de serviço.

O Facebook tem o seu próprio processo de análise para aplicativos publicados no Messenger. Você pode aprender mais sobre isso em Envios de exemplos e Motivos comuns de rejeição. Seu copiloto será testado para garantir que esteja em conformidade com as Políticas da Plataforma do Facebook antes de ser aprovado pelo Facebook para se tornar público.

Tornar o aplicativo público e publicar a página

Até ser publicado, o aplicativo está no Modo de desenvolvimento. O copiloto não será público e funcionará somente para administradores, desenvolvedores e testadores.

Após a análise ser bem-sucedida, no Painel do aplicativo, em Análise do aplicativo, defina o aplicativo como Público. Verifique se a página do Facebook associada ao copiloto foi publicada. O status aparece nas configurações de Páginas.

Remover seu copiloto do Facebook Messenger

Quando não quiser que o copiloto esteja acessível no Facebook Messenger, você poderá removê-lo do Facebook.

  1. Abra seu copiloto no Copilot Studio.

  2. Na barra de menus superior, selecione Canais.

  3. Selecione o bloco Facebook para abrir a janela de configuração.

  4. Selecione Excluir.

Como atualizar conteúdo do copiloto para conversas existentes no Facebook

Para evitar interrupções durante uma conversa entre um usuário e o copiloto, as conversas existentes não serão atualizadas para o conteúdo mais recente do copiloto imediatamente após uma nova publicação. Em vez disso, o conteúdo é atualizado após a conversa ficar inativa por 30 minutos.

Novas conversas entre usuário e copiloto terão o conteúdo do copiloto mais recente publicado.

Limitações conhecidas

  • Você precisará criar um novo copiloto se a pesquisa de satisfação do cliente (CSAT) aparecer como uma imagem de cartão não interativa para um copiloto criado durante a versão preliminar pública para acessar o conteúdo mais recente da CSAT.
  • Pode levar alguns minutos para que o copiloto se torne acessível para usuários nas páginas do Facebook após a adição do canal do Facebook.
  • Após a remoção de um canal do Facebook, pode levar alguns minutos para que o copiloto seja removido completamente e se torne inacessível no Facebook Messenger.
  • Após a remoção de uma página do Facebook, pode levar alguns minutos para que o copiloto se torne inacessível para visitantes da página removida por meio do Facebook Messenger.