Punte CRM
Când sesiunea primește un nume, înregistrarea ajunge ca notă la persoana din CRM — contactul existent, nu unul nou.
1. Funcția într-o propoziție
La identificarea sesiunii căutăm persoana în CRM prin identificatorul trimis și atașăm o notă cu linkul înregistrării.
Atât. Fără contacte noi, tranzacții noi sau modificări ale fluxului de vânzări. Un CRM care creează duplicate la fiecare vizită pe pagina de prețuri este mai rău decât lipsa integrării.
Dacă persoana nu este găsită, nu se întâmplă nimic. Crearea ar însemna scrierea unei înregistrări CRM dintr-o sesiune de browser — iar aceasta nu este sursa de adevăr privind identitatea clienților.
2. Cheia de asociere: cum găsim persoana
Merită zece minute de atenție: aici integrarea CRM greșește de obicei fără avertizare.
Cunoaștem vizitatorul prin valoarea comunicată de site — MousePlayer.setUserId(), un identificator distinct citit din analiza produsului sau un apel de identificare pe server. CRM-ul îl cunoaște tot printr-o valoare. Cele două trebuie să coincidă.
| Căutăm | Se poate schimba | |
|---|---|---|
| HubSpot | e-mailul contactului | nu — endpointul de căutare îl folosește direct |
| Pipedrive | persoane după termen, e-mail întâi | nu |
| Salesforce | un câmp numit de dumneavoastră, implicit Email | da |
De ce întreabă Salesforce
Instalările Salesforce folosesc rar e-mailul drept cheie. Pot folosi Customer_Number__c, sau un ID extern al facturării. Dacă am căuta tot prin e-mail, nu am găsi nimic și am raporta reușită — cel mai rău eșec, fiindcă integrarea pare funcțională.
De aceea formularul întreabă: care câmp Contact conține valoarea trimisă? Introduceți numele API, inclusiv sufixul __c pentru un câmp personalizat.
Numele se verifică după un tipar strict înaintea interogării. Sunt permise litere, cifre și liniuțe de subliniere — restul se respinge, nu se protejează prin escape, fiindcă acolo se pot strecura erori subtile, la respingere nu.
3. Când se declanșează și când nu
La identificare: când site-ul apelează MousePlayer.setUserId(), puntea citește un ID distinct din PostHog, Mixpanel sau Amplitude ori serverul apelează endpointul de identificare.
O dată pe sesiune, nu pe pagină
O persoană autentificată care vizitează unsprezece pagini produce o notă, nu unsprezece. Cronologia CRM este citită de oameni.
Nu fără identificator
Sesiunea anonimă nu are cheie de asociere. Nu ghicim după IP și nu atașăm înregistrarea persoanei care întâmplător folosește aceeași adresă.
Nu pentru persoane necunoscute CRM-ului
Considerat finalizat, nu eșuat — un client potențial încă absent din CRM este normal, iar reîncercarea mâine nu ar schimba asta.
4. Aspectul notei și stocarea tokenului
O notă în cronologia contactului: o linie despre sesiunea înregistrată și linkul. Agentul de vânzări apasă și vede ce a făcut persoana înainte de contact.
Datele de autentificare
Stocate criptat cu AES-256-GCM. Nu se reafișează — câmpul arată asteriscuri, iar salvarea lor păstrează valoarea existentă. Nu intră în coada internă: coada este stare partajată, nepotrivită pentru o cheie.
Salesforce necesită trei lucruri, ceilalți două
Salesforce folosește aplicație conectată cu token de reîmprospătare: cere consumer key, secretul, tokenul și URL-ul instanței. HubSpot și Pipedrive cer un token API. În toate cazurile aplicația vă aparține — MousePlayer nu are o aplicație de marketplace în care trebuie să aveți încredere.
5. Zoho CRM și Freshsales
Două CRM-uri suplimentare, cu efort de configurare foarte diferit.
| Zoho CRM | Freshsales | |
|---|---|---|
| Furnizați | centru de date, ID client, secret client, token de reîmprospătare | cheie API și domeniu Freshworks |
| Căutăm | un câmp numit de dumneavoastră, implicit Email | un câmp numit de dumneavoastră, implicit email |
| Nota ajunge | la contact, ca înregistrare Note | la contact, ca notă |
Zoho se află într-unul dintre șase centre de date
Contul este în com, eu, in, com.au, jp sau com.cn, iar cheia nu indică unde. Alegerea greșită produce răspunsul Zoho INVALID_TOKEN — care pare cheie greșită și vă trimite în direcția greșită. De aceea câmpul este o listă derulantă.
Self Client, o singură dată
Creați Self Client în consola API Zoho, generați un token de autorizare pentru ZohoCRM.modules.ALL și ZohoSearch.securesearch.READ, apoi schimbați-l o dată cu un token de reîmprospătare. Acesta nu expiră; tokenurile de acces de o oră sunt obținute din el și niciodată stocate.
Zoho răspunde 200 când refuză
Schimbul de tokenuri și scrierea datelor pot răspunde HTTP 200 cu eroare sau stare per înregistrare în conținut. Îl citim — încrederea doar în cod ar raporta reușită pentru o notă inexistentă.
Toate mărcile menționate aici aparțin proprietarilor lor. MousePlayer nu are relații comerciale cu acești furnizori.