Kimlik Doğrulama (Authentication)
ApisWP REST API istekleri Authorization: Bearer <API_KEY> başlığı kullanılarak doğrulanır. API anahtarınızı panelinizdeki Hesabım & Ekip → API & Entegrasyonlar bölümünden edinebilirsiniz.
/messages/send
Metin Mesajı Gönderme
İster Meta Cloud API hattınızdan ister bağlı QR cihazınızdan hedef telefon numarasına anında WhatsApp metin mesajı iletin.
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| phone | string | Evet | Ülke koduyla hedef numara (Örn: 905000000000). |
| message | string | Evet | Gönderilecek metin içeriği (WhatsApp kalın/italik formatlarını destekler). |
| instance_id | integer | Opsiyonel | Mesajın çıkacağı belirli WhatsApp hattı ID'si (boşsa varsayılan hat kullanılır). |
curl -X POST https://app.apiswp.com/api/v1/messages/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "905000000000",
"message": "Sayın Müşterimiz, siparişiniz onaylandı! Takip: TR941029"
}'
<?php
$payload = [
'phone' => '905000000000',
'message' => 'Sayın Müşterimiz, siparişiniz onaylandı!'
];
$ch = curl_init('https://app.apiswp.com/api/v1/messages/send');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
url = "https://app.apiswp.com/api/v1/messages/send"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"phone": "905000000000",
"message": "Sayın Müşterimiz, randevunuz onaylandı!"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const res = await fetch('https://app.apiswp.com/api/v1/messages/send', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
phone: '905000000000',
message: 'Sayın Müşterimiz, siparişiniz yola çıktı!'
})
});
const data = await res.json();
console.log(data);
{
"status": "success",
"message_id": "wamid.HBgMOTA1MzIxMDAyMDMwFQIAERgSNkY0NjhGQjRFNjc3ODFCNzVEAA==",
"status_code": "sent",
"cost_usd": 0.0075
}
/messages/send-media
Medya, Görsel ve PDF Belge Gönderme
Fatura PDF'i, ürün kataloğu veya görsel fotoğrafları başlık metniyle birlikte müşteriye ulaştırın.
curl -X POST https://app.apiswp.com/api/v1/messages/send-media \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "905000000000",
"media_url": "https://sirketiniz.com/faturalar/FAT-2026-0912.pdf",
"caption": "Sayın Müşterimiz, e-faturanız ekte yer almaktadır.",
"type": "document"
}'
Gelen Mesaj & İletim Olayları
Canlı Webhook Dinleyicisi
Müşteri WhatsApp'tan size yazdığında veya gönderdiğiniz mesaj okunduğunda kendi sunucunuza anında HTTP POST bildirimleri alın.
{
"event": "messages.upsert",
"instance_id": 3,
"data": {
"from": "905000000000",
"sender_name": "Ahmet Yılmaz",
"message_id": "wamid.HBgMOTA1MzIxMDAyMDMwFQIA",
"timestamp": 1791684920,
"type": "text",
"text": "Ürün stokta var mı?"
}
}
HTTP Durum & Hata Kodları
| Kod | Anlamı | Açıklama |
|---|---|---|
| 200 OK | Başarılı | İstek başarıyla işlendi ve mesaj WhatsApp iletim kuyruğuna alındı. |
| 401 Unauthorized | Geçersiz API Anahtarı | Gönderilen Bearer token geçersiz veya hesabınız askıda. |
| 422 Unprocessable | Eksik Parametre | Telefon numarası formatı hatalı veya mesaj metni boş. |
| 429 Rate Limit | Kota Aşıldı | Saniye başına izin verilen maksimum API istek limiti aşıldı. |
Hazır Platform ve Yazılım Entegrasyonları
Kod yazmadan veya tek satır webhook ile popüler platformları WhatsApp motorunuza bağlayın.
WooCommerce Entegrasyonu
Resmi WordPress eklentisi ile tek tıkla kurulum
1. Kurulum: WordPress admin panelinizden Eklentiler → Yeni Ekle diyerek ApisWP eklentisini yükleyin ve etkinleştirin.
2. API Anahtarı: ApisWP panelinizden aldığınız API anahtarınızı eklenti ayarlarına yapıştırın.
3. Otomatik Bildirimler: Sipariş Onayı, Kargo Takip Linki, Sipariş İptali ve Terk Edilmiş Sepet Hatırlatıcılarını dilediğiniz gibi açıp kapatın.
Shopify Webhook Entegrasyonu
Order Creation & Fulfillment Webhook Tetikleyicileri
1. Webhook Oluşturma: Shopify Admin → Settings → Notifications → Webhooks bölümüne gidin.
2. Olay Seçimi: Order creation veya Fulfillment create olayını seçin ve Hedef URL olarak ApisWP Webhook URL'nizi girin.
3. Terk Edilmiş Sepet: Checkout create olayını dinleyerek sepetinde ürün unutan kullanıcılara 1 saat sonra indirim kuponlu hatırlatma mesajı iletin.
Ticimax
Yerli E-TicaretTicimax panelinizdeki Ayarlar → Bildirim Ayarları → Webhook / SMS Servis Sağlayıcı alanından ApisWP HTTP REST API köprüsünü seçin. Tüm SMS maliyetlerinizi %80 düşürün.
İdeaSoft
Yerli E-TicaretİdeaSoft API & Webhook modülünden sipariş durum güncellemelerini anında ApisWP'e yönlendirin; kargo takip linki ve fatura PDF'ini müşterinize WhatsApp'tan otomatik ulaştırın.
Zapier & Make (Integromat)
Google Sheets, Airtable, HubSpot, ClickUp ve 5.000+ Uygulama
Zapier veya Make senaryonuzda Webhooks by Zapier / HTTP Module kullanarak POST https://app.apiswp.com/api/v1/messages/send endpoint'ine JSON isteği gönderin. Hiçbir kod yazmadan tüm iş akışlarınızı otomatikleştirin.
WordPress & Elementor Formları
Form & CRMElementor Pro Form, Contact Form 7, WPForms veya Gravity Forms ile form dolduran potansiyel müşterilere form iletildiği an otomatik WhatsApp teşekkür mesajı veya randevu onayı gönderin.