This repository contains a Javascript function to "unfurl" GoTo join and registration links. From a meeting id, name or a webinar key, the function fetches the meeting/webinar organizer and session details, and returns html tags parsed by social media.
Example of unfurled join link in Slack:
See below other examples.
The function returns tags as documented in the "classic unfurling" section of this Slack doc https://api.slack.com/docs/message-link-unfurling
The function is currently deployed on Netlify at https://tvanier.netlify.app/goto-unfurl
/join/{meeting-id} where {meeting-id} is either
- a 9-digit id such as
123456789 - a meeting room name such as
my-room
/register/{webinar-key} where {webinar-key} is a webinar key, usually 18 or more characters
The current function implementation has no external dependency on purpose, to illustrate how one single JS file can be deployed as a cloud function with no build step. The function runs on Node.js version 10 or greater.
The whole function code is in goto-unfurl.js, which currently
- works against the GoTo production environment
- fetches images (ex: logo) from
tvanier.netlify.app - is meant to be deployed on Netlify as documented here https://docs.netlify.com/functions/overview/
The function can be tested locally by running the test.js script, which takes a path as first argument. Examples:
node test.js /join/123456789
node test.js /register/123456789123456789
The test script prints the function return to the console.
When deploying to a cloud, like Netlify for example, the function can be invoked with utilities like curl:
curl https://tvanier.netlify.app/goto-unfurl/join/123456789
curl https://tvanier.netlify.app/goto-unfurl/register/123456789123456789
End-to-end testing can be perfomed by sharing links in social media. In Slack, it is possible to send links to yourself.
The links should also work in other media such as Facebook and Twitter (not tested).