Despre noiContactAutentificare
Baza de cunoștințe Apex

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.

1 / 6

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 ar trebui să configureze dezvoltatorul nostru ca clienții noștri din CRM să rămână în afara campaniilor?
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.

O poate cere un Superutilizator sau un Administrator
Pas cu pas în documentația pentru dezvoltatori
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.

O poate cere un Superutilizator sau un AdministratorCu pachet plătit
Pas cu pas în documentația pentru dezvoltatori
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.

O poate cere un Superutilizator sau un AdministratorCu pachet plătit
Pas cu pas în documentația pentru dezvoltatori
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.
O poate cere un Superutilizator sau un Administrator
Pas cu pas în documentația pentru dezvoltatori
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.

O poate cere un Superutilizator sau un Administrator
Pas cu pas în documentația pentru dezvoltatori

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ă.

De ce a primit CRM-ul o eroare azi-dimineață?
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.

O poate cere un Superutilizator sau un Administrator
În detaliu: API și webhookuri pentru propriile sisteme
De ce este suspendat webhookul nostru?
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.

O poate cere un Superutilizator 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ă.

Cont gratuit, fără date de card · taxă lunară, fără perioadă minimă de contract