تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

twenty-oauth-mastery

بواسطة avirweb

Coding Agents & IDEs
780التنزيلات وفق ما يذكره clawskills.sh
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

**Author**: Generated from extensive OAuth debugging sessions in OpenCode.

الوصف

ما الذي تفعله هذه المهارة

OAuth authentication knowledge for Twenty CRM covering implementation patterns, common failure modes, and automatic email/calendar sync setup after login. Focuses on Passport.js strategy configuration, token management, domain allowlists, and the compile-then-deploy workflow Twenty requires for source changes to take effect.

Twenty's OAuth flow has several non-obvious failure points, like needing to rebuild and redeploy compiled JavaScript before source changes take effect, that generic OAuth documentation does not cover.

متى تستخدمها

  • Fixing redirect loops after Google OAuth login completes
  • Allowing both .com and .co company domains to authenticate
  • Triggering automatic Gmail and Calendar sync on first OAuth sign-in
  • Debugging token refresh failures in a self-hosted Twenty instance
  • Tracing why the frontend stays on the welcome page instead of redirecting to the dashboard

مثال على سير العمل

الإدخال

User asks: Why does OAuth login succeed but Gmail sync never starts?

الوكيل
  1. 1

    Check the validate() method in google.auth.strategy.ts to confirm accessToken and refreshToken are included in the return object

  2. 2

    Verify auth.service.ts calls oauthSyncService.setupSyncForOAuthUser() after a successful login

  3. 3

    Confirm Google OAuth scopes include gmail.readonly and calendar.events

  4. 4

    Check that CALENDAR_PROVIDER_GOOGLE_ENABLED and MESSAGING_PROVIDER_GMAIL_ENABLED are set to true in the environment

  5. 5

    Query the connectedAccount table to confirm tokens were persisted and sync channels exist

الإخراج

Root cause identified as tokens lost in validate(), fix applied, sync channels created with syncStatus=ONGOING

المتطلبات

  • Google Cloud Console project with OAuth 2.0 credentials (client ID and client secret)
  • Redirect URIs and authorized origins configured in Google Cloud Console

التثبيت

clawhub install avirweb/twenty-oauth-mastery

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط