--- title: Conexiuni externe — un singur loc sigur pentru a conecta sisteme externe description: Ghid prietenos pentru Conexiuni externe, gateway-ul unic și auditat pentru a lega sisteme externe de TSync — CRM-uri, landing page-uri, PBX, 1C, marketplace-uri și webhook-uri. Șabloane de furnizor, mai multe tipuri de autentificare, secrete criptate, loguri de cereri și un buton de test, izolate per companie. product: TSync Intelligence 11.3.6 language: ro canonical: https://docs.tsync.pro/ro/modules/tsync-external-connections/ source: https://docs.tsync.pro/llms.txt --- # 🔌 Conexiuni externe **Conexiuni externe** este un singur loc unde conectezi sisteme externe la TSync — un CRM, un landing page, o centrală telefonică (PBX), 1C, un marketplace sau orice serviciu cu un API REST ori webhook. În loc de o integrare separată, ad-hoc, de fiecare dată, fiecare conexiune stă aici cu **secrete criptate**, **loguri de cereri**, un **buton de test** și izolare per companie. O deschizi din bara laterală, la **Integrări → Conexiuni externe**, sau din **Centru de configurare → Integrări → Conexiuni externe**. > Conectorii specializați (precum conectorul amoCRM) se pot baza pe acest strat — ai un singur mod consecvent și auditat de a-i gestiona pe toți. --- ## Ce afișează pagina principală Când deschizi **Conexiuni externe** vezi: - O linie de sumar scurtă cu un contor — conexiuni **active / total** (de exemplu, *2/5 active*). - Două butoane sus-dreapta: **Șabloane furnizori** și **Jurnale**. - În stânga, lista **Conexiuni** — fiecare conexiune arată numele, furnizorul folosit și o etichetă de status colorată. - În dreapta, formularul **Adaugă / Editează conexiune**. Apasă o conexiune din listă pentru a o încărca în formularul din dreapta; apasă **Adaugă conexiune** pentru a porni una nouă. ### Statusurile conexiunii Fiecare conexiune are un status, afișat ca etichetă colorată: - **draft** — creată, dar încă netestată. - **active** — ultimul test a reușit. - **degraded** — ultimul test a eșuat (pagina arată mesajul de eroare). - **error** / **disabled** — pusă deoparte sau oprită. --- ## Șabloane de furnizor Apasă **Șabloane furnizori** ca să pornești dintr-un șablon gata făcut. Pagina listează fiecare șablon cu o scurtă descriere, tipul de autentificare implicit și un URL de bază orientativ, plus un buton **Adaugă**: - **amoCRM** — CRM: lead-uri / contacte / companii / pipeline-uri. (Pentru import/sincronizare completă de lead-uri cu login OAuth, folosește conectorul amoCRM dedicat.) - **Tilda Webhooks** — formulare de pe landing page-uri, prin webhook. - **ManyChat** — chat marketing: abonați / fluxuri. - **1C / OData** — 1C prin interfața REST OData. - **Generic REST** — orice API REST cu URL de bază + token. - **PBX webhook** — evenimente de apel telefonic, prin webhook. - **Marketplace import** — import comenzi / catalog de pe marketplace. Apasă **Adaugă** lângă un șablon și se deschide o conexiune nouă precompletată cu tipul de autentificare recomandat al acelui furnizor și un URL de bază orientativ, ca să mai ai de completat doar restul. --- ## Adaugă o conexiune În formularul **Adaugă / Editează conexiune** completează: - **Furnizor** — sistemul extern (alege din lista de șabloane de mai sus). - **Tip autentificare** — cum te autentifică serviciul: - **OAuth2 Authorization Code** — pe bază de login (folosește conectorul propriu al furnizorului pentru autorizare). - **Bearer token (static)** — un token API fix. - **API key (header)** sau **API key (query param)** — o cheie trimisă în header sau în URL. - **Basic auth** — utilizator + parolă. - **Doar webhook** — serviciul doar *trimite* evenimente către tine; nu ai ce apela în afară. - **Nume conexiune** *(obligatoriu)* — orice recunoști. - **URL de bază** — adresa API a serviciului (de exemplu, `https://api.example.com`). Slash-ul de la final este eliminat automat. - **Secret / token** — stocat **criptat**. Dacă un secret e deja salvat, câmpul arată puncte mascate (`••••••••`) — lasă-le ca să păstrezi secretul curent, sau tastează o valoare nouă pentru a-l înlocui. - **Cale test** *(opțional)* — calea pe care o lovește cererea de test (implicit `/`). - **Header cheie API** *(opțional)* — numele header-ului când folosești *API key (header)* (implicit `X-Api-Key`). - **Parametru query cheie API** *(opțional)* — numele parametrului din URL când folosești *API key (query param)* (implicit `api_key`). Apasă **Salvează**. Conexiunea apare în listă, iar formularul se reîncarcă în modul de editare ca să o poți testa. --- ## Testeaz-o După ce conexiunea e salvată, apasă **Testează conexiunea**. TSync face o singură cerere sigură către serviciu cu setările tale (un `GET` către URL-ul de bază plus calea de test, purtând autentificarea aleasă) și arată rezultatul: - La succes conexiunea devine **activă**. - La eșec devine **degradată**, iar mesajul de eroare e afișat în partea de sus a formularului. Cazuri speciale: - O conexiune **Doar webhook** nu are ce apela în afară, așa că testul raportează pur și simplu că nu există endpoint de ieșire — e normal. - O conexiune **OAuth2 Authorization Code** nu poate obține un token din acest test generic; raportează că trebuie să autorizezi prin conectorul propriu al furnizorului. Fiecare test de ieșire e scris pe pagina **Jurnale**, cu URL-ul mascat ca să nu se înregistreze niciodată secrete. --- ## Webhook-uri (date primite) Pentru o conexiune **Doar webhook**, formularul de editare afișează **URL webhook** — adresa pe care o dai serviciului extern ca să poată trimite evenimente către TSync. Fiecare conexiune primește propria cheie unică în acel URL, așa că servicii diferite nu împart niciodată o adresă. Datele de webhook primite sunt tratate mereu ca **neîncrezute**: sunt date de validat, nu instrucțiuni de executat automat. Orice e primit pe această cale e verificat înainte de a fi folosit undeva în TSync. --- ## Jurnale și siguranță Pagina **Jurnale** listează cererile recente (cele mai noi primele): **Timp**, **Direcție** (intrare / ieșire), **Metodă**, un **URL** mascat, cod de **Status**, durata în milisecunde și orice mesaj de **Eroare**. - **Secretele sunt criptate** în repaus și nu se mai afișează niciodată după salvare. - **URL-urile sunt mascate** în jurnale — cheile API, token-urile și valorile similare din query sunt înlocuite cu `***` înainte de a fi stocate. - **Fiecare conexiune aparține unei singure companii** — conexiunile și jurnalele lor nu se scurg între companii (când multi-company e pornit, vezi doar conexiunile companiei active). - Datele primite sunt tratate ca neîncrezute și sunt validate înainte de a face ceva cu ele. --- ## Permisiuni Conexiuni externe are propriile permisiuni (Setup → Roluri / membru de personal): **Vizualizare**, **Creare**, **Editare** și **Ștergere**. Vizualizarea listei necesită *Vizualizare*; salvarea și testarea unei conexiuni necesită *Editare*; ștergerea uneia necesită *Ștergere*. Fiecare modificare e înregistrată în jurnalul de audit, iar ștergerea unei conexiuni îi elimină și jurnalele, după o confirmare. --- ## Când să folosești în schimb conectorul amoCRM dedicat Conexiuni externe este gateway-ul generic. Pentru un flux amoCRM complet — login OAuth, import de lead-uri cu deduplicare și webhook-uri bidirecționale — folosește conectorul [**amoCRM**](../tsync-amocrm/) dedicat, care e construit peste acest strat și adaugă toți pașii specifici CRM.