API Doküman | Mesajora

Mesajora API Belgeleri

QR bağlantı ile WhatsApp mesajlaşma ve API takibi için tek merkez.

Mesajora; QR oturumu, mesaj gönderimi, gelen mesaj kaydı, teslim/okundu durumu ve API olay akışını tek panelde yönetir.

3 gün deneme QR ile WhatsApp bağlantısı Gelen mesaj ve durum olayları

canlı test

POST /api/v1/messages/send
Authorization: Bearer msg_live_xxxxx
Content-Type: application/json

{"to":"905XXXXXXXXX","message":"Merhaba, siparisiniz hazirlaniyor."}

API hazır https://api.mesajora.com.tr

Hızlı Başlangıç

Bir müşteri hattını dakikalar içinde API'ye açın.

Müşteri teknik ID'lerle uğraşmadan panelde QR kodu okutur. API anahtarı panelde oluşur, entegrasyon tarafında sadece token kullanılır.

Demo veya müşteri hesabını aç

Firma ve kullanıcı oluşturulduğunda panel girişi hazır olur. Deneme süresi bittiğinde paket seçimiyle devam edilir.

WhatsApp QR oturumunu başlat

Müşteri panelinde WhatsApp bölümüne girer, QR kodu bağlı cihazlar ekranından okutur ve hat hazır duruma gelir.

API anahtarını üret

Token oluşturma anında tam hali gösterilir. Sonra güvenlik için yalnızca ön ek görünür.

Mesajları ve durumları takip et

Gelen mesajlar kaydedilir; giden mesajın gönderim, teslim ve okundu durumu panelden izlenir.

Endpointler

Temel API uçları

Tüm isteklerde taban adres https://api.mesajora.com.tr kullanılır.

GET/api/v1/health

Servis sağlık kontrolü.

GET/api/v1/account

Firma, paket ve limit bilgileri.

GET/api/v1/messages/statistics

Gönderilen, sıradaki, hatalı ve gelen mesaj sayıları.

POST/api/v1/messages/send

Telefon numarası veya WhatsApp birebir/grup chat ID’sine metin gönderimi.

POST/api/v1/messages/send-media

Resim, video, ses veya belge gönderimi; dosya sınırı 8 MB.

GET/api/v1/messages/chat

URL parametreleriyle hızlı test mesajı.

GET/api/v1/messages

Sayfalama, durum/yön filtresi ve sıralama ile mesaj geçmişi.

GET/api/v1/events

Gelen mesaj ve gönderim durumu olaylarını sayfalı olarak okuyun.

Kod Örnekleri

En çok kullanılan entegrasyon akışları.

Aşağıdaki örneklerde msg_live_xxxxxxxxx yerine panelde oluşturduğunuz API anahtarını kullanın.

Kimlik doğrulamaBearer Token

Authorization: Bearer msg_live_xxxxxxxxx

API anahtarı firma için üretilir. Tam hali yalnızca oluşturma anında gösterilir.

Mesaj göndercURL

curl -X POST https://api.mesajora.com.tr/api/v1/messages/send \
  -H "Authorization: Bearer msg_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to":"905XXXXXXXXX","message":"Merhaba"}'

Medya gönderJSON + Base64

POST /api/v1/messages/send-media
Authorization: Bearer msg_live_xxxxxxxxx
Content-Type: application/json

{"to":"905XXXXXXXXX","type":"image","mime_type":"image/jpeg",
  "filename":"urun.jpg","caption":"Yeni ürün","media_base64":"BASE64_DOSYA_VERISI"}

to telefon numarası veya WhatsApp chat ID olabilir. Desteklenen türler: JPEG/PNG/WebP resim, MP4 video, OGG/MP3/M4A/AAC/AMR ses ve PDF/Office belge. Dosya en fazla 8 MB.

URL ile test mesajıGET

https://api.mesajora.com.tr/api/v1/messages/chat?token=msg_live_xxxxxxxxx&to=905XXXXXXXXX&body=Merhaba

Mesajları listeleGET

GET /api/v1/messages?page=1&limit=25&status=failed&direction=outbound&sort=desc
Authorization: Bearer msg_live_xxxxxxxxx

status: queued, sent, delivered, read, played, received, failed, simulated, invalid, expired veya all. direction: inbound, outbound veya all. Limit 1-100.

Gelen mesaj ve durum olaylarıGET

GET /api/v1/events?after_id=0&limit=25&type=message.inbound
Authorization: Bearer msg_live_xxxxxxxxx

İlk istekte after_id=0 kullanın; yanıttaki pagination.next_after_id değerini sonraki isteğe koyun. type: message.inbound, message.sent, message.status veya all. Olaylar yalnızca API anahtarının firmasına aittir.

Python ile mesaj gönderrequests

import requests

response = requests.post(
    "https://api.mesajora.com.tr/api/v1/messages/send",
    headers={"Authorization": "Bearer API_ANAHTARI"},
    json={"to": "905XXXXXXXXX", "message": "Merhaba"},
    timeout=30,
)
print(response.status_code, response.json())

WhatsApp Bağlantısı

Tek adımda QR bağlantısı.

Müşteri, panelde QR oturumunu başlatır ve telefonundan WhatsApp Bağlı Cihazlar ekranında kodu okutur. Teknik kimlik veya sunucu ayarıyla uğraşmak gerekmez.

WhatsApp paneline git

Mesaj Otomasyonu

Olay akışınızı kendi sisteminize bağlayın.

Gelen mesajları ve teslim/okundu bildirimlerini API olay akışından alıp CRM veya destek yazılımınızda işleyebilirsiniz. WhatsApp otomatik yanıtı ayrıca bir AI sağlayıcı entegrasyonu gerektirir.

AI ayarlarına git

Üretime Hazır

API belgeleri, panel ve ana site aynı tasarım dilinde.

Entegrasyon ekibi dokümanı okurken, müşteri paneliyle aynı akışı ve aynı terminolojiyi görür.

3 gün demo iste Müşteri girişi