Connectors

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

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

Connectors זמינים

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

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

איך Connectors עובדים

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

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

הגדרת connector

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

קריאה דרך connector מהאפליקציה שלך

האפליקציה שלך יכולה לקרוא API של צד שלישי ישירות מהדפדפן מבלי שה-API key יגיע אי פעם ל-bundle. פרטי הגישה נשארים מוצפנים בפלטפורמה; האפליקציה שלך רק נוקבת בשם ה-connector, הפעולה וקלט מוקלד, והפלטפורמה מבצעת את הקריאה עבורך.

import { useConnectorData, useHttpRead } from '@/hooks/useConnector.ts';

// A connector's own read action, as a cached query
const { data, isLoading, error } = useConnectorData('eleven-labs', 'listVoices');

// The generic HTTP-read connector, by endpoint name
const { data: feed } = useHttpRead('news-feed', { limit: 10 });

שני מעקות בטיחות שכדאי להכיר, כי הם מכוונים:

• קריאה בלבד. רק פעולות שהפלטפורמה סימנה כבטוחות לדפדפן נגישות — כל דבר אחר מחזיר 403. כתיבות (פרסום ל-Slack, שליחת דואר, חיוב כרטיס) לעולם אינן נגישות מהדפדפן.
• אי אפשר להעביר URL או host. עבור ה-connector הגנרי http-read הקלט הוא { endpointKey, params }, וה-URL שמאחורי endpointKey מוגדר על ידך, בעל האפליקציה — ולא על ידי קוד האפליקציה. התשובות נשמרות ב-cache בצד השרת ומוגבלות בקצב, מכיוון שמפתחות של צד שלישי נמדדים במכסה.

404 פירושו שהבעלים עדיין לא חיבר את ה-connector הזה — זה המקרה שכדאי לטפל בו בממשק המשתמש שלך.

תן ל-AI לחבר את הכל

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

• "שלח אימייל ברוכים הבאים כשמשתמשים נרשמים" — משתמש ב-Resend connector
• "פרסם הודעת Slack כשהזמנה חדשה מגיעה" — משתמש ב-Slack connector
• "הפעל נרטיב שמע בדף המאמר" — משתמש ב-ElevenLabs connector

עיון בפעולות Connector

Resend (connectorId: 'resend')

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

Slack (connectorId: 'slack')

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

ElevenLabs (connectorId: 'eleven-labs')

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

סטטוסי חיבור

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

אבטחה

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

שאלות נפוצות

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

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

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

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

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

האפליקציה שלך לעולם אינה מחזיקה בהם. פעולות קריאה שבטוחות לדפדפן עוברות בפרוקסי דרך Proyecta Cloud, שמזריק את פרטי הגישה בצד השרת, כך שהמפתח לעולם לא נמצא ב-bundle שלך. פעולות כתיבה אינן נגישות מהדפדפן כלל.

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

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

בקרוב

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