Ce face un webhook
Un webhook trimite detaliile unui eveniment din magazin în alt loc chiar în momentul în care are loc. Tu alegi evenimentul și unde ajunge:
- API: Storeep trimite datele evenimentului la o adresă web (URL) a serverului tău, a CRM-ului, a unui scenariu Zapier sau Make ori a unui instrument de urmărire a reclamelor.
- E-mail: Storeep trimite datele evenimentului la o adresă de e-mail, de exemplu ca să primești un e-mail pentru fiecare comandă nouă.
Deschide Setări > Webhook-uri. Ai nevoie de permisiunea Setări.
Multe instrumente au deja o aplicație gata făcută, care este mai simplă: Google Sheets, rețelele de curierat și pixelii de reclame. Verifică mai întâi piața de aplicații.
Crearea unui webhook
Dă clic pe Adăugați un nou webhook, completează formularul și dă clic pe Adaugă.
- Activează: bifat implicit. Când este bifat, evenimentele se trimit imediat. Debifează-l ca să păstrezi webhook-ul, dar să-l pui pe pauză.
- Nume: o etichetă pentru listă, de exemplu „CRM comenzi noi”.
- Tip: API sau E-mail.
- Eveniment:
- Comandă creată: un client plasează o comandă nouă.
- Comandă actualizată: se schimbă statusul sau detaliile unei comenzi.
- Sesiune creată: un vizitator nou ajunge în magazin. Doar pentru tipul API.
- Format: Json.
- URL (tipul API): adresa la care se trimite. Partea
https://este adăugată pentru tine, așa că scrie restul, de exempluapi.example.com/orders. - Adresă de e-mail (tipul E-mail): unde ajunge e-mailul.
Un webhook E-mail trimite doar evenimente legate de comenzi. Dacă alegi E-mail cu Sesiune creată, nu se trimite nimic.
Datele comenzii în URL
Poți pune orice câmp din datele evenimentului în URL, între acolade duble, {{field_name}}. De exemplu:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Astfel trimiți ID-ul de clic Facebook și totalul comenzii către o platformă de urmărire a reclamelor sau de afiliere, fără alt server. Un câmp care nu există rămâne gol. Ca să vezi numele câmpurilor, creează un webhook E-mail pentru același eveniment și uită-te la datele primite.
Lista de webhook-uri
Fiecare rând arată Nume, URL / E-mail, Tip, Eveniment, Format și Stare (Activat sau Dezactivat). Dă clic pe un rând ca să-l editezi. Bifează rânduri și alege Ștergeți webhooks ca să le elimini definitiv. Există un număr maxim de webhook-uri pe magazin și vezi un mesaj când îl atingi.
Poți crea mai multe webhook-uri pentru același eveniment, de exemplu unul către CRM și unul către instrumentul de urmărire a reclamelor.
Când o livrare eșuează
- Serverul tău trebuie să răspundă repede cu un cod de succes (2xx). Un răspuns lent contează ca eșec.
- Dacă serverul este căzut sau ocupat (un răspuns 5xx sau 429, ori niciun răspuns), Storeep reîncearcă de mai multe ori în următoarele minute. Sunt reîncercate doar webhook-urile care au eșuat, așa că celelalte nu primesc duplicate.
- Dacă serverul refuză cererea (un răspuns 4xx, cum ar fi 404 sau 403), Storeep nu reîncearcă, pentru că adresa sau securitatea ei este greșită.
- Când un webhook eșuează de mai multe ori la rând, proprietarul magazinului primește un singur e-mail: „Acțiune necesară: webhook-ul tău Storeep eșuează”, cu numele webhook-ului, adresa, evenimentul și ultimul cod de eroare. După ce webhook-ul funcționează din nou, o problemă viitoare poate trimite un nou avertisment. Poți opri acest e-mail în Notificări.
- Webhook-urile E-mail se trimit o singură dată, fără reîncercare.
Webhook-uri puse pe pauză de un sold neplătit
Dacă magazinul are o sumă datorată neplătită și portofelul nu o poate acoperi, webhook-urile așteaptă. Ele se trimit după ce adaugi fonduri și suma este achitată. Vezi Portofel și facturare.
Sfaturi
- Dacă serverul tău are nevoie de o parolă sau o cheie, pune-o în parametrii URL-ului, de exemplu
?key=yoursecret. - Sesiune creată se declanșează pentru fiecare vizitator, ceea ce poate însemna foarte mult într-un magazin aglomerat. Folosește-l doar dacă serverul tău poate face față.
- Ca să lași un instrument să îți citească comenzile și produsele oricând vrea, folosește în schimb un token de acces.