# Appointment booking on WhatsApp

> Let customers book, reschedule and cancel appointments inside WhatsApp. Bookings go to Google Calendar, Microsoft 365, Apple iCloud or app2email's own calendar, with confirmations and reminders. Includes the calendar app, an online booking page, payments and a calendar team.

<a id="top"></a>

A customer writes "book" to your WhatsApp number and picks a service, a day and a time without leaving the chat.

The booking lands in your calendar, the customer gets a confirmation, and a reminder goes out before the visit.

## What the customer sees

1. They send a booking word (book, appointment, reserve - you choose the words) or tap "Book now" in a message from you.
2. A form opens inside WhatsApp (a WhatsApp Flow): choose a service, pick a day from a calendar, pick a free time, give a name, confirm.
3. They get a confirmation message with the details, a reference and, if you want, a calendar file to add the appointment to their phone.
4. Before the appointment they get a reminder with Confirm, Reschedule and Cancel buttons. Replying CANCEL or RESCHEDULE at any time works too.

Nothing to install for the customer and no link to another website: the form is WhatsApp's own and opens in the chat.

<a id="setup"></a>

## The five minute setup

1. **Services**: what can be booked and how long it takes (a 30 minute consultation, a 45 minute haircut).
2. **Availability**: your opening hours per weekday, the slot grid (every 15, 30 or 60 minutes), buffers between appointments, how much notice you need and how far ahead customers may book. Special days (closed, or other hours) go in the same place.
3. **Calendar**: connect Google Calendar, Microsoft 365 / Outlook.com or Apple iCloud, or keep bookings in app2email's own calendar. Busy times in the connected calendar are never offered.
4. **Messages**: the confirmation, the reminders and the cancellation text, in your words, with placeholders for the service, the date and the time.
5. **Publish**: the booking form is uploaded to WhatsApp and published from the Overview. Send yourself a test, then switch Book-and-Pay on.

**Staff**: add the people customers can book with, each with their own hours and, if they like, their own calendar. The form then asks "Who would you like?" with "Anyone available" first.

Everything on this page is set on the dashboard under Integrations, **Book-and-Pay**.

## Trigger words

A trigger word is a word or a short phrase that starts something when a customer sends it. You choose the words on the **Trigger** tab.

- **Booking words** (book, booking, appointment, reserve, reservation, schedule to begin with) send the booking form.
- **Cancel words** (cancel) ask a customer with an upcoming appointment "Cancel it?" with buttons.
- **Reschedule words** (reschedule, change booking) start a new booking that replaces the upcoming one.
- With several forms, each form can have **its own words** on the Flows tab. Those win over the booking words.

Words are matched as whole words. Capital letters and accents do not matter: "Book", "BOOK" and "book!" are the same, and "bookshelf" does not count.

### Long messages are left alone

A trigger word only counts in a short message: one with fewer than 10 other words. A longer message that happens to contain "booking" or "cancel" does not start anything and is handled like any other message.

You can change the number on the Trigger tab ("Ignore the words in long messages"), from "only when the word is the whole message" to "in a message of any length".

## Calendars

With **Google Calendar** and **Microsoft 365** you sign in once and choose the calendar bookings are written to, and which calendars should block times.

**Apple iCloud** and other CalDAV servers connect with an app-specific password.

A read-only calendar link (.ics) can block times while the bookings themselves stay in app2email's calendar.

If a connected calendar stops answering, bookings keep working and the dashboard tells you to reconnect.

<a id="reminders"></a>

## The 24 hour rule and reminders

WhatsApp lets a business send free text for 24 hours after the customer's last message. Confirmations arrive inside that window, so they are your own text.

Reminders usually go out later than that. So app2email creates a small set of approved utility templates on your number the moment you switch bookings on (Meta reviews them, usually within the hour) and uses the matching template whenever the window is closed.

Rebooking nudges ("it's been a while") are marketing messages and only go to contacts who agreed to marketing.

<a id="follow-ups"></a>

## Follow-ups and reports

After a visit, an aftercare note with your product links and a one-tap rating can follow.

The Reports tab shows bookings by source, no-shows, ratings and which services and staff members are busiest.

<a id="calendar-app"></a>

## The calendar app

Your bookings have their own app at `/calendar` (www.app2email.com/calendar). It is made for touch screens: a tablet at the reception desk or a phone in a pocket. Buttons are large and sheets slide up from the bottom on a narrow screen.

1. **Open it** from the "Calendar" entry in the dashboard menu, or go to /calendar and log in. If you have several businesses, switch between them in the top bar.
2. **Pick a view**: Day, Week, Month or List. Swipe left or right to move to the next or previous day (week, month). Tap the date to jump with a month picker. With staff, tap a staff chip to see one person only.
3. **Book**: tap "+ New", or tap an empty time in the day view. Choose the customer (search or type a number with country code), the service, the staff member ("Anyone available" is an option) and one of the free times. Switch "tell the customer" on to send the confirmation.
4. **Move**: open the appointment, tap Move and pick a new time. The appointment keeps its reference. The customer is told if you leave "tell the customer" on.
5. **Cancel, completed, no-show**: open the appointment and tap the button. A cancellation asks for a reason.
6. **Block time**: tap "+ New", then "Block time". Choose one staff member or everyone, the hours or whole days, and a title (lunch, holiday). Blocked time is never offered to customers.
7. **Notes**: internal notes on a customer or on one appointment. Pin the important ones. The customer never sees them. A note can carry a "Remind me on" date; you get an email that day.

### Customers and polls

**Customers** lists everyone who booked, with visits, no-shows, upcoming and past appointments, notes, packages and payments. From there you can edit tags and details, send a WhatsApp message or an email, and ask the assistant for a draft or a short preparation brief.

**Polls** lets you offer two to ten times and let people vote (see [Event types](#event-types)).

The calendar shows the busy times of a connected Google, Microsoft or Apple calendar in grey, so nothing is hidden from you. The screen refreshes every 30 seconds.

## Calendar team

You can invite people to the calendar only. They do not see your dashboard, your messages or your settings.

1. Open the calendar, then the menu, then **Team** (administrators only).
2. Type the person's email address, choose a role, and optionally the staff member this person is.
3. Send the invitation. The person gets an email with a link, signs in or creates a login, and lands in your calendar.
4. You can change a role, resend an invitation or remove a person at any time.

### Roles

| Role | What the person can do |
| --- | --- |
| Administrator | Everything in the calendar: book, move, cancel, block anyone's time, all notes, the team, sharing, payments and refunds, deleting customer data. |
| Staff | See the calendar, book, move and cancel, block their own time, write notes and message customers. Their own sharing feed only. |
| Viewer | Look only. No buttons that change anything. |

### Two options for each person

These are mainly for staff:

- **Only their own entries**: the person sees and changes only the appointments of their own staff member (you must pick the staff member).
- **Hide customer contact details**: phone numbers and email addresses show as "•••• 4567". This also applies to what is sent to the assistant.

People who already have a role on your dashboard get the matching calendar role automatically: owner and admin are administrators, member is staff, viewer is viewer.

<a id="online-booking"></a>

## Online booking page

Besides the WhatsApp form, customers can book on a mobile web page. It needs no login and no app. Set it up on the dashboard under Integrations, Book-and-Pay, **Online booking**.

1. Switch the page on.
2. Choose the address: `www.app2email.com/book/` followed by a short name of your own (5 to 40 letters, digits or dashes). Press "Check and save". If the name is taken you are told.
3. Write a headline and a short intro if you want to change the defaults.
4. Copy the link, print the QR code, or copy the embed snippet for your own website (an iframe; add `?embed=1` to hide the header and set colours with `color`, `bg` and `text`).

### The personal link tag

Type `{booking_link}` in any customer text and app2email replaces it with a link made for that customer. They open it already known: no number to type, and the booking is tied to their chat.

You can use it in the trigger reply, the confirmation, the reminders, the cancelled and moved messages, the follow-up and the "no free times" text.

The link expires after the number of days you set (7 by default). Texts sent as templates outside the 24 hour window cannot carry it. If the page is switched off, the tag becomes empty.

### What a trigger word sends

You choose one of three: the WhatsApp form (as before), a button that opens the online page, or the form with the page link under its text. If no form is published yet, the link is sent.

### A customer app2email does not know yet

1. The customer opens your public address and picks a service, a time and gives a name.
2. The time is kept for a few minutes (10 by default; you can set 5 to 30).
3. The page shows a button that opens WhatsApp with a ready message, "Confirm booking BK-...". The customer sends it.
4. The booking is made, the page shows "You're booked" and the confirmation arrives on WhatsApp. If the time runs out, the time is released and the customer can pick again.

This proves the customer owns the WhatsApp number. A customer who comes through a personal link needs no such step.

### Manage and limits

With a personal link the customer can see their upcoming appointments and cancel or move them (you can switch that off).

You can set a latest time before the start for customers to change things, and a limit of appointments per day. You, the API and the calendar app are never limited by these.

### Calendar feed (.ics)

In the calendar, open Sharing and make a feed link for yourself or one staff member. Add it to Google Calendar, Apple Calendar or Outlook as a subscription and your appointments and blocked times show up there.

The feed has names, services and references, never customers' phone numbers. Revoke a feed link at any time.

## Event types

- **One-on-one**: one customer per time. This is the default.
- **Group**: set "places" on a service (1 to 200). The same start time stays bookable until all places are taken. Each customer has their own booking, messages and payment. The page shows how many places are left.
- **Everyone attends**: pick two to ten staff members. A time is offered only when all of them are free, and the event goes into each person's calendar.
- **Round robin**: in the staff settings, choose how "Anyone available" picks a person: the first free one, or the free one with the fewest appointments around that time.
- **Polls**: in the calendar, open Polls and tap two to ten free times. Send the link. People vote on the page without a login. When you choose a time, an appointment is made for the customer you named, or the time is blocked. The times are not held while voting runs.

<a id="payments"></a>

## Taking payments

You connect your own Stripe or PayPal account. The money goes straight from the customer to your account.

app2email takes no fee and never holds your money. The payment provider's own fees and receipts apply. One currency per number.

### Connect and set prices

1. Open Bookings, **Payments**. The page tells you where to find each key.
2. Stripe: paste a secret or restricted key. app2email checks it and adds its own webhook to your account. PayPal: enter the client id and secret of a REST app and choose live or sandbox. Only the owner or an admin can connect or disconnect.
3. Choose the currency and which methods customers may use (one or both).
4. On each service, set the price and whether payment is **required**, **optional** or **none**. Add a deposit to charge only part now; the rest is paid at the visit.

### How it works

- **Required, on the online page**: the time is held while the customer pays. When the payment is confirmed, the booking is made. A payment that expires or is cancelled releases the time.
- **WhatsApp form and bookings you make**: the booking is made and the confirmation carries a "Pay now" link. With "optional" nothing is ever cancelled. With "required" you can cancel unpaid bookings automatically after a number of minutes you choose (0 means never).
- **Coupons**: a code, a percentage or an amount, for some or all services, with a maximum number of uses and an end date.
- **Prepaid packages**: for example 10 sessions for one price, valid for some days. Customers buy one on the online page, or you grant one at the desk. Booking with a package charges nothing and uses a session. A cancellation gives the session back when you cancel or the customer cancels in time.
- **One-off payment links**: in the calendar, request a payment from a customer with an amount and a description, sent on WhatsApp or copied to send yourself.
- **Refunds**: choose in Payments whether a cancellation never refunds, asks you, or refunds in full automatically. You can also refund from the calendar, in full or in part.

A payment counts as paid only when Stripe or PayPal confirms it. app2email stores the amount, the status and the provider's reference, never card details.

## Notifications

- **Customer emails**: when the booking has the customer's email address, the confirmation (with a calendar file), cancellation, moved notice, reminders and follow-up also go by email, in addition to WhatsApp. Replies go to the address you choose. Switch this on in Bookings, **Notifications**.
- **Extra rules**: up to 20 rules such as "send a parking note the day before". Each rule has a trigger (booked, cancelled, moved, before the start, after the end, completed, no-show, paid), a delay, the services it applies to, who gets it (the customer, you, or the staff member) and the channel (WhatsApp or email).
- **Outside the 24 hour window**: a rule on WhatsApp is sent as free text only inside the window. Outside it, the message goes by email if the customer has an address. If not, it is skipped and the log says so. The built-in reminders still use approved templates as described above.

## Branding

On the Online booking tab you can upload a logo (PNG, JPEG or WEBP, up to 300 KB), pick a button colour and a background colour, and hide the "Powered by app2email" line.

You can also write a cancellation policy that shows on the review step and with the appointment, add up to three buttons on the "You're booked" page, and send customers on to a page of yours a few seconds after booking.

<a id="delete-customer-data"></a>

## Deleting customer data

An administrator can erase one customer's booking data: in the calendar open the customer and choose "Delete customer data" (you type a confirmation). The API has the same call.

- Future appointments are cancelled without a message to the customer.
- On all appointments the name, email, notes and feedback are blanked and the customer's number is replaced by a random code.
- Notes, links, holds and poll votes of that customer are deleted. Payments and packages keep the amount and the date but lose the name and number.
- Reports keep counting the anonymised appointments.

This does not delete the contact or the WhatsApp conversation; that stays with the Contacts page.

For automatic deletion, set "keep customer details for N days" (30 to 3650) in the privacy settings. Once a day, details on appointments that ended longer ago than that are erased in the same way. 0 keeps everything.

<a id="developers"></a>

## For developers and agents

Everything the dashboard does is in the [REST API](/api/overview) under `/v1/{number}/bookings`: list and create bookings, cancel them, read the free slots and the booking settings.

Your system can receive the `booking.created`, `booking.cancelled` and `booking.rescheduled` webhook events. The same tools exist on the MCP server for AI agents.

The [API reference](/api/overview) has the parameters and examples. By purpose:

- **Calendar**: read the unified calendar of bookings and blocks; create, change and delete blocked time.
- **Finding times**: services, staff, the next free times, holds on a time.
- **Changing bookings**: update details, move a booking in place.
- **Notes**: read and write notes on a booking or a customer, with reminders.
- **Links**: personal booking links, list, revoke.
- **Customers**: profiles, update, erase booking data.
- **Payments**: list, payment links, refunds, mark a booking paid; packages and grants.
- **Polls**: create, list, close, book a time.
- **Webhooks**: `booking.updated`, `booking.note.created`, `calendar.block.created`, `calendar.block.deleted`, `booking.paid`, `booking.refunded`, `payment.paid`, `package.purchased`, `poll.voted`, `poll.closed`, `booking.customer.erased`. Every webhook gets all events.
- **MCP**: matching tools for agents, for example `get_calendar`, `find_next_booking_slots`, `reschedule_booking`, `add_booking_note`, `create_booking_link`, `request_payment`.

Writes need the `bookings:manage` scope. Sandbox keys cannot write, refund or erase.

<a id="not-available"></a>

## Not available yet

- Recurring appointments and a waitlist.
- Bookings that need your approval first.
- Subscriptions and recurring charges.
- Taxes and invoices (the receipt from Stripe or PayPal is the receipt).
- Part payments beyond one deposit, and paying by card inside WhatsApp itself.
- Bulk email to customers (Broadcasts sends bulk WhatsApp).
- A booking without a WhatsApp number: every customer needs one.
- Drag and drop in the calendar (Move is a button).
- Languages other than English on the online page.

Everything above is set on the dashboard under Integrations, **Book-and-Pay**. Questions: [support@app2email.com](mailto:support@app2email.com).

[Back to the top](#top)
