b27f01449a
* start make app integration * setup integration * add relevant env vars * update app metadata * import setup route in app setups * fix typo * add app store imports * fix module import error * update make readme * move scheduler to app-store utils * move add subscription to node scheduler * move delete subscription to scheduler * subscribe unsubscribe in zapier using common nodeScheduler * fix lint errors * revert settings.json * update icon * add app screenshots * fix app description * fix type errors * update app code * Delete .gitkeep * delete unused template files * get app invite link from env vars * chore: handle error, cleanup readme, address review comments * fix: update link in readme * revert yarn.lock * fix type errors * Update packages/prisma/seed-app-store.ts * Update .env.appStore.example * Update .env.appStore.example * update app readme * fix param name in deleteSubcription * fix listBookings handler * Update turbo.json * use default installation handler to install app * use logger for console logs * Fix inviteLink reading * fix app setup handler * Fix type issue * always show app invite link * fix type error * add make invite link --------- Co-authored-by: Peer Richelsen <peeroke@gmail.com> Co-authored-by: Carina Wollendorfer <30310907+CarinaWolli@users.noreply.github.com> Co-authored-by: Hariom Balhara <hariombalhara@gmail.com> Co-authored-by: CarinaWolli <wollencarina@gmail.com> |
||
---|---|---|
.. | ||
api | ||
components | ||
pages/setup | ||
static | ||
DESCRIPTION.md | ||
README.md | ||
_metadata.ts | ||
index.ts | ||
package.json | ||
zod.ts |
README.md
Setting up Zapier Integration
If you run it on localhost, check out the additional information below.
- Create Zapier Account
- If not redirected to developer account, go to: Zapier Developer Account
- Click Start a Zapier Integration
- Create Integration
- Name: Cal.com
- Description: Cal.com is a scheduling infrastructure for absolutely everyone.
- Intended Audience: Private
- Role: choose whatever is appropriate
- Category: Calendar
Authentication
- Go to Authentication, choose Api key and click save
- Click Add Fields
- Key: apiKey
- Check the box ‘is this field required?’
- Configure a Test
- Test: GET
<baseUrl>
/api/integrations/zapier/listBookings - URL Params
- apiKey: {{bundle.authData.apiKey}}
- Test: GET
- Test your authentication —> First you have to install Zapier in the Cal.com App Store and generate an API key, use this API key to test your authentication (only zapier Api key works)
Triggers
Booking created, Booking rescheduled, Booking cancelled, Meeting ended
Booking created
- Settings
- Key: booking_created
- Name: Booking created
- Noun: Booking
- Description: Triggers when a new booking is created
- API Configuration (apiKey is set automatically, leave it like it is):
- Trigger Type: REST Hook
- Subscribe: POST
<baseUrl>
/api/integrations/zapier/addSubscription- Request Body
- subscriberUrl: {{bundle.targetUrl}}
- triggerEvent: BOOKING_CREATED
- Request Body
- Unsubscribe: DELETE
<baseUrl>
/api/integrations/zapier/deleteSubscription- URL Params (in addition to apiKey)
- id: {{bundle.subscribeData.id}}
- URL Params (in addition to apiKey)
- PerformList: GET
<baseUrl>
/api/integrations/zapier/listBookings
- Test your API request
Create the other triggers (booking rescheduled, booking cancelled and meeting ended) exactly like this one, just use the appropriate naming (e.g. booking_rescheduled instead of booking_created)
Set ZAPIER_INVITE_LINK
The invite link can be found under under Manage → Sharing.
Localhost
Localhost urls can not be used as the base URL for api endpoints
Possible solution: using https://ngrok.com/
- Create Account
- Download gnork and start a tunnel to your running localhost
- Use forwarding url as your baseUrl for the URL endpoints