glean-webhooks-events

Glean Webhooks & Events

Overview

Glean does not send webhooks. Instead, build event-driven connectors that receive webhooks from source systems (GitHub, Confluence, Notion) and push incremental updates to the Glean Indexing API.

Instructions

GitHub Webhook -> Glean Indexing

// Receive GitHub wiki/page webhooks, index into Glean
app.post('/webhooks/github', async (req, res) => {
  const event = req.body;

  if (event.action === 'created' || event.action === 'edited') {
    await glean.indexDocuments('github_wiki', [{
      id: `wiki-${event.page.sha}`,
      title: event.page.title,
      url: event.page.html_url,
      body: { mimeType: 'text/html', textContent: event.page.body },
      author: { email: event.sender.email },
      updatedAt: new Date().toISOString(),
      permissions: { allowAnonymousAccess: true },
    }]);
  }

  res.sendStatus(200);
});

Confluence Webhook -> Glean Indexing

app.post('/webhooks/confluence', async (req, res) => {
  const { event, page } = req.body;

  if (event === 'page_updated' || event === 'page_created') {
    const content = await fetchConfluencePage(page.id);
    await glean.indexDocuments('confluence_custom', [{
      id: `conf-${page.id}`,
      title: content.title,
      url: `${CONFLUENCE_URL}/wiki/spaces/${content.space.key}/pages/${page.id}`,
      body: { mimeType: 'text/html', textContent: content.body.storage.value },
      updatedAt: content.version.when,
    }]);
  }

  if (event === 'page_removed') {
    await glean.deleteDocument('confluence_custom', `conf-${page.id}`);
  }

  res.sendStatus(200);
});

Resources

• Glean Index Documents