WhatsApp Mesajı Gönder (`POST /api/v1/messages`)
Bu uç nokta, belirtilen alıcı telefon numarasına (`to`) anında WhatsApp mesajı iletir. Alıcının GelsinSatışlar veritabanında kaydı yoksa, rehberinizde otomatik olarak müşteri kartı ve sohbet başlığı açılır.
Bu Uç Nokta Ne Yapar? (Basitçe Anlatım)
Bu adres, "şu telefon numarasına bir WhatsApp mesajı gönder" demek için kullandığınız adrestir. Mesajı kimin gönderdiğini bilmek için her istekte Authorization başlığına API anahtarınızı eklersiniz. Göndermek istediğiniz bilgileri de JSON adlı ortak bir formatta mesajın "gövdesine" (body) yazarsınız: kime (to), ne tür bir mesaj (type) ve içeriği (text). GelsinSatışlar mesajı gönderir ve sonucu size geri bildirir.
Bonus bilgi Mesaj gönderdiğiniz kişi henüz rehberinizde yoksa, GelsinSatışlar onu otomatik müşteri kartı olarak kaydeder ve bir sohbet başlığı açar. Sizin ayrıca müşteri oluşturmanız gerekmez.
JSON İstek Gövdesi (Request Body)
| Alan | Veri Tipi | Zorunlu? | Açıklama |
|---|---|---|---|
| to | string | Evet | Alıcının E.164 formatında WhatsApp telefon numarası (ör: +905321234567). |
| type | string | Opsiyonel | Mesaj türü: text, template, image, document, audio. Varsayılan: text. |
| text | string | Kısmen | Mesaj metni (veya medya gönderiminde açıklama yazısı). |
| template | object | Kısmen | type=template olduğunda zorunlu. name, language ve params içerir. |
| media_url | string | Kısmen | Görsel veya PDF medya URL'i (Resim/PDF gönderiminde zorunlu). |
Kod Örnekleri (cURL, Node.js, Python, PHP)
curl -X POST "https://gelsinsatislar.com/api/v1/messages" \
-H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+905320000000",
"type": "text",
"text": "Sayın Ahmet Bey, ikas mağazanızdaki SP-10492 numaralı siparişiniz onaylandı!"
}'Başarılı Yanıt Örneği (201 Created)
{
"data": {
"message_id": "8f3b2a19-9482-4b21-a123-bc4d5e6f7a8b",
"whatsapp_message_id": "wamid.HBgLOTE1NTE1NTE1NQ==",
"conversation_id": "c1a2b3c4-d5e6-7f8a-9b0c-1d2e3f4a5b6c",
"contact_id": "cnt_99481230",
"contact_created": false
},
"error": null
}