Интеграция Outlook Calendar API с сайтом

Интеграция Outlook Calendar API с сайтом

Outlook Calendar — часть Microsoft 365. API реализован через Microsoft Graph. Используется в корпоративных инструментах: запись к специалистам, синхронизация встреч, отображение занятости сотрудников.

Microsoft Graph: чтение событий

import { Client } from '@microsoft/microsoft-graph-client';

const client = Client.initWithMiddleware({ authProvider: tokenCredentialAuthProvider });

async function getCalendarEvents(userId: string): Promise<Event[]> {
  const response = await client
    .api(`/users/${userId}/calendarView`)
    .query({
      startDateTime: new Date().toISOString(),
      endDateTime:   new Date(Date.now() + 7 * 86400000).toISOString(),
    })
    .select('subject,start,end,location,isAllDay')
    .orderby('start/dateTime')
    .get();

  return response.value.map((e: any) => ({
    id:       e.id,
    title:    e.subject,
    start:    e.start.dateTime,
    end:      e.end.dateTime,
    location: e.location?.displayName,
    allDay:   e.isAllDay,
  }));
}

Создание события

async function createEvent(userId: string, booking: Booking): Promise<string> {
  const event = await client.api(`/users/${userId}/events`).post({
    subject:  booking.serviceName,
    start:    { dateTime: booking.startsAt, timeZone: 'Russian Standard Time' },
    end:      { dateTime: booking.endsAt,   timeZone: 'Russian Standard Time' },
    body: {
      contentType: 'HTML',
      content:     `<p>Клиент: ${booking.customerName}</p><p>Телефон: ${booking.phone}</p>`,
    },
    attendees: [{ emailAddress: { address: booking.customerEmail }, type: 'required' }],
    isReminderOn:       true,
    reminderMinutesBeforeStart: 60,
  });
  return event.id;
}

Проверка свободного времени (FindMeetingTimes)

async function findAvailableSlots(userEmail: string, duration: number) {
  return client.api('/me/findMeetingTimes').post({
    attendees: [{ emailAddress: { address: userEmail }, type: 'required' }],
    timeConstraint: {
      timeslots: [{
        start: { dateTime: new Date().toISOString(), timeZone: 'Russian Standard Time' },
        end:   { dateTime: new Date(Date.now() + 7 * 86400000).toISOString(), timeZone: 'Russian Standard Time' },
      }],
    },
    meetingDuration: `PT${duration}M`,
  });
}

Сроки

Чтение событий + создание через Graph API: 3–4 рабочих дня.