Ana Sayfa / Geliştirici Dokümantasyonu

Geliştirici Dostu REST API & Canlı Webhook Rehberi

E-ticaret, CRM, muhasebe veya ERP yazılımlarınıza dakikalar içinde çift motorlu (Meta Cloud API & QR) WhatsApp mesajlaşma altyapısını entegre edin.

BASE URL https://app.apiswp.com/api/v1
v1.4 • JSON REST
BAŞLARKEN

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.

// HTTP İsteği Başlığı Örneği
Authorization: Bearer apiswp_live_sk_9481928471928374
Content-Type: application/json
POST /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);
Örnek 200 OK Yanıtı
{
  "status": "success",
  "message_id": "wamid.HBgMOTA1MzIxMDAyMDMwFQIAERgSNkY0NjhGQjRFNjc3ODFCNzVEAA==",
  "status_code": "sent",
  "cost_usd": 0.0075
}
POST /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"
  }'
WEBHOOK 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.

Sunucunuza Gönderilen Örnek Webhook Verisi
{
  "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ı.
NO-CODE & E-TİCARET

Hazır Platform ve Yazılım Entegrasyonları

Kod yazmadan veya tek satır webhook ile popüler platformları WhatsApp motorunuza bağlayın.

WC

WooCommerce Entegrasyonu

Resmi WordPress eklentisi ile tek tıkla kurulum

Resmi Eklenti

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.

SH

Shopify Webhook Entegrasyonu

Order Creation & Fulfillment Webhook Tetikleyicileri

Canlı Webhook

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-Ticaret

Ticimax 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

No-Code

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 & CRM

Elementor 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.

Geliştirmeye Bugün Başlayın

3 gün boyunca ücretsiz API kotasıyla kendi sisteminizi dakikalar içinde entegre edin.