Doğru bağlantıları kurun.
Arama olaylarını araçlarınıza taşıyın, iş akışınızdan arama başlatın ve IVR’de kendi verinizi kullanın.
Doğru API yüzeyini seçin
MonoSIP oturumla doğrulanan yönetici API’sini, dahiliyle doğrulanan portal API’sini ve API anahtarıyla doğrulanan entegrasyon API’sini ayırır. Dış entegrasyonlar /api/v1/ext kullanır.
| Entegrasyon ucu | Amaç |
|---|---|
| POST /api/v1/ext/calls/originate | Tıkla-ara: önce bir dahiliyi çaldırın, sonra hedefi arayın. |
| GET /api/v1/ext/cdr | Arama ayrıntı kayıtlarını okuyun. |
| GET /api/v1/ext/recordings/:id/stream | Gerekli anahtar izinleriyle bir kaydı akıtın. |
API anahtarlarını Yönetici → Entegrasyonlar’da oluşturup yönetin. Kimlik doğrulama, izinler ve istek gövdeleri için API sözleşmesine ve güncel uygulama şemalarına bakın.
Araçlarınız ne olduğunu bilsin
Webhook olayları çalan, cevaplanan, biten ve kaçan aramaları kapsar. Proje HMAC imzalı gövdeler ve üç yeniden deneme belgeler. Alıcınızda özgünlüğü doğrulamak için ayarlanan webhook sırrını kullanın ve olay işlemeyi tekrar etmeye dayanıklı yapın.
call.ringing
call.answered
call.ended
call.missed
Örneğin kendi CRM entegrasyonunuz, çalma olayında arayanın kaydını açabilir. Bu bir entegrasyon örüntüsüdür, paketlenmiş bir CRM bağlayıcısı değildir.
Verinizi IVR’nin içinde kullanın
Bir API isteği düğümü müşteriyi arayabilir, yanıt alanlarını değişkenlere eşleyebilir ve sonraki hedefi seçebilir. API kimlik bilgilerini şifreli Ayarlar → Sırlar’da tutun. Başarısız, yavaş veya bozuk yanıtlar için bir hata rotası verin.
Arayanın beklemeyi anlaması için sorguya kısa bir anons eşleyin. Gerçek bir uca bağlamadan önce sahte veriyle simüle edin. İstek yöntemleri, eşleme ve zaman aşımı için IVR rehberine bakın.
Sitenize bir arama düğmesi koyun
Yönetici → Entegrasyonlar’da bir site arama bileşeni oluşturun ve üretilen gömme kodunu kopyalayın. Tarayıcı WebRTC araması kullanır ve isteğe bağlı bir geri arama formu destekler.
<!-- Örnek biçim: santralinizin ürettiği gerçek gömme kodunu kullanın. -->
<script
src="https://pbx.example.com/widget.js"
data-widget="YOUR_GENERATED_WIDGET_ID">
</script>
Bileşenin ortam bağlantısı yine santralinizin HTTPS, WSS ve RTP/TURN kurulumunu ister. Bu ürün sitesi canlı bir bileşen gömmez ve mikrofon izni istemez.
Bilinçli bağlayın
- Ayrı entegrasyonlar için ayrı anahtarlar üretin ve her birine yalnızca ihtiyacı olan erişimi verin.
- Anahtarları ve webhook sırlarını, herkese açık gönderilen tarayıcı kodunun dışında, güvenilen bir sunucuda tutun.
- HTTPS kullanın ve iç yönetici API’lerini herkese açık entegrasyon uçları gibi açmayın.
- İş akışlarını açmadan önce hata yollarını ve yeniden denemeleri kendi alıcınızla deneyin.