WhatsApp mesajlarını kendi numaranızdan API ile gönderin
Inohype WP API'si, panelde QR kod ile bağladığınız kendi WhatsApp hesabınız üzerinden kişilere ve gruplara metin, görsel, video, ses ve belge göndermenizi sağlar. Sipariş bildirimleri, randevu hatırlatmaları ve ekip duyuruları gibi akışları birkaç satır kodla sisteminize ekleyin.
https://wp.inohype.com
Endpoint özeti
Tüm uçlar https://wp.inohype.com/api/external/ altındadır ve X-API-Key başlığı ister.
/api/external/send-messageBir kişiye metin veya medya gönderir · kotadan 1 mesaj düşer
POST/api/external/send-to-groupBir WhatsApp grubuna metin veya medya gönderir · kotadan 1 mesaj düşer
GET/api/external/groupsHesabın üye olduğu grupları ID'leriyle listeler · kotadan düşmez
GET/api/external/meAnahtar, hesap bağlantısı ve kota durumu · kota dolu olsa da çalışır
Yanıt yapısı
Tüm yanıtlar JSON'dır ve success (boolean) alanını içerir. Başarısız isteklerde HTTP durum kodu 4xx/5xx olur ve error alanında Türkçe bir açıklama döner.
{
"success": true,
"message": "Mesaj gönderildi",
"remaining": 4821,
"sent_to": "905551112233"
}
{
"success": false,
"error": "Geçersiz API anahtarı"
}
Kararlarınızı HTTP durum koduna göre verin. error metinleri insanlar için yazılmış Türkçe açıklamalardır ve ifadeleri ileride değişebilir. Tüm durum kodları ve anlamları için Hata Kodları bölümüne bakın.
Hızlı Başlangıç
Dört adımda ilk WhatsApp mesajınızı API ile gönderin. Hesabınız hazırsa tüm süreç genellikle birkaç dakika sürer.
-
Panele giriş yapın
Inohype WP'de herkese açık kayıt yoktur; hesabınızı yönetici oluşturur ve giriş bilgilerinizi size iletir. wp.inohype.com adresinden giriş yapın. Hesabınızda iki adımlı doğrulama (2FA) açıksa, doğrulayıcı uygulamanızdaki (Google Authenticator, Authy vb.) kodu da girmeniz istenir.
-
WhatsApp numaranızı bağlayın
Panel → Hesaplar → Hesap Ekle ile hesaba bir ad verin (ör.
magaza-hatti) ve QR kodu oluşturun. Telefonunuzda WhatsApp → Bağlı Cihazlar → Cihaz Bağla menüsünü açıp QR kodu okutun. Bağlantı tamamlandığında hesap panelde bağlı olarak görünür. -
API anahtarı oluşturun
Panel → API Keys bölümünde gönderim yapacak WhatsApp hesabını seçin ve anahtar oluşturun. Anahtar
wpr_ile başlar ve yalnızca seçtiğiniz hesaba bağlıdır. Anahtarı hemen kopyalayın ve sunucunuzda güvenli bir yerde (ör..envdosyası) saklayın. -
İlk mesajınızı gönderin
Anahtarı ve alıcı numarasını kendi değerlerinizle değiştirip isteği çalıştırın. İlk testi kendi ikinci numaranıza ya da bir ekip arkadaşınıza yapmanızı öneririz.
curl -X POST "https://wp.inohype.com/api/external/send-message" \ -H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{ "to": "905551112233", "message": "Merhaba! Bu, Inohype WP API ile gönderilen ilk test mesajıdır." }'<?php $ch = curl_init('https://wp.inohype.com/api/external/send-message'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => [ 'X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'to' => '905551112233', 'message' => 'Merhaba! Bu, Inohype WP API ile gönderilen ilk test mesajıdır.', ], JSON_UNESCAPED_UNICODE), ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode((string) $body, true); if ($status === 200 && !empty($data['success'])) { echo "Gönderildi: {$data['sent_to']} (kalan kota: {$data['remaining']})\n"; } else { echo "Hata ($status): " . ($data['error'] ?? 'bilinmeyen hata') . "\n"; }// Node.js 18+ — yerleşik fetch, ek paket gerekmez async function main() { const res = await fetch('https://wp.inohype.com/api/external/send-message', { method: 'POST', headers: { 'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json', }, body: JSON.stringify({ to: '905551112233', message: 'Merhaba! Bu, Inohype WP API ile gönderilen ilk test mesajıdır.', }), }); const data = await res.json(); if (!res.ok) throw new Error(`HTTP ${res.status}: ${data.error}`); console.log(`Gönderildi: ${data.sent_to} (kalan kota: ${data.remaining})`); } main().catch(console.error);import requests resp = requests.post( "https://wp.inohype.com/api/external/send-message", headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"}, json={ # json= parametresi Content-Type: application/json başlığını otomatik ekler "to": "905551112233", "message": "Merhaba! Bu, Inohype WP API ile gönderilen ilk test mesajıdır.", }, timeout=30, ) data = resp.json() if resp.ok: print(f"Gönderildi: {data['sent_to']} (kalan kota: {data['remaining']})") else: print(f"Hata ({resp.status_code}): {data.get('error')}")// .NET 6+ (top-level statements) using System.Net.Http.Json; using System.Text.Json; using var http = new HttpClient { BaseAddress = new Uri("https://wp.inohype.com") }; http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"); var response = await http.PostAsJsonAsync("/api/external/send-message", new { to = "905551112233", message = "Merhaba! Bu, Inohype WP API ile gönderilen ilk test mesajıdır." }); var data = await response.Content.ReadFromJsonAsync<JsonElement>(); if (response.IsSuccessStatusCode) { var sentTo = data.GetProperty("sent_to").GetString(); var remaining = data.GetProperty("remaining").GetInt32(); Console.WriteLine($"Gönderildi: {sentTo} (kalan kota: {remaining})"); } else { var error = data.GetProperty("error").GetString(); Console.WriteLine($"Hata ({(int)response.StatusCode}): {error}"); }{ "success": true, "message": "Mesaj gönderildi", "remaining": 4821, "sent_to": "905551112233" }
Önce bağlantıyı test edin. GET /api/external/me kota harcamadan anahtarınızın geçerli olduğunu, hangi hesaba bağlı olduğunu ve WhatsApp oturumunun bağlı olup olmadığını gösterir.
Kimlik Doğrulama
Her istek, X-API-Key HTTP başlığında gönderilen API anahtarıyla doğrulanır. Anahtar aynı zamanda mesajın hangi WhatsApp numarasından gideceğini belirler.
POST /api/external/send-message HTTP/1.1
Host: wp.inohype.com
X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Anahtar özellikleri
| Özellik | Açıklama |
|---|---|
| Biçim | wpr_ öneki + 64 karakter onaltılık (0-9, a-f); toplam 68 karakter. Başlık adı büyük/küçük harfe duyarlı değildir; anahtarın başındaki ve sonundaki boşluklar yok sayılır. |
| Kapsam | Her anahtar tam olarak bir WhatsApp hesabına (oturuma) bağlıdır. İstekte numara veya hesap seçilmez; mesaj, anahtarın bağlı olduğu numaradan gider. Birden fazla numaradan gönderim için her hesaba ayrı anahtar oluşturun. |
| Kota | Mesaj kotası anahtar başına değil kullanıcı başınadır; tüm hesaplarınız ve anahtarlarınız aynı kotayı paylaşır. Bkz. Kota ve Hız Limitleri. |
| İptal | Panel → API Keys üzerinden iptal edilen anahtar anında geçersiz olur ve sonraki isteklerde 401 Geçersiz API anahtarı döner. |
| Gönderim yolu | Anahtar yalnızca X-API-Key başlığında kabul edilir. Authorization: Bearer, URL parametresi (?api_key=) veya gövdede anahtar gönderimi desteklenmez. |
| Content-Type | POST isteklerinde Content-Type: application/json gönderin. Bu başlık olmadan JSON gövde okunamaz ve 400 to ve message gerekli hatası alırsınız. |
Anahtarı asla tarayıcıya veya mobil uygulamaya koymayın. API, CORS açısından tüm kökenlere açıktır (Access-Control-Allow-Origin: *); bu, tarayıcıdan da istek atılabileceği anlamına gelir. Ancak sayfa kaynağına, JavaScript paketine ya da mobil uygulamaya gömülen anahtar herkes tarafından okunabilir; kotanız tüketilebilir ve numaranızdan istenmeyen mesajlar gönderilebilir. İstekleri her zaman kendi sunucunuzdan yapın.
Kimlik doğrulama yanıtları
| HTTP | error | Neden |
|---|---|---|
| 401 | API anahtarı gerekli | X-API-Key başlığı gönderilmemiş ya da başlık adı yanlış yazılmış. |
| 401 | Geçersiz API anahtarı | Anahtar hatalı/eksik kopyalanmış, iptal edilmiş, bağlı olduğu WhatsApp hesabı silinmiş veya kullanıcı hesabınız pasif. |
| 403 | Mesaj kotası doldu | Kullanıcı kotanız bitmiş. send-message, send-to-group ve groups uçlarını engeller; /me çalışmaya devam eder. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. | Dakikalık istek limiti aşıldı. Hız limiti, kimlik doğrulamadan önce uygulanır. |
Mesaj gönder
Bir kişiye metin mesajı ya da açıklamalı (caption) medya gönderir. Başarılı her istek kotanızdan 1 mesaj düşer; başarısız istekler kotadan düşmez.
Gövde parametreleri
| Ad | Tip | Zorunlu | Açıklama |
|---|---|---|---|
to |
string | Evet | Alıcının telefon numarası. Rakam dışındaki karakterler (boşluk, |
message |
string | Evet | Mesaj metni. |
media_url |
string | Hayır | Herkese açık, doğrudan indirilebilir bir |
media_mimetype |
string | Hayır | Yalnızca mesaj geçmişine kaydedilir, gönderimi etkilemez; MIME türü indirilen dosyadan belirlenir. Ör. |
Mesaj biçimlendirme
WhatsApp'ın standart biçimlendirme işaretleri olduğu gibi çalışır:
| Yazım | Görünüm |
|---|---|
*kalın* | kalın |
_italik_ | italik |
~üstü çizili~ | |
```mono``` | mono |
Satır atlamak için JSON metninde \n kullanın; emojiler UTF-8 olarak doğrudan gönderilebilir.
{
"to": "905551112233",
"message": "*Sipariş #10482 kargoda* 🚚\n\nMerhaba Ayşe, siparişiniz _bugün_ kargoya verildi.\nTakip no: ```TR123456789```"
}
< ve > karakterleri iletilmez. Örneğin İndirim <bugün> metni İndirim bugün olarak gider. Karşılaştırma veya ok için ≤, ≥, → gibi Unicode karakterleri kullanabilirsiniz.
curl -X POST "https://wp.inohype.com/api/external/send-message" \
-H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"to": "0555 111 22 33",
"message": "Merhaba Ayşe, *#10482* numaralı siparişiniz kargoya verildi.\nTakip no: TR123456789"
}'
<?php
$payload = [
'to' => '0555 111 22 33',
'message' => "Merhaba Ayşe, *#10482* numaralı siparişiniz kargoya verildi.\nTakip no: TR123456789",
];
$ch = curl_init('https://wp.inohype.com/api/external/send-message');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);
$data = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status === 200
? "Gönderildi: {$data['sent_to']} (kalan: {$data['remaining']})\n"
: "Hata ($status): " . ($data['error'] ?? 'bilinmeyen hata') . "\n";
// Node.js 18+ (ESM / .mjs — üst düzey await)
const res = await fetch('https://wp.inohype.com/api/external/send-message', {
method: 'POST',
headers: {
'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: '0555 111 22 33',
message: 'Merhaba Ayşe, *#10482* numaralı siparişiniz kargoya verildi.\nTakip no: TR123456789',
}),
signal: AbortSignal.timeout(30_000),
});
const data = await res.json();
if (!res.ok) throw new Error(`HTTP ${res.status}: ${data.error}`);
console.log(`Gönderildi: ${data.sent_to} (kalan: ${data.remaining})`);
import requests
resp = requests.post(
"https://wp.inohype.com/api/external/send-message",
headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "0555 111 22 33",
"message": "Merhaba Ayşe, *#10482* numaralı siparişiniz kargoya verildi.\nTakip no: TR123456789",
},
timeout=30,
)
data = resp.json()
if resp.ok:
print(f"Gönderildi: {data['sent_to']} (kalan: {data['remaining']})")
else:
print(f"Hata ({resp.status_code}): {data.get('error')}")
using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient { BaseAddress = new Uri("https://wp.inohype.com") };
http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx");
var response = await http.PostAsJsonAsync("/api/external/send-message", new
{
to = "0555 111 22 33",
message = "Merhaba Ayşe, *#10482* numaralı siparişiniz kargoya verildi.\nTakip no: TR123456789"
});
var data = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(response.IsSuccessStatusCode
? $"Gönderildi: {data.GetProperty("sent_to")} (kalan: {data.GetProperty("remaining")})"
: $"Hata ({(int)response.StatusCode}): {data.GetProperty("error")}");
{
"success": true,
"message": "Mesaj gönderildi",
"remaining": 4821,
"sent_to": "905551112233"
}
Numara normalize edildikten sonra 10–15 hane değil. to veya message eksikse: to ve message gerekli.
{
"success": false,
"error": "Geçersiz telefon"
}
Anahtar hatalı, iptal edilmiş ya da hesabı silinmiş. Başlık hiç yoksa: API anahtarı gerekli.
{
"success": false,
"error": "Geçersiz API anahtarı"
}
Kullanıcı mesaj kotanız doldu. Kota artışı için yöneticinizle iletişime geçin.
{
"success": false,
"error": "Mesaj kotası doldu"
}
Dakikalık istek limiti aşıldı. Retry-After başlığındaki süre kadar bekleyin.
{
"success": false,
"error": "Çok fazla istek. Lütfen biraz bekleyin."
}
Anahtarın bağlı olduğu WhatsApp oturumu bağlı değil. Panelden QR kodu yeniden okutun.
{
"success": false,
"error": "Hesap bağlı değil"
}
WhatsApp gönderimi tamamlanamadı (ör. medya indirilemedi). Mesaj gitmiş olabilir; körlemesine tekrar denemeyin.
{
"success": false,
"error": "Mesaj gönderilemedi: <hata ayrıntısı>"
}
Yanıt alanları 200
| Alan | Tip | Açıklama |
|---|---|---|
success | boolean | Başarılı isteklerde true. |
message | string | Mesaj gönderildi |
remaining | integer | Bu mesaj düşüldükten sonra kalan kullanıcı kotanız. |
sent_to | string | Normalize edilmiş alıcı numarası (ör. 905551112233). Kayıt ve mükerrer gönderim kontrolü için saklayın. |
Hatalar
| HTTP | error | Ne zaman? |
|---|---|---|
| 400 | to ve message gerekli | to veya message eksik ya da boş; veya Content-Type: application/json gönderilmemiş. |
| 400 | Geçersiz telefon | Normalize edilmiş numara 10–15 hane değil. |
| 401 | API anahtarı gerekli / Geçersiz API anahtarı | Başlık yok veya anahtar geçersiz. Bkz. Kimlik Doğrulama. |
| 403 | Mesaj kotası doldu | Kullanıcı kotanız bitti. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. | Anahtar başına dakikada 60 istek aşıldı. |
| 503 | Hesap bağlı değil | Anahtarın bağlı olduğu WhatsApp oturumu şu an bağlı değil. |
| 500 | Mesaj gönderilemedi: <ayrıntı> | WhatsApp gönderimi tamamlanamadı; örneğin medya indirilemedi veya alıcıya gönderim reddedildi. |
200, "teslim edildi" demek değildir. Başarılı yanıt, mesajın WhatsApp'a iletildiğini gösterir; alıcıya ulaştığını veya okunduğunu garanti etmez. API şu an teslim/okundu bilgisi sağlamaz.
Grup mesajı gönder
Bağlı WhatsApp hesabınızın üyesi olduğu bir gruba metin veya açıklamalı medya gönderir. Başarılı her istek kotanızdan 1 mesaj düşer (gruptaki üye sayısından bağımsız).
Gövde parametreleri
| Ad | Tip | Zorunlu | Açıklama |
|---|---|---|---|
group_id |
string | Evet | Grup kimliği, |
message |
string | Evet | Mesaj metni veya medya açıklaması. |
media_url |
string | Hayır | Herkese açık, doğrudan indirilebilir |
media_mimetype |
string | Hayır | Yalnızca mesaj geçmişine kaydedilir; gönderimi etkilemez. |
Grup üyeliği ve yetki gerekir. Bağlı numara grubun üyesi olmalı ve grupta mesaj gönderme izni bulunmalıdır. Yalnızca yöneticilerin mesaj gönderebildiği gruplarda numaranın yönetici olması gerekir; aksi halde 500 Grup mesajı gönderilemedi: … döner.
curl -X POST "https://wp.inohype.com/api/external/send-to-group" \
-H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"group_id": "120363012345678901@g.us",
"message": "*Duyuru:* Bu akşam 22.00 itibarıyla 30 dakikalık planlı bakım yapılacaktır."
}'
<?php
$ch = curl_init('https://wp.inohype.com/api/external/send-to-group');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'group_id' => '120363012345678901@g.us',
'message' => '*Duyuru:* Bu akşam 22.00 itibarıyla 30 dakikalık planlı bakım yapılacaktır.',
], JSON_UNESCAPED_UNICODE),
]);
$data = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status === 200
? "Gruba gönderildi (kalan: {$data['remaining']})\n"
: "Hata ($status): " . ($data['error'] ?? 'bilinmeyen hata') . "\n";
// Node.js 18+ (ESM / .mjs — üst düzey await)
const res = await fetch('https://wp.inohype.com/api/external/send-to-group', {
method: 'POST',
headers: {
'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
group_id: '120363012345678901@g.us',
message: '*Duyuru:* Bu akşam 22.00 itibarıyla 30 dakikalık planlı bakım yapılacaktır.',
}),
signal: AbortSignal.timeout(30_000),
});
const data = await res.json();
if (!res.ok) throw new Error(`HTTP ${res.status}: ${data.error}`);
console.log(`Gruba gönderildi (kalan: ${data.remaining})`);
import requests
resp = requests.post(
"https://wp.inohype.com/api/external/send-to-group",
headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"group_id": "120363012345678901@g.us",
"message": "*Duyuru:* Bu akşam 22.00 itibarıyla 30 dakikalık planlı bakım yapılacaktır.",
},
timeout=30,
)
data = resp.json()
print("Gruba gönderildi" if resp.ok else f"Hata ({resp.status_code}): {data.get('error')}")
using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient { BaseAddress = new Uri("https://wp.inohype.com") };
http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx");
var response = await http.PostAsJsonAsync("/api/external/send-to-group", new
{
group_id = "120363012345678901@g.us",
message = "*Duyuru:* Bu akşam 22.00 itibarıyla 30 dakikalık planlı bakım yapılacaktır."
});
var data = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(response.IsSuccessStatusCode
? $"Gruba gönderildi (kalan: {data.GetProperty("remaining")})"
: $"Hata ({(int)response.StatusCode}): {data.GetProperty("error")}");
{
"success": true,
"message": "Grup mesajı gönderildi",
"remaining": 4820,
"sent_to": "120363012345678901@g.us"
}
group_id veya message eksik ya da boş.
{
"success": false,
"error": "group_id ve message gerekli"
}
Anahtar geçersiz. Başlık hiç yoksa: API anahtarı gerekli.
{
"success": false,
"error": "Geçersiz API anahtarı"
}
{
"success": false,
"error": "Mesaj kotası doldu"
}
{
"success": false,
"error": "Çok fazla istek. Lütfen biraz bekleyin."
}
{
"success": false,
"error": "Hesap bağlı değil"
}
Grup ID'si hatalı, numara grupta değil, grupta yazma yetkisi yok veya medya indirilemedi.
{
"success": false,
"error": "Grup mesajı gönderilemedi: <hata ayrıntısı>"
}
Yanıt alanları 200
| Alan | Tip | Açıklama |
|---|---|---|
success | boolean | Başarılı isteklerde true. |
message | string | Grup mesajı gönderildi |
remaining | integer | Bu mesaj düşüldükten sonra kalan kullanıcı kotanız. |
sent_to | string | Mesajın gönderildiği grup kimliği (istekteki group_id). |
Hatalar
| HTTP | error | Ne zaman? |
|---|---|---|
| 400 | group_id ve message gerekli | Alanlardan biri eksik/boş veya Content-Type gönderilmemiş. |
| 401 | API anahtarı gerekli / Geçersiz API anahtarı | Başlık yok veya anahtar geçersiz. |
| 403 | Mesaj kotası doldu | Kullanıcı kotanız bitti. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. | Dakikalık istek limiti aşıldı. |
| 503 | Hesap bağlı değil | WhatsApp oturumu bağlı değil. |
| 500 | Grup mesajı gönderilemedi: <ayrıntı> | Geçersiz grup ID'si, numara grupta değil, yazma yetkisi yok veya medya indirilemedi. |
Grupları listele
Bağlı WhatsApp hesabının üyesi olduğu grupları ID, ad ve katılımcı sayısıyla listeler. Kotadan düşmez; ancak kotanız dolduysa bu uç da 403 Mesaj kotası doldu döner.
Gruba mesaj göndermenin üç adımı
1 · Grup ID'sini bulun
GET /api/external/groups ile grupları listeleyin ve hedef grubun id değerini alın.
2 · ID'yi saklayın
Grup ID'leri değişmez. Listeyi her gönderimden önce çekmek yerine ID'yi bir kez alıp yapılandırmanızda tutun.
Yanıt alanları 200
| Alan | Tip | Açıklama |
|---|---|---|
success | boolean | Başarılı isteklerde true. |
groups | array | Bağlı numaranın üye olduğu gruplar. |
groups[].id | string | Grup kimliği (…@g.us); send-to-group isteğindeki group_id. |
groups[].name | string | Grubun WhatsApp'taki adı. Adlar değişebilir ve benzersiz olmayabilir; eşleştirme için id kullanın. |
groups[].participants_count | integer | Katılımcı sayısı; katılımcı bilgisi alınamazsa 0. |
total | integer | Listelenen grup sayısı. |
curl "https://wp.inohype.com/api/external/groups" \
-H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx"
<?php
$ch = curl_init('https://wp.inohype.com/api/external/groups');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => ['X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx'],
]);
$data = json_decode((string) curl_exec($ch), true);
curl_close($ch);
foreach ($data['groups'] ?? [] as $group) {
echo "{$group['name']} → {$group['id']} ({$group['participants_count']} üye)\n";
}
// Node.js 18+ (ESM / .mjs — üst düzey await)
const res = await fetch('https://wp.inohype.com/api/external/groups', {
headers: { 'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx' },
});
const data = await res.json();
if (!res.ok) throw new Error(`HTTP ${res.status}: ${data.error}`);
for (const g of data.groups) {
console.log(`${g.name} → ${g.id} (${g.participants_count} üye)`);
}
import requests
resp = requests.get(
"https://wp.inohype.com/api/external/groups",
headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"},
timeout=60,
)
resp.raise_for_status()
for g in resp.json()["groups"]:
print(f"{g['name']} → {g['id']} ({g['participants_count']} üye)")
using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient { BaseAddress = new Uri("https://wp.inohype.com") };
http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx");
// 2xx dışındaki yanıtlarda HttpRequestException fırlatır
var data = await http.GetFromJsonAsync<JsonElement>("/api/external/groups");
foreach (var g in data.GetProperty("groups").EnumerateArray())
{
Console.WriteLine($"{g.GetProperty("name")} → {g.GetProperty("id")} ({g.GetProperty("participants_count")} üye)");
}
{
"success": true,
"groups": [
{
"id": "120363012345678901@g.us",
"name": "Müşteri Duyuru",
"participants_count": 148
}
],
"total": 1
}
{
"success": false,
"error": "Geçersiz API anahtarı"
}
Kota dolduğunda grup listesi de engellenir; durumu /me ile kontrol edebilirsiniz.
{
"success": false,
"error": "Mesaj kotası doldu"
}
{
"success": false,
"error": "Çok fazla istek. Lütfen biraz bekleyin."
}
{
"success": false,
"error": "Hesap bağlı değil"
}
Sohbet listesi WhatsApp'tan alınamadı. Güvenle tekrar deneyebilirsiniz (salt okunur istek).
{
"success": false,
"error": "Gruplar yüklenemedi"
}
Hatalar
| HTTP | error | Ne zaman? |
|---|---|---|
| 401 | API anahtarı gerekli / Geçersiz API anahtarı | Başlık yok veya anahtar geçersiz. |
| 403 | Mesaj kotası doldu | Kota dolduğunda bu uç da engellenir. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. | Dakikalık istek limiti aşıldı. |
| 503 | Hesap bağlı değil | WhatsApp oturumu bağlı değil. |
| 500 | Gruplar yüklenemedi | Grup listesi alınamadı; kısa bir süre sonra tekrar deneyin. |
Yanıt süresi. Liste, bağlı hesabın tüm sohbetleri taranarak oluşturulur; çok sayıda sohbeti olan hesaplarda yanıt birkaç saniye sürebilir. İstemci zaman aşımını en az 60 saniye tutun ve sonucu önbelleğe alın.
Hesap durumu
Anahtarın bağlı olduğu WhatsApp hesabını, oturumun bağlı olup olmadığını, kota kullanımını ve anahtar bilgilerini döndürür. Kotadan düşmez ve kotanız dolu olsa bile çalışır; entegrasyonunuz için ideal bir sağlık kontrolüdür (health check).
Yanıt alanları 200
| Alan | Tip | Açıklama |
|---|---|---|
account.name | string | Panelde verdiğiniz hesap adı. |
account.phone | string | null | Hesaba kayıtlı WhatsApp numarası (ülke koduyla); kayıtlı değilse null. |
account.connected | boolean | WhatsApp oturumu şu an bağlı mı? false ise gönderim istekleri 503 Hesap bağlı değil döner. |
quota.limit | integer | Toplam mesaj kotanız (kullanıcı başına). |
quota.used | integer | Kullanılan mesaj sayısı. |
quota.remaining | integer | Kalan mesaj hakkı; en az 0. |
key.id | integer | Anahtarın kimliği. |
key.created_at | string | Oluşturulma zamanı, YYYY-MM-DD HH:MM:SS (UTC). |
key.last_used | string | null | Bu istekten önceki son kullanım zamanı (UTC); hiç kullanılmadıysa null. |
curl "https://wp.inohype.com/api/external/me" \
-H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx"
<?php
$ch = curl_init('https://wp.inohype.com/api/external/me');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_HTTPHEADER => ['X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx'],
]);
$me = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
exit("Hata ($status): " . ($me['error'] ?? 'bilinmeyen hata') . "\n");
}
if (!$me['account']['connected']) {
echo "{$me['account']['name']} bağlı değil, panelden QR kodu yeniden okutun.\n";
}
echo "Kalan kota: {$me['quota']['remaining']} / {$me['quota']['limit']}\n";
// Node.js 18+ (ESM / .mjs — üst düzey await)
const res = await fetch('https://wp.inohype.com/api/external/me', {
headers: { 'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx' },
});
const me = await res.json();
if (!res.ok) throw new Error(`HTTP ${res.status}: ${me.error}`);
if (!me.account.connected) {
console.warn(`${me.account.name} bağlı değil, panelden QR kodu yeniden okutun.`);
}
console.log(`Kalan kota: ${me.quota.remaining} / ${me.quota.limit}`);
import requests
resp = requests.get(
"https://wp.inohype.com/api/external/me",
headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"},
timeout=15,
)
resp.raise_for_status()
me = resp.json()
if not me["account"]["connected"]:
print(f"{me['account']['name']} bağlı değil, panelden QR kodu yeniden okutun.")
print(f"Kalan kota: {me['quota']['remaining']} / {me['quota']['limit']}")
using System.Net.Http.Json;
using System.Text.Json;
using var http = new HttpClient { BaseAddress = new Uri("https://wp.inohype.com") };
http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx");
var me = await http.GetFromJsonAsync<JsonElement>("/api/external/me");
var account = me.GetProperty("account");
var quota = me.GetProperty("quota");
if (!account.GetProperty("connected").GetBoolean())
Console.WriteLine($"{account.GetProperty("name")} bağlı değil, panelden QR kodu yeniden okutun.");
Console.WriteLine($"Kalan kota: {quota.GetProperty("remaining")} / {quota.GetProperty("limit")}");
{
"success": true,
"account": {
"name": "magaza-hatti",
"phone": "905551112233",
"connected": true
},
"quota": {
"limit": 5000,
"used": 179,
"remaining": 4821
},
"key": {
"id": 12,
"created_at": "2026-11-01 09:12:44",
"last_used": "2026-11-17 10:03:10"
}
}
Başlık hiç yoksa: API anahtarı gerekli.
{
"success": false,
"error": "Geçersiz API anahtarı"
}
{
"success": false,
"error": "Çok fazla istek. Lütfen biraz bekleyin."
}
Ne zaman kullanılır?
Gönderimden önce
Toplu bir gönderim kuyruğunu başlatmadan önce account.connected değerini kontrol edin.
Kota alarmı
Periyodik olarak çağırıp quota.remaining belirlediğiniz eşiğin altına düştüğünde ekibinizi uyarın.
Anahtar doğrulama
Anahtarı yeniledikten sonra yeni anahtarın doğru hesaba bağlı olduğunu doğrulayın.
Hatalar
| HTTP | error | Ne zaman? |
|---|---|---|
| 401 | API anahtarı gerekli / Geçersiz API anahtarı | Başlık yok veya anahtar geçersiz. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. | Dakikalık istek limiti aşıldı; /me çağrıları da limite sayılır. |
Telefon Numarası Formatı
to alanı esnektir: numarayı boşluklu, tireli veya + ile yazabilirsiniz. Sunucu numarayı aşağıdaki kurallarla tek bir biçime (yalnızca rakam, ülke kodu + numara) çevirir; sonuç yanıtta sent_to olarak döner.
Normalizasyon kuralları
- Rakam olmayan tüm karakterler silinir: boşluk,
+,-,(,), nokta vb. - Numara
0ile başlıyorsa baştaki0kaldırılır ve yerine90(Türkiye) eklenir. - Numara 10 haneliyse ve
90ile başlamıyorsa başına90eklenir. - Sonuç 10–15 hane değilse istek
400 Geçersiz telefonile reddedilir.
Örnekler
Girdi (to) | Sonuç (sent_to) | Açıklama |
|---|---|---|
0555 111 22 33 | 905551112233 | Baştaki 0 → 90. |
+90 (555) 111-22-33 | 905551112233 | Rakam dışı karakterler silinir. |
5551112233 | 905551112233 | 10 hane, 90 ile başlamıyor → başına 90 eklenir. |
905551112233 | 905551112233 | Zaten doğru biçimde; önerilen kullanım. |
+49 151 1234 5678 | 4915112345678 | Yabancı numara, ülke koduyla yazıldığı için doğru. |
12345 | 400 | 5 hane; Geçersiz telefon. |
0049 151 1234 5678 | 400 | 00 öneki: baştaki 0, 90 ile değiştirilir ve numara 16 haneye çıkar. |
2125550123 | 902125550123 | Yanlış kişi Ülke kodu olmadan yazılmış 10 haneli bir ABD numarası Türk numarası sanılır. |
Yabancı numaraları mutlaka ülke koduyla gönderin. Ülke kodu olmadan yazılmış 10 haneli bir yabancı numara Türk numarası olarak yorumlanır ve başına 90 eklenir; mesaj gönderilemeyebilir ya da yanlış kişiye gidebilir. Uluslararası 00 önekini de kullanmayın; numarayı +49… veya 49… biçiminde yazın.
Göndermeden önce doğrulayın
Aynı kuralları kendi tarafınızda uygulayarak hatalı numaraları API'ye göndermeden ayıklayabilir ve kayıtlarınızı tek biçimde tutabilirsiniz:
<?php
// PHP 8+ — Inohype WP sunucusuyla aynı kurallar. Geçersizse null döner.
function normalizePhone(string $phone): ?string
{
$p = preg_replace('/[^0-9]/', '', $phone);
if (str_starts_with($p, '0')) {
$p = '90' . substr($p, 1);
} elseif (strlen($p) === 10 && !str_starts_with($p, '90')) {
$p = '90' . $p;
}
$len = strlen($p);
return ($len >= 10 && $len <= 15) ? $p : null;
}
var_dump(normalizePhone('0555 111 22 33')); // string(12) "905551112233"
var_dump(normalizePhone('12345')); // NULL
// Inohype WP sunucusuyla aynı kurallar. Geçersizse null döner.
function normalizePhone(phone) {
let p = String(phone).replace(/[^0-9]/g, '');
if (p.startsWith('0')) p = '90' + p.slice(1);
else if (p.length === 10 && !p.startsWith('90')) p = '90' + p;
return p.length >= 10 && p.length <= 15 ? p : null;
}
console.log(normalizePhone('0555 111 22 33')); // '905551112233'
console.log(normalizePhone('12345')); // null
import re
def normalize_phone(phone: str) -> str | None: # Python 3.10+
"""Inohype WP sunucusuyla aynı kurallar. Geçersizse None döner."""
p = re.sub(r"[^0-9]", "", str(phone))
if p.startswith("0"):
p = "90" + p[1:]
elif len(p) == 10 and not p.startswith("90"):
p = "90" + p
return p if 10 <= len(p) <= 15 else None
print(normalize_phone("0555 111 22 33")) # 905551112233
print(normalize_phone("12345")) # None
using System.Text.RegularExpressions;
// Inohype WP sunucusuyla aynı kurallar. Geçersizse null döner.
static string? NormalizePhone(string phone)
{
var p = Regex.Replace(phone ?? "", "[^0-9]", "");
if (p.StartsWith("0")) p = "90" + p[1..];
else if (p.Length == 10 && !p.StartsWith("90")) p = "90" + p;
return p.Length is >= 10 and <= 15 ? p : null;
}
Console.WriteLine(NormalizePhone("0555 111 22 33")); // 905551112233
Console.WriteLine(NormalizePhone("12345") ?? "geçersiz"); // geçersiz
Medya Gönderimi
send-message veya send-to-group isteğine media_url eklediğinizde sunucu dosyayı bu adresten indirir ve WhatsApp'a medya olarak yükler. message alanı medyanın açıklaması (caption) olur ve medya gönderirken de zorunludur.
Görsel
Ör. JPG, PNG
Video
Ör. MP4
Ses
Ör. MP3, OGG
Belge
Ör. PDF, DOCX, XLSX, ZIP
Türler örnektir; kabul edilen biçimler ve dosya boyutları WhatsApp'ın kendi sınırlarına tabidir.
Gereksinimler
- Herkese açık
http://veyahttps://adresi. Dosyayı sunucumuz internetten indirir;localhost, iç ağ adresleri veya yalnızca sizin erişebildiğiniz adresler çalışmaz. - Doğrudan indirilebilir olmalı. Adres dosyanın kendisini döndürmelidir. Giriş isteyen, önizleme/indirme ara sayfası açan veya HTML sayfası döndüren bağlantılar (ör. bulut sürücü paylaşım bağlantıları) çalışmaz.
- MIME türü indirilen dosyadan belirlenir. Dosyayı doğru
Content-Typebaşlığıyla sunun.media_mimetypeyalnızca mesaj geçmişine kaydedilir, gönderimi etkilemez. - Boyut sınırları WhatsApp'a aittir. Çok büyük dosyalar reddedilebilir veya isteği uzatabilir.
- İndirme süresi isteğe eklenir. Medya gönderirken istemci zaman aşımını en az 60 saniye tutun.
- Hata durumunda kota düşmez. Dosya indirilemez veya WhatsApp yüklemeyi reddederse
500 Mesaj gönderilemedi: …(gruptaGrup mesajı gönderilemedi: …) döner.
Süreli (imzalı) bağlantılar. S3/R2 gibi depolamalardan ön imzalı URL veriyorsanız geçerlilik süresini birkaç dakikadan kısa tutmayın; dosya gönderim anında indirilir.
Örnek: PDF fatura gönderme
curl -X POST "https://wp.inohype.com/api/external/send-message" \
-H "X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
--max-time 60 \
-d '{
"to": "905551112233",
"message": "Merhaba Ayşe, Kasım ayı faturanız ektedir.",
"media_url": "https://example.com/faturalar/F-2026-0042.pdf",
"media_mimetype": "application/pdf"
}'
<?php
$ch = curl_init('https://wp.inohype.com/api/external/send-message');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60, // medya indirme süresi dahil
CURLOPT_HTTPHEADER => [
'X-API-Key: wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'to' => '905551112233',
'message' => 'Merhaba Ayşe, Kasım ayı faturanız ektedir.',
'media_url' => 'https://example.com/faturalar/F-2026-0042.pdf',
'media_mimetype' => 'application/pdf',
], JSON_UNESCAPED_UNICODE),
]);
$data = json_decode((string) curl_exec($ch), true);
curl_close($ch);
print_r($data);
// Node.js 18+ (ESM / .mjs — üst düzey await)
const res = await fetch('https://wp.inohype.com/api/external/send-message', {
method: 'POST',
headers: {
'X-API-Key': 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: '905551112233',
message: 'Merhaba Ayşe, Kasım ayı faturanız ektedir.',
media_url: 'https://example.com/faturalar/F-2026-0042.pdf',
media_mimetype: 'application/pdf',
}),
signal: AbortSignal.timeout(60_000), // medya indirme süresi dahil
});
console.log(res.status, await res.json());
import requests
resp = requests.post(
"https://wp.inohype.com/api/external/send-message",
headers={"X-API-Key": "wpr_xxxxxxxxxxxxxxxxxxxxxxxx"},
json={
"to": "905551112233",
"message": "Merhaba Ayşe, Kasım ayı faturanız ektedir.",
"media_url": "https://example.com/faturalar/F-2026-0042.pdf",
"media_mimetype": "application/pdf",
},
timeout=60, # medya indirme süresi dahil
)
print(resp.status_code, resp.json())
using System.Net.Http.Json;
using var http = new HttpClient
{
BaseAddress = new Uri("https://wp.inohype.com"),
Timeout = TimeSpan.FromSeconds(60) // medya indirme süresi dahil
};
http.DefaultRequestHeaders.Add("X-API-Key", "wpr_xxxxxxxxxxxxxxxxxxxxxxxx");
var response = await http.PostAsJsonAsync("/api/external/send-message", new
{
to = "905551112233",
message = "Merhaba Ayşe, Kasım ayı faturanız ektedir.",
media_url = "https://example.com/faturalar/F-2026-0042.pdf",
media_mimetype = "application/pdf"
});
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
{
"success": true,
"message": "Mesaj gönderildi",
"remaining": 4821,
"sent_to": "905551112233"
}
Dosya indirilemedi (erişilemeyen adres, HTML sayfası vb.) veya WhatsApp yüklemeyi reddetti. Kota düşmez.
{
"success": false,
"error": "Mesaj gönderilemedi: <hata ayrıntısı>"
}
Kota ve Hız Limitleri
İki ayrı sınır vardır: toplam kaç mesaj gönderebileceğinizi belirleyen mesaj kotası ve dakikada kaç istek yapabileceğinizi belirleyen hız limiti.
Mesaj kotası
- Kullanıcı başınadır: tüm WhatsApp hesaplarınız ve API anahtarlarınız aynı kotayı paylaşır. Panelden gönderdiğiniz mesajlar da aynı kotadan düşer.
- Başarılı her gönderim 1 mesajdır: kişiye veya gruba, metin ya da medya + açıklama fark etmez. Başarısız istekler kotadan düşmez.
- Limiti paketinize göre yönetici belirler. Kalan hakkınızı yanıtlardaki
remainingalanından veyaGET /api/external/meile izleyin. - Kota dolunca
send-message,send-to-groupvegroupsuçları403 Mesaj kotası doldudöner;/meçalışmaya devam eder.
İstek hız limiti
60 istek / dakika / API anahtarı
/api/external/*altındaki tüm uçlar için geçerlidir;/meçağrıları ve başarısız istekler de sayılır.- Sayaç API anahtarı başına tutulur; anahtar göndermeyen istekler IP adresine göre sınırlanır.
- 1 dakikalık pencere dolduğunda HTTP
429döner; pencere sıfırlanınca istekler yeniden kabul edilir.
Hız limiti başlıkları
RateLimit-* başlıklarını izleyerek limite yaklaştığınızı önceden görebilir, 429 aldığınızda ne kadar bekleyeceğinizi Retry-After ile öğrenebilirsiniz.
| Başlık | Örnek | Açıklama |
|---|---|---|
RateLimit-Policy | 60;w=60 | Limit ve pencere süresi (saniye). |
RateLimit-Limit | 60 | Penceredeki toplam istek hakkı. |
RateLimit-Remaining | 0 | Penceredeki kalan istek hakkı. |
RateLimit-Reset | 42 | Pencerenin sıfırlanmasına kalan süre (saniye). |
Retry-After | 42 | 429 yanıtında: tekrar denemeden önce beklenecek süre (saniye). |
HTTP/1.1 429 Too Many Requests
Content-Type: application/json; charset=utf-8
RateLimit-Policy: 60;w=60
RateLimit-Limit: 60
RateLimit-Remaining: 0
RateLimit-Reset: 42
Retry-After: 42
{
"success": false,
"error": "Çok fazla istek. Lütfen biraz bekleyin."
}
Hız limiti bir hedef değil, teknik üst sınırdır. WhatsApp, kısa sürede çok sayıda mesaj gönderen hesapları kısıtlayabilir veya yasaklayabilir.
- Aynı hesaptan gönderilen mesajlar arasında en az 1–3 saniye bekleyin.
- Toplu gönderimleri bir kuyrukla sıraya alın; aynı anda paralel istek göndermeyin. Bkz. Toplu gönderim kuyruğu.
Hata Kodları
Hatalı yanıtlar her zaman {"success": false, "error": "…"} biçimindedir. Aşağıdaki tablo tüm uçlarda dönebilecek hataları, nedenlerini ve yapmanız gerekenleri listeler.
| HTTP | error | Neden | Ne yapmalı? |
|---|---|---|---|
| 400 | to ve message gerekli |
send-message: alan eksik/boş ya da Content-Type: application/json gönderilmemiş. |
Gövdeyi ve başlığı düzeltin. Tekrar denemek sonucu değiştirmez. |
| 400 | group_id ve message gerekli |
send-to-group: alan eksik/boş ya da Content-Type eksik. |
Gövdeyi ve başlığı düzeltin. |
| 400 | Geçersiz telefon |
Normalize edilmiş numara 10–15 hane değil. | Numarayı ülke koduyla düzeltin. Bkz. Telefon Numarası Formatı. |
| 401 | API anahtarı gerekli |
X-API-Key başlığı yok veya adı yanlış yazılmış. |
Başlığı ekleyin. Authorization başlığı kullanılmaz. |
| 401 | Geçersiz API anahtarı |
Anahtar hatalı/eksik kopyalanmış, iptal edilmiş, bağlı hesap silinmiş veya kullanıcı hesabı pasif. | Panel → API Keys'te anahtarı kontrol edin; gerekirse yenisini oluşturun. |
| 403 | Mesaj kotası doldu |
Kullanıcı kotanız bitti (me hariç tüm uçları engeller). |
Kota artışı için yöneticinizle iletişime geçin. Tekrar denemeyin. |
| 429 | Çok fazla istek. Lütfen biraz bekleyin. |
Anahtar başına dakikada 60 istek aşıldı. | Retry-After kadar bekleyip tekrar deneyin; istekleri zamana yayın. |
| 503 | Hesap bağlı değil |
Anahtarın bağlı olduğu WhatsApp oturumu kopmuş (ör. telefondan bağlı cihaz kaldırılmış, oturum sonlanmış). | Panel → Hesaplar'dan QR kodu yeniden okutun. Geçici kopmalar için üstel beklemeyle tekrar deneyin. |
| 503 | WhatsApp Store henüz hazır değil. Lütfen 30 saniye bekleyip tekrar deneyin. |
Hesap yeni bağlandı veya yeniden bağlanıyor; WhatsApp oturumu henüz tam yüklenmedi (geçici). | 30 saniye bekleyip tekrar deneyin. |
| 500 | Mesaj gönderilemedi: <ayrıntı> |
WhatsApp gönderimi tamamlanamadı; ör. medya indirilemedi veya gönderim reddedildi. | Ayrıntıyı loglayın. Mesaj gitmiş olabilir; körlemesine tekrar denemeyin. |
| 500 | Grup mesajı gönderilemedi: <ayrıntı> |
Geçersiz grup ID'si, numara grupta değil, grupta yazma yetkisi yok veya medya indirilemedi. | Grup ID'sini ve yetkileri kontrol edin; ayrıntıyı loglayın. |
| 500 | Gruplar yüklenemedi |
Grup listesi WhatsApp'tan alınamadı. | Kısa süre sonra tekrar deneyin (salt okunur, güvenli). |
| 400 | Geçersiz JSON gövdesi |
İstek gövdesi ayrıştırılamadı (eksik tırnak, sondaki virgül, yanlış kodlama vb.). | Gövdeyi bir JSON kütüphanesiyle üretin ve Content-Type: application/json gönderin. Tekrar denemek işe yaramaz. |
| 404 | Endpoint bulunamadı |
Yol veya HTTP metodu yanlış (ör. GET /api/external/send-message). Yanıtta path ve method alanları da döner. |
Yolu ve metodu Endpoint özeti ile karşılaştırın. |
| 413 | İstek gövdesi çok büyük (en fazla 10 MB) |
JSON gövdesi 10 MB sınırını aşıyor. | Medyayı gövdeye gömmeyin; media_url ile adres olarak gönderin. |
| 500 | Sunucu hatası |
Beklenmeyen sunucu hatası. | Kısa süre sonra tekrar deneyin; sorun sürerse yöneticinize bildirin. |
Tüm /api/… yanıtları JSON'dur. Yanlış yol veya metot (ör. GET /api/external/send-message) 404 {"success":false,"error":"Endpoint bulunamadı"} döndürür. Yine de yanıtı ayrıştırmadan önce durum kodunu ve Content-Type başlığını kontrol edin (ör. önünüzdeki bir proxy/CDN hata sayfası döndürebilir).
Yeniden Deneme & En İyi Uygulamalar
Ağ kesintileri ve geçici durumlar her entegrasyonda yaşanır. Hangi hatanın tekrar denenebileceğini bilmek hem mesaj kaybını hem de aynı mesajın iki kez gitmesini önler.
Hangi durumda tekrar denemeli?
| Durum | Tekrar dene? | Nasıl? |
|---|---|---|
| 400 401 403 | Hayır | İstek, anahtar veya kota düzeltilmeden sonuç değişmez. |
| 429 | Evet | Retry-After başlığındaki süre kadar bekleyin. |
| 503 | Evet | 30 saniyeden başlayan üstel bekleme (30 → 60 → 120 sn). Sürerse panelden hesabı yeniden bağlayın. |
| 500 POST | Körlemesine değil | Mesaj gitmiş olabilir. Ayrıntıyı loglayın; tekrar göndermeden önce telefonunuzdaki WhatsApp'ta ilgili sohbeti kontrol edin. |
| 5xx GET | Evet | groups ve me salt okunurdur; üstel beklemeyle güvenle tekrar denenebilir. |
| Zaman aşımı / bağlantı koptu (POST) | Dikkat | Sunucu mesajı göndermiş olabilir; 500 ile aynı şekilde ele alın. |
Idempotency anahtarı yoktur. Aynı isteği iki kez gönderirseniz alıcı mesajı iki kez alır. Her gönderim için kendi kayıt kimliğinizi, HTTP kodunu ve başarılı yanıttaki sent_to değerini loglayın; aynı iş için ikinci kez göndermeden önce bu kaydı kontrol edin.
Üstel beklemeli yeniden deneme
Aşağıdaki yardımcılar yalnızca 429 ve 503 yanıtlarında bekleyip yeniden dener; diğer hatalarda (özellikle 500) hemen hata fırlatır.
#!/usr/bin/env bash
# 429 ve 503'te bekleyip yeniden dener; 500'de DENEMEZ (mesaj gitmiş olabilir).
BODY='{"to":"905551112233","message":"Randevunuz yarın 14.00 için onaylandı."}'
for deneme in 1 2 3 4; do
kod=$(curl -sS -o yanit.json -D basliklar.txt -w "%{http_code}" \
-X POST "https://wp.inohype.com/api/external/send-message" \
-H "X-API-Key: $INOHYPE_API_KEY" \
-H "Content-Type: application/json" \
-d "$BODY")
if [ "$kod" = "429" ] || [ "$kod" = "503" ]; then
bekle=$(grep -i '^retry-after:' basliklar.txt | tr -dc '0-9')
[ -z "$bekle" ] && bekle=$(( 30 * 2 ** (deneme - 1) ))
echo "HTTP $kod, $bekle sn sonra tekrar denenecek ($deneme/4)" >&2
sleep "$bekle"
continue
fi
cat yanit.json; echo
break
done
<?php
/**
* 429 ve 503'te bekleyip yeniden dener.
* 500'de DENEMEZ: idempotency anahtarı olmadığı için mesaj gitmiş olabilir.
*/
function sendWithRetry(array $payload, int $maxAttempts = 4): array
{
for ($attempt = 1; ; $attempt++) {
$retryAfter = 0;
$ch = curl_init('https://wp.inohype.com/api/external/send-message');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'X-API-Key: ' . getenv('INOHYPE_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$retryAfter) {
if (stripos($line, 'Retry-After:') === 0) {
$retryAfter = (int) trim(substr($line, 12));
}
return strlen($line);
},
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode((string) $body, true) ?: [];
if ($status === 200) {
return $data;
}
$retryable = in_array($status, [429, 503], true);
if (!$retryable || $attempt >= $maxAttempts) {
throw new RuntimeException($data['error'] ?? "HTTP $status", $status);
}
$base = $status === 503 ? 30 : 2;
sleep($retryAfter > 0 ? $retryAfter : $base * 2 ** ($attempt - 1));
}
}
// Node.js 18+
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
/**
* 429 ve 503'te bekleyip yeniden dener.
* 500'de DENEMEZ: idempotency anahtarı olmadığı için mesaj gitmiş olabilir.
*/
async function sendWithRetry(payload, maxAttempts = 4) {
for (let attempt = 1; ; attempt++) {
const res = await fetch('https://wp.inohype.com/api/external/send-message', {
method: 'POST',
headers: {
'X-API-Key': process.env.INOHYPE_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify(payload),
signal: AbortSignal.timeout(60_000),
});
const data = await res.json().catch(() => ({}));
if (res.ok) return data;
const retryable = res.status === 429 || res.status === 503;
if (!retryable || attempt >= maxAttempts) {
throw new Error(`HTTP ${res.status}: ${data.error ?? 'bilinmeyen hata'}`);
}
const retryAfter = Number(res.headers.get('retry-after'));
const base = res.status === 503 ? 30_000 : 2_000;
const wait = retryAfter > 0 ? retryAfter * 1000 : base * 2 ** (attempt - 1);
console.warn(`HTTP ${res.status}, ${wait / 1000} sn sonra tekrar denenecek (${attempt}/${maxAttempts})`);
await sleep(wait);
}
}
import os
import time
import requests
API_URL = "https://wp.inohype.com/api/external/send-message"
HEADERS = {"X-API-Key": os.environ["INOHYPE_API_KEY"]}
def send_with_retry(payload, max_attempts=4):
"""429 ve 503'te bekleyip yeniden dener; 500'de DENEMEZ (mesaj gitmiş olabilir)."""
for attempt in range(1, max_attempts + 1):
resp = requests.post(API_URL, headers=HEADERS, json=payload, timeout=60)
if resp.ok:
return resp.json()
retryable = resp.status_code in (429, 503)
if not retryable or attempt == max_attempts:
resp.raise_for_status() # requests.HTTPError fırlatır
retry_after = resp.headers.get("Retry-After", "")
base = 30 if resp.status_code == 503 else 2
wait = int(retry_after) if retry_after.isdigit() else base * 2 ** (attempt - 1)
print(f"HTTP {resp.status_code}, {wait} sn sonra tekrar denenecek ({attempt}/{max_attempts})")
time.sleep(wait)
using System.Net.Http.Json;
using System.Text.Json;
// http: BaseAddress = https://wp.inohype.com ve X-API-Key varsayılan başlıklarda tanımlı
static async Task<JsonElement> SendWithRetryAsync(HttpClient http, object payload, int maxAttempts = 4)
{
for (var attempt = 1; ; attempt++)
{
using var response = await http.PostAsJsonAsync("/api/external/send-message", payload);
var data = await response.Content.ReadFromJsonAsync<JsonElement>();
if (response.IsSuccessStatusCode) return data;
var status = (int)response.StatusCode;
if (status is not (429 or 503) || attempt >= maxAttempts)
{
// 500: mesaj gitmiş olabilir, körlemesine tekrar denemeyin
var error = data.TryGetProperty("error", out var e) ? e.GetString() : null;
throw new HttpRequestException($"HTTP {status}: {error}");
}
var wait = response.Headers.RetryAfter?.Delta
?? TimeSpan.FromSeconds((status == 503 ? 30 : 2) * Math.Pow(2, attempt - 1));
Console.WriteLine($"HTTP {status}, {wait.TotalSeconds} sn sonra tekrar denenecek ({attempt}/{maxAttempts})");
await Task.Delay(wait);
}
}
Toplu gönderim kuyruğu
API'de toplu gönderim ucu yoktur; her alıcı için ayrı istek gönderilir. Mesajları sırayla, aralarında 2–3 saniye bekleyerek gönderin ve kota bittiğinde durun. Örnekler yukarıdaki yeniden deneme yardımcılarını kullanır.
#!/usr/bin/env bash
# numaralar.txt: her satırda bir numara. Gereksinim: curl, jq
while IFS= read -r numara; do
jq -n --arg to "$numara" --arg m "Merhaba, yarınki randevunuzu hatırlatırız. Görüşmek üzere!" \
'{to: $to, message: $m}' \
| curl -sS -X POST "https://wp.inohype.com/api/external/send-message" \
-H "X-API-Key: $INOHYPE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @-
echo
sleep 2 # aynı hesaptan mesajlar arası en az 2 sn
done < numaralar.txt
<?php
// Yukarıdaki sendWithRetry() fonksiyonunu kullanır.
$recipients = [
['to' => '905551112233', 'name' => 'Ayşe'],
['to' => '905551112244', 'name' => 'Mehmet'],
];
foreach ($recipients as $r) {
try {
$res = sendWithRetry([
'to' => $r['to'],
'message' => "Merhaba {$r['name']}, yarınki randevunuzu hatırlatırız. Görüşmek üzere!",
]);
echo "OK {$res['sent_to']} (kalan: {$res['remaining']})\n";
if ($res['remaining'] <= 0) {
break; // kota bitti
}
} catch (RuntimeException $e) {
error_log("HATA {$r['to']}: {$e->getMessage()}"); // logla, körlemesine tekrar gönderme
}
usleep(random_int(2000, 3000) * 1000); // mesajlar arası 2–3 sn
}
// Yukarıdaki sendWithRetry ve sleep fonksiyonlarını kullanır (ESM / .mjs).
const recipients = [
{ to: '905551112233', name: 'Ayşe' },
{ to: '905551112244', name: 'Mehmet' },
];
for (const r of recipients) {
try {
const res = await sendWithRetry({
to: r.to,
message: `Merhaba ${r.name}, yarınki randevunuzu hatırlatırız. Görüşmek üzere!`,
});
console.log('OK', res.sent_to, 'kalan:', res.remaining);
if (res.remaining <= 0) break; // kota bitti
} catch (err) {
console.error('HATA', r.to, err.message); // logla, körlemesine tekrar gönderme
}
await sleep(2000 + Math.random() * 1000); // mesajlar arası 2–3 sn
}
import random
import time
import requests
# Yukarıdaki send_with_retry fonksiyonunu kullanır.
recipients = [
{"to": "905551112233", "name": "Ayşe"},
{"to": "905551112244", "name": "Mehmet"},
]
for r in recipients:
try:
res = send_with_retry({
"to": r["to"],
"message": f"Merhaba {r['name']}, yarınki randevunuzu hatırlatırız. Görüşmek üzere!",
})
print("OK", res["sent_to"], "kalan:", res["remaining"])
if res["remaining"] <= 0:
break # kota bitti
except requests.HTTPError as e:
print("HATA", r["to"], e) # logla, körlemesine tekrar gönderme
time.sleep(2 + random.random()) # mesajlar arası 2–3 sn
// Yukarıdaki SendWithRetryAsync metodunu ve yapılandırılmış http istemcisini kullanır.
var recipients = new[]
{
(To: "905551112233", Name: "Ayşe"),
(To: "905551112244", Name: "Mehmet"),
};
foreach (var r in recipients)
{
try
{
var res = await SendWithRetryAsync(http, new
{
to = r.To,
message = $"Merhaba {r.Name}, yarınki randevunuzu hatırlatırız. Görüşmek üzere!"
});
var remaining = res.GetProperty("remaining").GetInt32();
Console.WriteLine($"OK {r.To} (kalan: {remaining})");
if (remaining <= 0) break; // kota bitti
}
catch (HttpRequestException ex)
{
Console.Error.WriteLine($"HATA {r.To}: {ex.Message}"); // logla, körlemesine tekrar gönderme
}
await Task.Delay(Random.Shared.Next(2000, 3000)); // mesajlar arası 2–3 sn
}
En iyi uygulamalar
Numaraları doğrulayın
Göndermeden önce aynı normalizasyon kurallarıyla kontrol edin; yabancı numaraları ülke koduyla saklayın.
Kişisel ve beklenen mesajlar
Yalnızca sizinle iletişime izin veren kişilere yazın ve mesajları kişiselleştirin. Aynı metnin topluca gönderilmesi ve spam şikâyetleri numaranızın WhatsApp tarafından yasaklanmasına yol açabilir.
Hızı zamana yayın
Aynı hesaptan mesajlar arasında 1–3 saniye bekleyin; paralel istek yerine kuyruk kullanın.
Zaman aşımı belirleyin
Metin mesajlarında 30 sn, medya ve grup listesinde 60 sn istemci zaman aşımı yeterlidir.
Loglayın
Her gönderimde HTTP kodu, error, sent_to ve remaining değerlerini kaydedin. API anahtarını asla loglamayın.
Sağlığı izleyin
/me ile bağlantıyı ve kotayı periyodik kontrol edin; connected: false olduğunda ekibinizi uyarın.
Entegrasyon Örnekleri
Kopyalayıp kendi projenize uyarlayabileceğiniz, çalışır durumda örnekler. Tüm örnekler API anahtarını kodun içine yazmak yerine ortam değişkeninden (INOHYPE_API_KEY) veya yapılandırma dosyasından okur.
WordPress / WooCommerce
Sipariş Hazırlanıyor (processing) durumuna geçtiğinde müşteriye WhatsApp bildirimi gönderir, sonucu sipariş notu olarak kaydeder ve aynı sipariş için ikinci kez göndermez. Önce anahtarı wp-config.php dosyasına tanımlayın:
define('INOHYPE_API_KEY', 'wpr_xxxxxxxxxxxxxxxxxxxxxxxx');
Ardından aşağıdaki kodu temanızın (tercihen alt temanın) functions.php dosyasının sonuna ya da küçük bir eklentiye ekleyin:
/**
* Inohype WP — sipariş "Hazırlanıyor" (processing) durumuna geçince
* müşteriye WhatsApp bildirimi gönderir.
*/
add_action('woocommerce_order_status_processing', 'inohype_wp_siparis_bildirimi', 10, 2);
function inohype_wp_siparis_bildirimi($order_id, $order = null)
{
if (!defined('INOHYPE_API_KEY')) {
return;
}
$order = $order instanceof WC_Order ? $order : wc_get_order($order_id);
if (!$order || $order->get_meta('_inohype_wp_bildirildi')) {
return; // sipariş yok veya daha önce bildirildi
}
// Yurt dışı müşterilerde numaranın ülke koduyla girildiğinden emin olun
$telefon = $order->get_billing_phone();
if (empty($telefon)) {
return;
}
$mesaj = sprintf(
"Merhaba %s,\n\n*#%s* numaralı siparişinizi aldık ve hazırlamaya başladık.\nToplam: %s %s\n\nTeşekkür ederiz!",
$order->get_billing_first_name(),
$order->get_order_number(),
$order->get_total(),
$order->get_currency()
);
$yanit = wp_remote_post('https://wp.inohype.com/api/external/send-message', [
'timeout' => 30,
'headers' => [
'X-API-Key' => INOHYPE_API_KEY,
'Content-Type' => 'application/json',
],
'body' => wp_json_encode([
'to' => $telefon,
'message' => $mesaj,
]),
]);
if (is_wp_error($yanit)) {
$order->add_order_note('WhatsApp bildirimi gönderilemedi: ' . $yanit->get_error_message());
return;
}
$kod = (int) wp_remote_retrieve_response_code($yanit);
$veri = json_decode(wp_remote_retrieve_body($yanit), true);
if ($kod === 200 && !empty($veri['success'])) {
$order->update_meta_data('_inohype_wp_bildirildi', current_time('mysql'));
$order->add_order_note('WhatsApp bildirimi gönderildi: ' . $veri['sent_to']);
$order->save();
} else {
$order->add_order_note(sprintf(
'WhatsApp bildirimi başarısız (HTTP %d): %s',
$kod,
$veri['error'] ?? 'bilinmeyen hata'
));
}
}
Yoğun mağazalar için: wp_remote_post isteği sipariş akışı sırasında çalışır. Ödeme adımını hiç bekletmemek için gönderimi WooCommerce ile gelen Action Scheduler (as_enqueue_async_action) ile arka plana alabilirsiniz.
Laravel
Laravel HTTP istemcisi (Http::withHeaders) ile küçük bir servis sınıfı ve 429/503'te kendini yeniden kuyruğa alan bir iş (job).
INOHYPE_API_URL=https://wp.inohype.com
INOHYPE_API_KEY=wpr_xxxxxxxxxxxxxxxxxxxxxxxx
// Mevcut dizinin içine ekleyin
'inohype' => [
'url' => env('INOHYPE_API_URL', 'https://wp.inohype.com'),
'key' => env('INOHYPE_API_KEY'),
],
<?php
namespace App\Services;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Http;
class InohypeWp
{
private function client(): PendingRequest
{
return Http::withHeaders(['X-API-Key' => config('services.inohype.key')])
->baseUrl(config('services.inohype.url'))
->acceptJson()
->timeout(60);
}
/** @throws \Illuminate\Http\Client\RequestException */
public function sendMessage(string $to, string $message, ?string $mediaUrl = null): array
{
return $this->client()
->post('/api/external/send-message', array_filter([
'to' => $to,
'message' => $message,
'media_url' => $mediaUrl,
]))
->throw()
->json();
}
/** @throws \Illuminate\Http\Client\RequestException */
public function sendToGroup(string $groupId, string $message, ?string $mediaUrl = null): array
{
return $this->client()
->post('/api/external/send-to-group', array_filter([
'group_id' => $groupId,
'message' => $message,
'media_url' => $mediaUrl,
]))
->throw()
->json();
}
public function groups(): array
{
return $this->client()->get('/api/external/groups')->throw()->json('groups');
}
public function me(): array
{
return $this->client()->get('/api/external/me')->throw()->json();
}
}
<?php
namespace App\Jobs;
use App\Services\InohypeWp;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Http\Client\RequestException;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
class SendWhatsAppMessage implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public int $tries = 4;
public function __construct(public string $to, public string $message)
{
}
public function handle(InohypeWp $wp): void
{
try {
$result = $wp->sendMessage($this->to, $this->message);
logger()->info('WhatsApp gönderildi', [
'sent_to' => $result['sent_to'],
'remaining' => $result['remaining'],
]);
} catch (RequestException $e) {
$status = $e->response->status();
if (in_array($status, [429, 503], true)) {
// Geçici durum: Retry-After kadar (yoksa 30 sn) sonra tekrar kuyruğa al
$this->release((int) ($e->response->header('Retry-After') ?: 30));
return;
}
// 4xx ve 500: tekrar deneme (500'de mesaj gitmiş olabilir)
$this->fail($e);
}
}
}
use App\Jobs\SendWhatsAppMessage;
use App\Services\InohypeWp;
// Tek mesaj (senkron)
$sonuc = app(InohypeWp::class)->sendMessage('0555 111 22 33', 'Merhaba! Ödemeniz alındı, teşekkür ederiz.');
// Toplu gönderim: işleri 2 sn arayla kuyruğa alın (php artisan queue:work)
foreach ($musteriler as $i => $musteri) {
SendWhatsAppMessage::dispatch(
$musteri->phone,
"Merhaba {$musteri->first_name}, randevunuz yarın 14.00 için onaylandı."
)->delay(now()->addSeconds($i * 2));
}
Node.js
Bağımlılığı olmayan, Node.js 18+ yerleşik fetch kullanan küçük bir istemci. Hatalarda HTTP kodunu ve Retry-After değerini taşıyan bir hata fırlatır.
// inohype-wp.js — Node.js 18+, ek paket gerekmez
const BASE_URL = 'https://wp.inohype.com';
class InohypeWpError extends Error {
constructor(status, message, retryAfter) {
super(message);
this.name = 'InohypeWpError';
this.status = status;
this.retryAfter = retryAfter; // saniye (yalnızca 429)
}
}
class InohypeWp {
constructor(apiKey = process.env.INOHYPE_API_KEY, { timeoutMs = 60_000 } = {}) {
if (!apiKey) throw new Error('INOHYPE_API_KEY tanımlı değil');
this.apiKey = apiKey;
this.timeoutMs = timeoutMs;
}
async request(method, path, body) {
const res = await fetch(BASE_URL + path, {
method,
headers: {
'X-API-Key': this.apiKey,
...(body ? { 'Content-Type': 'application/json' } : {}),
},
body: body ? JSON.stringify(body) : undefined,
signal: AbortSignal.timeout(this.timeoutMs),
});
const data = await res.json().catch(() => ({}));
if (!res.ok) {
const retryAfter = Number(res.headers.get('retry-after')) || null;
throw new InohypeWpError(res.status, data.error || `HTTP ${res.status}`, retryAfter);
}
return data;
}
sendMessage(to, message, mediaUrl) {
return this.request('POST', '/api/external/send-message', {
to,
message,
...(mediaUrl ? { media_url: mediaUrl } : {}),
});
}
sendToGroup(groupId, message, mediaUrl) {
return this.request('POST', '/api/external/send-to-group', {
group_id: groupId,
message,
...(mediaUrl ? { media_url: mediaUrl } : {}),
});
}
async groups() {
const data = await this.request('GET', '/api/external/groups');
return data.groups;
}
me() {
return this.request('GET', '/api/external/me');
}
}
module.exports = { InohypeWp, InohypeWpError };
const { InohypeWp, InohypeWpError } = require('./inohype-wp');
const wp = new InohypeWp(); // anahtar INOHYPE_API_KEY ortam değişkeninden okunur
(async () => {
const durum = await wp.me();
if (!durum.account.connected) {
throw new Error('WhatsApp hesabı bağlı değil, panelden QR kodu yeniden okutun');
}
try {
const r = await wp.sendMessage('0555 111 22 33', 'Merhaba! Randevunuz yarın 14.00 için onaylandı.');
console.log('Gönderildi:', r.sent_to, '| kalan kota:', r.remaining);
} catch (err) {
if (err instanceof InohypeWpError) console.error(err.status, err.message);
else throw err;
}
})();
Python
requests kütüphanesiyle (pip install requests) oturum tabanlı küçük bir istemci.
# inohype_wp.py — pip install requests
import os
import requests
BASE_URL = "https://wp.inohype.com"
class InohypeWpError(Exception):
def __init__(self, status, message, retry_after=None):
super().__init__(f"HTTP {status}: {message}")
self.status = status
self.message = message
self.retry_after = retry_after # saniye (yalnızca 429)
class InohypeWp:
def __init__(self, api_key=None, timeout=60):
self.session = requests.Session()
self.session.headers["X-API-Key"] = api_key or os.environ["INOHYPE_API_KEY"]
self.timeout = timeout
def _request(self, method, path, payload=None):
resp = self.session.request(method, BASE_URL + path, json=payload, timeout=self.timeout)
try:
data = resp.json()
except ValueError:
data = {}
if not resp.ok:
retry_after = resp.headers.get("Retry-After", "")
raise InohypeWpError(
resp.status_code,
data.get("error", resp.reason),
int(retry_after) if retry_after.isdigit() else None,
)
return data
def send_message(self, to, message, media_url=None):
payload = {"to": to, "message": message}
if media_url:
payload["media_url"] = media_url
return self._request("POST", "/api/external/send-message", payload)
def send_to_group(self, group_id, message, media_url=None):
payload = {"group_id": group_id, "message": message}
if media_url:
payload["media_url"] = media_url
return self._request("POST", "/api/external/send-to-group", payload)
def groups(self):
return self._request("GET", "/api/external/groups")["groups"]
def me(self):
return self._request("GET", "/api/external/me")
if __name__ == "__main__":
wp = InohypeWp()
durum = wp.me()
print("Bağlı:", durum["account"]["connected"], "| Kalan kota:", durum["quota"]["remaining"])
try:
sonuc = wp.send_message("0555 111 22 33", "Merhaba! Randevunuz yarın 14.00 için onaylandı.")
print("Gönderildi:", sonuc["sent_to"])
except InohypeWpError as e:
print("Hata:", e.status, e.message)
PHP (cURL)
Çerçeve kullanmayan projeler için yalnızca ext-curl gerektiren yardımcı fonksiyonlar (PHP 7.4+).
<?php
// inohype-wp.php — PHP 7.4+ ve ext-curl
const INOHYPE_WP_URL = 'https://wp.inohype.com';
function inohype_wp_request(string $method, string $path, ?array $payload = null): array
{
$headers = ['X-API-Key: ' . getenv('INOHYPE_API_KEY'), 'Accept: application/json'];
$ch = curl_init(INOHYPE_WP_URL . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 60,
]);
if ($payload !== null) {
$headers[] = 'Content-Type: application/json';
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload, JSON_UNESCAPED_UNICODE));
}
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$body = curl_exec($ch);
if ($body === false) {
$hata = curl_error($ch);
curl_close($ch);
throw new RuntimeException('Bağlantı hatası: ' . $hata);
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($body, true) ?: [];
if ($status !== 200) {
throw new RuntimeException($data['error'] ?? "HTTP $status", $status);
}
return $data;
}
function inohype_wp_send(string $to, string $message, ?string $mediaUrl = null): array
{
$payload = ['to' => $to, 'message' => $message];
if ($mediaUrl) {
$payload['media_url'] = $mediaUrl;
}
return inohype_wp_request('POST', '/api/external/send-message', $payload);
}
function inohype_wp_send_group(string $groupId, string $message): array
{
return inohype_wp_request('POST', '/api/external/send-to-group', [
'group_id' => $groupId,
'message' => $message,
]);
}
// Kullanım
try {
$sonuc = inohype_wp_send('0555 111 22 33', 'Merhaba! Ödemeniz alındı, teşekkür ederiz.');
echo "Gönderildi: {$sonuc['sent_to']} (kalan kota: {$sonuc['remaining']})\n";
} catch (RuntimeException $e) {
error_log("WhatsApp hatası ({$e->getCode()}): {$e->getMessage()}");
}
C# (.NET)
HttpClient tabanlı, .NET 6+ ile çalışan tip güvenli bir istemci. ASP.NET Core'da IHttpClientFactory ile de kaydedilebilir.
// InohypeWpClient.cs — .NET 6+
using System.Net;
using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
public sealed class InohypeWpException : Exception
{
public HttpStatusCode Status { get; }
public TimeSpan? RetryAfter { get; }
public InohypeWpException(HttpStatusCode status, string message, TimeSpan? retryAfter)
: base(message) => (Status, RetryAfter) = (status, retryAfter);
}
public sealed record SendResult(
[property: JsonPropertyName("success")] bool Success,
[property: JsonPropertyName("message")] string Message,
[property: JsonPropertyName("remaining")] int Remaining,
[property: JsonPropertyName("sent_to")] string SentTo);
public sealed class InohypeWpClient
{
private static readonly JsonSerializerOptions JsonOptions = new()
{
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
};
private readonly HttpClient _http;
public InohypeWpClient(HttpClient http, string apiKey)
{
_http = http;
_http.BaseAddress = new Uri("https://wp.inohype.com");
_http.Timeout = TimeSpan.FromSeconds(60);
_http.DefaultRequestHeaders.Add("X-API-Key", apiKey);
}
public Task<SendResult> SendMessageAsync(string to, string message, string? mediaUrl = null) =>
PostAsync<SendResult>("/api/external/send-message", new { to, message, media_url = mediaUrl });
public Task<SendResult> SendToGroupAsync(string groupId, string message, string? mediaUrl = null) =>
PostAsync<SendResult>("/api/external/send-to-group", new { group_id = groupId, message, media_url = mediaUrl });
public Task<JsonElement> MeAsync() =>
SendAsync<JsonElement>(new HttpRequestMessage(HttpMethod.Get, "/api/external/me"));
private Task<T> PostAsync<T>(string path, object body) =>
SendAsync<T>(new HttpRequestMessage(HttpMethod.Post, path)
{
Content = JsonContent.Create(body, options: JsonOptions)
});
private async Task<T> SendAsync<T>(HttpRequestMessage request)
{
using var response = await _http.SendAsync(request);
if (response.IsSuccessStatusCode)
return (await response.Content.ReadFromJsonAsync<T>())!;
string error;
try
{
var body = await response.Content.ReadFromJsonAsync<JsonElement>();
error = body.GetProperty("error").GetString() ?? "";
}
catch
{
error = $"HTTP {(int)response.StatusCode}";
}
throw new InohypeWpException(response.StatusCode, error, response.Headers.RetryAfter?.Delta);
}
}
using System.Net;
var apiKey = Environment.GetEnvironmentVariable("INOHYPE_API_KEY")
?? throw new InvalidOperationException("INOHYPE_API_KEY tanımlı değil");
var wp = new InohypeWpClient(new HttpClient(), apiKey);
try
{
var r = await wp.SendMessageAsync("0555 111 22 33", "Merhaba! Ödemeniz alındı, teşekkür ederiz.");
Console.WriteLine($"Gönderildi: {r.SentTo} (kalan kota: {r.Remaining})");
}
catch (InohypeWpException ex) when (ex.Status == HttpStatusCode.TooManyRequests)
{
Console.WriteLine($"Hız limiti: {ex.RetryAfter?.TotalSeconds ?? 60} sn sonra tekrar deneyin.");
}
catch (InohypeWpException ex)
{
Console.WriteLine($"Hata ({(int)ex.Status}): {ex.Message}");
}
Bash / cURL: gruba duyuru
Gruplarınızı listeleyip adına göre bulduğu gruba duyuru gönderen betik. JSON'u güvenle üretmek için jq kullanır (Türkçe karakterler ve tırnaklar sorun çıkarmaz).
#!/usr/bin/env bash
# Gereksinim: curl, jq
# Kullanım: export INOHYPE_API_KEY="wpr_xxxxxxxxxxxxxxxxxxxxxxxx"
# ./grup-duyuru.sh "Müşteri Duyuru" "*Duyuru:* Bu akşam 22.00 itibarıyla planlı bakım yapılacaktır."
set -euo pipefail
API="https://wp.inohype.com/api/external"
GRUP_ADI="${1:?Grup adı gerekli}"
MESAJ="${2:?Mesaj gerekli}"
# 1) Grupları çek ve yanıtı kontrol et
GRUPLAR=$(curl -sS "$API/groups" -H "X-API-Key: $INOHYPE_API_KEY")
if [ "$(echo "$GRUPLAR" | jq -r '.success')" != "true" ]; then
echo "Gruplar alınamadı: $(echo "$GRUPLAR" | jq -r '.error')" >&2
exit 1
fi
# 2) Grup ID'sini ada göre bul
GRUP_ID=$(echo "$GRUPLAR" | jq -r --arg ad "$GRUP_ADI" 'first(.groups[] | select(.name == $ad) | .id) // empty')
if [ -z "$GRUP_ID" ]; then
echo "Grup bulunamadı: $GRUP_ADI" >&2
exit 1
fi
# 3) Mesajı gönder
jq -n --arg g "$GRUP_ID" --arg m "$MESAJ" '{group_id: $g, message: $m}' \
| curl -sS -X POST "$API/send-to-group" \
-H "X-API-Key: $INOHYPE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @-
echo
Güvenlik
API anahtarı, WhatsApp numaranızdan mesaj gönderme yetkisidir. Bir şifre gibi koruyun.
Yalnızca sunucu tarafı
CORS tüm kökenlere açık (*) olsa da anahtarı tarayıcı JavaScript'ine, mobil uygulamaya veya masaüstü istemcisine koymayın. İstemciler kendi sunucunuza, sunucunuz Inohype WP'ye istek atmalıdır.
Ortam değişkeni / .env
Anahtarı koda yazmayın; .env dosyasında veya bir gizli anahtar yöneticisinde tutun ve .env dosyasını sürüm kontrolüne eklemeyin.
Düzenli yenileyin
Anahtarları belirli aralıklarla ve ekipten biri ayrıldığında yenileyin (adımlar aşağıda).
Yalnızca HTTPS
İstekleri her zaman https://wp.inohype.com adresine gönderin; anahtarı şifrelenmemiş bağlantı üzerinden iletmeyin.
En az yetki
Her entegrasyon (web sitesi, CRM, ekip botu) için ayrı WhatsApp hesabı ve anahtar kullanın; bir anahtarı iptal etmek diğerlerini etkilemez.
Panelde 2FA
Panel hesabınızda iki adımlı doğrulamayı (Google Authenticator / Authy) açık tutun. Panele erişen biri anahtarlarınızı yönetebilir.
.env örneği
# Inohype WP — bu dosyayı asla sürüm kontrolüne eklemeyin
INOHYPE_API_KEY=wpr_xxxxxxxxxxxxxxxxxxxxxxxx
# Gizli yapılandırma
.env
.env.*
Anahtarı yenileme (rotasyon)
- Panel → API Keys bölümünde ilgili hesabın mevcut anahtarını iptal edin. Bir hesapta aynı anda tek aktif anahtar bulunur.
- Aynı hesap için yeni anahtar oluşturun ve hemen kopyalayın.
- Sunucularınızdaki
.env/ gizli anahtar kaydını güncelleyip uygulamanızı yeniden başlatın. GET /api/external/meile yeni anahtarın doğru hesaba bağlı olduğunu doğrulayın.
İptal anında etkili olduğundan, eski anahtarla yapılan istekler bu aralıkta 401 alır. Yenilemeyi düşük trafikli bir zamanda yapın.
Anahtarınız sızdıysa:
- Anahtarı panelden hemen iptal edin; iptal edilen anahtar anında
401döner. - Panelde mesaj geçmişini ve kalan kotanızı kontrol edin.
- Yeni anahtarı yalnızca sunucu tarafında, gizli olarak dağıtın.
SSS / Sorun Giderme
En sık karşılaşılan durumlar ve çözümleri.
Sürekli 401 alıyorum. Ne yapmalıyım?
- Başlık adının tam olarak
X-API-Keyolduğundan emin olun.Authorization: Bearer …kullanılmaz. - Anahtarın tamamını (
wpr_+ 64 karakter) kopyaladığınızı ve tırnak işareti eklemediğinizi kontrol edin. - Anahtar panelden iptal edilmiş, bağlı WhatsApp hesabı silinmiş ya da kullanıcı hesabınız pasif olabilir. Panel → API Keys'te anahtarın aktif olduğunu kontrol edin.
API anahtarı gereklimesajı başlığın hiç ulaşmadığını gösterir; bir proxy veya HTTP istemcisi başlığı siliyor olabilir.
503 "Hesap bağlı değil" hatası alıyorum.
Anahtarın bağlı olduğu WhatsApp oturumu kopmuş demektir. Panel → Hesaplar bölümünden hesabı açıp QR kodu telefonunuzdan yeniden okutun. Telefonda WhatsApp → Bağlı Cihazlar listesinden oturumu kaldırırsanız veya WhatsApp uzun süre (yaklaşık 14 gün) telefonda hiç açılmazsa bağlı cihazlar oturumu sonlanabilir.
Yeniden bağlandıktan hemen sonra kısa süreliğine WhatsApp Store henüz hazır değil… hatası görebilirsiniz; 30 saniye bekleyip tekrar deneyin. Durumu kota harcamadan /me ile izleyebilirsiniz.
200 aldım ama mesaj karşı tarafa ulaşmadı.
200 yanıtı mesajın WhatsApp'a iletildiğini gösterir; teslimi garanti etmez. Olası nedenler:
- Numara WhatsApp'ta kayıtlı değil veya yanlış normalize edildi (ör. ülke kodu olmayan yabancı numara). Yanıttaki
sent_todeğerini kontrol edin. - Alıcı sizi engellemiş veya alıcının telefonu uzun süredir çevrim dışı.
- WhatsApp, numaranızın gönderimlerini kısıtlamış olabilir (çok hızlı veya istenmeyen gönderimler).
API mesajları kendi hesabınızdan gönderdiği için gönderilen mesajlar telefonunuzdaki WhatsApp'ta ilgili sohbette görünür; tik durumunu oradan kontrol edebilirsiniz.
Numarayı hangi formatta göndermeliyim?
En güvenlisi ülke kodu + numara, yalnızca rakam: 905551112233. 0555 111 22 33 ve +90 555 111 22 33 de kabul edilir. Yabancı numaraları mutlaka ülke koduyla yazın ve 00 önekini kullanmayın. Tüm kurallar: Telefon Numarası Formatı.
Kotam doldu. Nasıl artırırım?
Kota, paketinize göre yönetici tarafından belirlenir; API veya panel üzerinden kendiniz artıramazsınız. Paket yükseltme veya ek kota için yöneticinizle iletişime geçin. Kota tüm hesaplarınız ve anahtarlarınız arasında paylaşılır; kalan hakkınızı /me ile izleyebilirsiniz.
Webhook var mı? Gelen mesajları alabilir miyim?
Şu an yok. API yalnızca giden mesajları destekler; gelen mesajlar, teslim ve okundu bildirimleri için webhook henüz sunulmuyor. Eklendiğinde Değişiklik Günlüğü'nde duyurulacaktır.
Toplu gönderim ucu var mı?
Hayır; her alıcı için ayrı istek gönderilir. Mesajları kuyruğa alıp aralarında 1–3 saniye bekleyerek sırayla gönderin. Hazır örnek: Toplu gönderim kuyruğu.
Birden fazla numaradan gönderim yapabilir miyim?
Evet. Her numarayı panelde ayrı bir hesap olarak bağlayın ve her hesap için ayrı anahtar oluşturun. Mesaj, isteği hangi anahtarla gönderirseniz o anahtarın bağlı olduğu numaradan gider. Kota tüm hesaplar arasında ortaktır.
Grup ID'sini nasıl bulurum?
GET /api/external/groups isteği, bağlı numaranın üye olduğu tüm grupları id değerleriyle döndürür. Grup ID'leri değişmez; bir kez alıp saklayabilirsiniz.
Mesajımdaki < ve > karakterleri neden kayboluyor?
Güvenlik nedeniyle message alanındaki < ve > karakterleri silinir. Yerine ≤, ≥ veya → gibi Unicode karakterleri kullanabilirsiniz.
404 "Endpoint bulunamadı" veya HTML yanıt alıyorum.
404 Endpoint bulunamadı: yanlış yol veya metot kullanıyorsunuz (ör. send-message için GET); yanıttaki path ve method alanlarını Endpoint özeti ile karşılaştırın. Gövdeniz geçerli JSON değilse 400 Geçersiz JSON gövdesi alırsınız. Tamamen HTML bir yanıt geliyorsa istek API'ye ulaşmadan önünüzdeki proxy/CDN tarafından yanıtlanıyor olabilir; adresin https://wp.inohype.com/api/… ile başladığını kontrol edin.
API'yi doğrudan tarayıcıdan (frontend) çağırabilir miyim?
Teknik olarak mümkündür (CORS açık), ancak yapmayın: anahtarınız sayfa kaynağında herkese görünür olur. Tarayıcıdan kendi sunucunuza istek atın; sunucunuz anahtarı ekleyerek Inohype WP'ye iletsin. Bkz. Güvenlik.
Değişiklik Günlüğü
API'de yapılan değişiklikler. Mevcut uçlar geriye dönük uyumlu kalır.
v1.1
Güncel- Yeni
GET /api/external/me: anahtar, hesap bağlantısı ve kota durumu (kota dolu olsa da çalışır). - YeniAnahtar başına dakikada 60 istek hız limiti ve
RateLimit-*/Retry-Afteryanıt başlıkları. - YeniTutarlı hata yanıtları: bilinmeyen
/apiyolları JSON404, bozuk JSON gövdesi400, çok büyük gövde413; harici uçlarda geçici WhatsApp hazır değil durumu503. - DeğiştiÜrün adı Inohype WP olarak güncellendi; adres
https://wp.inohype.com. - GüvenlikPanel girişinde iki adımlı doğrulama (2FA) desteği.
v1.0
İlk sürüm- Yeni
POST /api/external/send-message: kişiye metin ve medya gönderimi. - Yeni
POST /api/external/send-to-group: gruba metin ve medya gönderimi. - Yeni
GET /api/external/groups: grupları listeleme.