To bridge Figma webhooks with Hookshot, you will need:
- A personal access token with admin access to the team you intend to bridge.
- A figma account that is on the professional tier, as the free tier does provide webhook access.
- Your team ID. You can get this by going to the team page on Figma, and looking for the ID in the url (e.g. 12345 in `https://www.figma.com/files/team/12345/...`)
## Configuration
You can now set some configuration in the bridge `config.yml`
```yaml
figma:
publicUrl: https://example.com/hookshot/
instances:
your-instance:
teamId: your-team-id
accessToken: your-personal-access-token
passcode: your-webhook-passcode
```
`your-instance` should be a friendly name for your instance E.g. `matrix-dot-org`.
The `publicUrl` value must be the **public** path to `/figma/webhook` on the webhooks listener. E.g. if your load balancer points `https://example.com/hookshot` to the bridge's webhooks listener, you should use the path `https://example.com/hookshot/figma/webhook`.
The `accessToken` should be the personal access token for your account.
The `passcode` should be a randomly generated code which is used to authenticate requests from Figma.
The bridge will automatically set up a webhook on Figma for you upon startup, and will automatically reconfigure that webhook if the `publicUrl` or `passcode` changes.
