● REST API · Webhook · Özel API

Geliştiriciler için: ürünlerimize kodla bağlanın.

Q: Kimlik doğrulama nasıl yapılıyor?

İstekler Authorization: Bearer başlığında gönderilen, şirkete özel bir API anahtarıyla doğrulanır. Her anahtar yalnızca kendi şirketinin verisine erişir.

Q: API anahtarını nasıl alırım?

Hangi ürüne ve hangi amaçla bağlanmak istediğinizi oigoworks'e yazın; şirketinize özel anahtar oluşturulup uç nokta listesi ve örneklerle birlikte iletilir.

Q: İstek sınırı var mı?

Evet; herkese açık uç noktalar istek sınırlamasıyla korunur. Yüksek hacimli kullanım için limitler ihtiyaca göre ayarlanır.

Ürünlerimiz JSON tabanlı REST API'ler ve webhook'larla dış sistemlerle konuşur. İhtiyacınız olan uç nokta henüz yoksa, onu projenize göre biz yazarız.

API erişimi iste → Açık API'leri gör

JSON · Bearer API anahtarı · şirket bazında izole veri · HTTPS

terminal · oigodesk REST API ● 201 Created

# Yeni destek talebi oluştur (örnek)
curl -X POST https://<sizin-adresiniz>/api/v1/tickets \
  -H "Authorization: Bearer $OIGODESK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Fatura adresi güncellenmeli",
    "priority": "high",
    "contact_email": "musteri@ornek.com",
    "contact_name": "Ayşe Yılmaz"
  }'

REST · JSON Bearer API anahtarı Webhook alıcıları Ürünler arası köprüler Özel API geliştirme

Kimler için?

Kendi yazılımını bağlamak isteyen ekipler.

Şirket içi bir yazılımınız, mobil uygulamanız ya da müşteri portalınız varsa, oigoworks ürünlerine API üzerinden bağlanabilirsiniz: kendi ekranınızdan destek talebi açmak, durumunu sorgulamak, sitenize canlı sohbet yerleştirmek ya da ödeme ve kanal olaylarını yakalamak gibi.

Her istek şirketinize ait bir API anahtarıyla doğrulanır ve yalnızca kendi şirketinizin verisine erişir. Ürünlerimiz de birbirleriyle aynı yöntemle konuşur; örneğin oigohotel, otel kimliğiyle oigodesk'te destek talebi açar.

Henüz açık olmayan bir uç noktaya ihtiyacınız varsa, onu dokümantasyonu ve test ortamıyla birlikte geliştiririz.

Açık API'ler

Bugün kullanılabilen API'ler.

Aşağıdaki uç noktalar ürünlerimizde çalışıyor.

oigodesk REST API

Destek taleplerini kendi sisteminizden yönetin.

Talep listeleme (duruma göre filtre)
Talep oluşturma, görüntüleme, güncelleme
Yorum listeleme ve ekleme

◌

Canlı sohbet API'si

oigodesk canlı sohbetini sitenize ya da uygulamanıza yerleştirin.

Oturum başlatma
Mesaj gönderme ve listeleme
Çevrimdışı mesaj bırakma

✉

E-postadan talep

Şirketinize özel gelen kutusu adresine düşen e-postalar otomatik olarak talebe dönüşür.

Şirkete özel gelen e-posta adresi
Ek dosyalar talebe eklenir
Otomatik yanıt ve bounce filtresi

MetotUç noktaAçıklama

GET/api/v1/ticketsTalepleri listeler; status ile filtrelenir.

POST/api/v1/ticketsYeni talep açar: başlık, açıklama, tür, öncelik, kişi bilgisi.

GET/api/v1/tickets/{id}Tek bir talebin ayrıntısı.

PATCH/api/v1/tickets/{id}Durum, öncelik ya da atanan kişiyi günceller.

GET/api/v1/tickets/{id}/commentsTalebin yorumları.

POST/api/v1/tickets/{id}/commentsTalebe yorum ekler.

Webhook & köprüler

Olaylar gerçekleştiği anda.

Ürünlerimiz dış servislerden gelen olayları webhook ile anında alır; periyodik sorgulamaya gerek kalmaz. Gelen istekler servisin kendi doğrulama yöntemiyle (imza veya doğrulama anahtarı) kontrol edilir.

⇄ Kanal yöneticisioigohotel: SiteMinder ve HotelRunner'dan rezervasyon bildirimleri.

✉ WhatsApp & InstagramMeta'dan gelen mesajlar oigohotel ve oigodesk gelen kutusuna düşer.

€ Ödeme olaylarıoigoecomm: imzalı Stripe webhook'u ile ödeme durumu.

⚭ Ürünler arasıoigohotel ↔ oigodesk: otel kimliğiyle müşteri eşleme ve destek talebi.

Size özel API

İhtiyacınız olan uç noktayı yazıyoruz.

Mevcut API yetmediğinde ya da kendi sisteminiz için bir API gerektiğinde, şu standartlarla teslim ediyoruz:

{ }

REST ya da GraphQL

İhtiyaca göre REST veya GraphQL; JSON yanıtlar, tutarlı hata kodları ve sayfalama.

▤

Dokümantasyon

OpenAPI (Swagger) tanımı, örnek istekler ve değişiklik notları ile birlikte.

⚗

Test ortamı

Canlıya geçmeden önce ayrı anahtarlarla deneyebileceğiniz bir sandbox.

⛨

Güvenlik

API anahtarı veya OAuth, yetki kapsamları, istek sınırlama ve erişim kayıtları.

↻

Webhook gönderimi

Sizin sisteminize olay bildirimleri; imzalı istekler ve hata durumunda yeniden deneme.

Sürümleme

Uç noktalar sürümlenir; mevcut entegrasyonlarınız güncellemelerle bozulmaz.

Süreç

API erişimi nasıl alınır?

Kısa bir görüşmeyle başlar.

Talep

Hangi ürüne, hangi amaçla bağlanmak istediğinizi bize yazın.

API anahtarı

Şirketinize özel anahtarı oluşturur, uç noktaları ve örnekleri paylaşırız.

Geliştirme & test

Entegrasyonunuzu kurarken sorularınıza ekibimiz yanıt verir.

Canlı & destek

Canlıya geçiş sonrası değişiklikleri önceden duyurur, sürümleri koruruz.

SSS

API hakkında sık sorulanlar.

Teknik bir sorunuz varsa ekibimize yazın.

Hangi ürünlerin API'si var?

oigodesk'in destek talepleri ve yorumlar için REST API'si, canlı sohbet API'si ve e-postadan talep oluşturma özelliği var. oigohotel ve oigoecomm kanal yöneticisi, WhatsApp, Instagram ve ödeme olaylarını webhook ile alır. Diğer ürünler için ihtiyaç duyduğunuz uç noktaları projenize göre açıyoruz.

Kimlik doğrulama nasıl yapılıyor?

İstekler Authorization: Bearer başlığında gönderilen, şirketinize özel bir API anahtarıyla doğrulanır. Her anahtar yalnızca kendi şirketinin verisine erişir.

API anahtarını nasıl alırım?

Bize hangi ürüne ve hangi amaçla bağlanmak istediğinizi yazın; şirketinize özel anahtarı oluşturup uç nokta listesi ve örneklerle birlikte iletiyoruz.

Kendi sistemim için API geliştirir misiniz?

Evet. REST veya GraphQL API'leri; OpenAPI dokümantasyonu, test ortamı, sürümleme ve webhook gönderimiyle birlikte geliştiriyoruz.

İstek sınırı var mı?

Evet; herkese açık uç noktalar (örneğin canlı sohbet) istek sınırlamasıyla korunur. Yüksek hacimli kullanım için limitleri ihtiyacınıza göre ayarlıyoruz.

API ile bağlanalım.

Neye bağlanmak istediğinizi anlatın; anahtarınızı ve dokümantasyonu iletelim ya da ihtiyacınız olan API'yi teklif edelim.

API erişimi iste → contact@oigoworks.com