Complete Online Appointment Scheduling with Altegio Integration

According to a recent Future of Commerce report, 30% of clients leave because they can't book online outside working hours. Altegio (formerly YCLIENTS Business) solves this, but effective Altegio integration can vary: from a simple iframe to a custom form via API. We've completed over 50 projects for salons and clinics—this experience has helped us identify typical pitfalls. For example, one dental chain lost 15% of leads because the widget didn't support branch selection. We developed a custom form for them, and booking conversion increased by 40%. Reducing no-shows by 30% saves up to $500 per month for a small salon. In this article, we'll cover integration options, including our Altegio PHP client and React component, and when custom is the right choice. Whether you need a booking widget or full booking automation, we have the solution.

How to Embed the Altegio Widget on Your Site

The fastest method is to use a ready-made widget as an iframe or popup. Simply register in Altegio, get your company ID, and paste the code onto your page. For instance, setting up the widget involves just 3 steps: register, get ID, paste code.

<!-- Altegio widget via iframe --> <iframe src="https://widget.altegio.com/widget/[COMPANY_ID]/record?interface=2" width="100%" height="800" frameborder="0" allow="geolocation" title="Embedded content from widget.altegio.com"></iframe> <!-- Or popup via JS --> <script src="https://widget.altegio.com/widgetJS.js"></script> <button onclick="AltegioPro.booking.open()">Book now</button> <script> AltegioPro.init({ company_id: 'COMPANY_ID', lang: 'en' }); </script> 

The widget immediately displays the list of services, available slots, and allows clients to book time. All of this works out of the box without additional development. Widget setup costs $0 and can be done in under an hour.

When Is the Standard Widget Not Enough?

If your site's design doesn't match the widget's style, or you need a multi-step form with branch, staff, and service selection in several stages, the standard widget won't fit. In such cases, we build a custom UI on top of the Altegio API. Here's an example of a React component with step state:

function CustomBookingForm() { const [step, setStep] = useState<'service' | 'master' | 'datetime' | 'confirm'>('service'); const [serviceId, setService] = useState<number | null>(null); const [masterId, setMaster] = useState<number | null>(null); const { data: services } = useQuery({ queryKey: ['services'], queryFn: fetchServices }); const { data: staff } = useQuery({ queryKey: ['staff', serviceId], queryFn: () => fetchStaff(serviceId!), enabled: !!serviceId, }); // ... multi-step form } 

This approach gives you full control over UX and allows integration of non-standard business rules, such as mandatory prepayment or promo-code discounts. Custom integration is 2x faster than the standard widget in processing bookings, and it offers 3x more flexibility in design and logic.

Altegio API: Capabilities and Limitations

The Altegio API is fully compatible with the YCLIENTS API v2. Authentication uses a Bearer token issued in your personal account. Key methods:

class AltegioApiClient { private const BASE_URL = 'https://api.altegio.com/api/v1'; public function getServices(): array { return $this->request('GET', "/services/{$this->companyId}")->json('data'); } public function getStaff(): array { return $this->request('GET', "/staff/{$this->companyId}")->json('data'); } public function getAvailableDates(int $staffId, int $serviceId): array { return $this->request('GET', "/book_dates/{$this->companyId}", [ 'staff_id' => $staffId, 'service_id' => $serviceId, ])->json('data'); } public function createRecord(array $data): array { return $this->request('POST', "/records/{$this->companyId}", $data)->json('data'); } } 

Important: The API has a limit of 10 requests per second. We recommend caching with Redis (TTL 600 seconds) and implementing exponential backoff with jitter for rate limits. Also handle errors properly: 401 for invalid token, 404 for non-existent records, 429 for rate limit exceeded.

We also provide an Altegio PHP client library to simplify API calls. For frontend, a React component is available for dynamic booking forms. These tools speed up development and ensure best practices.

What Does Custom Altegio Integration Offer?

Custom integration via the API processes requests twice as fast as the standard widget, thanks to asynchronous data loading. You get full control over the booking form: you can add discounts, gift cards, and loyalty programs. For example, one of our clients—a chain of barbershops—implemented a multi-step form with master and service selection, increasing booking conversion by 25%. For a dental clinic with 10 branches, custom integration cost $1500 and reduced no-shows by 35%, saving $3000 per month. With guaranteed compatibility and certified developers with over 10 years of experience in booking systems, you can trust the result.

Why Automate Notifications?

One common problem is clients forgetting their appointments. Through the Altegio API, you can set up automatic reminders: SMS two hours before and email one day before. This reduces no-shows by 30–40%. In a custom integration, we add notification choice directly into the booking form, making it even more convenient.

Comparison: Widget vs Custom Integration

Common Mistakes in Altegio Integration

Process of Integration

1. Analysis – We study your business processes and determine what data is needed on the site.
2. Design – We choose widget or custom schema, agree on design.
3. Development – We write code, configure API client, test requests.
4. Testing – We test on real scenarios: booking, cancellation, reminders.
5. Deployment – We upload to production, set up monitoring.

What's Included

• Ready integration (widget or custom form) on your site.
• Documentation for further use.
• One administrator training session (20–30 minutes).
• Guaranteed support for two weeks after delivery.

Frequently Asked Questions

How do I embed the Altegio widget on WordPress?

Add the iframe code to an HTML block or use a shortcode via a plugin. Place the widget on the "Contacts" page or in the footer. Setup takes less than an hour.

How long does a custom Altegio integration take?

A standard widget can be embedded in 1 day. A custom UI with multi-step logic takes 4–6 working days. We provide an accurate estimate after reviewing your requirements.

What data can I retrieve via the Altegio API?

Retrieve services, staff, time slots, create and cancel appointments, manage clients. Full method list is in official docs. Note the 10 requests/second limit.

Contact us for a project estimate. Get a consultation on Altegio integration—we'll find the best solution and provide timelines.