API și webhookuri
Cu API-ul, CRM-ul, magazinul online sau tipografia dumneavoastră lucrează direct cu Trendizz: predă clienții protejați și excluderile, preia companiile cu răspuns pozitiv și adresele campaniilor poștale, descarcă raportul de campanie și află imediat prin webhook. Apex explică configurarea și vă spune din jurnal ce s-a întâmplat. Cheia și webhookul le gestionează Superutilizatorul contului sau un Administrator.
Răspunsul lui Apex vine din propriile cunoștințe și din jurnalul contului dumneavoastră. Adresa este inventată.
Conectare pas cu pas
Apex vă conduce prin cele cinci conectări cele mai frecvente. Apelurile exacte și exemplele de cod se găsesc în documentația pentru dezvoltatori, cu câte un ghid separat pentru fiecare.
- Ce se întâmplă
- Apex vă spune pașii: sistemul dumneavoastră predă ca client protejat fiecare client care se înregistrează sau se abonează, cu propriul său identificator; pe cei existenți îi predă în lot, cel mult 10.000 la un apel; iar pe cel care renunță îl șterge, astfel încât poate fi contactat din nou. La o adresă de companie, alegerea potrivită este domeniul, la un furnizor gratuit de e-mail (de exemplu gmail.com), adresa de e-mail în sine.
- Unde vedeți
- În chat, în răspunsul lui Apex. Cheia o creați în meniul contului, la API și webhookuri, în vizualizarea Chei.
Nicio campanie nu scrie unui client protejat, nici măcar una destinată clienților existenți. Pe cei cărora doriți să le scrieți, de exemplu într-o campanie de recumpărare, îi încărcați într-o campanie și nu îi marcați ca protejați.
- Ce se întâmplă
- Apex parcurge pașii: sistemul tipografiei cere un export al adreselor campaniei, doar cele noi sau pe toate, citește exportul mare pe pagini, iar după predarea la poștă raportează înapoi, companie cu companie, data expedierii. Doar o companie „Exportat” poate trece la „Expediat”.
- Unde vedeți
- În chat, în răspunsul lui Apex.
Este același export ca în interfață și apare și la Exporturile mele. Cheia de test oferă adrese exemplu în orice pachet.
- Ce se întâmplă
- Apex explică că în vizualizarea Webhookuri trebuie adăugat un endpoint nou cu adresa CRM-ului și bifat evenimentul Răspuns pozitiv. Secretul de semnare îl primește dezvoltatorul o singură dată și îl stochează. Dacă CRM-ul nu a fost disponibil o vreme, preluarea răspunsurilor pozitive recuperează ce a lipsit între timp.
- Unde vedeți
- În chat, în răspunsul lui Apex. Endpointul îl adăugați în meniul contului, la API și webhookuri, în vizualizarea Webhookuri.
Acest webhook predă și persoane de contact, de aceea fiecare livrare a lui este export și apare și la Exporturile mele.
- Ce se întâmplă
- Apex explică cei patru pași: dezvoltatorul citește corpul brut, calculează o semnătură HMAC-SHA256 din marcajul de timp și corp cu secretul endpointului, o compară cu valoarea v1 din antetul Trendizz-Signature printr-o comparație în timp constant și respinge orice cerere mai veche de 5 minute. Exemplele de cod se găsesc în documentație.
- Unde vedeți
- În chat, în răspunsul lui Apex.
- Ce se întâmplă
- Apex explică că pentru asta este nevoie de o cheie de raport, cu numele agenției. Această cheie citește doar contul și raportul de campanie, agregat și defalcat pe zile, săptămâni sau luni; nu poate scrie nimic și poate fi revocată individual. Agenția o folosește din însărcinarea dumneavoastră în propriul sistem sau tabel.
- Unde vedeți
- În chat, în răspunsul lui Apex. Cheia o creați în meniul contului, la API și webhookuri, în vizualizarea Chei.
Raportul oferă doar numere, fără companii și date de contact. Cifrele sunt aceleași ca pe paginile de campanie Trendizz.
Jurnal de apeluri și webhookuri
Apex citește jurnalul de apeluri și livrările webhook, vă spune ce s-a întâmplat și deschide vizualizarea potrivită.
- Ce se întâmplă
- Apex citește jurnalul de apeluri și vă spune ce s-a întâmplat, când, cu ce cheie și în numele cui: apelurile reușite și, la erori, ce înseamnă codul de eroare. La cerere deschide vizualizarea Jurnal de apeluri.
- Unde vedeți
- În chat, în răspunsul lui Apex, și în dreapta, în vizualizarea Jurnal de apeluri de la API și webhookuri.
Răspunsul complet al unui apel care a scos date îl poate deschide doar cel care a creat cheia; Superutilizatorul și Administratorii, dacă nu ei au creat cheia, văd sinteza: câte companii și ce câmpuri au ieșit.
- Ce se întâmplă
- Apex citește endpointurile webhook și livrările: ce a plecat, când, ce a răspuns endpointul și, dacă endpointul are erori sau este suspendat, de ce. Deschide vizualizarea Webhookuri, iar la cerere un singur endpoint.
- Unde vedeți
- În chat, în răspunsul lui Apex, și în dreapta, în vizualizarea Webhookuri.
Retrimiterea și repornirea se fac cu butoanele din vizualizarea Webhookuri; le poate face Superutilizatorul contului sau un Administrator.
Bine de știut
Client protejat
Nicio campanie nu scrie unui client protejat. Pe cei cărora doriți să le scrieți îi încărcați într-o campanie; ca protejați îi marcați pe cei pe care i-ați lăsa în pace.
Cheie de test și cheie live
Cu o cheie de test, în orice pachet, fiecare apel se comportă ca în mod live, dar nu se schimbă nimic, iar la citire vin date exemplu. Cheia live funcționează într-un pachet plătit. Cheile le creează Superutilizatorul contului și Administratorii; cheia de raport citește doar contul și rapoartele de campanie.
O limită pentru toți
În orice pachet, 1000 de apeluri pe oră pentru fiecare companie, separat pentru cheia de test și cea live.
Totul în jurnal
Fiecare apel și fiecare webhook este în jurnal: când, cu ce cheie, ce s-a cerut și ce s-a primit. Detaliile sunt vizibile 90 de zile pentru Superutilizator și Administratori.
Încercați gratuit.
Întrebați-l pe Apex. Vă răspunde în propriul cont, adaptat companiei dumneavoastră.