> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerçek zamanlı güncellemeler için webhook’lar

> Bir sipariş geldiğinde, durumu değiştiğinde ya da gönderi oluşturulamadığında OTO’dan anında haber alın; API’yi sürekli sorgulamak yerine bir webhook kurun.

Webhook’lar, sistemlerinizin bir şey olup olmadığını tekrar tekrar sorması yerine, OTO’nun bir şey olduğunda sistemlerinize haber vermesinin yoludur.

## Üç olay

| Tür | Ne zaman tetiklenir? | Tipik alıcı |
| - | - | - |
| `orderStatus` | Bir siparişin durumu değiştiğinde. | E-ticaret siteniz, ERP’niz ya da müşteri hizmetleri aracınız. |
| `shipmentError` | Kargo şirketinde bir gönderi oluşturulamadığında. | Bir insanı uyaran her ne ise. Sessiz hata budur. |
| `newOrders` | OTO’ya bir sipariş geldiğinde. | Siparişi kendisinde oluşturması gereken ayrı bir WMS. |

## Webhook kurmak

**Ayarlar → Developers → Webhooks** üzerinden ya da `POST /rest/v2/webhook` ile bir URL kaydedin. Yöntemi, olay türünü, bir yetkilendirme anahtarını ve bir gizli anahtarı siz seçersiniz; uç noktanızın verinin OTO’dan geldiğini kanıtlayabilmesi için her veri paketi **HMAC-SHA256** ile imzalanır.

Veri paketlerinin tamamı, imza şeması ve mükerrer ya da sırasız teslimata dayanıklı bir uç nokta oluşturma kuralları [Webhook olayları](https://docs.tryoto.com/tr/developers/webhook-events.md) sayfasındadır.

> [!WARNING]
>
> **İmzayı doğrulayın; URL bir sır değildir**
>
> Webhook URL’nizi öğrenen herkes ona istek gönderebilir. Doğrulama yapmazsanız sisteminize bir siparişin teslim edildiğini söyleyebilirler.
>
> HMAC’i yeniden hesaplayın, sabit sürede karşılaştırın ve eski zaman damgalarını reddedin.

## Alternatif ve neden ölçeklenmediği

Bunun yerine `orderStatus`’u bir zamanlayıcıyla sorgulayabilirsiniz; ilk gün barındırmanız gereken bir uç nokta olmadan çalışır. Yüksek hacimde ise hiçbir şeyin değişmediğini öğrenmek için binlerce çağrı yapmak anlamına gelir ve ihtiyaç duyduğunuz o tek durum bilgisi bir sorgulama aralığına kadar geç gelir.

## İlgili sayfalar

* [Webhook olayları](https://docs.tryoto.com/tr/developers/webhook-events.md): veri paketleri ve doğrulama.
* [İşbirliği ve bildirimler](https://docs.tryoto.com/tr/platform/collaboration-and-notifications.md): aynı olaylar, bu kez kişilere gönderilir.
* [Durum ve Takip Güncellemeleri](https://docs.tryoto.com/tr/modules/sales-channels/updates.md): aynı olaylar, bu kez bir satış kanalına iletilir.


## Related topics

- [Entegrasyonlara genel bakış](https://docs.tryoto.com/tr/integrations/overview.md)
- [Gönderi oluşturma, etiket yazdırma ve koli takibi](https://docs.tryoto.com/tr/modules/shipping-management/shipping-and-tracking.md)
- [OTO API’ye genel bakış](https://docs.tryoto.com/tr/developers/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.