🔌 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 dedicat, care e construit peste acest strat și adaugă toți pașii specifici CRM.