Connectors

חבר את האפליקציה שלך לשירותים חיצוניים כמו Slack, Resend ו-ElevenLabs. פרטי הגישה מוצפנים והפעולות מאומתות מראש.

Connectors מאפשרים לך לשלב שירותים חיצוניים באפליקציה שלך מבלי לנהל מפתחות API גולמיים בקוד. מגדיר חיבור אחת ולתמיד, מקשר אותו לפרויקט שלך, וקורא לפעולות מוכנות מהאפליקציה דרך ה-Proyecta SDK. פרטי הגישה מוצפנים במנוחה ולעולם אינם נחשפים לקוד ה-frontend שלך.

Connectors זמינים

Connector	קטגוריה	סוג אימות	מה הוא עושה
Resend	תקשורת	מפתח API	שליחת אימייל טרנזקציוני, שליחת אימיילים בקבוצה, רשימת דומיינים מאומתים
Slack	תקשורת	OAuth	פרסום הודעות, רשימת ערוצים ומשתמשים, תגובה להודעות, קריאת שרשורים
ElevenLabs	בינה מלאכותית	מפתח API	המרת טקסט לדיבור, רשימת קולות זמינים, יצירת אפקטי סאונד

Connectors נוספים מתווספים באופן שוטף.

איך Connectors עובדים

1. יוצר חיבור — מספק פרטי גישה (מפתח API או כניסה דרך OAuth)
2. מקשר את החיבור לפרויקט — זה מסמיך את הפרויקט להשתמש בפרטי הגישה הללו
3. האפליקציה קוראת לפעולות — ה-SDK שולח את הבקשה דרך Proyecta Cloud, שמזריק את פרטי הגישה בצד השרת

קוד האפליקציה שלך לעולם אינו נוגע במפתח ה-API הגולמי או ב-OAuth token. מערכת ה-connector מטפלת באימות, הגבלת קצב ורישום ביקורת.

הגדרת connector

1. פתח את הפרויקט שלך ב-builder
2. עבור אל Settings > Connectors
3. לחץ על connector מהקטלוג (לדוגמה, Resend)
4. הזן את פרטי הגישה:
   • connectors עם מפתח API (Resend, ElevenLabs): הדבק את המפתח הסודי שלך
   • connectors עם OAuth (Slack): התחבר ואשר גישה
5. תן לחיבור שם (לדוגמה, “Production Resend”)
6. החיבור נבדק אוטומטית ומסומן Active אם תקין

שימוש ב-connector באפליקציה שלך

פעולות connector נקראות מקוד בצד השרת (Convex actions) באמצעות ה-Proyecta SDK:

'use node';
import { action } from './_generated/server';
import { v } from 'convex/values';
import Proyecta from '@proyecta-ai/sdk';

const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY ?? null });

export const notifySlack = action({
    args: {
        message: v.string(),
    },
    handler: async (ctx, args) => {
        const result = await proyecta.connectors.execute({
            connectorId: 'slack',
            actionId: 'postMessage',
            input: {
                channel: '#general',
                text: args.message,
            },
        });
        return result.output;
    },
});

המתודה execute מחזירה:

שדה	תיאור
output	ערך ההחזרה של הפעולה (המבנה תלוי בפעולה)
durationMs	זמן הביצוע במילישניות
invocationId	מזהה רשומת יומן הביקורת

תן לבינה המלאכותית לחבר הכל

אתה לא חייב לכתוב קוד connector ידנית. ה-AI builder יודע אילו connectors מקושרים לפרויקט שלך ויכול לייצר עבורך את האינטגרציה:

• "Send a welcome email when users sign up" — משתמש ב-connector של Resend
• "Post a Slack message when a new order comes in" — משתמש ב-connector של Slack
• "Play audio narration on the article page" — משתמש ב-connector של ElevenLabs

עיון בפעולות ה-connector

Resend

פעולה	השפעות צד	תיאור
sendEmail	כתיבה	שליחת אימייל טרנזקציוני יחיד
sendBatch	כתיבה	שליחת מספר אימיילים בבת אחת
listDomains	קריאה	רשימת דומיינים מאומתים לשליחה

Slack

פעולה	השפעות צד	תיאור
postMessage	כתיבה	פרסום הודעה בערוץ
listChannels	קריאה	רשימת ערוצים בסביבת העבודה
listUsers	קריאה	רשימת חברי סביבת העבודה
reactToMessage	כתיבה	הוספת תגובת אמוג׳י
getThread	קריאה	קבלת תגובות בשרשור

ElevenLabs

פעולה	השפעות צד	תיאור
textToSpeech	כתיבה	המרת טקסט לשמע דיבור
listVoices	קריאה	רשימת קולות זמינים
generateSoundEffect	כתיבה	יצירת אפקט סאונד בבינה מלאכותית

סטטוסי חיבור

סטטוס	משמעות
Active	פרטי הגישה תקינים והחיבור מוכן לשימוש
Broken	פרטי הגישה פגו או בוטלו — עדכן אותם כדי לשחזר

אבטחה

• פרטי גישה מוצפנים עם AES-256-GCM במנוחה
• פעולות מוגבלות ב-1,000 בקשות לדקה לכל connector לכל פרויקט
• כל קריאה לפעולה נרשמת עם רצף ביקורת (חיבור, פעולה, משך, סטטוס)
• חיבורים בתחום סביבת העבודה כולה

שאלות נפוצות

האם אפשר להשתמש באותו חיבור במספר פרויקטים?

כן. צור את החיבור פעם אחת וקשר אותו לכל מספר פרויקטים באותה סביבת עבודה.

מה קורה אם מפתח ה-API שלי פג תוקף או בוטל?

סטטוס החיבור משתנה ל-Broken. עדכן את פרטי הגישה ב-Settings > Connectors כדי לשחזר אותו.

האם אפשר לקרוא לפעולות connector מה-frontend?

לא. פעולות connector חייבות להיקרא מקוד בצד השרת (Convex actions) כדי לשמור על אבטחת פרטי הגישה. ה-SDK מנתב דרך Proyecta Cloud, שמזריק אימות בצד השרת.

האם אפשר להוסיף connectors מותאמים אישית?

עדיין לא. הגדרות connector מותאמות אישית נמצאות במפת הדרכים.

בקרוב

• connectors נוספים (Google, Twilio, SendGrid ועוד)
• הגדרות connector מותאמות אישית — הבא את ה-API שלך
• קליטת webhook לאירועים נכנסים משירותים מחוברים
• OAuth gateway — שמירת tokens בצד השרת אפילו עבור flows שיוזם הלקוח