WhatsApp SIP Arama Entegrasyonu

Genel Bakış

WhatsApp artık WhatsApp Cloud API aracılığıyla SIP aramalarını desteklemekte ve TLS/SRTP üzerinden SIP kullanılarak sesli aramaların yapılmasını mümkün kılmaktadır.

Bu, WhatsApp ile 3CX arasında doğal entegrasyonu mümkün kılar ve mevcut, yalnızca mesajlaşmaya dayalı entegrasyonu genişleterek WhatsApp sesli aramalarını da destekler; bu aramalar 3CX dahili numaralarına, kuyruklarına, IVR’lerine veya AI Temsilcilerine yönlendirilebilir.

Sesli aramalar için mevcut uygulamanın yalnızca 3CX'e gelen WhatsApp aramalarını destekleyeceğini lütfen unutmayın.

Ön Koşullar

  • WhatsApp SIP özelliğini etkinleştirmek için, Meta’nın Geliştirici portalında, SIP’yi etkinleştirmek istediğiniz işletme telefon numarası için mesajlaşma izinlerine sahip, aktif bir WhatsApp uygulaması bulunması gerekir.
  • Yukarıdaki ayarları henüz yapmadıysanız, lütfen WhatsApp Entegrasyon Kılavuzumuzda açıklanan adımları izleyin ve SIP’i etkinleştirmek için Meta’nın Graph API’sine gönderilecek gerekli isteklerin kimlik doğrulaması için gerekli olan, kılavuzda belirtilen Telefon Numarası Kimliğinizi ve Kullanıcı Erişim Jetonunuzu alın.
  • WhatsApp uygulamanızda SIP Arama özelliğini etkinleştirmek şu anda Meta'nın kullanıcı arayüzü portalı üzerinden mümkün olmadığından, Meta'nın Graph API'sine POST istekleri göndermek için Postman gibi bir üçüncü taraf aracı kullanmanız gerekir.
  • Birden fazla WhatsApp telefon numarasını aynı anda entegre etmek için, her numaranın Meta for Developers portalında kendine ait ayrı bir WhatsApp Uygulaması ile ilişkilendirilmesi gerekir. Bu kılavuzda ayrıntılı olarak açıklanan, WhatsApp Uygulaması oluşturmaktan 3CX'te SIP Trunk'ı yapılandırmaya kadar olan kurulum süreci, entegre etmek istediğiniz her WhatsApp telefon numarası için tekrarlanmalıdır.
  • WhatsApp SIP Resmi Kılavuzu'ndan daha fazla bilgi edinebilirsiniz.

Adım 1: Bir WhatsApp uygulaması Oluşturun

  • 3CX’inizde WhatsApp Mesajlaşma özelliği halihazırda yapılandırılmışsa, bu adımı atlayabilir ve Telefon numarası Kimliğiniz ile Kullanıcı Erişim Jetonunuzu, 3CX’teki Yönetici Konsolu > Ses ve Sohbet > WhatsApp Mesajlaşma Trunk’ınızdan alabilirsiniz.
  • Aksi takdirde, lütfen WhatsApp Entegrasyon Kılavuzumuzda açıklanan adımları izleyin ve Telefon numarası Kimliğiniz ile Kullanıcı Erişim Jetonunuzu alın.

Adım 2: WhatsApp Numaranızda SIP’i Etkinleştirme

  • curl veya başka bir araç kullanarak Meta’nın Graph API’sine aşağıdaki POST isteğini gönderin.
  • “Dosya → İçe Aktar”a gidip aşağıdakini yapıştırarak curl komutunu doğrudan Postman’a aktarabilirsiniz:

curl -X POST "https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/settings" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \

  -H "Content-Type: application/json" \

  -d '{

    "calling": {

      "status": "ENABLED",

      "callback_permission_status": "ENABLED",

      "call_icon_visibility": "DEFAULT",

      "srtp_key_exchange_protocol": "SDES",

      "sip": {

        "status": "ENABLED",

        "servers": [

          {

            "hostname": "<YOUR_3CX_FQDN>",

            "port": <YOUR_SIPS_PORT>

          }

        ]

      }

    }

  }'

  • Yukarıdaki komutu göndermeden önce, aşağıdaki kısımları kendi bilgilerinizle değiştirdiğinizden emin olun:
  • <PHONE_NUMBER_ID> = Yukarıda 1. Adımda aldığınız Telefon Numarası Kimliği
  • <YOUR_ACCESS_TOKEN> = Yukarıda 1. Adımda aldığın Kullanıcı Erişim Jetonu
  • <YOUR_3CX_FQDN> = 3CX PBX FQDN'niz; örneğin: mypbx.3cx.com
  • <YOUR_SIPS_PORT> = PBX'iniz varsayılan portları kullanıyorsa genellikle 5061'dir
  • İstek başarılı olursa:

{"success":true}

  • curl'de bir başarı yanıtı almalısınız

  • Ya da Postman’da

Adım 3: SIP Yapılandırmanızı Doğrulama

  • Aşağıdaki GET isteiğini Meta’nın Grap API’sine gönderin:

curl -X GET "https://graph.facebook.com/v17.0/<PHONE_NUMBER_ID>/settings?fields=calling&include_sip_credentials=true" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

  • Yukarıdaki komutu göndermeden önce, aşağıdaki kısımları kendi bilgilerinizle değiştirdiğinizden emin olun:
  • <PHONE_NUMBER_ID> = Yukarıda 1. adımda aldığınız Telefon Numarası Kimliği
  • <YOUR_ACCESS_TOKEN> = Yukarıda 1. adımda aldığınız Kullanıcı Erişim Jetonu
  • İstek başarılı olursa, aşağıdaki yanıtla benzer bir yanıt almalısınız:

{

    "calling": {

        "status": "ENABLED",

        "call_icon_visibility": "DEFAULT",

        "callback_permission_status": "ENABLED",

        "srtp_key_exchange_protocol": "SDES",

        "sip": {

            "status": "ENABLED",

            "servers": [

                {

                    "app_id": 112233445566778,

                    "hostname": "pbx.3cx-example.com",

                    "port": 5061,

                    "sip_user_password": "aabbccddeeffgghhiijjkkllmmnnoopp"

                }

            ]

        }

    },

    "storage_configuration": {

        "status": "DEFAULT"

    }

}

  • curl’de

  • Ya da Postman’da

Adım 4: WhatsApp İş Yöneticisinde Arama Ayarlarını Etkinleştirin

  • Telefon Numaraları görünmüyorsa, Tüm araçlar tıklayın

  • Arama Ayarları sekmesini açın ve aşağıdaki seçeneklerin etkinleştirildiğinden emin olun:
  • Sesli aramalara izin ver
  • Geri aramalara izin ver
  • Arama düğmelerini göster

Adım 5: 3CX’te Bir SIP Trunk Oluşturun

Yeni WhatsApp SIP Trunk'ınızı oluşturmak için:

  • WhatsApp şablonunu buradan indirin
  • 3CX Yönetici Konsolunuzda, “Yönetici → Gelişmiş → Şablonlar → Sağlayıcı Şablonları” sekmesine gidin
  • Sağlayıcıyı İçe Aktar düğmesine tıklayın, yukarıda indirdiğiniz şablonu seçin ve İçe Aktar düğmesine tıklayın:

  • Yeni WhatsApp SIP Trunk’ınız için bir İsim belirleyin
  • Gelen WhatsApp SIP aramaları için Varsayılan rotayı ayarlayın
  • Giden kural oluştur onay kutusunun işaretini kaldırın
  • Ana Trunk Numarasını WhatsApp numaranız olarak ayarlayın
  • Diğer tüm alanları varsayılan değerlerinde bırakın
  • Kaydet düğmesine tıklayın
  • Artık WhatsApp numaranıza gelen WhatsApp aramalarını kabul edebileceksiniz ve bu aramalar seçtiğiniz 3CX hedefine yönlendirilecektir. 

Alternatif olarak, 3CX üzerinde manuel olarak bir Genel SIP Trunk oluşturabilirsiniz; bu sırada aşağıdaki yapılandırmayı kullandığınızdan emin olun:

  • Yetkilendirme Türü: IP-tabanlı
  • Ana Bilgisayar: wa.meta.vc
  • Port: Otomatik keşif
  • Transport Protokolü: TLS
  • SRTP Modu: Zorla
  • Kodekler: OPUS

Ayrıca Bakınız

Last Updated

This document was last updated on 3 August 2026

https://www.3cx.com.tr/kullanici-kilavuzu/whatsapp-sip-calling-integration/