Bu rehberde: IdeaSoft mağazanızda bir API istemcisi oluşturur ve OrqLabs'a bağlarsınız. Yeni sipariş ve yeni üye kaydı iş akışı başlatır; akış içinden siparişleri listeler veya tek siparişi okursunuz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | IDEASOFT |
| Kategori | E-ticaret |
| Kimlik doğrulama | Mağazanın kendi API istemcisi (Client ID + Client secret) ile OAuth 2 izin ekranı |
| API | IdeaSoft Admin API (https://<mağaza>/admin-api) |
| Kapsam | Proje bazlı (bir bağlantı = bir mağaza) |
| Webhook | Hayır – yeni kayıtlar 5 dakikada bir kontrol edilir |
| Kutu | IdeaSoft (app.ideasoft) |
| Tetikleyici | Entegrasyon olayı → IDEASOFT · Order created, IDEASOFT · Member registered |
Ne işe yarar?
Tetikleyiciler (5 dakikada bir, sipariş/üye numarasına göre; aynı kayıt iki kez gelmez):
| Olay | Akışın ilk alanları |
|---|---|
| Order created | orderId, transactionId, status, paymentStatus, total, currency, customerName, customerEmail, customerPhone, paymentType, items (name, sku, quantity, price), createdAt |
| Member registered | memberId, firstName, lastName, name, email, phone, status, allowedToCampaigns, createdAt |
Akış ilk etkinleştirildiğinde mevcut siparişler için çalıştırma başlamaz; yalnızca sonrakiler gelir.
IdeaSoft kutusunun işlemleri:
| İşlem | Ne yapar | Etki |
|---|---|---|
| List orders | En yeni siparişleri listeler (isteğe bağlı durum kodu ve "şu tarihten sonra" filtresi, en fazla 100). Her sipariş ayrı öğe olur. | Okuma |
| Get order | Tek siparişi numarasıyla okur; kargo firması ve takip kodu dahil, ayrıca ham veri raw. | Okuma |
Örnek akış – siparişe teşekkür mesajı: Entegrasyon olayı (IDEASOFT · Order created) → AI · Metin üret (kişisel teşekkür) → Mesaj gönder (WhatsApp şablonu veya e-posta, {{ $json.customerPhone }} / {{ $json.customerEmail }}). Kampanya mesajı göndermeden önce üyenin allowedToCampaigns iznini ve İYS kaydını kontrol edin.
Ön koşullar
- IdeaSoft mağazasında 1 numaralı yönetici hesabı (API bölümünü yalnızca bu kullanıcı görür ve düzenler).
- Mağazanın panel alan adı (
magazam.myideasoft.comveya kendi alan adınız).
Adım adım kurulum
A) IdeaSoft panelinde API istemcisi
- IdeaSoft yönetim paneli → Entegrasyonlar → API → API Ekle.
- Ad:
OrqLabs. Yönlendirme adresi (Redirect URI):https://api.orqlabs.com/api/v1/integrations/oauth/ideasoft/callback– birebir aynı yazılmalı. - İzinler: Sipariş ve Üye için Okuma yeterlidir (yazma izni vermeyin).
- Kaydedin; Client ID ve Client Secret değerlerini kopyalayın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → IdeaSoft → Bağla → Proje seçin.
- Mağaza alan adı (
https://ve/olmadan), Client ID, Client secret alanlarını doldurun. - IdeaSoft ile devam et → açılan IdeaSoft panelinde izni onaylayın.
- Kartta mağaza alan adınız görünür. Bağlantıyı test et sipariş listesini okur.
- Entegrasyon olayı tetikleyicisini ekleyin → hesap: IdeaSoft bağlantınız → olay:
IDEASOFT · Order created→ Etkinleştir.
Client secret şifreli saklanır ve bağlantının erişim anahtarını yenilemek için kullanılır (erişim anahtarı ~24 saat, yenileme anahtarı ~2 ay geçerlidir; her yenilemede yenisi alınır). Yeniden bağlamak için Bağla penceresini aynı mağaza alan adıyla tekrar doldurun – mevcut bağlantı güncellenir.
Platform yöneticisi
IdeaSoft için platform düzeyinde uygulama kaydı gerekmez: her mağaza kendi API istemcisini oluşturur. Kontrol listesi:
- API'nin
API_URLdeğeri dışarıdan erişilebilir olmalı; mağaza sahipleri yönlendirme adresini{API_URL}/api/v1/integrations/oauth/ideasoft/callbackolarak girer. - Mağaza alan adı yalnızca herkese açık bir alan adı olabilir (IP adresi, port, iç ağ adresi reddedilir); tüm çağrılar SSRF korumalı istemciyle yapılır.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| IdeaSoft panelinde "redirect_uri" hatası | Yönlendirme adresi farklı yazılmış | API istemcisindeki adresi yukarıdakiyle birebir eşleyin |
AUTH – token isteği başarısız | Client ID/secret yanlış veya kod süresi doldu (~30 sn) | Bilgileri kontrol edip tekrar bağlanın |
FORBIDDEN – 403 "check the API client's permissions" | API istemcisinde sipariş/üye okuma izni yok | Panelde izni verin |
| "is not a store domain" | Alan adı https://…/panel gibi girilmiş veya geçersiz | Yalnızca alan adını girin: magazam.myideasoft.com |
AUTH – yenileme başarısız | Yenileme anahtarının süresi doldu (2 ay kullanılmadı) veya API istemcisi silindi | Yeniden bağlanın |