-
Notifications
You must be signed in to change notification settings - Fork 16
Integrations FAQ
Accounts on opencollective.com need a bank account associated, so use staging.opencollective.com for testing. Make sure to switch the USE_STAGING variable in settings.py so that metagov is querying the staging URL.
Project webhooks are hidden from the UI. To get there, go to the settings page and add /webhooks, ie: https://www.opencollective.com/metagov-test-collective/projects/another-project/admin/webhooks
Pass the discussion_id integer parameter when starting the loomio.poll governance process. To find the ID of an existing discussion thread in Loomio, click on the ellipsis icon on the top right of your Loomio project page. Click Export Group Data and then Export Group Data as HTML. This will open a new tab with your Loomio group data. Find the discussion id in the leftmost column Id in the Discussions section.
Log into Loomio as an administrator, and navigate to Settings > Integrations > Add Integration > API. Select all API scopes. Enter a name for the integration and save. To find the API key, navigate to 'See API Usage' for the new integration.
Log into Loomio as an administrator, and navigate to Settings > Integrations > Edit Integration > Webhook. Enter the Webhook URL. Select Markdown format and all event types.
When enabling the Loomio Plugin, input the subgroup's API key in the subgroup_api_keys array. If you have multiple subgroups, you'll need to generate and input one API key for each subgroup. To generate an API Key for your subgroup in Loomio, go to Subgroups, click on your subgroup, and then follow the steps above to generate the API key. The webhook URL registration steps must be duplicated for each subgroup as well (although each group will same webhook URL).
Subgroups are only supported for actions and processes on the Metagov Loomio Plugin that accept a subgroup parameter. This is the "slug" of the subgroup, which can be found in the Loomio URL. For example if the subgroup URL is https://www.loomio.org/my-subgroup-slug/, the subgroup parameter should be my-subgroup-slug.