Primește evenimentele prin webhooks
GoCargo trimite un POST JSON semnat către sistemul dvs. când apare o comandă nouă, se schimbă un status sau primiți un mesaj.
- Plan cu API (Pro, Business, Enterprise)
- Rol de administrator al firmei
Pe această pagină (5 pași)
- 1
Deschideți Webhooks
În Cont și setări → Chei API și webhooks, deschideți secțiunea „Webhooks”.
- 2
Adăugați endpoint-ul
La „Endpoint nou” scrieți „URL” (o adresă https://), opțional o „Descriere”, și bifați „Evenimente”: încărcături (publicată, modificată, rezervată, retrasă, ofertă de preț primită), comenzi (comandă nouă, status schimbat, document adăugat, poziție actualizată) și mesaje primite. Apăsați „Adaugă endpoint”.
Adaugă endpoint - 3
Salvați secretul
Copiați secretul whsec_… și apăsați „Am salvat secretul”. Cu el verificați antetul GoCargo-Signature.
Secretul se afișează o singură dată.
- 4
Testați legătura
Apăsați „Trimite test” și verificați „Ultimele livrări”: livrat, în așteptare, se reîncearcă, eșuat sau abandonat.
Trimite test - 5
Răspundeți corect
Sistemul dvs. trebuie să răspundă cu un cod 2xx în cel mult 10 secunde. Altfel reîncercăm după 1 min, 5 min, 30 min, 2 h, 6 h și 24 h.
După 50 de eșecuri la rând, endpoint-ul se dezactivează și administratorii sunt anunțați.
Întrebări frecvente
Pe ce adrese pot primi webhooks?
Doar pe domeniile firmei și subdomeniile lor, prin HTTPS. Primul webhook își adaugă singur domeniul; restul le vedeți la „Domeniile firmei”.
Pot primi același eveniment de două ori?
Da, se poate. Folosiți câmpul id ca să ignorați dublurile.
Câte endpoint-uri pot avea?
Cel mult 10 webhook-uri pe firmă.
Ghiduri legate
- Creează o cheie APIGenerați chei API cu permisiuni limitate, restricție pe IP și expirare, ca TMS-ul, ERP-ul sau site-ul să lucreze cu GoCargo.
- Documentația API pentru dezvoltatoriGhidul tehnic de la /dezvoltatori: pornire rapidă, autentificare, limite, idempotency, mod test, webhooks și semnătura HMAC.
Consultantul GoCargoAI răspunde imediat; echipa de suport, în mesaje.