Müşteri Numarasını Bilmeden Sipariş Numarasıyla Çağrı Başlatma

Genel Bakış

Teslimat ve lojistikte kuryelerin zaman zaman müşterileri araması gerekir — ancak saha çalışanlarıyla müşteri telefon numaralarını paylaşmak gizlilik ve kişisel veri koruma sorunlarına yol açar. Müşteri numarası asla sisteminizden çıkmamalıdır.

Bu rehber, Hızlı Arama’yı bir webservis sorgusuyla birlikte kullanarak yalnızca sipariş numarasıyla çağrı bağlamayı gösterir. Kurye kısa bir dahili hattı çevirir, sipariş kodunu girer ve Hipcall, kurye telefon numarasını hiç görmeden müşteriyle bağlantıyı otomatik olarak kurar.

Nasıl Çalışır

Kurye, Hızlı Arama dahili hattını çevirir ve istendiğinde sipariş numarasını girer. Hipcall girilen rakamları sunucunuza gönderir; sunucunuz müşterinin telefon numarasını bulup döndürür. Hipcall çağrıyı kurye adına yapar — numara baştan sona gizli kalır.

Mimari

flowchart TD
    A[Kurye Hızlı Arama 72 numarasını çevirir] --> B[Hipcall sipariş numarasını ister]
    B --> C[Kurye rakamları girer örn. 1234]
    C --> D[Hipcall rakamları sunucunuza POST eder]
    D --> E{Sipariş bulundu mu?}
    E -- Evet --> F[Müşteri telefon numarasını döndür]
    E -- Hayır --> G[Hata döndür]
    F --> H[Hipcall çağrıyı bağlar\nkurye ↔ müşteri]

Adım 1: Hipcall’da Hızlı Arama’yı Yapılandırın

1. Hipcall kontrol panelinizde Hesap > Entegrasyonlar > Hızlı Arama bölümüne gidin.
2. Aşağıdaki ayarlarla yeni bir Hızlı Arama girişi oluşturun:

Alan	Değer
Dahili Hat	72 (veya boş herhangi bir dahili hat)
Anons	”Lütfen sipariş numarasını girin.”
Webservis URL	https://your-server.example.com/lookup

Yerel geliştirme: Yerel sunucunuzu dışarıya açmak için ngrok kullanın. ngrok http 5010 komutunu çalıştırın ve oluşturulan URL’yi kullanın.

Adım 2: Sorgu İsteğini Alın

Kurye rakam girişini tamamladığında Hipcall, uç noktanıza şu yapıda bir POST isteği gönderir:

{
  "number": "1234",
  "user_id": 3508,
  "uuid": "06787f4b-4873-433b-a000-8fd99ff24ccf",
  "speed_dial_id": 5,
  "timestamp": 1774611216
}

number alanı, kurye tarafından girilen DTMF rakamlarını içerir — bu sizin sipariş kodunuzdur. Diğer alanlar (user_id, speed_dial_id) hangi temsilci ve Hızlı Arama kuralının isteği tetiklediğini belirtir.

Adım 3: Siparişi Sorgulayın ve Hedefi Döndürün

Sipariş kodunu kullanarak veritabanınızı sorgulayın. Bulunursa müşterinin telefon numarasını destination alanında döndürün. Hipcall çağrıyı hemen o numaraya bağlar.

@app.route('/lookup', methods=['POST'])
def lookup():
    data = request.get_json()
    code = str(data.get('number', '')).strip()

    row = db.execute(
        'SELECT phone FROM orders WHERE order_code = ?', (code,)
    ).fetchone()

    if row:
        return jsonify({"destination": row['phone']}), 200
    else:
        return jsonify({"error": "Order not found"}), 404

Başarılı yanıt:

{ "destination": "905060508169" }

Telefon numarasını E.164 formatında döndürün (yalnızca rakamlar, + öneki olmadan). Hipcall bu numarayı arar ve kurye ile müşteriyi bağlar.

Bulunamadı yanıtı:

{ "error": "Order not found" }

Sipariş kodu mevcut değilse Hipcall, kurye için bir hata mesajı oynatır.

Kullanılan Araçlar

Araç	Amaç
Hızlı Arama	Kurye için rakam girişi ister ve lookup uç noktanızı çağırır

Sonraki Adımlar

• Hızlı Arama dokümantasyonu — Dahili hatları, anonsu ve webservis entegrasyonunu yapılandırın
• REST API kimlik doğrulaması — Lookup uç noktanızı API anahtarları veya Temel Kimlik Doğrulama ile güvence altına alın
• Webkancaları dokümantasyonu — Hangi siparişlerin arandığını kaydetmek için call_hangup olaylarıyla birleştirin