Настройка интеграций: ID, ключи и вебхуки

Каждая интеграция необязательна и включается переменными окружения. Пока ключи не заданы, провайдер бездействует. Ниже для каждого сервиса указано, где получить credentials, какой redirect URI или вебхук зарегистрировать и в какую переменную окружения записать значение.

Две основы нужны всему. Первая — APP_URL, публичный базовый URL развёртывания, например https://braveday.work. Каждый redirect URI и вебхук ниже — это APP_URL плюс фиксированный путь. Укажите точный публичный HTTPS origin без завершающего слэша. Вторая — после изменения env vars пересоберите и заново разверните приложение: часть значений читается при сборке. Redirect URI и URL вебхуков должны ТОЧНО совпадать с зарегистрированными в консоли провайдера, иначе callback будет отклонён.

Google Calendar и вход через Google

1. В Google Cloud Console создайте или выберите project и включите Google Calendar API.
2. Настройте OAuth consent screen, добавьте свой аккаунт как test user или опубликуйте приложение.
3. Откройте Credentials → Create OAuth client ID → Web application. Authorized redirect URI: APP_URL/api/calendars/connect/google/callback
4. Задайте GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET, а также NEXT_PUBLIC_GOOGLE_AUTH=1, чтобы показать кнопку входа через Google.

• Scopes: calendar.events, calendar.readonly, openid, email, profile.
• Push-синхронизация в реальном времени автоматически регистрируется на APP_URL/api/webhooks/google. Google требует подтверждённый HTTPS-домен; если он недоступен, система продолжит работать и перейдёт на polling.

Microsoft 365 / Outlook

1. Azure Portal → Microsoft Entra ID → App registrations → New registration.
2. Redirect URI (Web): APP_URL/api/calendars/connect/microsoft/callback
3. Certificates & secrets → New client secret → скопируйте VALUE.
4. API permissions → Microsoft Graph → Delegated: Calendars.ReadWrite, User.Read, offline_access, openid, email, profile.
5. Задайте MICROSOFT_CLIENT_ID — Application/client ID — и MICROSOFT_CLIENT_SECRET — значение secret.

Apple iCloud

Настройки разработчика и env vars не нужны. Apple Calendar подключается по CalDAV с личным паролем приложения: пользователь создаёт его на appleid.apple.com в Sign-In & Security → App-Specific Passwords и вставляет в Настройки → Календари → Apple. Настоящий пароль Apple ID вводить нельзя.

Twenty — синхронизация с собственной CRM

1. Разверните Twenty на публичном HTTPS origin, например https://crm.ravefox.dev.
2. Зарегистрируйте публичный OAuth-клиент с callback APP_URL/api/integrations/crm/twenty/callback и grants authorization_code и refresh_token.
3. Задайте TWENTY_BASE_URL и TWENTY_CLIENT_ID. Динамически зарегистрированный client использует PKCE и не имеет client secret.
4. Пользователь подключает CRM одним нажатием в Настройки → CRM. Бронирования создают или находят Person и синхронизируют связанную Task.

Zoom — ссылки на видеовстречи

1. Zoom App Marketplace → Develop → Build App → OAuth (user-managed).
2. Redirect / OAuth allow-list URL: APP_URL/api/integrations/zoom/callback; добавьте scope для создания встреч.
3. Задайте ZOOM_CLIENT_ID и ZOOM_CLIENT_SECRET. Без них кнопка подключения скрыта.

• Для Google Meet отдельная настройка не нужна — он приходит с подключением Google Calendar. Ссылки Teams создаются через подключение Microsoft.

Stripe — биллинг Pro только для Cloud

1. Developers → API keys → скопируйте Secret key в STRIPE_SECRET_KEY.
2. Products → добавьте Product с RECURRING price $9/seat/mo. Откройте цену, скопируйте API ID, начинающийся с price_, в STRIPE_PRICE_PRO. Нужен именно ID price_, а не число.
3. Developers → Webhooks → Add endpoint: APP_URL/api/webhooks/stripe. Events: checkout.session.completed, customer.subscription.created / updated / deleted. Скопируйте signing secret в STRIPE_WEBHOOK_SECRET.

Twilio — напоминания по SMS и WhatsApp

1. В Twilio Console скопируйте Account SID и Auth Token.
2. Задайте TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_SMS_FROM с номером E.164 и TWILIO_WHATSAPP_FROM в формате whatsapp:+….
3. Для входящих ответов направьте incoming-message webhook номера или Messaging Service на APP_URL/api/webhooks/twilio.

Resend — главная ошибка настройки email

1. Resend → API Keys → создайте ключ и запишите его в RESEND_API_KEY.
2. Domains → Add domain, добавьте DNS records и дождитесь статуса Verified.
3. Задайте EMAIL_FROM с адресом НА подтверждённом домене, например "BraveDay <no-reply@yourdomain.com>".