Implantar um conector de páginas do Facebook Business para arquivar dados no Microsoft 365

Este artigo descreve o processo de implantação de um conector que usa o serviço de importação do Microsoft 365 para importar dados das páginas do Facebook Business para o Microsoft 365. Para obter uma visão geral de alto nível desse processo e uma lista de pré-requisitos necessários para implantar um conector do Facebook, consulte Configurar um conector para arquivar dados do Facebook.

Etapa 1: Criar um aplicativo no Microsoft Entra ID

Conclua as etapas a seguir para criar e registrar um aplicativo no Microsoft Entra ID.

  1. https://portal.azure.com Acesse e entre com as credenciais de uma conta de administrador global.

    Captura de tela da página inicial do portal do Azure para criar um registro de aplicativo do Microsoft Entra ID.

  2. Na navegação à esquerda, selecione Microsoft Entra ID.

    Captura de tela do painel de navegação esquerdo do portal do Azure com o Microsoft Entra ID selecionado.

  3. Na navegação à esquerda, selecione Registros de aplicativo (Versão prévia) e, em seguida, selecione Novo registro.

    Captura de tela da página de Registros de aplicativo com a opção Novo registro realçada.

  4. Registre o aplicativo. Em URI de redirecionamento, selecione Web na lista suspensa do tipo de aplicativo e insira https://portal.azure.com na caixa URI.

    Captura de tela da página Registrar um aplicativo com o nome, o URI de redirecionamento e o botão Registrar.

  5. Copie a ID do aplicativo (cliente) e a ID do diretório (locatário) e salve-as em um arquivo de texto ou em outro local seguro. Você usará essas IDs em etapas posteriores.

    Captura de tela da página de visão geral do aplicativo mostrando os valores de ID do Aplicativo e ID do Diretório a serem copiados.

  6. Vá para Certificados & segredos para o novo aplicativo.

    Captura de tela da página Certificados e segredos do novo aplicativo no portal do Azure.

  7. Selecione Novo segredo do cliente.

    Captura de tela da seção Segredos do cliente com o botão Novo segredo do cliente destacado.

  8. Criar um novo segredo. Na caixa de descrição, digite o segredo e selecione um período de expiração.

    Captura de tela da caixa de diálogo Adicionar um segredo do cliente com os campos descrição e período de expiração.

  9. Copie o valor do segredo e salve-o em um arquivo de texto ou em outro local de armazenamento. Esse é o segredo do aplicativo do Microsoft Entra que você usará nas etapas posteriores.

    Captura de tela do valor do segredo do cliente exibido após a criação para copiar para um local seguro.

Etapa 2: Implantar o serviço Web conector do GitHub para sua conta do Azure

Conclua as etapas a seguir para implantar o serviço Web conector do GitHub em sua conta do Azure.

  1. Acesse o repositório do conector de exemplo do Microsoft 365 e selecione Implantar no Azure.

    Captura de tela da página do repositório GitHub com o botão Implantar no Azure destacado.

  2. Depois de selecionar Implantar no Azure, você será redirecionado para um portal do Azure com uma página de modelo personalizada. Preencha os detalhes de Noções básicas e configurações e selecione Comprar.

    • Assinatura: Selecione a assinatura do Azure na qual você deseja implantar o serviço Web do conector de páginas do Facebook Business.

    • Grupo de recursos: Selecione ou crie um novo grupo de recursos. Um grupo de recursos é um contêiner que armazena os recursos relacionados de uma solução do Azure.

    • Localização: Selecione um local.

    • Nome do aplicativo Web: Forneça um nome exclusivo para o aplicativo Web do conector. O nome deve ter entre 3 e 18 caracteres. Esse nome é usado para criar a URL do serviço de aplicativo Azure; por exemplo, se você fornecer o nome do aplicativo Web do fbconnector, a URL do serviço de aplicativo Azure será fbconnector.azurewebsites.net.

    • tenantId: A ID de locatário da sua organização do Microsoft 365 que você copiou depois de criar o aplicativo conector do Facebook no Microsoft Entra ID na Etapa 1.

    • APISecretKey: Você pode digitar qualquer valor como o segredo. Esse valor é usado para acessar o aplicativo Web do conector na Etapa 5.

      Captura de tela da página do modelo de implantação personalizada do Azure com os campos Básico e Configurações preenchidos.

  3. Depois que a implantação for bem-sucedida, a página será semelhante à seguinte captura de tela:

    Captura de tela do portal do Azure mostrando a implantação bem-sucedida do serviço Web do conector.

Etapa 3: registrar o aplicativo do Facebook

Conclua as etapas a seguir para registrar e configurar um aplicativo do Facebook para o conector.

  1. Acesse https://developers.facebook.com, entre com as credenciais da conta das páginas de Negócios do Facebook da sua organização e selecione Adicionar Novo Aplicativo.

    Captura de tela da página do Facebook para Desenvolvedores com a opção Adicionar Novo Aplicativo destacada.

  2. Crie uma nova ID de aplicativo.

    Captura de tela da caixa de diálogo Criar uma nova ID do aplicativo do Facebook com os campos obrigatórios exibidos.

  3. Na navegação à esquerda, selecione Adicionar produtos e, em seguida, selecione Configurar no bloco de login do Facebook.

    Captura de tela do dashboard do aplicativo do Facebook com Adicionar produtos selecionado e o bloco de login do Facebook visível.

  4. Na página Integrar login do Facebook, selecione Web.

    Captura de tela da página de login Integrar do Facebook com a opção plataforma Web selecionada.

  5. Adicione a URL do serviço de aplicativo do Azure, como https://fbconnector.azurewebsites.net.

    Captura de tela da página de configuração de Logon do Facebook com a URL do serviço de aplicativo do Azure inserida no campo URL do Site.

  6. Conclua a seção Início rápido da configuração de login do Facebook.

    Captura de tela da seção de Início Rápido concluída do assistente de configuração de Login do Facebook.

  7. Na navegação à esquerda, em Login do Facebook, selecione Configurações e adicione o URI de redirecionamento OAuth na caixa URIs de redirecionamento OAuth válidos. Use o formato <connectorserviceuri>/Views/FacebookOAuth, em que o valor para connectorserviceuri é a URL do serviço de aplicativo do Azure para sua organização; por exemplo, https://fbconnector.azurewebsites.net.

    Captura de tela da página Configurações de Logon do Facebook com o URI de redirecionamento OAuth no campo URIs de redirecionamento OAuth válidos.

  8. Na navegação à esquerda, selecione Adicionar produtos e, em seguida, selecione Webhooks. No menu suspenso Página , selecione Página.

    Captura de tela do dashboard do aplicativo do Facebook com Adicionar produtos selecionado e o bloco de produtos Webhooks.

  9. Adicione a URL de retorno de chamada de Webhooks e adicione um token de verificação. Para a URL de retorno de chamada, use o formato <connectorserviceuri>/api/FbPageWebhook, em que o valor de connectorserviceuri é a URL do serviço de aplicativo do Azure para sua organização; por exemplohttps://fbconnector.azurewebsites.net.

    O token de verificação deve ser semelhante a uma senha forte. Copie o token de verificação para um arquivo de texto ou outro local de armazenamento.

    Captura de tela da página de configuração de Webhooks com os campos de retorno de chamada e token de verificação configurados.

  10. Teste e assine o ponto de extremidade para feed.

    Captura de tela da página Webhooks mostrando o ponto de extremidade do feed com opções de teste e assinatura.

  11. Adicione uma URL de privacidade, ícone de aplicativo e uso comercial. Além disso, copie a ID e o segredo do aplicativo para um arquivo de texto ou outro local de armazenamento.

    Captura de tela da página de configurações do aplicativo do Facebook com os campos de privacidade, ícone do aplicativo e uso comercial.

  12. Torne o aplicativo público.

    Captura de tela da página de configurações de revisão do aplicativo do Facebook com a alternância para tornar o aplicativo público.

  13. Adicione usuário à função de administrador ou testador.

    Captura de tela da página Funções do aplicativo do Facebook com a opção de adicionar um usuário à função de administrador ou testador.

  14. Adicione a permissão de Acesso ao Conteúdo Público da Página .

    Captura de tela da página de permissões do aplicativo do Facebook com a permissão de Acesso ao Conteúdo Público da Página adicionada.

  15. Adicionar permissão Gerenciar Páginas .

    Captura de tela da página de permissões do aplicativo do Facebook com a permissão Gerenciar Páginas adicionada.

  16. Faça com que o aplicativo seja revisado pelo Facebook.

    Captura de tela da página de avaliação do aplicativo do Facebook mostrando o envio da inscrição para análise pelo Facebook.

Etapa 4: Configurar o aplicativo Web do conector

Conclua as etapas a seguir para configurar o aplicativo Web do conector com as credenciais e configurações necessárias.

  1. Vá para https://<AzureAppResourceName>.azurewebsites.net (em que AzureAppResourceName é o nome do recurso de aplicativo do Azure que você nomeou na Etapa 4). Por exemplo, se o nome for fbconnector, vá para https://fbconnector.azurewebsites.net. A página inicial do aplicativo se parece com a seguinte captura de tela:

    Captura de tela da página inicial do aplicativo Web do conector do Facebook na URL do serviço de aplicativo do Azure.

  2. Selecione Configurar para exibir uma página de entrada.

    Captura de tela do aplicativo Web conector com o botão Configurar para exibir a página de entrada.

  3. Na caixa ID do locatário, digite ou cole a ID do locatário (obtida na Etapa 1). Na caixa de senha, digite ou cole a APISecretKey (obtida na Etapa 2) e selecione Definir definições de configuração para exibir a página de detalhes da configuração.

    Captura de tela da página de entrada com os campos ID do locatário e senha para acessar as configurações.

  4. Insira as seguintes configurações:

    • ID do aplicativo do Facebook: o ID do aplicativo para o aplicativo do Facebook que você obteve na Etapa 3.

    • Segredo do aplicativo do Facebook: o segredo do aplicativo para o aplicativo do Facebook que você obteve na Etapa 3.

    • Token de verificação de webhooks do Facebook: o token de verificação que você criou na Etapa 3.

    • ID do aplicativo Microsoft Entra: a ID do aplicativo para o aplicativo Microsoft Entra que você criou na Etapa 1.

    • Segredo do aplicativo do Microsoft Entra: o valor do segredo APISecretKey criado na Etapa 1.

  5. Selecione Salvar para salvar as configurações do conector.

Etapa 5: configurar um conector do Facebook

Conclua as etapas a seguir para configurar um conector do Facebook no portal do Microsoft Purview.

  1. Entre no portal do Microsoft Purview.

  2. Selecione Configurações>Conectores de dados.

  3. Selecione Meus conectores e, em seguida, selecione Adicionar conector.

  4. Na lista, selecione Páginas do Facebook Business.

  5. Na página Termos de serviço , selecione Aceitar.

  6. Na página Adicionar credenciais para seu aplicativo conector , insira as seguintes informações e selecione Validar conexão.

    • Na caixa Nome, digite um nome para o conector, como Página de notícias do Facebook.
    • Na caixa URL de Conexão, digite ou cole a URL do serviço de aplicativo do Azure, como https://fbconnector.azurewebsites.net.
    • Na caixa Senha , digite ou cole o valor da APISecretKey que você adicionou na Etapa 2.
    • Na caixa ID do Azure App, digite ou cole o valor da ID do aplicativo (cliente), também chamada de ID do aplicativo do Microsoft Entra, que você criou na Etapa 1.
  7. Depois que a conexão for validada com êxito, selecione Avançar.

  8. Na página Autorizar o Microsoft 365 a importar dados , digite ou cole a APISecretKey novamente e selecione Aplicativo Web de Logon.

  9. Na página Configurar o aplicativo Conector do Facebook, selecione Entrar com o Facebook e entre usando as credenciais da conta das páginas do Facebook Business da sua organização. Certifique-se de que a conta do Facebook na qual você entra está inscrita tenha a função de administrador para as páginas comerciais do Facebook da sua organização.

  10. É exibida uma lista das páginas comerciais gerenciadas pela conta do Facebook na qual você entra entrar. Selecione a página a ser arquivada e, em seguida, selecione Avançar.

  11. Selecione Continuar para sair da configuração do aplicativo de serviço do conector.

  12. Na página Definir filtros , você pode aplicar um filtro para importar inicialmente itens que tenham uma determinada idade. Selecione uma idade e, em seguida, selecione Avançar.

  13. Na página Escolher local de armazenamento, digite o endereço de email da caixa de correio do Microsoft 365 para a qual os itens do Facebook serão importados e selecione Avançar.

  14. Selecione Avançar para revisar as configurações do conector e, em seguida, selecione Concluir para concluir a configuração do conector.