Ce fac webhooks
Un webhook este un abonament la un eveniment specific din magazin. Când acel eveniment are loc, Storeep trimite imediat datele evenimentului la un URL specificat (API tip) sau o adresă de email specificată (E-mail tip). Webhooks sunt frecvent folosite pentru integrările de urmărire a comenzilor, sincronizările CRM, conversiile platformelor de reclame și notificările automate.
Pentru a gestiona webhooks, mergi la Setări → Webhooks.
Limitele webhooks
- Maximum 20 de webhooks per magazin. Încercarea de a adăuga al 21-lea returnează o eroare.
- Webhooks sunt listate de la cel mai recent, paginate la 40 per pagină.
Crearea unui webhook
Apasă Adaugă webhook nou.
Comutator de activare
Când este bifat (implicit), webhook-ul este live din momentul în care este salvat. Evenimentele sunt trimise imediat. Debifează pentru a salva webhook-ul în stare dezactivată fără a primi evenimente. Poți activa sau dezactiva un webhook oricând editându-l.
Nume
- Obligatoriu.
- Maximum 50 de caractere.
- O etichetă descriptivă afișată în lista de webhooks. Exemplu: Facebook CAPI, comandă creată.
Tip
Controlează cum este livrat payload-ul evenimentului. Două opțiuni:
- API: Storeep trimite o solicitare HTTP POST cu datele evenimentului la URL-ul specificat.
- E-mail: Storeep trimite un email cu datele evenimentului la adresa specificată.
Eveniment
Evenimentul din magazin care declanșează acest webhook. Trei evenimente sunt disponibile:
- Sesiune creată: se declanșează când o nouă sesiune de vizitator este creată în magazinul tău.
- Comandă creată: se declanșează când o nouă comandă este plasată.
- Comandă actualizată: se declanșează când starea sau datele unei comenzi existente se schimbă.
Format
Formatul datelor al payload-ului evenimentului. Momentan o opțiune:
- Json: payload-ul este trimis ca document JSON.
URL (doar tipul API)
- Obligatoriu când tipul este API.
- Maximum 500 de caractere. Limita mai mare acomodează URL-uri care includ mai multe segmente de placeholder.
- Introdu URL-ul endpoint-ului fără prefixul
https://. Este adăugat automat. Exemplu:api.example.com/events/order. - Placeholder-e dinamice URL: orice câmp din payload-ul evenimentului poate fi injectat în URL folosind sintaxa cu acolade duble:
{{field_name}}. De exemplu:https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
Aceasta îți permite să trimiți date de conversie la platformele de reclame direct din URL-ul webhook-ului fără un server proxy separat. - Dacă structura URL este invalidă după rezolvarea placeholder-elor, vei primi o eroare de validare.
Adresă de email (doar tipul e-mail)
- Obligatorie când tipul este E-mail.
- Trebuie să fie o adresă de email validă, maximum 127 de caractere.
Editarea unui webhook
Apasă orice rând de webhook pentru a deschide editorul. Toate câmpurile sunt editabile. Câmpul URL se pre-completează doar dacă tipul curent este API; câmpul de email se pre-completează doar dacă tipul curent este E-mail. Schimbarea tipului șterge celălalt câmp.
Activarea și dezactivarea webhooks
Caseta de selectare Activare din partea de sus a editorului controlează dacă webhook-ul se declanșează. Starea din listă arată Activat sau Dezactivat. Un webhook dezactivat nu înregistrează livrări dar nu este șters, deci îl poți reactiva mai târziu fără a-l reconfigura.
Coloanele listei de webhooks
- Nume: eticheta webhook-ului cu data creării.
- URL / E-mail: adresa de destinație.
- Tip: API sau E-mail.
- Eveniment: numele evenimentului (Sesiune creată, Comandă creată sau Comandă actualizată).
- Format: Json.
- Stare: Activat sau Dezactivat.
Ștergerea unui webhook
Selectează unul sau mai multe webhooks și apasă Șterge webhooks. Aceasta este permanentă și oprește toate livrările viitoare pentru acel abonament.
Sfaturi și capcane
- Poți crea mai multe webhooks pentru același eveniment, de exemplu trimite Comandă creată atât la un CRM cât și la o platformă de reclame, fiecare ca o intrare separată de webhook.
- Dacă endpoint-ul tău necesită autentificare, adaugă acreditările la șirul de interogare al URL-ului folosind un
{{placeholder}}provenit din datele evenimentului sau configurează un server proxy care gestionează autentificarea înainte de a transmite la endpoint-ul real. - Evenimentul Sesiune creată se declanșează pentru fiecare sesiune unică de vizitator, care poate fi de mare volum pe magazinele populare. Abonează-te la el doar dacă endpoint-ul tău poate gestiona debitul.