Geliştirici

REST API

WhatsApp mesajlaşmasını mevcut uygulamanıza birkaç HTTP isteğiyle bağlayın. Kimlik doğrulama instance API anahtarı ile yapılır.

REQUEST

POST /api/{instanceId}/send
Content-Type: application/json
X-API-Key: API_KEY

{
  "phone": "+905551234567",
  "message": "Merhaba"
}

RESPONSE

{
  "success": true,
  "instanceId": "example-instance",
  "messageId": "example-message-id",
  "quotaRemaining": "unlimited"
}

Base URL

https://app.kolaywhatsapp.com

Mesaj, QR ve durum uçları X-API-Key ister — anahtar instance ile üretilir, panelden yenilenebilir.

Instance oluşturma uçları ayrı bir sunucu secret'ı ister (dış entegrasyon).

Kod	Anlam
200	Gönderildi
400	Eksik phone veya message
401	Geçersiz veya eksik API anahtarı
403	Premium gerekli veya kota tükendi
503	WhatsApp bağlantısı hazır değil
500	Sunucu hatası

WhatsApp message.received KolayWhatsApp POST webhook Sisteminiz 200 OK

Webhook secret tanımlandığında teslimat HMAC-SHA256 ile imzalanır.

Müşteri
Bir yetkiliyle görüşebilir miyim?

Asistan
Elbette, sizi ekibe aktarıyorum. Chatbot

Operatör devraldı

Örnek akış — chatbot kurucuda mesaj ve koşul düğümleri ile akış tasarlanır.

POST /api/{instanceId}/send
Metin mesajı. Gövde: phone, message. Premium olmayan instance'larda kredi düşer.
POST /api/{instanceId}/send-media
Medya gönderimi. multipart file alanı.
GET /api/{instanceId}/qr-code
Bağlantı QR'ı. Durum qr_code_generated iken.
GET /api/{instanceId}/status
initializing | qr_code_generated | connected | disconnected | requires_premium
POST /api/instances/create
Dış oluşturma. X-API-Secret. İlk instance 30 gün premium.