Message Template
Otantikasyon
Bu başlığı her istekte gönderiniz.
{
"Authorization": "Bearer ${token}"
}🔒 WhatsApp Telefon Durumu
Mesaj Şablonlarının gönderimi WhatsApp Phone Number durumuna bağlıdır.
GET
https://backend.helorobo.com/agent-app/message-template/template/waba-status?channel_id=<channel_id>
Response
{
"success": true,
"data": {
"status": "<phone_status>",
"id": "<phone_number_id>",
"quality_rating": "<quality_rating>",
"verified_name": "<phone_display_name>",
"display_phone_number": "<phone_number>",
"messaging_limit_tier": "<tier_limit>"
}
}Parameter Explanations
| İsim | Açıklama |
|---|---|
| id | Mesaj şablonunu oluştururken, listesini alırken ve gönderirken kullanacağınız Channel Id |
| status | Telefon numarasının durumu. Durum listeini ve detaylarını buradan da inceleyebilirsiniz Meta Dökümantasyon Sayfası
|
| quality_rating | 7 Gün içerisindeki kalite durumu. Bu kalite durumu müşterilerin geri bildirimi üzerinden değerlendirilmektedir. Kalite değerlendirme durumları aşağıda belirtilmiştir. Resmi Meta Dökümantasoynu
|
| messaging_limit_tier | 24 saat içerisidne gönderilebilecek business-initiated konuşma sayısı.
|
BİLGİ
TIER_50 olduğunda 50 business-initiated olabilir demek. UNLIMITED ise sınırsız demek
BİLGİ
Business-Initiated: Sizin ( Şirket ) tarafınızdan başlatılmış konuşmalaar demektir. Müşteri yazmadan sizin başlatmış olduğunuz konuşmalardır.
Siz mesaj şablonu göndermiş olsanızda 24 saatlik ücretsiz çerçeve müşteri mesaj atmadan başlamaz.
ÖNEMLİ
status -> Bu değer eğer FLAGGED olursa mesaj gönderemezsiniz.
ÖNEMLİ
quality_rating -> Bu değer eğer RED olursa yine aynı şekilde mesaj gönderemezsiniz.
UYARI
Eğer ki durmunuz ( status ) FLAGGED olursa dikkatli olmalısınız. Bu şekilde seyretmesi ve müşterilerinizin geribildirimleri olumsuz yönde olmaya devam ederse telefon numaranız kullanıma kapatıabilir. Bu durumda aşağıdaki durumları gözden geçirmeniz önerilir.
- Kişi listesini kontrol edin. Mesaj göndermek için onayını aldığınız kişilere göndermeye çalışın.
- Mesaj şablonunuzu kontrol edin. İçeriğin spam benzeri veya ilgi çekici olmadığı yerleri tespit edip değiştirin.
Eğer müşterileriniz göndermiş olduğunuz Mesaj Şablonlarını spam olarak işaretlemeye devam ederse; İlk olarak Kalite Değerlendirme'niz düşecektir. Sonrasında ise telefon numaranızın durumu RESTRICTED (Kısıtlanmış) olacaktır. Artık mesaj gönderemez duruma geleceksiniz ve devamında TIER'iniz düşecektir. Bu duruma bağlı olarak da 24 saat içerisinde gönderebileceğiniz Bussiness-initiated mesaj sayısı düşecektir.
BİLGİ
Eğer ki Kalite Değerlendirmeniz GREEN olarak kalmaya devam ederse TIER'iniz artacaktır. Buna bağlı olarak da 24 saat içerisinde gönderebileceğiniz Bussiness-initiated mesaj sayısı artacaktır.
🔒 Mesaj Şablonlarını Listele
Mesaj Şablonlarını listemek için kullanılır.
GET
https://backend.helorobo.com/agent-app/message-template/template?channel_id=<channel_id>
Response
{
"success": true,
"items": [
{
"name": "helorobo_demo",
"components": [
{
"type": "HEADER",
"format": "IMAGE",
"example": {
"header_handle": [
"<image_url>"
]
}
},
{
"type": "BODY",
"text": "Hello, Dear {{1}}. {{2}} How are you?",
"example": {
"body_text": [["example_param_1", "example_param_2"]]
}
}
],
"language": "tr",
"status": "<message_template_status>",
"category": "<message_template_category>",
"id": "<messsage_template_id>"
}
]
}🔒 Mesaj Şablonu Detayı
Oluşturmuş olduğunuz Mesaj Şablonun Id'si verilenin detayını dönderir.
GET
https://backend.helorobo.com/agent-app/message-template/template/get-by-id?template_id=<message_template_id>&channel_id=<channel_id>
Response
{
"success": true,
"data": {
"message_template": {
"name": "helorobo_demo",
"components": [
{
"type": "HEADER",
"format": "IMAGE",
"example": {
"header_handle": [
"<image_url>"
]
}
},
{
"type": "BODY",
"text": "Hello, Dear {{1}}",
"example": {
"body_text": [["example_param_1"]]
}
}
],
"language": "tr",
"status": "<message_template_status>",
"category": "<message_template_category>",
"id": "<messsage_template_id>"
}
}🔒 Mesaj Şablonu Silme
ID'si verilen mesaj şablonunu silmek için kullanılır.
DELETE
https://backend.helorobo.com/agent-app/message-template/template
Body
{
"id": "<message_template_id>"
}Response
{
"success": true
}