Hızlı başlangıç
Çalışma alanının sahibi Ayarlar → Geliştirici bölümünde herkese açık bir HTTPS alıcı adresi ekler ve olayları seçer. Bir kez gösterilen whsec_… imza anahtarını hemen saklayın. Test olayı gönderip gönderim günlüğünü yenileyin. Genel özellik bayrağı ve çalışma alanınızın API erişimi açık olmalıdır; özellik varsayılan olarak kapalıdır. Alıcı ekleme, açma ve anahtar yenileme işlemleri yeni bir 2FA kodu gerektirir. Güvenlik değişikliklerinden sonra 24 saat beklenir.
Bu bağlantı için resmi Blinkerbot Zapier veya Make uygulaması gerekmez. Kendi sunucunuzu veya genel webhook araçlarını kullanabilirsiniz. REST API rehberi program üzerinden abonelik oluşturma ve silmeyi açıklar.
Olaylar abonelikten sonra gözlenen değişikliklerle başlar; geçmiş kişiler otomatik gönderilmez. İlk CRM eşitlemesi için GET /v1/contacts kullanın.
Zarf ve başlıklar
{"id":"evt_example","type":"lead.captured","createdAt":"2026-11-12T12:00:00.000Z","workspaceId":"workspace_example","apiVersion":"2026-11-12","data":{"id":"contact_example","name":"Ada","phone":"+905550000000","email":"ada@example.com","tags":["Nitelikli"]}}İstek JSON POST olarak gelir. Blinkerbot-Event-Id, Blinkerbot-Event-Type ve Blinkerbot-Signature başlıkları bulunur. İmza biçimi: t=<unix saniye>,v1=<hex HMAC-SHA256>. whsec_ öneki dahil gizli anahtarın tamamını kullanarak t + "." + rawBody UTF-8 baytlarını imzalayın. Doğrulamadan önce JSON ayrıştırıp yeniden üretmeyin.
Geçmişte veya gelecekte 300 saniyeden fazla fark olan zaman damgalarını reddedin. Sabit zamanlı karşılaştırma yapın ve sunucu saatinizi eşitleyin. Anahtar yenilemesinde iki v1 değeri bulunur; geçerli olan herhangi biri kabul edilir. Eski anahtar 24 saat boyunca çalışır. Bu geçiş bitmeden tekrar anahtar yenilenemez.
Node ile doğrulama
import { createHmac, timingSafeEqual } from 'node:crypto';
export function verify(rawBody, header, secret, now = Date.now() / 1000) {
const fields = header.split(',');
const ts = fields.filter(f => /^t=/.test(f));
if (ts.length !== 1 || !/^t=\d+$/.test(ts[0])) return false;
const t = Number(ts[0].slice(2));
if (!Number.isSafeInteger(t) || Math.abs(now - t) > 300) return false;
const expected = createHmac('sha256', secret)
.update(`${t}.`).update(rawBody).digest();
return fields.some(f => /^v1=[a-f0-9]{64}$/.test(f) &&
timingSafeEqual(expected, Buffer.from(f.slice(3), 'hex')));
}
// rawBody: JSON middleware öncesindeki özgün Buffer.PHP ile doğrulama
<?php
function verifyWebhook(string $raw, string $header, string $secret): bool {
$fields = explode(',', $header);
$ts = array_values(array_filter($fields, fn($f) => str_starts_with($f, 't=')));
if (count($ts) !== 1 || !preg_match('/^t=\d+$/D', $ts[0])) return false;
$t = (int) substr($ts[0], 2);
if (abs(time() - $t) > 300) return false;
$expected = hash_hmac('sha256', $t . '.' . $raw, $secret);
foreach ($fields as $field) {
if (preg_match('/^v1=[a-f0-9]{64}$/D', $field) &&
hash_equals($expected, substr($field, 3))) return true;
}
return false;
}
$raw = file_get_contents('php://input');
// json_decode öncesinde doğrulayın; anahtarı güvenli yapılandırmadan alın.Python ile doğrulama
import hashlib, hmac, re, time
def verify(raw: bytes, header: str, secret: str) -> bool:
fields = header.split(',')
timestamps = [f for f in fields if f.startswith('t=')]
if len(timestamps) != 1 or not re.fullmatch(r't=\d+', timestamps[0]):
return False
t = int(timestamps[0][2:])
if abs(time.time() - t) > 300:
return False
expected = hmac.new(secret.encode(), str(t).encode() + b'.' + raw,
hashlib.sha256).hexdigest()
return any(re.fullmatch(r'v1=[a-f0-9]{64}', f) and
hmac.compare_digest(expected, f[3:]) for f in fields)
# raw: JSON ayrıştırmasından önceki özgün istek baytları.Olay kataloğu
Aşağıdaki örnekler zarf içindeki data alanıdır. Kimlikler yalnızca bu çalışma alanındaki kayıtlara aittir. Kişi etiketleri kalıcı müşteri etiketleridir; sohbet konu etiketleri ayrı tutulur.
Kişiler ve müşteri adayları
contact.created: yeni kişi kaydı.contact.updated: ad, telefon, e-posta veya kişi etiketi üyeliği değişti. Her mesajda, son görülme veya yapay zekâ belleği değişikliklerinde gönderilmez.lead.captured: ilk kez boş olmayan ad ile telefon veya e-posta bir aradadır. Bilgilerin silinip geri eklenmesi ikinci bir olay oluşturmaz.
{"id":"contact_example","name":"Ada","phone":"+905550000000","email":"ada@example.com","tags":["Nitelikli"]}Sohbetler
conversation.created:{"id":"conversation_example","contactId":"contact_example","status":"OPEN","pausedForHuman":false}conversation.handoff_requested:{"id":"conversation_example","contactId":"contact_example","status":"OPEN","pausedForHuman":true}; asistan veya panel sohbeti bir insana aktarmak için duraklatır.conversation.closed:{"id":"conversation_example","contactId":"contact_example","status":"CLOSED","pausedForHuman":false}
Mesajlar: ayrıca seçilmelidir
Mesaj olayları yüksek hacim oluşturabilir. message.sent, gönderilmemiş taslağı değil SENT, DELIVERED veya READ durumuna ulaşan mesajı belirtir.
message.received:{"id":"message_example","conversationId":"conversation_example","direction":"INBOUND","contentType":"TEXT","text":"Yarın için randevu alabilir miyim?"}message.sent:{"id":"message_reply","conversationId":"conversation_example","direction":"OUTBOUND","contentType":"TEXT","text":"Hangi saat size uygun?"}
Metin 16.000 karakterle sınırlıdır. Ham sağlayıcı nesneleri, medya kimlik bilgileri ve iç meta veriler eklenmez.
Randevular
booking.created onaylanmış randevudur. booking.cancelled durumun CANCELLED olmasıdır. booking.rescheduled onaylı randevunun başlangıç veya bitiş saatinin değişmesidir.
{"id":"booking_example","reference":"public_reference","startAt":"2026-11-13T09:00:00Z","endAt":"2026-11-13T09:30:00Z","timezone":"Europe/Istanbul","status":"CONFIRMED","customer":{"name":"Ada","phone":"+905550000000","email":"ada@example.com","contactId":"contact_example"}}booking.cancelled için status CANCELLED olur. booking.rescheduled yeni saatleri içerir. Müşteri alanları null olabilir.
Telefon aramaları
call.completed, telefon asistanı oturumuna bitiş zamanı yazıldığında oluşur.
{"id":"call_example","startedAt":"2026-11-12T12:00:00Z","endedAt":"2026-11-12T12:02:00Z","durationSeconds":120,"outcome":"COMPLETED","reason":"normal"}Kayıt adresi, özel döküm, ödeme bilgisi ve yapay zekâ belleği gönderilmez. Hesap sahibi belirli alıcı için maskelenmiş dökümü açabilir. Hazırlama anında mevcut ve süresi dolmamışsa data.transcript eklenir. Çok büyük veya erişilemeyen döküm eklenmez. Varsayılan kapalıdır; toplam içerik 256 KB ile sınırlıdır. Alıcının erişimini kısıtlayın ve müşteri bilgilendirmesi ile saklama politikanızı uygulayın.
Döküm eklemeyi kapatmak bekleyen yeniden denemelerden de dökümü çıkarır. Kişi silme işlemi ilgili yerel olay ve gönderim kopyalarını kaldırır; alıcıların daha önce kabul ettiği kopyaları kendi silme süreçleriyle yönetin.
Döküm girdileri {"role":"user","text":"maskelenmiş sözler"} veya {"role":"assistant","text":"yanıt"} biçimindedir. Sistem turları, araç parametreleri ve araç sonuçları eklenmez.
Yorumdan DM
comment_delivery.delivered: yorum / DM anahtar kelimesi / hikâye cevabı kuralı içeriği teslim etti (ya da DM'yi asistana devretti).comment_delivery.lead_collected: takipçi bu yolculukta ilk kez e-posta ya da telefon yazdı.consentAt, izin sorusunu cevapladığı andır.
{"id":"delivery_example","ruleId":"rule_example","ruleName":"Ücretsiz rehber","source":"COMMENT","email":"ada@example.com","phone":null,"follows":"yes","consentAt":"2026-11-14T10:02:00Z","deliveredAt":"2026-11-14T10:02:05Z"}source değeri COMMENT, DM_KEYWORD ya da STORY_REPLY; follows değeri yes, no, unknown ya da null olur. Yorum metni ve takipçinin Instagram kimliği gönderilmez.
Yeniden deneme, tekrarları önleme ve günlük
Olayı kalıcı olarak kabul ettikten sonra 2xx döndürün. HTTP başarısı, CRM işleminin tamamlandığını değil alıcının kabulünü gösterir. Zarfın id alanıyla, gerekirse çalışma alanı + kimlik kullanarak tekrarları önleyin. Manuel yeniden gönderme de aynı kimliği kullanır. Teslimat en az bir kezdir; zaman aşımı tekrara neden olabilir. Sıra garantisi yoktur.
Zaman aşımı 10 saniyedir. Başarısız denemeler yaklaşık 1 dakika, 5 dakika, 30 dakika, 2 saat, 6 saat ve 12 saat sonra ±%20 rastgele sapmayla tekrarlanır. Toplam teslimat penceresi 24 saattir. 410 alıcıyı hemen kapatır. 24 saat süren kesintisiz hata dönemi de alıcıyı kapatıp hesap sahibine panel/push bildirimini oluşturur. Başarılı bir gönderim bu hata dönemini sıfırlar. Yönlendirmeler izlenmez. Özel ağ, metadata ve link-local adresleri bağlantı sırasındaki DNS kontrolünde engellenir.
Ayarlar → Geliştirici son 30 gündeki son 50 gönderimin durumunu, deneme sayısını, HTTP kodunu ve süresini gösterir. Yanıtın en fazla 1 KB kısmı saklanır; başlıklar saklanmaz. Yeniden gönder, aynı olay kimliği ve gövdeyle yeni deneme süreci başlatır. Test olayı gönder, seçili olaylardan bağımsız olarak data.test: true içeren örnek contact.created gönderir. Bağlantıyı durdurmak için alıcıyı kapatın/silin veya API anahtarını iptal edin.
Zapier → HubSpot veya Google Sheets
- Yeni Zap oluşturun; Webhooks by Zapier → Catch Hook seçin. Test adımındaki adresi kopyalayın. Olay kimliğini korumak için alt alan seçimini boş bırakın.
- Blinkerbot → Ayarlar → Geliştirici bölümüne adresi ekleyin;
lead.capturedseçip imza anahtarını saklayın. - Blinkerbot'tan test olayı gönderip Zapier tetikleyicisini test edin.
- HubSpot kişi işlemi veya Google Sheets satır işlemi ekleyin.
data.name,data.phone,data.emailve zarfınidalanını eşleyin. - Zarf kimliğiyle tekrarları önleyin, Zap'i açın ve gerçek bir adayla kontrol edin.
Catch Hook JSON ayrıştırır; HMAC imzasını sizin yerinize doğrulamaz. Doğrulama için önüne kendi doğrulayıcı sunucunuzu koyun veya Catch Raw Hook ile özgün gövde/başlıkları CRM işleminden önce doğrulayın. Alıcı adresini gizli tutun. Zapier webhook rehberi.
Make → Bitrix24, Kommo veya Google Sheets
- Yeni senaryoda Webhooks → Custom webhook → Add seçin; kaydedip HTTPS adresini kopyalayın.
- Doğrudan abonelik için Make'in isteğe bağlı API anahtarı doğrulamasını kapalı bırakın: Blinkerbot
x-make-apikeyyerine kendi imza başlığını gönderir. Ek başlık gerekiyorsa doğrulayıcı ara sunucu kullanın. - Adresi Blinkerbot'a kaydedin;
lead.capturedseçip alanları tanıtmak için test olayı gönderin. - CRM veya Google Sheets modülünü ekleyin;
dataalanlarını eşleyin ve tekrar kontrolü için zarfınidalanını saklayın. - Senaryoyu açıp gerçek bir adayla deneyin. HMAC doğrulaması gerekiyorsa Make'e iletmeden önce ham baytları ara sunucuda doğrulayın.
n8n Webhook + HTTP Request
- POST yöntemli Webhook düğümü ve bir yol ekleyin. Herkese açık HTTPS sunucu kullanın.
- Test sırasında Listen for Test Event seçip Test URL adresini Blinkerbot'a kaydedin. Test olayı gönderin.
- CRM işlemlerinden önce özgün ham gövde ve başlıklarla HMAC doğrulayın; alıcıda ham gövde işlemeyi açın veya doğrulayıcı ara sunucu kullanın. Zarfın
idalanıyla tekrarları önleyin. - CRM için HTTP Request düğümü ekleyin. Blinkerbot okumak için
https://api.blinkerbot.com/v1/contactsadresini ve n8n kimlik bilgisi olarak saklanan Bearer API anahtarını kullanın. - İş akışını yayımlayıp geçici Blinkerbot alıcısını Production URL ile değiştirin. Tekrar test edin. Test ve üretim adresleri farklıdır.