Sisteminiz, yetenekleri sorgulamak, kişileri yönetmek, konuşmaları takip etmek, mesaj göndermek, AI ajanın kontrolünü sağlamak ve insan desteği talep etmek için Whatsplaid'i çağırır.
Kamu API'si ve dokümantasyon
Sistemlerinizi API'ler, konektörler ve webhook'larla Whatsplaid'e bağlayın.
Kişileri, konuşmaları, mesajları, insan destek ve AI ajanını entegre etmek için genel API'yi kullanın. Sisteminizin verilerini sorgulamak için harici bağlayıcıyı ve gerçek zamanlı olayları almak için webhook'ları kullanın.
Üç sözleşme
Entegrasyonun doğru yönünü seçin.
Swagger belgeleri, Whatsplaid çağrıları, asistan tarafından yapılan sorgular ve sisteminize gönderilen olaylar arasındaki karışıklığı önlemek için akışları ayırır.
Whatsplaid, bir konuşma sırasında ürünleri, siparişleri, müşterileri veya gerçek zamanlı kullanılabilirliği sorgulamak için sisteminizi çağırır.
API üzerinden harici bağlayıcıyı keşfedinWhatsplaid, yapılandırılmış bir URL'ye lead olayları, mesajlar, teslimat durumları, ticket'lar ve AI ajan değişiklikleri gönderir.
`api.whatsplaid.com/docs/` adresindeki Swagger, şemaları, örnekleri, beklenen yanıtları ve eksiksiz teknik sözleşmeleri içerir.
Ana uç noktalar için hızlı başvuru.
Bu görünüm, resmi belgede yer alan özellikleri özetler. Nihai uygulama Swagger'a uygun olmalıdır.
GET
/store
Hesap verilerini, bağlı e-ticareti ve etkin modülleri döndürür.
Account
GET
/capabilities
Hesaba, plana, modüllere ve entegrasyonlara göre hangi işlemlerin gerçekten kullanılabilir olduğunu gösterir.
Account
GET
/ecommerce/products/search
Nuvemshop, Wix veya Shopify gibi bağlı yerel entegrasyonlarda ürün arayın.
Ecommerce
GET
/ecommerce/orders/search
Bağlı yerel entegrasyonlarda siparişleri numara, e‑posta veya telefonla arayın.
Ecommerce
POST
/contacts
Telefon numarasını birincil anahtar olarak kullanarak bir kişi oluşturur veya günceller.
Contacts
GET
/conversations
Kişiler tarafından başlatılan konuşmaların listesi; sayfalama, yanıt penceresi ve AI temsilci durumu ile.
Conversations
GET
/conversations/{conversationId}/messages
Bir konuşmanın sayfalandırılmış mesaj geçmişini döndürür.
Conversations
PATCH
/contacts/{contactId}/custom-fields
Hedefleme ve operasyonel bağlam için özel alanları günceller.
Fields
POST
/messages/send
WhatsApp’ın 24 saatlik ileti penceresi içinde bir metin mesajı gönderir.
Messaging
POST
/handoffs
Şirketin mevcut yapılandırmasını kullanarak insan desteği talep edin.
Handoff
GET
/tickets
Filtreler ve sayfalama ile insan destek talepleri listesi.
Tickets
POST
/tickets/{ticketId}/close
Talebi kapatır, ilgili olayı tetikler ve konuşmanın AI temsilcisini yeniden etkinleştirir.
Tickets
PATCH
/conversations/{conversationId}/ai-agent
Yalnızca belirtilen konuşma için AI ajanını etkinleştir veya duraklat.
Conversations
GET
/ai-agent/prompt
Yapay zeka ajanının temel talimatı olarak kullanılan düzenlenebilir istemi denetler.
AI Agent
PATCH
/ai-agent/prompt
Eşzamanlı üzerine yazmaları önlemek için düzenlenebilir istemi sürüm denetimi ile güncelleyin.
AI Agent
Teknik sözleşmeler
Dokümantasyon API, harici bağlayıcı ve webhooks konularını kapsar.
Sözleşmeler, Whatsplaid'e yapılan çağrıları, temsilcinin harici sistemlerde yaptığı sorguları ve Whatsplaid tarafından gönderilen olayları ayırır.
Hesabı ve yetenekleri kontrol eder, kişiler, etiketler ve özel alanları yönetir, konuşmaları takip eder ve izin verilen pencere içinde mesaj gönderir.
Düzenlenebilir promptu görüntüleyin ve güncelleyin; ayrıca her sohbette ajanı ayrı ayrı etkinleştirin veya duraklatın.
Sohbet geçmişine, sayfalandırmaya, WhatsApp cevap penceresine ve mevcut AI ajan durumuna erişir.
Sisteminiz, konuşma sırasında temsilcinin kullanımı için ürün, sipariş, müşteri ve stok uygunluğu sorgularını açığa çıkarabilir.
Mevcut etkinlikler: `lead.created`, `message.received`, `message.sent`, `message.status.updated`, `ticket.created`, `ticket.closed` ve `conversation.ai_agent.updated`.
Webhook'ler geçici hatalar için çifte kayıtları önlemek ve yeniden denemeler için `delivery_id` kullanır. Teslimat yalnızca bir HTTP 2xx yanıtı alındıktan sonra tamamlanmış sayılır.
Bir entegrasyonu uygulamanız veya doğrulamanız mı gerekiyor?
Etkileşimli dokümantasyonu açarak `Whatsplaid Public API`, `Custom Data Connector Contract` ve `Outgoing Webhooks` arasında geçiş yapın.