Papo API'sini Kullanarak WhatsApp Mesaj Şablonları (HSM) Nasıl Gönderilir

Papo (https://papo.global/) ile, arayüze erişmeden işlemsel bildirimleri ve kampanyaları otomatikleştirerek WhatsApp'ta onaylı mesaj şablonlarını (HSM) göndermek için REST API'sini kullanabilirsiniz. API, hesabınızın Cloud API gelen kutularını listelemenize, Meta tarafından onaylanan şablonları almanıza ve bir API token'ınız olduğu ve şablonlar platformda senkronize edildiği sürece bunları bir veya birden çok kişiye göndermenize olanak tanır.

API ile HSM gönderimi nasıl çalışır

Papo API'si platformun işlevlerini yansıtır. Bir WhatsApp mesaj şablonu göndermek için kod aracılığıyla yeni bir şey oluşturmanıza gerek yoktur: şablonlar doğrudan Meta Business Manager'da oluşturulur ve gönderilir ve onaylandıktan sonra otomatik olarak Papo hesabınızda görünür. API yalnızca onaylı şablonların listesini sorgular ve gönderimi gerçekleştirir.

Tipik entegrasyon akışı şunlardan oluşur:

1. Papo panelinden bir API token'ı oluşturun.
2. Şablonun senkronize edildiği WhatsApp Cloud API gelen kutusunu belirleyin.
3. Bu kutudaki onaylı şablonların (HSM) listesini alın.
4. Gerekli parametrelerle isteği hazırlayın: şablon kimliği, dil, ülke koduyla birlikte alıcı numarası ve değişken değerleri (şablon {{1}}, {{2}} vb. içeriyorsa).
5. İsteği gönderin — tek bir kişiye veya her biri kendi özel değişkenlerine sahip bir dizi numaraya.

API'yi kullanmak için adım adım kılavuz

1. Bir API token'ı oluşturun

Papo hesabınızın ayarlar menüsünde, API veya erişim token'ları bölümüne gidin. Konuşmaları ve mesajları yönetmek için gerekli izinlere sahip bir token oluşturun. Token'ı güvenli bir yerde saklayın; tüm isteklerin başlığında gönderilecektir.

2. Mevcut WhatsApp kutularını listeleyin

Herhangi bir şablon göndermeden önce, hangi gelen kutusunun (inbox) onaylı şablonları içerdiğini bilmeniz gerekir. Hesabınızın WhatsApp Cloud API kutularını döndüren uç noktayı kullanın. Kullanmayı planladığınız kutunun tanımlayıcısını not edin — sonraki adımlarda zorunlu olacaktır.

3. Onaylı şablonları (HSM) sorgulayın

Kutunun tanımlayıcısı elinizdeyken, APPROVED durumundaki şablonları listeleyen uç noktayı çağırın. Yanıt, her şablon için adı, mevcut dili, kategoriyi (Pazarlama, Faydalı veya Kimlik Doğrulama) ve beklenen parametreleri getirecektir. Bu adım, şablonun kullanıma açık olduğunu doğrulamak ve hangi değişkenlerin doldurulacağını bilmek için önemlidir.

4. Gönderme isteğini oluşturun

Tek bir kişiye gönderme işlemi temel olarak şunları gerektirir:

• Şablon kimliği (veya uygulamaya bağlı olarak adı).
• Şablonun dili (örneğin, pt_BR).
• Ülke kodu dahil kişinin telefon numarası (örn.: 5511999999999).
• Şablon yer tutucular içeriyorsa, değişken değerlerini içeren bir nesne.

Toplu gönderim (birden çok kişi) için, çağrı her biri kendi numarasına ve isteğe bağlı olarak kendi değişkenlerine sahip bir alıcı listesi kabul eder. Şablon hepsi için aynıdır.

5. Gönderin ve yanıtı kontrol edin

API, gönderme isteğinin kabul edildiğine dair senkron bir onay döndürür. Gerçek teslimat durumunu (teslim edildi, okundu, başarısız) izlemek için bir giden webhook yapılandırabilirsiniz — Papo, konuşma olaylarını gerçek zamanlı olarak bildirir. Gerçek zamanlı olay alma makalesi ("Ayrıca okuyun" bölümünde listelenmiştir) bu özelliğin nasıl etkinleştirileceğini açıklar.

HSM gönderimi için API'yi kimler kullanmalı

İşlemsel iletişimleri harici sistemlerden otomatikleştirmek isteyen her işletme API'den yararlanır. Her bildirim için Papo arayüzüne bağlı kalmak yerine, gönderimi doğrudan ERP, CRM veya e-ticaret platformunuza entegre edebilirsiniz. Yaygın örnekler:

• Satın alma onayı veya sipariş durumu güncellemesi.
• 24 saat önce gönderilen randevu veya rezervasyon hatırlatıcısı.
• Ödeme bağlantısıyla birlikte vadesi geçmiş fatura bildirimi.
• Uçuş veya rezervasyon değişikliği bildirimi.

API, şablonun ne zaman gönderileceğini belirleyen kural başka bir yazılımda yaşadığında özellikle kullanışlıdır — örneğin, paket taşımaya çıktığı anda teslimat bildirimini tetikleyen bir lojistik sistemi.

Sıkça sorulan sorular

Papo API'sinin ek maliyeti var mı?

API, Papo planlarında mevcuttur. Token'lar oluşturabilir ve uç noktaları seçtiğiniz plana göre kullanabilirsiniz. Sınırlar ve istek başına ücretlerle ilgili ayrıntılar planlar sayfasında ve API belgelerinde bulunur.

Mesaj şablonlarını API aracılığıyla oluşturmam gerekiyor mu?

Hayır. Şablonlar Meta Business Manager'da oluşturulmalı ve onaya sunulmalıdır. Onaylandıktan sonra otomatik olarak Papo'da senkronize edilir ve API'nin şablon listesinde görünür.

Papo CRM'inde olmayan numaralara HSM gönderebilir miyim?

Evet. Alıcının platformun CRM'inde önceden kayıtlı olması gerekmez. İstekte WhatsApp numarasını (ülke kodu ve alan koduyla) belirtmeniz yeterlidir. Ancak, özellikle şablon Pazarlama kategorisindeyse, müşterinin iletişimi almak için onayına (opt-in) sahip olmalısınız.

Mesajın teslim edilip edilmediğini nasıl anlarım?

API'nin anında yanıtı, isteğin kabul edildiğini ve WhatsApp'a gönderildiğini doğrular. Hataları, teslimatları ve okumaları gerçek zamanlı olarak izlemek için Papo'nun olay webhook'unu (giden) etkinleştirmeniz gerekir. Yardım merkezindeki webhook kılavuzuna bakın.

API üzerinden gönderimler için hız sınırı var mı?

Evet. Papo, hizmetin kararlılığını korumak ve WhatsApp politikalarına uymak için hız sınırları uygular. Ilımlı hızların korunması önerilir — ani artışlardan kaçınmak numaranın sağlığını korumaya yardımcı olur. Kesin değerler API belgelerinde bulunur.

API'yi toplu pazarlama kampanyaları için kullanabilir miyim?

Evet, yalnızca Pazarlama kategorisinde onaylı şablonları kullanmanız ve alıcıların açık onayına (opt-in) sahip olmanız koşuluyla. İstenmeyen mesajlar göndermek şikayetlere yol açabilir ve numaranızın engellenme riskini artırabilir. Gönderimleri tempo kontrolü ile planlayın ve her zaman WhatsApp politikalarına uyun.

Ayrıca okuyun

• Papo'dan Webhook (giden) ile gerçek zamanlı olaylar nasıl alınır
• Papo API'sini kullanarak toplu kişi oluşturma ve güncelleme nasıl yapılır

HSM gönderimlerinizi şimdi otomatikleştirmeye başlayın – ücretsiz deneyin →

Papo'da hesabınızı oluşturun ve ilk kullanıcıda onaylı mesaj şablonlarını ücretsiz gönderin.