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
Masaüstü Uygulamasını İndirin
All-in-One Messenger Hub'ı Windows bilgisayarınıza indirin ve kurun.
WhatsApp'ınızı Bağlayın
QR kodunu tarayarak WhatsApp hesabınızı uygulamaya ekleyin.
Bir Session API Oluşturun
WhatsApp sekmesine gidin ve yeni bir Session API oluşturun. WhatsApp kanalınıza bağlayın.
API Anahtarınızı Kopyalayın
Oluşturulan API anahtarını kopyalayın. Güvende tutun - bu sizin kimlik doğrulamanızdır.
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 |
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"
}
}
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"
}
}
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.
Chatbot API
Chatbot yanıtlarını tetikleyin ve konuşmaları programatik olarak yönetin.
Kişiler API
Mesajlaşma kişilerinize platformlar arasında erişin ve bunları yönetin.
Web Kancaları
Mesajlar alındığında veya gönderildiğinde gerçek zamanlı bildirimler alın.
All-in-One Messenger Hub