Documentation Bookings and calendars Square Appointments

Bookings integration

Square Appointments

Square Appointments AI integration
  • CategoryBookings
  • AuthOAuth
  • Scopes5

Overview

Connect Square Appointments so the AI agent can check open times and book, move or cancel Square appointments for your customers in the chat. You connect it from Connections > Integrations by signing in to Square, with nothing to copy or paste. The AI agent works with the free, bookable services at the first active location in your Square account.

What MessageMind can do with it

  • Checks open times for a service on a given day, at an exact time, within a time window or across several days.
  • Finds your earliest opening when a customer asks for the next free slot, without asking them for a date.
  • If you offer more than one service and the customer hasn't said which one they want, the AI agent asks before it checks times.
  • Books the appointment in Square once it has the customer's first name, last name and email. Before booking it asks whether they have any notes and adds them to the appointment.
  • Bookings made with an email that already belongs to a Square customer go on that customer's profile. Otherwise a new customer is created in Square.
  • Customers can move an appointment to another time. The new time is checked first, so nothing changes if it's taken.
  • Cancellations need the customer's confirmation first, and the AI agent offers to note their reason in Square.
  • If Square holds new bookings for you to accept, the customer is told the booking is waiting for your confirmation.

Requirements

  • A MessageMind Starter, Professional or Enterprise plan.
  • A Square account with Square Appointments and at least one active location.
  • At least one team member who is bookable for appointments at that location.
  • At least one free service in Square (a fixed price of 0) that has a duration, is available for booking and is offered at that location.

How to connect

  1. In Square, set up the services you want the AI agent to book (see Requirements). MessageMind reads your services when you connect.
  2. In MessageMind, open Connections > Integrations from the top bar.
  3. Find the Square row under Bookings, or type Square in the search box.
  4. Click Connect on the row. The Connect Square window opens, with no fields to fill in.
  5. Click Connect in the window. Square's sign-in page opens in the same tab.
  6. Sign in to the Square account that holds your appointments. Square asks you to sign in even if you're already signed in to Square in that browser.
  7. Review the access MessageMind asks for and approve it.
  8. Square sends you back to Integrations with the message "Square connected successfully". The Square row now shows a tick and a Disconnect button.

Authentication and permissions

Mechanism
You sign in to Square on Square's own page and approve access for MessageMind. The connection stays active until you disconnect it in MessageMind or remove MessageMind's access in Square.
Credentials
Your Square login, entered on Square's sign-in page. MessageMind never sees your Square password.

Required scopes

  • Read your business profile and locations
  • See, create and change appointments
  • Read your appointment settings
  • Read your items, which include your services
  • See and manage customers

Available data and actions

Reads

  • Your active locations. The first one is where the AI agent books.
  • Your services and their variations, with price, duration and where each one is offered. This list is read when you connect.
  • Open times for a service at that location.
  • Your bookable team members at that location.
  • Customers, looked up by email.
  • A customer's appointments on a given day, to find the one they want to move or cancel.

Writes

  • New customers with first name, last name and email (plus a phone number if the customer gave one), when the email isn't in Square yet.
  • New appointments, with any notes the customer gave.
  • Moved appointments. The original is cancelled and the new time is booked as a new appointment, with a note saying when it was moved from and the customer's reason, if they gave one.
  • Cancellations. A reason the customer gives is added to the appointment's note.

AI agent use cases

  • A new client asks on WhatsApp for a free consultation on Friday afternoon. The AI agent offers the open times, takes their name and email and books it in Square.
  • Someone asks on Instagram when your next free slot is, and gets the earliest opening without having to suggest a date.
  • A client can't make Tuesday and asks to move to Thursday. The AI agent checks Thursday, moves the appointment and confirms it in the chat.
  • A client writes in the website chat to cancel. After they confirm, the appointment is cancelled in Square with their reason on it.

Configuration

  • There is nothing to configure for Square in MessageMind.
  • You decide what the AI agent can book in Square itself. The AI agent offers every service variation that is free, has a duration, is available for booking and is offered at your first active location.
  • Each variation is offered as its own option, named after the service and the variation. A variation called Regular shows under the service name alone.

Example workflows

A client books on WhatsApp

  1. A client writes: "Do you have anything Thursday afternoon?"
  2. You offer two free services, so the AI agent asks which one they want.
  3. The client picks one. The AI agent checks Thursday afternoon and lists the open times.
  4. The client picks 3 pm. The AI agent asks for their first name, last name and email, and whether they have notes for the appointment.
  5. The AI agent checks that 3 pm is still free, books it in Square and confirms it in the chat.
  6. In Square, the appointment is on your calendar, on the client's customer profile, with their notes.

A client moves an appointment

  1. A client writes: "I need to move my appointment on the 14th."
  2. The AI agent asks for the email they booked with, the service and time of that appointment, and the new time they want. It also asks whether they want to give a reason.
  3. It checks that the new time is free first.
  4. When the new time is free, the AI agent cancels the appointment on the 14th and books the new time with the same team member.
  5. In Square you see the old appointment cancelled and a new one with a note saying it was rescheduled from the 14th.

Disconnect and reconnect

  • Open Connections > Integrations and click Disconnect on the Square row. It happens straight away and shows "Integration Successfully Removed".
  • The AI agent stops checking times and stops booking, moving or cancelling Square appointments.
  • Appointments and customers already in Square stay there.
  • To also withdraw MessageMind's access on Square's side, remove MessageMind from the apps connected to your Square account.
  • To reconnect, click Connect on the Square row and sign in to Square again. Your current services are read again at that point.