106 lines
4.0 KiB
Plaintext
106 lines
4.0 KiB
Plaintext
---
|
|
title: Booking redirects
|
|
description: Find out how to manage the booking flow.
|
|
"icon": "clipboard"
|
|
---
|
|
|
|
When creating an OAuth client you can specify:
|
|
1. booking URL to manage where people land after booking after one of your users.
|
|
2. reschedule URL to your page for rescheduling a booking.
|
|
3. cancel URL to your page for cancelling a booking.
|
|
|
|
This guide will explain each of the URLs and how to create page for each of them using atoms and our hooks.
|
|
|
|
## Booking URL
|
|
|
|
After a person books one of your users, that person should see the successful booking.
|
|
|
|
<img src="/images/booking-page.png" width="800" height="800" />
|
|
|
|
Page in the booking URL will take URL parameter provided by us and then hook to fetch the booking and then display it. Here is an example:
|
|
|
|
1. Pass `my-app.com/bookings` as the redirectURI.
|
|
2. In your app, create `my-app.com/bookings/[bookingUid]` page where bookingUid will become path parameter.
|
|
3. When a booking occurs, booker will be re-directed to the redirectURI with booking UID as the bookingUid parameter aka my-app.com/bookings/[bookingUid].
|
|
4. In the my-app.com/bookings/[bookingUid] route create a page that imports `useGetBooking` hook, then extract bookingUid from URL parameter, and uses the hook to display booking information:
|
|
|
|
```js
|
|
import { useGetBooking } from "@calcom/atoms";
|
|
|
|
export default function Bookings(props: { calUsername: string; calEmail: string }) {
|
|
const router = useRouter();
|
|
|
|
const { isLoading, data: booking, refetch } = useGetBooking((router.query.bookingUid as string) ?? "");
|
|
|
|
return (
|
|
<p>{booking.title}</p>
|
|
)
|
|
};
|
|
```
|
|
|
|
An example implementation can be found [here](https://github.com/calcom/cal.com/blob/main/packages/platform/examples/base/src/pages/%5BbookingUid%5D.tsx).
|
|
|
|
## Reschedule URL
|
|
|
|
1. Pass `my-app.com/bookings/reschedule` as the redirectURI.
|
|
2. When “Reschedule” is clicked, user will be re-directed to the redirectURI with rescheduled and eventTypeSlug query parameters `my-app.com/reschedule?rescheduleUid=buiaE8jHmNAxLrqitahCeL&eventTypeSlug=thirty-minutes`
|
|
3. In the my-app.com/reschedule route create a page that extracts `rescheduleUid` and `eventTypeSlug` from the query parameters and passes the to the `Booker` atom:
|
|
|
|
```js
|
|
const rescheduleUid = (router.query.rescheduleUid as string) ?? "";
|
|
const eventTypeSlugQueryParam = (router.query.eventTypeSlug as string) ?? "";
|
|
|
|
<Booker
|
|
rescheduleUid={queryParamRescheduleUid}
|
|
eventSlug={queryParamEventTypeSlug}
|
|
username={calUsername}
|
|
/>
|
|
```
|
|
|
|
You only need rescheduleUid, eventSlug and username.
|
|
|
|
An example implementation can be found [here](https://github.com/calcom/cal.com/blob/main/packages/platform/examples/base/src/pages/booking.tsx).
|
|
|
|
## Cancel URL
|
|
|
|
1. Pass `my-app.com/bookings/cancel` as the cancelURI.
|
|
2. In your app, create `my-app.com/bookings/cancel/[bookingUid]` page where bookingUid will become path parameter.
|
|
3. In the page of my-app.com/cancel/[bookingUid] import useCancelBooking from atoms and get access to the cancel mutation
|
|
import { useCancelBooking } from "@calcom/atoms";
|
|
|
|
```js
|
|
const { mutate: cancelBooking } = useCancelBooking({
|
|
onSuccess: () => {
|
|
refetch();
|
|
},
|
|
});
|
|
```
|
|
|
|
4. Create a cancel button that invokes mutation returned by the “useCancelBooking”. You have to pass id of the booking which you can get by fetching booking using "useGetBooking" hook by uid from the query params. Provide a suitable “cancellationReason”.
|
|
|
|
```js
|
|
import { useGetBooking, useCancelBooking } from "@calcom/atoms";
|
|
|
|
...
|
|
const { isLoading, data: booking, refetch } = useGetBooking((router.query.bookingUid as string) ?? "");
|
|
const { mutate: cancelBooking } = useCancelBooking({
|
|
onSuccess: () => {
|
|
refetch();
|
|
},
|
|
});
|
|
...
|
|
|
|
<button
|
|
className="underline"
|
|
onClick={() => {
|
|
cancelBooking({
|
|
id: booking.id,
|
|
cancellationReason: "User request",
|
|
});
|
|
}}>
|
|
Cancel
|
|
</button>
|
|
```
|
|
|
|
An example implementation can be found [here](https://github.com/calcom/cal.com/blob/main/packages/platform/examples/base/src/pages/booking.tsx).
|