--- title: Conector amoCRM — importă lead-urile, contactele și pipeline-urile în TSync description: Ghid prietenos pentru conectarea amoCRM la TSync. Autorizezi o singură dată prin OAuth, imporți lead-urile (cu telefon și sursă), le menții sincronizate prin webhook-uri și vezi calitatea datelor și diagnosticul — totul per companie, cu token-uri criptate. product: TSync Intelligence 11.3.6 language: ro canonical: https://docs.tsync.pro/ro/modules/tsync-amocrm/ source: https://docs.tsync.pro/llms.txt --- # 🔄 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](../tsync-external-connections/)**. --- ## 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.