Anketlerin SMS Entegrasyonu ile Gönderimi

Pisano, sağlamış olduğu adaptör altyapısı ile beraber, şirketlerin kullandığı SMS servislerine entegre olarak müşteri geri bildirimi toplayabilir.

SMS ile anket gönderimi için aşağıdaki adımlar takip edilmelidir:

• SMS servis sağlayıcısının tanımlanması: etkileşimli videodan yararlanarak tanımlamaları yapabilirsiniz.
• SMS kanalının tanımlanması, ilgili akışa bağlanması ve kullanılacak servis sağlayıcısının seçilmesi
• SMS kanalı üzerinden SMS gönderilebilmesi için link kısaltma servisinin aktif olması gerekmektedir. Pisano servisi bulut üzerinde aktiftir. On-prem kullanımlarda müşteri link kısaltma servisinin konfigüre edilmiş olması veya Pisano servisinin kullanılması beklenir.
• SMS anketinin tetiklenmesi
  • Csv dosyası yükleyerek manuel tetikleme: Toplu anket gönderimi için tercih edilebilir. Anketin gönderimi her gün sıklıkla yapılmayacaksa kullanılır. Anketler manuel tetikleneceği için iş birimi tarafından ön hazırlık yapılması gerekir.
  • Workflow ile sms anketi tetiklemesi: planlanmış zamanlarda toplu anket gönderiminin otomatik olarak yapılması isteniyorsa tercih edilir.
  • API kullanarak (SMS Sharing) anketin tetiklenmesi (bu sayfada): işlem bazlı anketlerin otomatik olarak tetiklenmesi için tercih edilir. Müşteri işlemi gerçekleştirdikten hemen sonra anket gönderimi yapılabilir. API'nin ne zaman tetikleneceğine isteği gönderen sistem karar verir. API tetiklendiği anda SMS gönderimi sağlanır.

API kullanarak (SMS Sharing) anketin tetiklenmesi

Endpoint Bilgileri

POST  https://<pisanoURL>/v1/sms_campaigns/:campaign_id/sms_sharings/

*** pisanoURL bilgisi Pisano tarafından sizinle paylaşılacaktır.

*** On-prem müşterileri için pisanoURL bilgisi, sistem yöneticisi tarafından API configmap (ENV)  içerisinde api_host değişkenindeki bilgi ile değiştirilmelidir.

Parametreler

Başlıklar (HTTP Header)

Örnek cURL İsteği

curl --location 'https://<pisanoEnvironment>/v1/sms_campaigns/<campaignID>/sms_sharings' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone_numbers": [
        "<phone1>",
        "<phone2>"
    ],
    "custom_attributes": {
        "<phone1>": {
            "name": "<name1>",
            "external_id": "<external_id1>",
            "email": "<email1>"
        },
        "<phone2>": {
            "name": "<name2>",
            "external_id": "<external_id2>",
            "email": "<email2>"
        }
    },
    "built_in_responses": {
        "<phone1>": {
            "Segment": "<Segment1>",
            "Location": "<Location1>",
            "TransactionDate": "<TransactionDate1>"
        },
        "<phone2>": {
            "Segment": "<Segment2>",
            "Location": "<Location2>",
            "TransactionDate": "<TransactionDate2>"
        }
    }
}'

#   - 20 requests in 5 seconds

#   - 40 requests in 25 seconds

#   - 80 requests in 125 seconds (~2 min)

#   - 160 requests in 625 seconds (~10 min)

Tek bir requestte best practice olarak max 5000 musteri icin tetikleme gerceklestirilmesi         tavsiye edilmektedir.

API id alma (campaign_id)

• Kanallar > SMS Kanallarına gidip ve "Kampanya Düzenle" butonuna tıklayınız.
  
  
• API  kullanımında hangi kampanya için gönderim yapılmasını belirleyen API ID bu ekran üzerinden alınmaktadır. Örnek API ID: 13c53943-e63e-4910-9eac-91d56f7ef521
• Metin sonuna anket için oluşan link sistem tarafından gönderim sırasında otomatik olarak eklenmektedir
  
  
  
  TOKEN alma
• Pisano'da tüm API kullanımları için TOKEN almalısınız.

API Yanıt Kodları