Dokümantasyon.

Hızlı Başlangıç

Cxperium'u kullanmaya başlamak için üç adım yeterli. WhatsApp Business API başvurunuzu sizin adınıza biz yönetiyoruz.

1. Hesabınızı oluşturun

   Demo talebinizin ardından ekibimiz hesabınızı açar ve WhatsApp Business API başvurunuzu Meta'ya iletir. Onay genellikle aynı gün tamamlanır.

2. Numaranızı ve profilinizi doğrulayın

   İşletme numaranız onaylandığında marka profilinizi (logo, açıklama, çalışma saatleri) panelden düzenlersiniz. Yeşil onay rozeti başvurusu da buradan yapılır.

3. İlk mesajınızı gönderin

   Şablon oluşturun, onaya gönderin ve ilk kampanyanızı yayınlayın — ya da hazır şablon kütüphanesinden seçin. Panel üzerinden kod yazmadan ilerleyebilirsiniz.

Platform Modülleri

Panel üzerindeki tüm modüllerin ayrıntılı kullanım kılavuzları ve geliştirici referansları. Her modül için adım adım anlatım panel içi yardım merkezinde de yer alır.

Web & Mobil Kanallar

Aynı bot ve aynı gelen kutusu; WhatsApp'a ek olarak web sitenizde bir sohbet balonu ya da kendi mobil uygulamanız. Panelde Kanallar → Ekle ile kanal oluşturduğunuzda size bir kanal anahtarı ve bir secret verilir.

Web kanalı için tek yapmanız gereken, panelin verdiği kurulum kodunu sitenizin </body> etiketinden hemen önce yapıştırmak. Renk, konum ve metinleri paneldeki Widget Tasarımcısı'ndan değiştirir, kodu yeniden kopyalarsınız.

<!-- Cxperium chat -->
<script>
  window.cxperiumSettings = {
    channelKey: "ch_xxxxxxxxxxxxxxxx",
    secret: "…",
    brand: "Acme Destek",
    color: "#7c3aed"
  };
  (function (d) {
    var s = d.createElement("script");
    s.src = "https://cdn.cxperium.com/widget/v1/cxperium-widget.js";
    s.async = true;
    d.head.appendChild(s);
  })(document);
</script>

Mobil uygulamalar (iOS, Android, React Native, Flutter) için custom kanal REST + WebSocket ile çalışır: uygulama bir kez kayıt olup kimlik ve token alır, sonra WebSocket üzerinden mesaj gönderir ve anında cevap alır. Sunucu gerektirmez; isterseniz kendi sunucunuz üzerinden imzalı istekle de bağlanabilirsiniz.

Kurulum adımları, tüm widget ayarları, mesaj tipleri ve hata kodları için Kanallar dokümanına bakın.

Geliştiriciler için API

Cxperium REST API'si ile kişi yönetimini, mesaj ve bildirim gönderimini, anketleri, talepleri ve canlı sohbeti kendi sistemlerinize bağlayın. Tüm istekler https://api.cxperium.com adresine HTTPS üzerinden gönderilir ve apikey başlığıyla doğrulanır. API anahtarınızı panelde Ayarlar → Api Entegrasyonu ekranından oluşturursunuz (Premium ve Enterprise planlarda).

# Kişi oluştur (varsa telefon numarasına göre günceller)
curl -X POST https://api.cxperium.com/api/contacts \
  -H "apikey: $CX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "905551112233",
    "userProfileName": "Ayşe Yılmaz",
    "email": "ayse@ornek.com",
    "language": "TR",
    "tags": []
  }'

# Açık oturumdaki (son 24 saat içinde yazmış) bir kişiye serbest metin
curl -X POST https://api.cxperium.com/api/send-message \
  -H "apikey: $CX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "TEXT", "phone": "905551112233", "text": "Merhaba! Siparişiniz kargoya verildi." }'

# 201 Created
{ "status": 201, "success": true, "message": "OK", "data": { … } }

Her yanıt status, success, message ve varsa data alanlarını taşır. Geçersiz ya da eksik anahtar 401 ve { "error": "Invalid API key!" } döner. Oturum penceresi kapalı kişilere onaylı şablonla bildirim göndermek için POST /api/notification/send-single kullanılır. IP başına dakikada 100 istek sınırı vardır; aşımda 429 alırsınız.

Tüm uç noktalar, sayfalama ve filtre kuralları, örnek gövdeler: REST API Referansı. Postman koleksiyonunu panelde Api Entegrasyonu ekranındaki Koleksiyonu Görüntüle düğmesinden indirebilirsiniz.

Webhook'lar

Anket yanıtları, talep ve sohbet olayları, toplu gönderim özetleri ve asistan olayları gerçekleştiğinde Cxperium, panelde tanımladığınız HTTPS adresine JSON gövdeli bir POST isteği gönderir. Webhook'lar Enterprise planda kullanılabilir; hangi olayların gideceğini ve hangi anketleri kapsayacağını panelde webhook tanımında seçersiniz.

# COMPLETED — bir kişi anketi tamamladığında
{
  "event_status": "COMPLETED",
  "survey": { "id": "6650aabbccddeeff00112233", "name": "Müşteri Memnuniyet Anketi" },
  "contact": { "contactId": "6612cc33dd44ee55ff667788", "name": "A**** Y*****", "phone": "905321112233" },
  "questions": [
    { "id": "6650bbccddeeff0011223345", "name": { "TR": "Hizmetimizi 1-5 arası puanlar mısınız?" }, "answer": { "button_reply": "5" } },
    { "id": "6650bbccddeeff0011223346", "name": { "TR": "Eklemek istediğiniz bir şey var mı?" }, "answer": { "text_reply": "Çok memnun kaldım." } }
  ],
  "start_time": "2026-09-07T09:47:40.000Z",
  "complated_time": "2026-09-07T09:47:40.212Z"
}

Her istekte olayın kodu event_status ve gönderim anı complated_time bulunur; kalan alanlar olaya özeldir. Yanıt olarak 2xx dönmeniz yeterlidir; gövde okunmaz. İstek yalnızca ağ hatasında bir kez yinelenir, 4xx/5xx yanıtlar yeniden denenmez. Değeri olmayan alanlar JSON'a yazılmaz.

Tüm olaylar ve alan açıklamaları: Webhook Referansı. Panelden tanımlama adımları: Webhook Entegrasyonu.