API Entegrasyon Kılavuzu

Basit API'miz aracılığıyla WhatsApp mesajları göndermek için CRM'inizi, rezervasyon sisteminizi veya herhangi bir uygulamayı bağlayın.

5 Basit Adımda Başlayın

1

Masaüstü Uygulamasını İndirin

All-in-One Messenger Hub'ı Windows bilgisayarınıza indirin ve kurun.

2

WhatsApp'ınızı Bağlayın

QR kodunu tarayarak WhatsApp hesabınızı uygulamaya ekleyin.

3

Bir Session API Oluşturun

WhatsApp sekmesine gidin ve yeni bir Session API oluşturun. WhatsApp kanalınıza bağlayın.

4

API Anahtarınızı Kopyalayın

Oluşturulan API anahtarını kopyalayın. Güvende tutun - bu sizin kimlik doğrulamanızdır.

5

Mesaj Göndermeye Başlayın

API'yi uygulamanızdan kullanın. Mesajları teslim etmek için masaüstü uygulamasını çalışır durumda tutun.

Kimlik Doğrulama

Tüm API uç noktaları, API anahtarınız aracılığıyla kimlik doğrulama gerektirir. Anahtarı şu yollardan herhangi biriyle geçirebilirsiniz:

Yöntem Örnek
X-API-Key Başlığı (Önerilen) X-API-Key: your-api-key
Sorgu/Gövde Parametresi key=your-api-key
Alternatif Parametre api_key=your-api-key
POST

Mesaj Gönder

Bir telefon numarasına veya gruba WhatsApp mesajı gönderin. Mesajlar kuyruğa alınır ve masaüstü uygulaması çalışırken teslim edilir.

POST https://onemessengerhub.com/api/whatsapp-session/send

Parametreler

Parametre Tür Gerekli Açıklama
key string Evet Masaüstü uygulamasından API anahtarınız
mobile string Koşullu Ülke koduyla telefon numarası (group_id olmadan gereklidir)
group_id string Koşullu WhatsApp grup kimliği (mobile olmadan gereklidir). @g.us soneki otomatik olarak eklenir.
message string Evet Mesaj metni (maksimum 4096 karakter)

Örnek İstek

curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mobile": "1234567890", "message": "Hello!"}'

Basit GET İsteği (Tarayıcı veya Bağlantı)

https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!

Başarılı Yanıt (201)

{
  "success": true,
  "message": "Message queued successfully",
  "data": {
    "message_id": 123,
    "recipient": "1234567890",
    "status": "pending"
  }
}
POST

Kişi Kaydet

WhatsApp'ınızda bir kişiyi kaydedin veya yeniden adlandırın. İşlem kuyruğa alınır ve masaüstü uygulaması tarafından işlenir.

POST https://onemessengerhub.com/api/whatsapp-session/save-contact

Parametreler

Parametre Tür Gerekli Açıklama
key string Evet Masaüstü uygulamasından API anahtarınız
contact_id string Evet Kişi telefon numarası veya WhatsApp kimliği (maksimum 50 karakter). @c.us soneki otomatik olarak eklenir.
name string Evet Kişi için görünen ad (maksimum 255 karakter)

Örnek İstek

curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890", "name": "John Doe"}'

Başarılı Yanıt (201)

{
  "success": true,
  "message": "Contact save operation queued",
  "data": {
    "operation_id": 456,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}
POST

Kişi Kaldır

WhatsApp'ınızdan bir kişiyi kaldırın. İşlem kuyruğa alınır ve masaüstü uygulaması tarafından işlenir.

POST https://onemessengerhub.com/api/whatsapp-session/remove-contact

Parametreler

Parametre Tür Gerekli Açıklama
key string Evet Masaüstü uygulamasından API anahtarınız
contact_id string Evet Kişi telefon numarası veya WhatsApp kimliği (maksimum 50 karakter). @c.us soneki otomatik olarak eklenir.

Örnek İstek

curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890"}'

Başarılı Yanıt (201)

{
  "success": true,
  "message": "Contact remove operation queued",
  "data": {
    "operation_id": 789,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}

Hata Yönetimi

API standart HTTP durum kodları kullanır. İşte sık karşılaşılan hata yanıtları:

Kimlik Doğrulama Hatası (401)

{
  "success": false,
  "message": "Invalid or inactive API key"
}

Doğrulama Hatası (422)

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "mobile": ["The mobile field is required when group id is not present."],
    "message": ["The message field is required."]
  }
}

Neler Oluşturabilirsiniz

CRM Entegrasyonu

CRM sisteminizden doğrudan takip mesajları, hatırlatıcılar ve güncellemeler gönderin.

Rezervasyon Onayları

Müşterilere otomatik olarak randevu onayları ve hatırlatıcıları gönderin.

Sipariş Bildirimleri

Müşterileri sipariş durumu, kargo güncellemeleri ve teslimat bilgileri hakkında bilgilendirin.

Uyarı Sistemleri

Ekibinize veya müşterilerinize önemli uyarılar ve bildirimler gönderin.

Pazarlama Kampanyaları

Kişi listenize promosyon mesajları ve güncellemeler gönderin.

Özel İş Akışları

Zapier, Make, n8n veya herhangi bir otomasyon platformuyla entegre olun.

Daha Fazla API Yakında

Daha fazla platformu ve kullanım senaryosunu kapsayacak şekilde API tekliflerimizi genişletiyoruz.

Yakında

Chatbot API

Chatbot yanıtlarını tetikleyin ve konuşmaları programatik olarak yönetin.

Yakında

Kişiler API

Mesajlaşma kişilerinize platformlar arasında erişin ve bunları yönetin.

Yakında

Web Kancaları

Mesajlar alındığında veya gönderildiğinde gerçek zamanlı bildirimler alın.