Connectors

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

Connectorii îț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 asociezi proiectului tău și apelezi acțiuni pre-construite din aplicație prin intermediul SDK-ului Proyecta. Credențialele sunt criptate în repaus și nu sunt niciodată expuse codului tău frontend.

Connectors disponibili

Connector	Categorie	Tip autentificare	Ce face
Resend	Comunicații	Cheie API	Trimite email tranzacțional, trimite emailuri în lot, listează domeniile 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

Se adaugă connectors noi în mod regulat.

Cum funcționează connectorii

1. Creezi o conexiune — furnizezi credențiale (o cheie API sau te autentifici prin OAuth)
2. Asociezi conexiunea unui proiect — aceasta autorizează proiectul să utilizeze acele credențiale
3. Aplicația ta apelează acțiuni — SDK-ul trimite cererea prin Proyecta Cloud, care injectează credențialele pe partea de server

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

Configurează un connector

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

Folosește un connector în aplicația ta

Acțiunile connectorilor sunt apelate din codul server-side (acțiuni Convex) folosind SDK-ul Proyecta:

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

Metoda execute returnează:

Câmp	Descriere
output	Valoarea returnată de acțiune (structura depinde de acțiune)
durationMs	Timpul de execuție în milisecunde
invocationId	ID-ul intrării din jurnalul de audit

Lasă AI-ul să configureze totul

Nu trebuie să scrii codul pentru connectors manual. Builder-ul AI știe ce connectors sunt asociați proiectului tău și poate genera integrarea pentru tine:

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

Referință acțiuni connectors

Resend

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

Slack

Acțiune	Efecte	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

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

Statusurile conexiunilor

Status	Semnificație
Active	Credențialele sunt valide și conexiunea este gata de utilizare
Broken	Credențialele au expirat sau au fost revocate — actualizează-le pentru a restabili conexiunea

Securitate

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

Întrebări frecvente

Pot folosi aceeași conexiune pentru mai multe proiecte?

Da. Creează conexiunea o singură dată și asociaz-o oricâtor proiecte din același workspace.

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

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

Pot apela acțiunile connectorilor din frontend?

Nu. Acțiunile connectorilor trebuie apelate din codul server-side (acțiuni Convex) pentru a păstra credențialele în siguranță. SDK-ul rutează prin Proyecta Cloud, care injectează autentificarea pe partea de server.

Pot adăuga propriii conectori personalizați?

Încă nu. Definițiile de connectors personalizați se află pe foaia de parcurs.

În curând

• Connectors suplimentari (Google, Twilio, SendGrid și alții)
• Definiții de connectors personalizați — adaugă-ți propriul API
• Ingestie de webhook pentru evenimentele primite de la serviciile conectate
• Gateway OAuth — păstrează token-urile pe server chiar și pentru fluxurile inițiate de client