Connectors

अपने app को Slack, Resend, और ElevenLabs जैसी third-party services से connect करें। Credentials एन्क्रिप्टेड होते हैं और actions पहले से authenticated होते हैं।

Connectors आपको code में raw API keys manage किए बिना अपने app में external services integrate करने देते हैं। आप एक बार connection set up करते हैं, उसे अपने project से bind करते हैं, और अपने app से pre-built actions call करते हैं। Credentials rest में एन्क्रिप्टेड होते हैं और कभी भी आपके frontend code में expose नहीं होते।

उपलब्ध connectors

Connector	Category	Auth type	यह क्या करता है
Resend	Communications	API key	Transactional email भेजें, batch emails भेजें, verified domains की list करें
Slack	Communications	OAuth	Messages post करें, channels और users list करें, messages पर react करें, threads पढ़ें
ElevenLabs	AI	API key	Text-to-speech, उपलब्ध voices की list करें, sound effects generate करें

और connectors नियमित रूप से जोड़े जा रहे हैं।

Connectors कैसे काम करते हैं

आप एक connection बनाते हैं — credentials दें (एक API key या OAuth के ज़रिए sign in करें)
आप connection को एक project से bind करते हैं — इससे project उन credentials को उपयोग करने के लिए authorized हो जाता है
आपका app actions call करता है — request Proyecta Cloud के ज़रिए जाती है, जो server-side पर credentials inject करता है

आपका app code कभी भी raw API key या OAuth token को नहीं छूता। Connector system authentication, rate limiting, और audit logging संभालता है।

Connector set up करें

Builder में अपना project खोलें
Settings > Connectors पर जाएं
Catalog से एक connector चुनें (जैसे, Resend)
अपने credentials दर्ज करें:
- API key connectors (Resend, ElevenLabs): अपनी secret key paste करें
- OAuth connectors (Slack): Sign in करें और access authorize करें
Connection को एक नाम दें (जैसे, “Production Resend”)
Connection अपने आप test होता है और valid होने पर Active mark हो जाता है

अपने app से connector के ज़रिए पढ़ें

आपका app किसी third-party API को सीधे browser से पढ़ सकता है, बिना API key के bundle तक पहुँचे। Credential platform पर एन्क्रिप्टेड ही रहता है; आपका app सिर्फ connector, action, और एक typed input बताता है, और platform आपकी ओर से call कर देता है।

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 });

दो guardrails जानने लायक हैं, क्योंकि वे जानबूझकर बनाए गए हैं:

सिर्फ reads। केवल वही actions पहुँच में हैं जिन्हें platform ने browser-safe mark किया है — बाकी सब 403 लौटाते हैं। Writes (Slack पर post करना, mail भेजना, card charge करना) browser से कभी reachable नहीं होते।
आप कोई URL या host pass नहीं कर सकते। Generic http-read connector के लिए input { endpointKey, params } होता है, और endpointKey के पीछे का URL आप — यानी app owner — configure करते हैं, app code नहीं। Responses server-side पर cache और rate limit होते हैं, क्योंकि third-party keys quota-metered होती हैं।

404 का मतलब है कि owner ने वह connector अभी connect नहीं किया है — अपनी UI में यही case संभालने लायक है।

AI से wire करवाएं

आपको connector code खुद लिखने की ज़रूरत नहीं है। AI builder जानता है कि आपके project से कौन से connectors bound हैं और आपके लिए integration generate कर सकता है:

"Send a welcome email when users sign up" — Resend connector use करता है
"Post a Slack message when a new order comes in" — Slack connector use करता है
"Play audio narration on the article page" — ElevenLabs connector use करता है

Connector actions reference

Resend (`connectorId: 'resend'`)

Action	Side effects	Description
`sendEmail`	write	एक single transactional email भेजें
`sendBatch`	write	एक साथ कई emails भेजें
`listDomains`	read	Verified sending domains की list करें

Slack (`connectorId: 'slack'`)

Action	Side effects	Description
`postMessage`	write	किसी channel में message post करें
`listChannels`	read	Workspace में channels की list करें
`listUsers`	read	Workspace members की list करें
`reactToMessage`	write	Emoji reaction जोड़ें
`getThread`	read	Thread में replies देखें

ElevenLabs (`connectorId: 'eleven-labs'`)

Action	Side effects	Description
`textToSpeech`	write	Text को speech audio में बदलें
`listVoices`	read	उपलब्ध voices की list करें
`generateSoundEffect`	write	AI sound effect generate करें

Connection statuses

Status	Meaning
Active	Credentials valid हैं और connection उपयोग के लिए तैयार है
Broken	Credentials expire हो गए या revoke हो गए — restore करने के लिए उन्हें update करें

Security

Credentials rest में AES-256-GCM से एन्क्रिप्टेड होते हैं
Actions प्रति connector प्रति project प्रति minute 1,000 requests तक rate-limited होते हैं
हर action call audit trail के साथ log होती है (connection, action, duration, status)
Connections पूरे workspace तक scoped होते हैं

FAQ

क्या मैं एक ही connection कई projects में use कर सकता/सकती हूँ?

हाँ। Connection एक बार बनाएं और उसे उसी workspace के किसी भी number of projects से bind करें।

अगर मेरी API key expire हो जाए या revoke हो जाए तो क्या होगा?

Connection status Broken हो जाती है। उसे restore करने के लिए Settings > Connectors में credentials update करें।

क्या मैं frontend से connector actions call कर सकता/सकती हूँ?

आपका app उन्हें कभी hold नहीं करता। Browser-safe read actions Proyecta Cloud के ज़रिए proxy होते हैं, जो server-side पर credentials inject करता है, इसलिए key कभी आपके bundle में नहीं आती। Write actions browser से बिल्कुल भी reachable नहीं होते।

क्या मैं अपने custom connectors जोड़ सकता/सकती हूँ?

अभी नहीं। Custom connector definitions roadmap पर हैं।

जल्द आ रहा है

और connectors (Google, Twilio, SendGrid, और अधिक)
Custom connector definitions — अपना खुद का API लाएं
Connected services से incoming events के लिए Webhook ingestion
OAuth gateway — client-initiated flows के लिए भी tokens server-side रखें