Configurar a integração de Virtual Agent com Facebook Messenger (legado)

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Configure a integração Virtual Agent para Facebook Messenger e associe o aplicativo à sua instância.

    Antes de Iniciar

    Você já deve ter o seguinte:

    Funções necessárias:

    • virtual_agent_admin e external_app_install_admin ou admin.
    • Administrador para aplicações de terceiros.

    Procedimento

    1. No desenvolvedor do Facebook, navegue até Messenger > Configurações.
      1. Localize a seção Geração de token.
      2. Na lista de páginas, selecione a página do Facebook que você criou e anote o Token de acesso à página gerado.
      3. Localize a seção Webhooks e clique em Configurar Webhooks.
      4. Na janela pop-up Nova assinatura de página exibida, insira os seguintes campos:
        Campo Valor
        URL de retorno de chamada. O URL da instância ServiceNow seguido por /api/now/v1/cs/adapter/messenger/message.
        Verificar token. nowbot
        Campos de assinatura Selecione mensagens e messaging_postbacks
      5. Clique em Verificar e Salvar.
    2. Na instância ServiceNow, insira hash_message_verification.list no Navegador de filtros.
      1. No formulário Verificações de hash de mensagens, clique em Novo para criar um novo registro.
      2. Insira estes campos:
        Campo Valor
        Nome Nome que ajuda a identificar esse registro. Este campo tem como padrão sample-fb-messenger-inbound-app-token, mas esse padrão pode ser alterado.
        Descrição Descrição do registro
        Segredo Segredo do aplicativo Facebook Messenger (o segredo foi gerado quando você criou o aplicativo).
      3. Clique em Enviar.
    3. Na instância ServiceNow, insira token_verification.list no Navegador de filtros.
      1. No formulário Verificações de token, clique em Novo para criar um novo registro.
      2. Insira estes campos:
        Campo Valor
        Nome Nome que ajuda a identificar esse registro. Este campo tem como padrão sample-fb-messenger-outbound-app-token, mas esse padrão pode ser alterado.
        Descrição Descrição do registro
        Token Token de acesso à página do app Facebook Messenger (da etapa 1b deste procedimento)
      3. Clique em Enviar.
    4. Na instância ServiceNow, insira message_auth.list no Navegador de filtros.
      1. Na página de Autenticação de mensagem, clique em Novo para criar um novo registro.
      2. Insira estes campos:
        Campo Valor
        Nome Nome que ajuda a identificar esse registro. Este campo tem como padrão sample-fb-messenger-app, mas esse padrão pode ser alterado.
        Provedor Nome do provedor
        Verificação de mensagem de entrada. Nome especificado no formulário de Verificações de mensagens de hash (este token verifica se a solicitação veio de fato do provedor).
        Criação de mensagem de saída. Nome especificado no formulário de Verificação de token (esse token interage com o provedor em nome do usuário)
      3. Clique em Enviar.
    5. Na instância ServiceNow, insira sys_cs_adapter_configuration_page_messenger.list no Navegador de filtros.
      1. Na Página de configuração do adaptador do Facebook Messenger, clique em Novo para criar um novo registro.
      2. Insira estes campos:
        Campo Valor
        Tipo do aplicativo Assume como padrão o Facebook Messenger e não pode ser alterado.
        ID da Página do Messenger. O ID da sua página (o ID da página pode ser encontrado no URL da página do Facebook).
        Nome Nome que ajuda a identificar esse registro. Este campo tem como padrão sample-fb-messenger-app, mas esse padrão pode ser alterado.
        Autenticação do provedor Nome especificado na página de Autenticação de mensagem
    6. Clique em Enviar.
    7. Configure se os usuários devem ser solicitados a vincular seus perfis ao perfil ServiceNow.
      1. No Filtro de navegação, insira sys_properties.list.
      2. Navegue até va.messenger.account.auth e clique nele .
      3. No campo Valor, insira verdadeiro ou falso.
        verdadeiro Solicitar que os usuários vinculem suas contas ao perfil ServiceNow deles. Os usuários que vinculam suas contas ao perfil ServiceNow deles podem acessar todos os tópicos e conversar com um atendente. Usuários que não vincularem suas contas só poderão acessar tópicos de convidados.
        falso Não solicite aos usuários que vinculem suas contas ao seus perfis ServiceNow. Os usuários só podem acessar tópicos de convidados, mas ainda podem conversar com um atendente.
      4. Clique em Atualizar.