gist/matrix/uk.half-shot.matrix-hookshot.feed
2023-03-31 17:59:21 +03:00
..
README.md matrix/hookshot: note it working without integration manager 2023-03-31 17:59:21 +03:00

hookshot room state configuration

When Hookshot is configured via the manage integrations menu, it appears to perform two state installations/directories/whatever:

  • uk.half-shot.matrix-hookshot.feed
    • contains state events with the feed name
      • contains the json below
  • io.element.integrations.installations
    • contains uuid below

feed

This entry is the feed url e.g. https://feeds.yle.fi/uutiset/v1/recent.rss?publisherIds=YLE_NEWS, and contains:

{
  "label": "YLE News in English",
  "url": "https://feeds.yle.fi/uutiset/v1/recent.rss?publisherIds=YLE_NEWS"
}

installation

This probably has or should be left for the integration manager.

{
  "appId": "hookshot-feeds",
  "installationId": "uuid-goes-here",
  "userIds": ["@feeds:integrations.ems.host"],
  "widgetIds": []
}

Usage without integration manager

Hookshot appears to answer /invite @feeds:integrations.ems.host and !feeds help so it will hopefully work without having to touch an integration manager for benefit of Element iOS users.

Note that the bot will likely require power level to touch room state so it will in most cases require power level 50.