Geliştirici API

Tek bir POST ile DM gönderin.

Telegram ve X otomasyonu için üretime hazır REST API. Bearer kimlik doğrulama, kapsam sınırlı anahtarlar, idempotency, hız limiti başlıkları, giden webhook’lar. SDK gerekmez.

API anahtarı al OpenAPI dokümanı

HTTPS üzerinden JSON
Düşük gecikmeli yanıt
Tasarımı gereği güvenilir

api.crmsolid.com/v1/messages/send

v1 · kararlı

Uç noktalar

POST/v1/messages/send

GET/v1/contacts

POST/v1/webhooks

Kimlik doğrulama

Bearer cs_live_***

İstek

curl -X POST \

https://api.crmsolid.com/v1/messages/send \

-H "Authorization: Bearer cs_live_***" \

-H "Idempotency-Key: 9d2c-44e1" \

-H "Content-Type: application/json" \

-d '{

"account_id": 7421,

"to": "@sarah_miller",

"text": "Merhaba {first_name}, davetin hazır"

Yanıt200 OK · 187 ms

{

"id": "msg_01HKQ9R2X3",

"status": "queued",

"eta": "2026-05-06T14:32:18Z"

}

Hız limiti

X-RateLimit-Remaining

bu saat 4.982 hak kaldı

Yığınınızı seçin

Aynı endpoint. Dört dil.

Tek bir JSON sözleşmesi. Kopyalayın, yapıştırın, yayına alın. OpenAPI dokümanı her endpoint’i, her hatayı ve her webhook gövdesini kapsar.

curl -X POST https://api.crmsolid.com/v1/messages/send \

-H "Authorization: Bearer cs_live_***" \

-H "Idempotency-Key: $(uuidgen)" \

-H "Content-Type: application/json" \

-d '{"account_id":7421,"to":"@sarah_miller","text":"Aramıza hoş geldin"}'

Tüm referans ve hata kataloğu: api.crmsolid.com/swagger

Kimlik doğrulama

Kapsam sınırlı anahtar. Varsayılan en az yetki.

Kapsam sınırlı API anahtarları üretin: analiz panoları için salt okunur, üretim göndericileri için yazma yetkili, operasyon otomasyonu için yönetim yetkili. Kesintisiz yenileyin, geçiş sırasında iki anahtar da geçerli kalır.

Bearer kimlik doğrulama
Her istekte Authorization: Bearer cs_live_… gönderin. Canlı ve test anahtarları görsel olarak ayrışır, üretim akışlarınız güvende kalır.
Kapsam sınırlı izinler
Bir anahtara yalnızca ihtiyaç duyduğu en küçük kapsam kümesini verin. Sızan bir pano anahtarı asla mesaj gönderemez.
Kesintisiz anahtar yenileme
Yeni anahtarı üretin, yayına alın, sonra eskisini iptal edin. Geçiş penceresinde ikisi de geçerlidir, toplu 401 yağmuru olmaz.

Üretim göndericisi

CANLI

cs_live_a4f9_•••••••••••••••

Kapsamlar

read:contactsKişileri listeleyin, arayın, dışa aktarın.

read:messagesSohbet geçmişini ve gelen kutusunu okuyun.

read:analyticsHuni, sekans ve hesap istatistiklerini çekin.

write:messagesDM ve toplu duyuru gönderin.

write:contactsKişi oluşturun, güncelleyin, etiketleyin.

manage:sequencesSekansları başlatın, duraklatın, sürdürün.

manage:webhooksWebhook adreslerini tanımlayın, yenileyin.

Güvenilirlik

Her şeyi söyleyen geri basınç.

Idempotency anahtarları sayesinde yeniden denemek güvenlidir: aynı mesaj iki kez gitmez. Hız limiti başlıkları, 429 gelmeden önce istemcinize yavaşlama sinyalini verir.

Yanıt · 200 OK187 ms

X-RateLimit-Limit:600 # anahtar başına dakikadaki istek

X-RateLimit-Remaining:588 # bu pencerede kalan hak

X-RateLimit-Reset:42 # pencere sıfırlanana kadar saniye

Retry-After:12 # 429 gelirse bu kadar saniye bekle

Idempotency anahtarları

Her yazma isteğinde Idempotency-Key gönderin. Yeniden denemeler ilk yanıtı döndürür. Mesaj asla iki kez gitmez.

Uyarlanabilir hız limitleri

Varsayılan: Telegram hesabı başına dakikada 600 istek ve günde 50 gönderim, otomatik flood-wait yönetimiyle. Başlıklar kalan bütçeyi gösterir, tahmin yürütmeniz gerekmez.

Sabit hata kataloğu

Her hata, dallanabileceğiniz sabit bir code ve arayüzde gösterebileceğiniz okunabilir bir message döndürür. RFC 7807 problem-detail biçimi.

Webhook’lar

Her olay için giden webhook.

Her CRM olayını anlık alın. HMAC-SHA256 imzası, üstel geri çekilmeli otomatik yeniden deneme ve yeniden oynatabileceğiniz teslimat kaydı.

Diğer olaylar

message.sent · message.failed · contact.created · contact.tagged · sequence.started · sequence.paused · job.completed · subscription.upgraded

POST · your-handler

teslim edildi

{

"event": "message.received",

"id": "evt_01HKQ9R2X7",

"created_at": "2026-05-06T14:32:18Z",

"account_id": 7421,

"contact": "@sarah_miller",

"text": "Merhaba, demoyu gönderebilir misiniz?",

"thread_id": "th_5829"

}

Alırken doğrulayın

const sig = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');

if (sig !== headers['x-signature']) return 401;

CRM Solid ile geliştirin. Dakikalar içinde yayına alın.

Bir sandbox anahtarı üretin, curl’ü yapıştırın, mesajın ulaştığını görün. Üretim sözleşmesi birebir aynı biçimde. Geliştirme ile canlı arasında kodu yeniden yazmazsınız.

API anahtarı al Dokümanı okuyun

Ücretsiz sandbox katmanı
60 saniyeden kısa sürede canlı anahtar
HMAC imzalı webhook’lar

Zaten hesabınız var mı? Anahtarlarınız: Ayarlar → API