Api Dökümanları
Temel Bilgiler
API key:
Panele giriş yaptıktan sonra
API Yönetimi
menüsünden API KEY oluşturabilirsiniz.
Ardından tüm HTTP isteklerine
apikey=[APIKEY]
şeklinde kullanmanız gerekmektedir.
Her API için göndereceğiniz isteklerin HTTP metodu kendi alanında
belirtilmiştir.
Eğer metod sadece GET ise apikey bilgisini
sadece query string olarak göndermeniz gerekmektedir.
Eğer metod POST veya GET/POST ise hem query string içerisinde
hem de POST JSON datası içerisinde belirtebilirsiniz.
Temel API Adresi:
https://api.multiwhats.app/api/v1/
Aşağıda belirtilecek olan tüm API'ler için temel adres burasıdır.
HTTP Header Content-Type:
Tüm gelen ve giden datalar JSON formatındadır. Bundan dolayı göndereceğiniz
tüm HTTP isteklerine Content-Type bilgisini aşağıdaki gibi
belirlemeniz gerekmektedir:
Content-Type: application/json
Başarılı/Başarısız Cevap:
Tüm başarılı cevaplar HTTP 2XX kodu ile dönüş yapmaktadır.
Fakat her başarılı işlemden bir JSON datası dönmeyebilir. Örneğin 204
kodu geldiğinde JSON datası dönmeyecektir.
Tüm başarısız cevaplar ise 2 ile başlamayan kodlarla dönüş yapar.
Örneğin 4XX veya 5XX şeklinde. Standart hatalı sonuç
JSON formatı ise şu şekildedir:
{
"status": false,
"messages": [
"Hata mesajı burada gösterilecektir.",
"Birden fazla hata mesajı olabilir.",
]
}
Yani eğer HTTP status kodu
2 ile başlıyorsa işlem başarılıdır, başlamıyorsa başarısızdır ve
bir hata mesajı dönecektir.
Başarılı cevaplar her API'nin altında belirtilmiştir.
Text Mesaj Göndermek
Bu API ile sadece text mesaj gönderilmektedir. Text içerisine yeni satır karakteri ve
emoji yazabilirsiniz. Böylece müşterilerinize daha güzel görünen mesajlar gönderebilirsiniz.
Bu API hem GET hem de POST metoduyla kullanılabilmektedir.
HTTP Metod: GET/POST
URL:
basic/whatsapp/send-single
Payload:
{
"apikey": "APIKEY",
"from": "908503080335",
"to": "905551112233",
"message": "👋 Merhaba Değerli Müşterimiz 👤\n\n🌟 Web sitemize hoşgeldiniz.\n\n☑️ Sorularınız için buradan bize ulaşabilirsiniz.",
}
Başarılı Cevap:
{
"created_at": "2025-10-15 14:13:29",
"updated_at": "2025-10-15 14:13:29",
"user_id": 35,
"social_media_account_id": 35,
"platform": "whatsapp",
"from_identifier": "908503080335",
"message": "👋 Merhaba Değerli Müşterimiz 👤\n\n🌟 Web sitemize hoşgeldiniz.\n\n☑️ Sorularınız için buradan bize ulaşabilirsiniz.",
"queue_type": "normal",
"message_type": "text",
"total_credit": 1,
"target_count": 1,
"pending_count": 0,
"status": "done",
"extra_data": {
"buttons": null,
"options": null,
"selectedItemId": null
},
"send_at": "2025-10-15 14:13:29",
"id": 1,
"sent_count": 1,
"targets": [
{
"id": 1,
"user_id": 2,
"queue_id": 1,
"target_identifier": "905551112233",
"message": null,
"status": "sent",
"extra_data": {
"buttons": null,
"options": null,
"selectedItemId": null
},
"created_at": "2025-10-15 14:13:29",
"updated_at": "2025-10-15 14:13:29"
}
]
}
CURL:
curl https://api.multiwhats.app/api/v1/basic/whatsapp/send-single?apikey=APIKEY&from=908503080335&to=905551112233&message=%F0%9F%91%8B%20Merhaba%20De%C4%9Ferli%20M%C3%BC%C5%9Fterimiz%20%F0%9F%91%A4\n\n%F0%9F%8C%9F%20Web%20sitemize%20ho%C5%9Fgeldiniz.\n\n%E2%98%91%EF%B8%8F%20Sorular%C4%B1n%C4%B1z%20i%C3%A7in%20buradan%20bize%20ula%C5%9Fabilirsiniz.
PHP:
$payload = [ "apikey" => "APIKEY", "from" => "908503080335", "to" => "905551112233", "message" => "👋 Merhaba Değerli Müşterimiz 👤\n\n🌟 Web sitemize hoşgeldiniz.\n\n☑️ Sorularınız için buradan bize ulaşabilirsiniz." ]; $endpoint = "https://api.multiwhats.app/api/v1/basic/whatsapp/send-single"; $response = file_get_contents($endpoint . "?" . http_build_query($payload));
