🔄 Conector amoCRM

Conectorul amoCRM aduce în TSync lead-urile, contactele, companiile și pipeline-urile din amoCRM. Te conectezi o singură dată (un login OAuth securizat), previzualizezi ce se va importa, apoi imporți — iar de atunci modificările noi pot intra automat prin webhook-uri.

Îl deschizi din Integrări → amoCRM în meniu, sau din Centru de configurare → Integrări → amoCRM.

Conectorul este oprit până îl pornești. Nimic nu comunică cu amoCRM până nu îl activezi și nu conectezi un cont.

De ce ai nevoie din amoCRM

În contul amoCRM, creează o integrare privată (Setări → Integrări → creează-ți propria integrare). Vei primi:

  • un Client ID (integration ID),
  • un Client secret,
  • și vei lipi un Redirect URI pe care ți-l dă TSync.

Ține fila amoCRM deschisă — vei copia câteva valori dintr-o parte în alta.

Pasul 1 — deschide Setări și copiază URL-ul de callback

Mergi la amoCRM → Setări. Sus vei vedea URL-ul de callback OAuth — TSync îl construiește automat din adresa instanței tale, deci e mereu corect pentru domeniul tău:

{TSYNC_BASE_URL}/tsync_amocrm/oauth/callback
Exemplu: https://erp-ul-tau.example.com/tsync_amocrm/oauth/callback

Folosește butonul Copiază de lângă el, apoi lipește-l ca Redirect URI în integrarea amoCRM. Butonul Testează callback deschide adresa ca să confirmi că răspunde — afișează o pagină mică „amoCRM OAuth callback ready" (e normal, nu o eroare).

HTTPS este obligatoriu pentru OAuth live. amoCRM redirecționează doar către o adresă publică https://. Dacă instanța ta afișează un URL de callback non-HTTPS, TSync arată un avertisment — acea adresă funcționează doar pentru test local.

Pasul 2 — adaugă o conexiune

Tot pe Setări, apasă Adaugă conexiune și completează:

  • Nume conexiune — orice recunoști, ex. „amoCRM principal".
  • URL de bază — adresa contului, ex. https://compania-ta.amocrm.com.
  • Client ID și Client secret — din amoCRM. Secretul este stocat criptat și nu mai este afișat; dacă lași punctele mascate, secretul salvat se păstrează.
  • Mod sincronizare — Manual, Cron sau Webhook.
  • Direcție — începe cu amoCRM → TSync.
  • Opțional: un responsabil implicit și o sursă lead implicită pentru lead-urile importate.

Apasă Salvează.

Pasul 3 — conectează (autorizează)

Apasă Conectează amoCRM. Vei fi trimis la amoCRM ca să aprobi accesul, apoi readus în TSync. Când funcționează, conexiunea apare conectată iar token-urile sunt stocate (criptat). Poți apăsa Testează conexiunea oricând pentru a confirma că încă merge.

Dacă un token expiră, TSync îl reîmprospătează automat. Dacă nu poate, conexiunea e marcată degradată și apeși din nou Conectează.

Pentru a deconecta un cont, apasă Deconectează la conexiune. Asta șterge token-ul stocat din TSync și marchează conexiunea dezactivată — nu mai comunică cu amoCRM, dar îți păstrează setările, ca să poți apăsa Conectează din nou mai târziu (nu șterge nimic în amoCRM). Ca să elimini complet o conexiune, folosește Șterge în Setări.

Pasul 4 — previzualizează importul

Deschide Previzualizare import la conexiune. Este o simulare — nu schimbă nimic. Arată câte lead-uri ar fi create, actualizate, sărite (deja existente) sau marcate pentru revizuire manuală (posibil duplicat), plus un eșantion ca să verifici că maparea arată corect.

Când ești mulțumit, apasă Rulează importul. După ce se termină ajungi pe pagina Stare sincronizare, care listează fiecare rulare de import cu ora și rezultatul (preluate · create · actualizate · revizuire · erori), plus numărul total de înregistrări legate în prezent între amoCRM și TSync. O folosești ca să vezi dintr-o privire cum au mers ultimele importuri.

Cum se evită duplicatele

TSync nu creează niciodată orbește un duplicat. Potrivește un lead amoCRM cu un lead TSync existent în această ordine:

  1. o legătură anterioară cu același record amoCRM,
  2. același număr de telefon (comparat normalizat, deci 069 123 456 și +373 69 123 456 contează la fel),
  3. același email,
  4. același nume cu telefon/email potrivit → marcat pentru revizuire manuală (niciodată îmbinat automat).

Numerele de telefon sunt normalizate pentru Moldova și România.

Pasul 5 — menține sincronizarea prin webhook-uri

După primul import, pornește webhook-urile ca lead-urile noi și modificate să intre automat.

Pe pagina Webhook-uri vezi un URL de webhook pentru fiecare conexiune. Înregistrează-l în amoCRM (Setări → Integrări → webhooks). Când amoCRM trimite un eveniment, TSync îl pune în coadă și apoi reverifică recordul direct cu amoCRM înainte de a-l aplica — așa că un mesaj malformat sau falsificat nu îți poate modifica datele. Pagina listează și evenimentele webhook recente (ora, eveniment, entitate, stare: procesat / ignorat / eșuat). Poți apăsa Procesează webhook-urile din coadă acum ca să golești imediat coada.

Sincronizare automată în fundal

Pentru întreținerea de rutină nu trebuie să apeși nimic — TSync rulează două joburi de fundal pentru conector (vizibile și pornibile la cerere în Automatizare → Programator):

  • amoCRM — reîmprospătare token (cam o dată pe oră): reîmprospătează token-urile OAuth aproape de expirare, ca o conexiune să rămână conectată fără să te reconectezi. Dacă reîmprospătarea eșuează, conexiunea e marcată degradată ca să observi.
  • amoCRM — procesare coadă webhook (cam la fiecare 5 minute): golește evenimentele webhook din coadă în același mod sigur ca butonul manual — reluând fiecare record din amoCRM înainte de a-l aplica.

Ambele joburi nu fac nimic cât timp conectorul e oprit.

Diagnostic și calitatea datelor

Pagina Diagnostic îți spune, pe înțeles, dacă totul e în regulă: conectorul e pornit, schema e prezentă, OAuth e conectat, URL-ul de callback e accesibil. Arată și un scor de calitate a datelor pentru lead-urile importate:

  • ce procent au telefon,
  • ce procent au sursă,
  • câte așteaptă revizuire manuală,
  • câte webhook-uri sunt în așteptare,
  • erori în ultimele 24 de ore,
  • și ultima sincronizare reușită.

Pagina Jurnale listează fiecare acțiune cu marcaj de timp — utilă dacă ceva pare în neregulă.

Mai multe conturi și multi-company

Poți adăuga câte conexiuni ai nevoie — de exemplu una per cont amoCRM, sau una per departament — fiecare cu propriile credențiale, mod de sincronizare, URL de webhook și istoric de import. Dashboard-ul și Setările le listează pe toate cu starea lor.

Fiecare conexiune aparține unei singure companii. O conexiune configurată în Compania A poate importa doar în Compania A — datele amoCRM nu se amestecă niciodată între companii.

Cine îl poate folosi

Accesul e controlat de permisiunile de personal pentru amoCRM (Configurare → Roluri / Personal):

  • Vizualizare — deschide conectorul, dashboard-ul, diagnosticul, jurnalele și starea sincronizării.
  • Creare / Editare — adaugă și editează conexiuni, conectează/deconectează, testează, rulează importuri, procesează webhook-uri și pornește sau oprește conectorul.
  • Ștergere — elimină o conexiune.

amoCRM este una dintre integrările TSync. Dacă trebuie să conectezi alt serviciu printr-un API REST sau OAuth, vezi gateway-ul Conexiuni externe.

Ce funcționează acum, ce urmează

Conectorul e onest despre ce acoperă acum — pe dashboard apare un panou stare funcții:

  • Gata acum: conectare OAuth, Test conexiune, import lead-uri (preview + rulare), receptor/coadă webhook, loguri, diagnostic.
  • Beta / parțial: mapare câmpuri, mapare pipeline/status, asociere contacte/companii.
  • Curățarea duplicatelor — există deja. Dacă un import întrerupt a lăsat aceeași tranzacție amo de două ori în TSync, conectorul le poate găsi și îmbina: Diagnostichează arată ce consideră duplicat și de ce, Previzualizează arată exact ce ar face o curățare înainte să se întâmple ceva, iar Curăță mută sarcinile, memento-urile, fișierele și propunerile duplicatului pe înregistrarea pe care o păstrezi, apoi o elimină pe cealaltă sau o marchează. Uită-te întâi la previzualizare — o îmbinare mută muncă reală între înregistrări.
  • Planificat: sincronizare în ambele sensuri, push din TSync înapoi în amoCRM și conversie automată lead→client.

Paginile încă neterminate spun asta clar — niciun buton nu pretinde că face ceva ce încă nu poate.

Rezolvarea problemelor frecvente

  • „Callback ready. Missing authorization code" când deschizi URL-ul de callback — e normal; pornește conexiunea din butonul Conectează din TSync, nu vizitând direct URL-ul.
  • Conexiunea apare „degradată" — token-ul nu s-a putut reîmprospăta; deschide Setări și apasă din nou Conectează.
  • Testarea conexiunii eșuează — verifică URL-ul de bază, Client ID și Client secret, apoi re-salvează.
  • Un lead nu s-a importat — verifică Jurnale și Previzualizare import; lead-urile fără telefon/email care potrivesc un nume existent sunt ținute pentru revizuire manuală, intenționat.

Configurarea aplicației amoCRM (Client ID/secret) și aprobarea OAuth live se fac pe adresa reală a ERP-ului, pentru că amoCRM trebuie să poată ajunge la URL-ul de callback.