API kanalı
Entagl’i kendi uygulamanıza veya Make’e bağlayın: mesaj gönderin, yanıtları alın ve workspace’inizi yönetin.
Genel bakış
API channel, DM’lerinizi güçlendiren aynı AI agent’ı kendi web sitenizdeki chat, mobil uygulamanız veya backend’inizde çalıştırmanızı sağlar. Siz bir mesaj gönderirsiniz, agent düşünür (gerçek bir DM’deki gibi aynı buffering ve insan benzeri, çok parçalı yanıtlarla) ve yanıt size biraz sonra webhook callback veya polling ile ulaşır. Kurulumu Kanallar → API altında yapın: bir API key oluşturun, channel’ı açın, ardından callback veya polling seçin. Aynı API, developer’ınızın veya Make’in contacts, conversations, bookings, orders ve daha fazlasıyla çalışmasını da sağlar. Workspace API sekmesine bakın.
Bu sayfadaki sekmeler
API yalnızca chat için değildir. Developer’ınız veya Make gibi bir tool, workspace’inizin çoğunu okumak ve güncellemek için bunu kullanabilir.
Bununla neler yapabilirsiniz
Mesaj göndermenin yanı sıra, API şunları kapsar:
- Contacts: oluşturma, güncelleme, arama, birleştirme, not ekleme, do-not-contact olarak işaretleme
- Tags ve lifecycle stages: tag ekleme veya kaldırma, bir contact’i başka bir stage’e taşıma
- Conversations: bir teammate’e atama, closing note ile kapatma, AI’ı duraklatma veya devam ettirme, team comment ekleme, business’iniz adına mesaj gönderme
- Bookings ve reminders: uygun saatleri kontrol etme, rezervasyon oluşturma, yeniden planlama, iptal etme, reminder oluşturma ve kapatma
- Orders ve products: order’ları ve item’larını oluşturma ve güncelleme, katalog yönetimi
- Calls: bir AI phone call başlatma veya sıraya alma, sonucu okuma
- Campaigns: campaign’lerinizi görme ve gönderme
Bir şey değiştiğinde Entagl bunu araçlarınıza hemen webhooks üzerinden bildirebilir.
İki giriş yöntemi
Make. Make’i bağladığınızda, kendi Entagl hesabınızla giriş yaparsınız. Make daha sonra tam yetkilerinizle sizin yerinize hareket eder: owner veya admin her şeyi yapabilir, team member ise yalnızca izin verilenleri yapar. Girişinizde birden fazla workspace varsa, hangisini kullanacağınızı seçersiniz.
API key. Kendi server’ınız için Kanallar → API veya Ayarlar → API keys altında bir key oluşturun ve Authorization: Bearer <your key> olarak gönderin. Bir key yalnızca bir workspace’e aittir ve o workspace üzerinde tam owner erişimine sahiptir; bu yüzden onu bir password gibi değerlendirin.
Tekrar denemeye güvenli: Idempotency-Key header’ı
Bazen bir istek geçer ama cevap geri dönerken kaybolur. Sisteminiz bir isteğin başarılı olup olmadığından emin değilse, aynı Idempotency-Key header’ı ile tekrar gönderebilir. 24 saat içinde Entagl key’i tanır, işlemi atlar ve ilk yanıtı döner; böylece iki order veya iki contact oluşmaz. Aynı key’in farklı bir istek için kullanılması hata ile reddedilir.
Ne kadar istek gönderebilirsiniz
Her workspace için dakikada en fazla 120 istek. Bunu aşarsanız Entagl 429 hatası (rate_limited) döner. Biraz bekleyip tekrar deneyin. Çoğu automation bunun yanına bile yaklaşmaz.
Tam API referansı
Her endpoint, field ve error code Entagl API referansında listelenmiştir. Developer’ınızda yoksa, support@entagl.com adresine email atıp API referansını isteyin.
Özellikler
Kurulum ve kimlik doğrulama
Channels → API altından bir API anahtarı oluşturun, kanal anahtarını etkinleştirin, ardından https://api.entagl.com adresine Authorization: Bearer <anahtarınız> başlığıyla istek atın. Anahtarlar çalışma alanına özeldir.
Mesaj gönderme
POST /api/v1/messages ile { message, externalUserId } gönderin. Hemen 202 ve bir conversationId alırsınız. Konuşmayı sürdürmek için aynı conversationId’yi yeniden kullanın. Agent’ın yanıtı daha sonra gelir, bu response içinde değildir.
Webhook callback (önerilir)
Genel bir HTTPS callback URL'si ekleyin; Entagl her ajan yanıtını X-Entagl-Signature başlığıyla (HMAC-SHA256) imzalayarak buraya POST eder. İmzayı doğrulayın ve yaklaşık 5 saniye içinde 2xx yanıt verin. Otomatik yeniden deneme yoktur.
Yoklama (polling)
Bir callback URL'si barındıramıyorsanız, yeni yanıtları almak için GET /api/v1/conversations/:id/messages?since=<cursor> çağırın. Her yanıttaki cursor'ı ?since= olarak geri gönderin; böylece yalnızca yeni mesajları alırsınız.
Güvenlik ve izolasyon
API key’ler hashed olarak saklanır ve signing secret şifrelenir (ikisi de yalnızca bir kez gösterilir). Her sorgu workspace’e bağlıdır: başka bir workspace’ten gelen bir conversation ID 404 döner ve user ID gönderemezsiniz (çünkü key’inizden türetilir).
Yaygın görevler
API kanalını kurun
3 dk hakkında- Channels → API’ye gidin ve Generate API Key’e tıklayın. Şimdi kopyalayın, çünkü yalnızca bir kez gösterilir.
- API kartı başlığındaki kanal anahtarını açın.
- Önerilir: kartı genişletin, genel bir HTTPS callback URL'si yapıştırın, kaydedin ve imzalama gizli anahtarını kopyalayın.
- Uygulamanızdan https://api.entagl.com/api/v1/messages adresine mesaj gönderin (POST) ve yanıtları callback veya yoklama ile alın.
İpuçları
Sık sorulan sorular
Bu sayfa faydalı mıydı?