How to connect a WhatsApp AI assistant to Timeo | API and webhooks guide

More studios are putting a WhatsApp AI assistant in front of customer chats: it answers “is tomorrow’s 9am full?”, sends the booking link, and checks a member’s remaining sessions. This guide explains how an external AI platform connects to Timeo: what the API gives it, what the webhooks tell it, and how to split responsibilities so the two systems never fight over one WhatsApp number.

What Timeo exposes to your AI platform

Timeo has a REST API with self-serve API keys (Settings, then Developers) and outbound webhooks (Settings, then Webhooks). Any platform that can make standard HTTP calls can use both, which includes Zapier and Make through their generic HTTP and webhook modules.

• Class availability: an endpoint returns your upcoming classes with live spots remaining, so the AI can answer availability questions with real numbers, never a guess.
• Membership and package status: a read-only endpoint returns a customer’s packages with sessions remaining and expiry, for “how many classes do I have left?” conversations.
• Customers, bookings, services, orders: read and write endpoints behind scoped keys, so the AI can look up a customer or create an appointment where that makes sense.

Webhooks keep the AI in sync

Register your AI platform’s URL and Timeo pushes signed events the moment things happen: a booking created, updated, cancelled, or completed; a member reserving or cancelling a seat in a class; a new customer; an order completed or refunded. Every delivery is HMAC-signed and retried automatically if your endpoint is down, so the assistant’s picture of the schedule stays honest.

The part the AI should NOT do

Timeo already sends booking confirmations, reminders 24 hours and 1 hour before class (WhatsApp, email, app push), and understands YES and NO replies to confirm or cancel. Let it. Your AI handles enquiries and sends links; Timeo handles the operational messaging it was built for. Duplicating reminders from two systems is how customers end up with four messages about one class.

One number or two?

Timeo can send from your studio’s own WhatsApp number (scan a QR once, like WhatsApp Web). An external AI platform that wants to control the same number will conflict with that session. The clean setup: your AI lives on the enquiry number customers message, and Timeo sends confirmations and reminders in the background. If you must have both on one number, run everything through the AI platform’s number and leave Timeo’s WhatsApp channel off.

Links your AI can always send

• Your booking page: services, prices, real availability, online payment.
• The live class schedule link: upcoming classes with spots remaining, no login needed, made for WhatsApp replies.

A perfectly good v1 assistant sends these two links and answers questions from the availability endpoint, while Timeo confirms, reminds, and counts the sessions.

Setting it up

• 1.In Settings, then Developers, generate an API key with the scopes your AI needs (read-only is a sensible start). The key is shown once; store it in your AI platform’s credentials vault.
• 2.In Settings, then Webhooks, add your platform’s endpoint URL and pick the events you want. Send the test ping to verify reachability.
• 3.Point the AI’s answers at the class availability endpoint and your booking links, and switch its reminder features off in favour of Timeo’s.

Related: WhatsApp marketing for Malaysian salons and the class scheduling guide.