Evolution API Bağlantı & Anahtar Yapılandırması
Ayarlar tarayıcınızın LocalStorage belleğinde saklanır ve API isteklerinde otomatik kullanılır.
Coolify Webhook Entegrasyonu
Evolution API instance'ınızdaki event'leri bu arayüzde canlı izlemek için aşağıdaki Webhook URL'sini Evolution API'nize kaydedin:
Global Key vs Instance Token
-
Global Key: Evolution API'nizin
AUTHENTICATION_API_KEYdeğeridir. Sunucunun ana yöneticisidir. - Instance Key / Token: Her instance oluşturulurken belirlenen özel paroladır. Mesaj gönderme işlemlerinde bu anahtar kullanılır.
Henüz bir webhook event'i alınmadı.
Evolution API webhook adresini /api/webhook olarak ayarlayın veya simüle butonuna tıklayın.
LID / JID Çözümleme Motoru
WhatsApp v2.4.0+ ile birlikte kullanıcılar telefon numarası gizli (@lid) veya standart (@s.whatsapp.net) gelebilir. Fallback motoru şu hiyerarşiyle kimliği belirler:
Hızlı Hedef Seçimi
Mesaj akışı oluştukça aktif sohbetler burada listelenir.
Genel Canlı Akış
CanlıTüm gelen & giden mesajlar
Evolution API Fonksiyonları
Seçilen endpoint açıklaması burada görüntülenir.
Yanıt İnceleyici (Response Viewer)
HTTP 200 0 ms Key: Instance// Henüz bir istek gönderilmedi. "İsteği Çalıştır" butonuna basarak canlı test yapabilirsiniz.Entegrasyon, AI Prompt & Kod Üreteci Engine
Aktif Evolution API ayarlarınız, seçili versiyon ve LID çözümleme kurallarıyla tam uyumlu hazır kodlar.
evo_test Kullanım, Entegrasyon & Sorun Giderme Rehberi
Evolution API v2.3.7 ve v2.4.0 ile ilgili tüm kavramlar, anahtar farkları ve pratik adımlar.
1. Global API Key vs Instance Token Farkı
Evolution API'de iki farklı güvenlik anahtarı katmanı bulunur:
-
Global API Key (Master Key): Evolution API sunucunuzun
AUTHENTICATION_API_KEYortam değişkenidir. Tüm instance'ları listeleme (/instance/fetchInstances), yeni instance oluşturma ve silme gibi sunucu seviyesi işlemler için şarttır. - Instance API Key / Token: Her bir WhatsApp instance'ına özel tanımlanabilen token'dır. Mesaj gönderme, rehber okuma ve webhook ayarları bu token ile yetkilendirilir.
💡 İpucu: Eğer instance oluştururken özel bir token tanımlamadıysanız, her iki alana da Global API Key'inizi yazabilirsiniz.
2. WhatsApp LID (@lid) ve JID Çözümlemesi
WhatsApp, gizlilik amacıyla topluluk ve gizli profillerde kullanıcının gerçek telefon numarası yerine rastgele bir @lid (Linked ID) adresi gönderir.
Nasıl Yanıtlanır? Eğer hedef adres @lid içeriyorsa, /message/sendText içindeki number alanına doğrudan bu LID string'ini (örn: 123456789@lid) göndermelisiniz.
3. Coolify Üzerinde Canlı Webhook Kurulumu
Bu paneldeki "Canlı Webhook" sekmesinde mesajları gerçek zamanlı izlemek için:
-
Ayarlar sekmesine gidin ve "Bu Uygulamanın Webhook Alıcı URL'si" kutusundaki URL'yi kopyalayın (Örn:
https://evo-test.cakirlar.net/api/webhook). -
"Webhook'u Instance'a Otomatik Tanımla" butonuna basın veya Evolution API'nize
POST /webhook/set/{instance}isteği atın. - WhatsApp'ınıza mesaj geldiğinde veya mesaj gönderdiğinizde, ekranda anlık olarak renklendirilmiş JSON logları akacaktır.
4. AI Prompt, n8n ve Kod Üreteci Kullanımı
Test ettiğiniz herhangi bir Evolution API fonksiyonunu diğer projelerinize tek tıkla aktarabilirsiniz:
- Antigravity / Cursor Prompt: LLM'e projenizin Evolution API ayarlarını ve LID kurallarını öğreten hazır sistem talimatı.
- Node.js & Python: Try/Catch hata yönetimli, istek zamanlamalı ve otomatik yetkilendirmeli fonksiyonlar.
- n8n Code Node: Webhook'tan gelen ham JSON'u parçalayıp temizleyen JavaScript bloğu.
Sık Karşılaşılan Hatalar ve Çözüm Adımları
HTTP 401 Unauthorized Hatası
Evolution API'ye gönderilen API Key yanlıştır. Ayarlar sekmesinde Global API Key veya Instance Token alanlarını kontrol edin.
HTTP 404 Instance Not Found Hatası
Yazdığınız Instance adı Evolution API'de henüz oluşturulmamış veya yazım hatası var. Instance adının doğruluğundan emin olun.
Webhook Logları Ekrana Düşmüyor
Evolution API sunucunuz bu uygulamanın domainine (/api/webhook) erişemiyor olabilir veya instance'ta Webhook enabled: true değildir. Alternatif olarak Yoklama (Polling) modunu açabilirsiniz.
SSL / HTTPS Sertifika Hatası (Önemli Çözüm)
Eğer Coolify alan adınızda alt çizgi (_) kullanıldıysa (Örn: evo_test.cakirlar.net), Let's Encrypt ve SSL standartları alt çizgili domainlere güvenlik sertifikası üretmez ve tarayıcıda SSL hatası verir.
Çözüm: Coolify'da domaininizi alt çizgi yerine tire (-) veya bitişik yazarak güncelleyin (Örn: https://evo-test.cakirlar.net veya https://evotest.cakirlar.net). Traefik sertifikayı anında başarıyla üretecektir.