Conectori

Conectează-ți aplicația la servicii terțe precum Slack, Resend și ElevenLabs. Credențialele sunt criptate, iar acțiunile sunt pre-autentificate.

Conectorii îți permit să integrezi servicii externe în aplicația ta fără să gestionezi chei API brute în cod. Configurezi o conexiune o singură dată, o legi de proiectul tău și apelezi acțiuni pre-construite din aplicație. Credențialele sunt criptate în repaus și nu sunt niciodată expuse codului tău frontend.

Conectori disponibili

Conector	Categorie	Tip autentificare	Ce face
Resend	Comunicații	Cheie API	Trimite emailuri tranzacționale, trimite emailuri în lot, listează domenii verificate
Slack	Comunicații	OAuth	Postează mesaje, listează canale și utilizatori, reacționează la mesaje, citește fire de discuție
ElevenLabs	AI	Cheie API	Text-to-speech, listează vocile disponibile, generează efecte sonore

Mai mulți conectori sunt adăugați în mod regulat.

Cum funcționează conectorii

Creezi o conexiune — furnizezi credențialele (o cheie API sau te autentifici prin OAuth)
Legi conexiunea de un proiect — aceasta autorizează proiectul să folosească acele credențiale
Aplicația ta apelează acțiuni — cererea trece prin Proyecta Cloud, care injectează credențialele pe server

Codul aplicației tale nu atinge niciodată cheia API brută sau tokenul OAuth. Sistemul de conectori gestionează autentificarea, limitarea ratei și jurnalizarea auditului.

Configurarea unui conector

Deschide proiectul tău în builder
Mergi la Settings > Connectors
Fă clic pe un conector din catalog (de ex., Resend)
Introdu credențialele tale:
- Conectori cu cheie API (Resend, ElevenLabs): Lipește cheia ta secretă
- Conectori OAuth (Slack): Autentifică-te și autorizează accesul
Dă conexiunii un nume (de ex., „Production Resend“)
Conexiunea este testată automat și marcată ca Active dacă este validă

Citirea printr-un conector din aplicația ta

Aplicația ta poate citi un API terț direct din browser, fără ca cheia API să ajungă vreodată în bundle. Credențiala rămâne criptată pe platformă; aplicația ta doar numește conectorul, acțiunea și un input tipizat, iar platforma face apelul în locul tău.

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

Două măsuri de protecție merită cunoscute, pentru că sunt intenționate:

Doar citiri. Sunt accesibile doar acțiunile pe care platforma le-a marcat ca sigure pentru browser — orice altceva returnează 403. Scrierile (postarea în Slack, trimiterea de emailuri, încasarea unei plăți cu cardul) nu sunt niciodată accesibile din browser.
Nu poți transmite o URL sau un host. Pentru conectorul generic http-read, input-ul este { endpointKey, params }, iar URL-ul din spatele lui endpointKey este configurat de tine, proprietarul aplicației — nu de codul aplicației. Răspunsurile sunt puse în cache pe server și au limitare de rată, pentru că cheile terțe au cote măsurate.

Un 404 înseamnă că proprietarul nu a conectat încă acel conector — acesta este cazul care merită tratat în interfața ta.

Lasă AI-ul să facă legătura

Nu trebuie să scrii codul conectorului de mână. Builder-ul AI știe ce conectori sunt legați de proiectul tău și poate genera integrarea pentru tine:

"Send a welcome email when users sign up" — folosește conectorul Resend
"Post a Slack message when a new order comes in" — folosește conectorul Slack
"Play audio narration on the article page" — folosește conectorul ElevenLabs

Referință acțiuni conectori

Resend (`connectorId: 'resend'`)

Acțiune	Efecte secundare	Descriere
`sendEmail`	scriere	Trimite un singur email tranzacțional
`sendBatch`	scriere	Trimite mai multe emailuri deodată
`listDomains`	citire	Listează domeniile de trimitere verificate

Slack (`connectorId: 'slack'`)

Acțiune	Efecte secundare	Descriere
`postMessage`	scriere	Postează un mesaj într-un canal
`listChannels`	citire	Listează canalele din workspace
`listUsers`	citire	Listează membrii workspace-ului
`reactToMessage`	scriere	Adaugă o reacție emoji
`getThread`	citire	Obține răspunsurile dintr-un fir de discuție

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

Acțiune	Efecte secundare	Descriere
`textToSpeech`	scriere	Convertește text în audio vorbit
`listVoices`	citire	Listează vocile disponibile
`generateSoundEffect`	scriere	Generează un efect sonor AI

Stările conexiunilor

Stare	Semnificație
Active	Credențialele sunt valide și conexiunea este pregătită pentru utilizare
Broken	Credențialele au expirat sau au fost revocate — actualizează-le pentru a restaura conexiunea

Securitate

Credențialele sunt criptate cu AES-256-GCM în repaus
Acțiunile sunt limitate la 1.000 de cereri pe minut per conector per proiect
Fiecare apel de acțiune este înregistrat cu un jurnal de audit (conexiune, acțiune, durată, stare)
Conexiunile sunt limitate la întreg workspace-ul

Întrebări frecvente

Pot folosi aceeași conexiune în mai multe proiecte?

Da. Creează conexiunea o singură dată și leag-o de orice număr de proiecte din același workspace.

Ce se întâmplă dacă cheia mea API expiră sau este revocată?

Starea conexiunii se schimbă în Broken. Actualizează credențialele în Settings > Connectors pentru a o restaura.

Pot apela acțiunile conectorilor din frontend?

Aplicația ta nu deține niciodată credențialele. Acțiunile de citire sigure pentru browser sunt rutate prin Proyecta Cloud, care injectează credențialele pe server, deci cheia nu ajunge niciodată în bundle-ul tău. Acțiunile de scriere nu sunt deloc accesibile din browser.

Pot adăuga propriii conectori personalizați?

Nu încă. Definițiile de conectori personalizați sunt pe foaia de parcurs.

În curând

Conectori suplimentari (Google, Twilio, SendGrid și alții)
Definiții de conectori personalizați — adaugă propriul tău API
Ingestie webhook pentru evenimente primite de la serviciile conectate
OAuth gateway — păstrează tokenurile pe server chiar și pentru fluxurile inițiate de client