Mesaj türleri

Dokuz mesaj türü, tek istek gövdesi

Bir gönderim isteği bir kanal, bir alıcı ve bir tür belirtir; içerik ise türün adını taşıyan anahtarın altında yer alır. Bu sayfa her türü, onu üreten gövdeyi ve nerede desteklendiğini gösterir.

API referansını aç Kanalları karşılaştır

Destek matrisi

Hangi kanal hangi türü kabul eder?

Bir kanal, kabul ettiği türleri capabilities alanında bildirir. Kanalın desteklemediği bir türü göndermek 400 unsupported_message_type döndürür ve hiçbir ücret alınmaz.

Kanal türüne göre mesaj türü desteği
Tür	WhatsApp	SMS	SMS OTP	Telegram	Messenger	Instagram	TikTok
Metin`text`	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor
Ekler`attachments`	Destekleniyor	Destekleniyor	Desteklenmiyor	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor
Şablon`template`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor
Yanıt düğmeleri`button`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Destekleniyor	Destekleniyor	Destekleniyor	Destekleniyor
Liste`list`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor
URL düğmesi`cta_url`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor
Konum`location`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor
Kişiler`contacts`	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor
Anket`poll`	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor	Destekleniyor	Desteklenmiyor	Desteklenmiyor	Desteklenmiyor

type: "text"

Metin

Tüm kanal türlerinin kabul ettiği düz metin. Kanalın bağlantı önizlemesi oluşturması için preview_url değerini ayarlayın.

body: 1 ile 4.096 karakter arasında.

WhatsApp Business
SMS
SMS OTP
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "#1042 numaralı siparişiniz kargoya verildi. Buradan takip edebilirsiniz: https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

type: "attachments"

Ekler

Mesaj başına, bir https URL’siyle belirtilen tek bir medya öğesi: görsel, video, belge, ses, sesli mesaj veya çıkartma; isteğe bağlı bir açıklamayla.

Tam olarak bir öğe. caption: en fazla 1.024 karakter.

WhatsApp Business
SMS
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "attachments",
  "attachments": [
    {
      "type": "image",
      "url": "https://example.com/receipts/1042.jpg",
      "caption": "#1042 numaralı siparişinizin makbuzu."
    }
  ]
}

type: "template"

Şablon

Değişkenler içeren onaylı bir WhatsApp şablonu. Şablonlar, WhatsApp’ın 24 saatlik müşteri hizmetleri penceresi dışında kabul ettiği tek mesaj türüdür.

name ve language, kanalın onaylı bir şablonuyla eşleşmelidir.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "template",
  "template": {
    "name": "order_out_for_delivery",
    "language": {
      "code": "en"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Elif"
          },
          {
            "type": "text",
            "text": "#1042"
          },
          {
            "type": "text",
            "text": "18:00"
          }
        ]
      }
    ]
  }
}

type: "button"

Yanıt düğmeleri

En fazla üç hızlı yanıt içeren bir mesaj. Dokunulan düğmenin kimliği, webhook’unuza bir message.received olayıyla geri gelir.

1 ile 3 arasında düğme. title: en fazla 20 karakter.

WhatsApp Business
Telegram
Messenger
Instagram
TikTok

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "İki kişilik masanız bu akşam 19:30 için ayrıldı. Gelebilecek misiniz?"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "Onayla"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "Yeniden planla"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "Rezervasyon iptali"
          }
        }
      ]
    }
  }
}

type: "list"

Liste

Tek bir düğmeyle açılan, satırları başlıklı bölümler hâlinde gruplanmış bir menü.

action.button: en fazla 20 karakter.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "list",
  "list": {
    "body": {
      "text": "Bugün size hangi ekip yardımcı olsun?"
    },
    "action": {
      "button": "Ekip seçin",
      "sections": [
        {
          "title": "Ekipler",
          "rows": [
            {
              "id": "orders",
              "title": "Siparişler",
              "description": "Teslimat, iade ve geri ödemeler"
            },
            {
              "id": "billing",
              "title": "Faturalandırma",
              "description": "Faturalar ve ödeme yöntemleri"
            },
            {
              "id": "technical",
              "title": "Teknik destek",
              "description": "Kurulum ve sorun giderme"
            }
          ]
        }
      ]
    }
  }
}

type: "cta_url"

URL düğmesi

Bir URL açan tek düğmeli mesaj; takip sayfaları, ödemeler ve giriş bağlantıları için.

Mesaj başına bir düğme.

WhatsApp Business

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "cta_url",
  "cta_url": {
    "body": {
      "text": "Kargonuz yola çıktı. Gerçek zamanlı olarak takip edin."
    },
    "action": {
      "parameters": {
        "display_text": "Siparişi takip et",
        "url": "https://example.com/t/1042"
      }
    }
  }
}

type: "location"

Konum

Alıcının harita uygulamasında açılan, adı ve adresi olan bir konum işareti.

latitude ve longitude ondalık derece cinsindendir.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "Teslim alma noktası",
    "address": "Şeyh Zayid Yolu, Dubai"
  }
}

type: "contacts"

Kişiler

Bir veya daha fazla kişi kartı. Dizi kanala olduğu gibi iletilir; bu nedenle sağlayıcının kendi kişi biçimini kullanır.

Örnekte WhatsApp kişi biçimi gösterilmektedir.

WhatsApp Business
Telegram

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "Destek masası",
        "first_name": "Destek"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}

type: "poll"

Anket

Bir soru ve bir dizi seçenek içeren yerel bir Telegram anketi.

Yalnızca Telegram.

POST /v1/messages

{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "Siparişinizi ne zaman teslim edelim?",
    "options": [
      "Sabah, 09:00 – 12:00",
      "Öğleden sonra, 12:00 – 17:00",
      "Akşam, 17:00 – 21:00"
    ]
  }
}

Tüm türleri sandbox’ta deneyin

Her hesapta, her kanal türü için bir sandbox kanalı bulunur. Desteklediği herhangi bir türü bir test anahtarıyla gönderin; hiçbir şey teslim edilmez veya faturalandırılmaz.

API anahtarı alın Dokümanları okuyun