Webhooks

Τεχνική Ορολογία

Η παρακάτω διαδικασία απαιτεί πρόσβαση στις ρυθμίσεις του διαχειριστή της ιστοσελίδας σας.

Τα Webhooks επιτρέπουν στο CourierHub να λαμβάνει ειδοποιήσεις σε πραγματικό χρόνο όταν συμβαίνει ένα γεγονός στο e-shop σας (π.χ. δημιουργία νέας παραγγελίας).

Endpoints

Ανάλογα με την πλατφόρμα που χρησιμοποιείτε, θα πρέπει να ορίσετε το αντίστοιχο URL webhook στις ρυθμίσεις του καταστήματός σας.

Shopify

Για το Shopify, θα πρέπει να ρυθμίσετε το Webhook στο event Order Checkouts ή Order Payment.

URL Format:https://app.courierhub.gr/webhooks/shopify/orders/{CUSTOMER_ID}

WooCommerce

Για το WooCommerce, πηγαίνετε στο Settings > Advanced > Webhooks.

Σημαντική Σημείωση

Θα πρέπει να δημιουργήσετε 2 webhooks - ένα για Order Created και ένα για Order Updated.

Webhook #1 - Νέες Παραγγελίες

Πεδίο	Τιμή
Όνομα	CourierHub Orders (Create)
Status	Ενεργοποιημένο
Topic	Order Created (Η Παραγγελία Δημιουργήθηκε)
Delivery URL	https://app.courierhub.gr/webhooks/woocommerce/orders/{CUSTOMER_ID}
Secret	(αφήστε κενό - θα δημιουργήσει το WooCommerce δικό του)
API Version	Τελευταία σταθερή έκδοση

Webhook #2 - Ενημερωμένες Παραγγελίες

Πεδίο	Τιμή
Όνομα	CourierHub Orders (Update)
Status	Ενεργοποιημένο
Topic	Order Updated (Η Παραγγελία Ενημερώθηκε)
Delivery URL	https://app.courierhub.gr/webhooks/woocommerce/orders/{CUSTOMER_ID}
Secret	(αφήστε κενό)
API Version	Τελευταία σταθερή έκδοση

TIP

Με την ενέργεια Order Created ενημερώνετε το CourierHub για τις νέες σας παραγγελίες, ενώ με την ενέργεια Order Updated ενημερώνετε το CourierHub για αλλαγές σε υπάρχουσες παραγγελίες (π.χ. αλλαγές προϊόντων, τιμών, μεταφορικών).

Πού να βρείτε το

Το {CUSTOMER_ID} είναι μοναδικό για κάθε λογαριασμό CourierHub και μπορείτε να το βρείτε στις Ρυθμίσεις του προφίλ σας ή στη σελίδα Διασύνδεσης Καταστημάτων.

Wix

Για το Wix, θα πρέπει να ρυθμίσετε το αντίστοιχο Automation ή Developer Trigger.

URL Format:https://app.courierhub.gr/webhooks/wix/orders/{CUSTOMER_ID}

---

❓ Συχνές Ερωτήσεις (FAQ)

❌ Τα webhooks δεν στέλνονται

Αν παρατηρείτε ότι τα webhooks δεν φτάνουν στο CourierHub:

1. Ελέγξτε το URL του webhook

   • Βεβαιωθείτε ότι είναι ακριβώς https://app.courierhub.gr/webhooks/woocommerce/orders/{CUSTOMER_ID}
   • Αντικαταστήστε το {CUSTOMER_ID} με το σωστό ID από τη σελίδα Διασύνδεσης Καταστημάτων

2. Βεβαιωθείτε ότι το webhook είναι ενεργό

   • Πηγαίνετε στο WooCommerce: Settings > Advanced > Webhooks
   • Ελέγξτε ότι το webhook έχει κατάσταση "Active"

3. Ελέγξτε τα WooCommerce logs

   • Πηγαίνετε στο φάκελο wp-content/uploads/wc-logs/
   • Αναζητήστε αρχεία που ξεκινούν με webhook-
   • Εκεί θα βρείτε πληροφορίες για τα σφάλματα

4. Δοκιμάστε να δημιουργήσετε μια νέα παραγγελία

   • Δημιουργήστε μια δοκιμαστική παραγγελία στο WooCommerce
   • Στις ρυθμίσεις του webhook, κάντε κλικ στο Webhook και δείτε την ενότητα Deliveries για τις Αποστολές
   • Εκεί θα δείτε αν το webhook στάλθηκε και ποιο ήταν το σφάλμα (εάν υπάρχει)

5. Επικοινωνήστε με την υποστήριξη

   • Αν το πρόβλημα παραμένει, συλλέξτε ένα screenshot από τα logs και επικοινωνήστε με την ομάδα υποστήριξης.