Mesajlaşma Uç Noktası
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, sistemde otomatik olarak müşteri kartı ve sohbet başlığı oluşturulur.
POSThttps://gelsinsatislar.com/api/v1/messagesScope: messages:send
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 metni). type=text durumunda zorunludur. |
| template | object | Kısmen | type=template olduğunda zorunlu. name, language ve params alanlarını içerir. |
| media_url | string | Kısmen | Görsel veya PDF medya URL'i. Resim ve PDF gönderimlerinde zorunludur. |
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
}