API Endpoint Tanımlama ve Entegrasyon Rehberi

API Entegrasyonları ve Connectors Kılavuzu

Platformumuz, asistanınızın şirket içi yazılımlarınızla (CRM, ERP, e-ticaret) iletişim kurmasını sağlayan güvenli bir API Connector altyapısı sunar.

API Connector Tanımlama

Şirket panelinizde API Entegrasyonları sekmesine gidin. "Yeni Entegrasyon Ekle" butonu ile bağlantı oluşturun:

1. Temel Bilgiler: Entegrasyon adı ve base URL tanımlayın.
2. API Kimlik Doğrulama (Auth) Yöntemleri: Harici sunucunuzun güvenlik yapısına göre aşağıdaki kimlik doğrulama modellerinden birini seçin:
   • Bearer Token: HTTP Header alanına Authorization: Bearer [token] formatında token ekler.
   • API Key: Belirlediğiniz özel bir anahtarı Header ya da Query string olarak iletir.
   • Basic Auth: Kullanıcı adı ve şifreyi Base64 formatında kodlayarak gönderir.

Endpoint ve Parametre Tanımlama

Bir entegrasyon altında birden fazla API Endpoint (örn: /orders/search, /customers/detail) tanımlayabilirsiniz. Her endpoint için:

• HTTP Metodunu seçin (GET, POST, PUT, DELETE).
• İstek (Request) parametrelerini veri türleriyle birlikte tanımlayın.
• Yanıt (Response) parametreleri için yapay zekanın hangi JSON alanlarını (örn: status, delivery_date) okuyacağını haritalayın.

Webhook Tetikleme Mekanizması

Asistanınız bir e-postaya yanıt verdiğinde veya kritik bir sohbet sonlandığında, bu işlemi harici sistemlerinize bildirmek için Webhook tanımlayabilirsiniz. Webhook verisi, alıcı sunucunuza güvenli bir JSON payload formatında POST edilir.