Preview

## Rows: 1 Columns: 10
## ── Column specification ────────────────────────────────────────────────────────
## Delimiter: "\t"
## chr  (4): event_type, name, status, uri
## lgl  (2): meeting_notes_html, meeting_notes_plain
## dttm (4): created_at, end_time, start_time, updated_at
## 
## ℹ Use `spec()` to retrieve the full column specification for this data.
## ℹ Specify the column types or set `show_col_types = FALSE` to quiet this message.
knitr::kable(calendly)
created_at end_time event_type meeting_notes_html meeting_notes_plain name start_time status updated_at uri
2024-01-10 14:29:21 2024-01-17 14:30:00 https://api.calendly.com/event_types/d39d7211-9c78-4121-8271-208cfaa34989 NA NA 30 Minute Meeting 2024-01-17 14:00:00 active 2024-01-10 14:29:22 https://api.calendly.com/scheduled_events/ac7a3d65-37ee-4277-a057-c308bdc7a067

Setting Up Calendly

To set up Calendly authorization, go to the Calendly API and webhooks integrations page and click “Generate Token”.

Underneath “Choose a name for this token”, pick a name that will remind you of this project. Click “Create Token” and Calendly will send you an authorization code to your email. After you enter that authorization code, click “Copy Token” and keep this handy.

Then, return to your metricminer dashboard repository and go to Settings > Secrets and variables > Actions.

  • Click on New repository secret. Name your new secret exactly METRICMINER_CALENDLY
  • Paste your token into the Secret box and then click the green “Add secret” button.

Important: metricminer does not remove or redact identifying information that may be included in the data you collect, such as names, email addresses, or Calendly meeting notes. Review your data before sharing or publishing it.

After you’ve set up authorization you’ll need to check the following items in the _config_automation.yml file.

###### Calendly ######
refresh-calendly: yes
calendly_googlesheet:

  • In the _config_automation.yml file, make sure that refresh-calendly is set to “yes”.

  • Optionally, if you are saving data to Google, specify a googlesheet ID in calendly_googlesheet where you’d like the Calendly data to be saved. This will only be relevant if you’ve set data_dest to google.

Customizing the data

In order to customize the data you are downloading from calendly you can modify the refresh-scripts/refresh-calendly.R script in your repository.

You can take a look at the metricminer R package documentation for more details about the functions and what is possible.

If you have a metric need that is not currently fulfilled by metricminer or metricminer-dashboard we encourage you to file a GitHub issue with us and let us know about your new feature idea (or bug report).