Înapoi la ghiduri

Actualizează livrările automat cu ShippyPro

Conectează webhook-ul de tracking ShippyPro ca să comenzile COD treacă singure la „livrat” și să primești alerte despre problemele de livrare.

Actualizat pe 20 iunie 2026


Când expediezi o comandă cu ramburs (COD) prin ShippyPro, curierul actualizează starea coletului pe măsură ce avansează (în tranzit, livrat, încercare eșuată…). Webhook-ul de tracking este legătura care îi permite lui ShippyPro să-l anunțe pe RoyLead la fiecare schimbare de stare: astfel comanda trece la «Livrat» de la sine și primești un avertisment dacă apare o problemă de livrare, fără să verifici tracking-ul manual.

💡 Este opțional: fără webhook expediezi la fel de bine, dar starea «Livrat» va trebui s-o actualizezi tu, uitându-te la tracking. Durează 2 minute, îl configurezi o singură dată.

Înainte să începi

Îți trebuie contul ShippyPro deja conectat la RoyLead (cheia ta API salvată în Setări echipă → Adresa expeditorului). Dacă n-ai făcut-o încă, conectează-l mai întâi: caseta «Webhook tracking» apare doar după ce salvezi cheia API.

Pasul 1 — Copiază cele 3 valori din RoyLead

Mergi în Setări echipă → Adresa expeditorului și deschide caseta «Webhook tracking». Găsești trei valori, fiecare cu propriul buton de copiere:

  • URL webhook — adresa la care ShippyPro va trimite actualizările.
  • Nume header personalizatx-roylead-token.
  • Valoare header personalizat (secret) — cheia ta privată.

🔒 Valoarea header-ului e un secret: e „semnătura" care îi arată lui RoyLead că apelul vine cu adevărat de la ShippyPro-ul tău. N-o distribui.

Pasul 2 — Deschide Webhooks în ShippyPro

În panoul tău ShippyPro mergi la Integration → API: secțiunea Webhook e jos de tot pe pagină. Click pe Add webhook.

Deschide ShippyPro

Pasul 3 — Creează webhook-ul

Completează fereastra ca în imagine:

  1. Webhook Url — pune lista derulantă pe https:// și lipește URL webhook copiat din RoyLead (partea de după https://).
  2. Webhook Events — selectează Tracking Update (cel care actualizează livrările).
  3. Add Basic authentication — lasă-l nebifat (Username și Password goale).
  4. Add custom headerbifează-l, apoi completează:
    • Key: x-roylead-token
    • Value: valoarea header-ului (secret) copiată din RoyLead — lipește-o integral, trebuie să corespundă exact.
  5. Click pe Save Webhook.

Fereastra „Webhook” din ShippyPro completată cu URL-ul RoyLead, evenimentul Tracking Update și header-ul personalizat (secretul e ascuns)
Fereastra „Webhook” din ShippyPro completată cu URL-ul RoyLead, evenimentul Tracking Update și header-ul personalizat (secretul e ascuns)

⚠️ Valoarea header-ului trebuie să fie identică, literă cu literă, cu cea din RoyLead. Folosește butonul „copiază” din caseta RoyLead în loc s-o scrii de mână.

Pasul 4 — Verifică

De atunci încolo totul e automat. La prima expediere reală poți verifica apelurile primite din butonul «View Webhook Log» din ShippyPro: când curierul marchează livrarea, comanda din RoyLead trece la «Livrat» de la sine.

Gata să pui asta în practică?

Creează-ți contul RoyLead și începe în câteva minute.

Începe gratis