Bookings integration

Phorest

Phorest AI integration
  • CategoryBookings
  • AuthHTTP Basic

Overview

Connect Phorest so the AI agent can check your salon's free times and book appointments in Phorest for clients who message you. You connect it in Connections > Integrations with the API username, password and Business ID that Phorest gives you. If your salon takes deposits in Phorest, the AI agent sends the client Phorest's deposit link with each booking it makes. Appointment changes in Phorest can also start campaigns in Workspace > Campaigns.

What MessageMind can do with it

  • When a client asks when they can come in, the AI agent checks your Phorest calendar at that moment and offers free times with the stylist and, when the service has one, the price.
  • Clients can ask the way they normally would: a day, an exact time, part of a day such as "after 5", a range of days, or the soonest you have.
  • A client who asks for a stylist by name is only offered that stylist's times.
  • If your business has more than one branch, the AI agent asks which one the client wants before looking for times.
  • When a request matches several services, the AI agent lists them. If there are a lot, it lists your Phorest service categories first so the client can narrow it down.
  • Once the client picks a time, the AI agent books the appointment on your Phorest calendar. It first looks for the client in Phorest by mobile number or email, and creates a new client record only when nobody matches.
  • Clients can book for someone else, such as a friend or their child. The appointment goes on that person's own client record, with their name and mobile number.
  • If your salon takes a deposit, the AI agent sends Phorest's payment link in the chat. The client pays it within the time to pay you set, 1 hour unless you change it.
  • If someone else takes the time just before the booking goes through, the AI agent books another stylist who is free then (only when the client didn't ask for a particular one) or offers other times that day.
  • The AI agent can also send your Phorest online booking page, where the client picks the service, stylist and time.
  • Your Phorest service list is imported into MessageMind, so the AI agent can answer questions about prices and how long a service takes.
  • The AI agent can tell a client about their upcoming appointments and those from the last 90 days. It finds them only from the phone number or email of the channel the client is writing on, such as WhatsApp, SMS, a phone call or email.
  • When you turn it on in Phorest AI settings, the AI agent can also cancel an appointment, or move a single-service appointment to another free time, outside the cancellation period you set there.
  • With Sync Phorest clients on, every Phorest client with an email address or phone number is added to your contacts and kept up to date.
  • Five Phorest triggers in Workspace > Campaigns start a campaign when an appointment is booked, cancelled, rescheduled or completed, or when the client doesn't turn up. A sixth, Phorest: Client Added, starts one when a client is added in Phorest.

Requirements

  • A Starter, Professional or Enterprise plan.
  • A Services account in MessageMind. If you picked Services, Healthcare, Beauty and Wellness or Real Estate as your category when you signed up, your account is one.
  • API access for your Phorest business, which you request from Phorest support. Phorest sends it in an "API access" email with an API username that starts with global/, a password and a Business ID.
  • The Phorest region your business is on: US for salons in the United States, Canada or Australia, EU for everywhere else.
  • At least one branch set up in Phorest.
  • If you want the AI agent to send deposit links, deposits turned on in Phorest (they run through PhorestPay). The amount comes from your Phorest deposit settings.

How to connect

  1. Find the "API access" email from Phorest. You need the username, password and Business ID in it.
  2. In MessageMind, open Connections > Integrations from the top bar.
  3. Click Bookings in the category list on the left, or type Phorest in the search box.
  4. Click Connect on the Phorest row. The Connect Phorest window opens.
  5. Paste the username into Username, with global/ at the start.
  6. Paste the password into Password. Click the eye button if you want to check what you pasted.
  7. Paste the Business ID from the email into Business ID.
  8. Leave Region on EU, or pick US if your salon is in the United States, Canada or Australia.
  9. Click Connect. "Connecting to Phorest..." shows while your details are checked with Phorest.
  10. The window closes and you see "Phorest connected. Live availability can take up to 5 minutes to appear in your assistant." The Phorest row now has a tick and a Disconnect button.

Authentication and permissions

Mechanism
You paste the API username and password Phorest gave you, add the Business ID and pick a region. There's no Phorest sign-in page to go through. The details are checked with Phorest when you click Connect, and the connection keeps working until you disconnect.
Credentials
Username, Password and Business ID, all from the "API access" email Phorest sends when it turns on API access for your business, plus the Region your business is on. To use new ones, disconnect Phorest and connect again.

Available data and actions

Reads

  • Your branches, with name, address, time zone and currency.
  • The services each branch offers online, with price, duration and category. If none are set up for online booking, every service that isn't archived.
  • Staff who aren't hidden from online bookings, which services each one does, and prices that differ by staff level.
  • Free appointment times for a service, for any stylist or for the one the client asked for.
  • Client records, searched by mobile number or email, so the same person doesn't end up with two records.
  • Every client in your Phorest business, with name, email address and phone number, while Sync Phorest clients is on.
  • Appointments on your Phorest calendar, checked about every 5 minutes for the Phorest campaign triggers.
  • The client on each of those appointments, with name, mobile, email and their reminder and marketing consent.
  • Your salon's Phorest online booking page.

Writes

  • New client records with first name, last name, mobile number, and email if the client gave one. No marketing consent is set on them.
  • New appointments on your Phorest calendar for the service and time the client chose, with the stylist named in the offer.
  • A deposit payment link for each appointment the AI agent books, when your Phorest deposit settings ask for one, valid for the time to pay you set (1 hour unless you change it).
  • Cancelled appointments, and appointments moved to a new time, when you let the AI agent cancel or move them.

AI agent use cases

  • A client on WhatsApp asks for a cut and blow dry on Saturday morning. The AI agent offers the Saturday morning times, books the one they pick and sends the deposit link if you take deposits.
  • A regular asks for Sara by name and only gets Sara's free times.
  • Someone on Instagram asks how much balayage costs and how long it takes. The AI agent answers from your Phorest service list and can then look for a time.
  • A parent wants to book their daughter in. The AI agent asks for the daughter's name and mobile number and books her on her own client record.
  • Your business has two salons. The AI agent asks which one the client wants and offers that branch's times and prices.
  • A client misses an appointment. A campaign on the Appointment No Show trigger sends them a message asking them to rebook.

Configuration

  • Click the gear button on the Phorest row in Connections > Integrations to open Phorest Settings.
  • Auto-sync Services keeps the imported service list in step with Phorest. A daily check picks up new services, prices, durations and stylists. Free times and bookings always come straight from Phorest.
  • Turning Auto-sync Services off stops the daily check and leaves the imported services as they are. Turning it back on starts a new import straight away.
  • Click Save after changing the switch.
  • Phorest AI settings, on the same page, decides what the AI agent may do. Let the AI check availability, Let the AI book appointments and Let the AI see the client's appointments are on by default. Let the AI cancel appointments and Let the AI move appointments stay off until you turn them on.
  • Cancellation period sets how many hours before a visit clients can still cancel or move it through the chat, 24 unless you change it. Use the period set in Phorest.
  • Time to pay a deposit sets how long a client has to pay a deposit link, from 1 to 24 whole hours, 1 hour unless you change it. A visit that starts sooner gets fewer whole hours.
  • While This salon takes deposits is on, the AI agent offers to move an appointment that may have a paid deposit instead of cancelling it.
  • Sync Phorest clients is on by default. Turn it off and click Save to stop adding Phorest clients to your contacts.
  • The Phorest triggers in Workspace > Campaigns (Appointment Booked, Appointment Canceled, Appointment No Show, Appointment Rescheduled and Appointment Completed) have no settings. Pick one and it's ready. The same five are also available as campaign goals.

Example workflows

A client books a colour on WhatsApp

  1. A client writes: "Have you got anything for a full head colour on Friday afternoon?"
  2. The AI agent checks Friday afternoon in Phorest and replies with the free times, each with the stylist and the price.
  3. The client picks 2:30. The AI agent already has their mobile number from WhatsApp, so it only asks for what's missing, such as their surname.
  4. It finds the client's record in Phorest by their number, or creates one, and books the appointment.
  5. Your salon takes a deposit for colour, so the AI agent sends Phorest's payment link and tells the client how long they have to pay it.
  6. The client pays on Phorest's page and the appointment stays on your calendar.

Message clients after a no-show

  1. Open Workspace, click Campaigns in the left rail, then click Create campaign.
  2. Type a Campaign name, keep Create an Automation selected and click Create.
  3. Click Add a Trigger, then pick Appointment No Show under Phorest in the Choose a trigger window.
  4. Add a step that messages the client, such as Send SMS or Send WhatsApp Template, and insert appointment details like Appointment date, Services and Stylist.
  5. Switch the campaign from Draft to Published and click Save.
  6. From then on, when an appointment the client never checked in to is cancelled or removed at or after its start time in Phorest, the campaign runs for that client, usually within a few minutes.
  7. If the client isn't in your contacts yet, MessageMind adds them. It matches existing contacts by mobile number or email first.

Disconnect and reconnect

  • Open Connections > Integrations and click Disconnect on the Phorest row. It happens straight away and shows "Integration Successfully Removed".
  • The AI agent stops checking times and booking in Phorest, and campaigns on a Phorest trigger stop starting.
  • Your Phorest details and the services imported from Phorest are removed from MessageMind. Contacts the Phorest triggers added stay in Contacts, and appointments, clients and deposits already in Phorest stay there.
  • To reconnect, click Connect on the Phorest row and enter the username, password, Business ID and region again. Your services are imported again.