Webhook endpoint'i nasıl oluştururum?

POST https://api.unipile.com/v2/webhooks/endpoints/, X-API-KEY başlığıyla ve trigger_events ile url içeren bir body ile. Yanıt, we_… biçiminde bir id ve bir secret taşır.

Bir webhook'u tek bir müşterinin hesaplarıyla nasıl sınırlarım?

account_ids ile: acc_… biçiminde tanımlayıcılardan oluşan bir dizi. Gönderilmezse veya boş bırakılırsa endpoint uygulamanın tüm hesaplarını dinler.

Unipile MCP · Webhook'lar

LinkedIn, WhatsApp ve e-posta webhook'larını bir kodlama ajanıyla kurun

Q: Bir bildirimin gerçek olduğunu nasıl doğrularım?

Endpoint oluşturulduğunda bir secret döner. Bunu sunucu tarafında saklayın ve her teslimatı işlemeden önce doğrulayın. URL'niz HTTPS olmalı ve herkese açık erişilebilir olmalıdır; teslimat kaydı webhook konuşmaları rotasında bulunur.

LinkedIn, üyelerin mesajları için herkese açık bir webhook sunmaz. Unipile bu mesajları endpoint'inize iletir; Unipile MCP sunucusu sayesinde handler'ı ajanınız yazar.

Webhook'ları bir ajanla kurun Webhook dokümantasyonu

7 gün ücretsiz deneme, kredi kartı gerekmez.

Yeni mesaj webhook'larına abone ol ve kişi zaman akışını güncelle.

İstek çalıştırılıyorPOST /v2/webhooks/endpoints/201 · we_…

Endpoint Development uygulamasında oluşturuldu; idempotent, kuyruklu bir handler eklendi.

3 dosya değişti · ilk olay bir saniyeden kısa sürede alındı

Sonraki özelliği anlatın…

İş

Yapmak istediğiniz şey

Yeni bir mesajı veya e-postayı geldiği anda ürününüzde gösterin ve bir hesabın bağlantısı koptuğunda polling yapmadan tepki verin. LinkedIn'in bir üye hesabı için herkese açık mesaj webhook'u yoktur; Unipile her kanal için aynı olayı iletir.

Yeni LinkedIn mesajıkullanıcınızın bağladığı hesapta

Yeni WhatsApp mesajıaynı olay, başka kanal

Yeni e-postaGmail, Outlook veya IMAP

message.newmessage.newemail.new

Uygulamanız · kişi zaman akışıPOST /webhooks/unipile

Sarah K. LinkedIn'de yanıt verdi0.4 s

Tom R. WhatsApp mesajı gönderdi0.3 s

Ana L. teklifi e-postayla gönderdi0.5 s

Kuyruğa alındı, tekilleştirildi, bir kez yazıldı

Onsuz Polling döngüleri ve kör noktalar

Her hesabı otuz saniyede bir sorgulayan, çoğu zaman boşuna çalışan bir iş.

Hiç LinkedIn mesaj olayı yok, çünkü platform bir üye hesabı için bunu sunmuyor.

Bağlantısı kopan bir hesabı ürününüz değil, kullanıcı fark ediyor.

Unipile MCP sunucusuyla Uygulamanızdaki sonuç

Development uygulamanızda oluşturulmuş, yönettiğiniz olaylara abone bir webhook endpoint'i.

Hemen yanıt veren, işlemeyi kuyruktan yapan ve her olayı bir kez yazan bir handler.

Yayına almadan önce test edilmiş, bir saniyeden kısa sürede güncellenen kişi zaman akışı ve hesap durumu.

Prompt, adımlar, kod

Ajanınıza prompt'u verin

İki prompt; her birinde ajanın okuyup çalıştırdığı Unipile endpoint'leri ve projenize eklenenler yer alır. Yollar eksiksiz verilmiştir; API temel URL'si: https://api.unipile.com, Scope'a bağlı anahtarınız ise X-API-KEY başlığında.

Ajanınız · crm-appDevelopment uygulaması

Unipile yeni mesaj webhook'larına abone ol ve kişi zaman akışını güncelle: message.new ve email.new için webhook endpoint'ini oluştur, bu uygulamaya idempotent bir handler ekle ve işlemeyi kuyruğa al.

Endpoint okunuyorPOST /v2/webhooks/endpoints/şema yüklendi

İstek çalıştırılıyorPOST /v2/webhooks/endpoints/201 · we_… + secret

Endpoint şu değerle oluşturuldu: trigger_events: ["message.new", "email.new"] ve uygulamanın herkese açık URL'si; dönen secret değeri sunucu tarafında saklandı; teslimatı doğrulayan, hemen 200 yanıt veren ve payload'u kuyruğa ekleyen POST /webhooks/unipile eklendi; ayrıca kişi zaman akışına yazmadan önce nesne ID'sine göre tekilleştirme yapan bir worker yazıldı. Development uygulamasında test mesajı gönderildi: zaman akışı güncellendi.3 dosya değişti · kuyruklu, idempotent, doğrulandı

Önce onaylayın, sonra işleyin, bir kez yazın

Ajan endpoint sözleşmesini sunucu üzerinden okur: trigger_events ve url zorunludur, account_ids kapsamı daraltır ve yanıt, endpoint ID'sini ve secret değerini taşır. Ardından handler'ı bir webhook'un gerektirdiği şekilde yazar: anında 2xx, asenkron işleme, nesne tanımlayıcısına göre tekilleştirme ve bir şey eksik göründüğünde teslimat kaydının kontrolü.

Ajanın kullandığı endpoint'ler

POST/v2/webhooks/endpoints/GET/v2/webhooks/endpoints/GET/v2/webhooks/conversations/GET/v2/{account_id}/chats/{chat_id}/messages/{message_id}

Sık yapılan hata: İşi handler'ın içinde yapmak. Hemen 2xx yanıt verin ve olayı bir kuyruktan işleyin; aksi halde teslimatlar zaman aşımına uğrar ve yeniden denenir.

Bu olaylarla birleşik bir inbox besleyin

Ajanınız · crm-appDevelopment uygulaması

Hesap yaşam döngüsü webhook'larını ele al: account.status.disconnected geldiğinde hesabı ilgi gerektiren olarak işaretle ve bir Yeniden bağlan butonu göster; account.add geldiğinde yeni account_id değerini state içinde taşınan çalışma alanına kaydet.

Endpoint okunuyorPOST /v2/webhooks/endpoints/olay enum'u

İstek çalıştırılıyorPATCH /v2/webhooks/endpoints/{id}200 · olaylar güncellendi

Eklendi: account.add, account.reconnect ve account.status.disconnected olayları endpoint'e. account.add geldiğinde worker account_id değerini, şu alanda belirtilen çalışma alanına kaydeder: state; öte yandan account.status.disconnected geldiğinde hesabı işaretler ve Ayarlar sayfası, Hosted Auth yeniden bağlanma rotasını çağıran Yeniden bağlan butonunu gösterir. Development uygulamasında mock hesabın bağlantısı kesilerek doğrulandı.2 dosya değişti · yeniden bağlanma arayüzde gösterildi

Hesap olayları Hosted Auth ile döngüyü tamamlar

account.add ve account.reconnect olayları, auth bağlantısını oluştururken belirlediğiniz state değerini taşır; bu da webhook'u yeni bir bağlantı için doğruluk kaynağı yapar. Durum olayları, bir hesabın ilgi gerektirdiğini kullanıcı fark etmeden ürününüze bildirir. Ajan ikisini de aynı endpoint'e bağlar ve handler'ı idempotent tutar.

Ajanın kullandığı endpoint'ler

PATCH/v2/webhooks/endpoints/{id}GET/v2/accounts/{account_id}POST/v2/auth/link

Sık yapılan hata: Her şeye abone olmak. Otuz dokuz olay var; hepsine abone bir endpoint durmaksızın okundu bilgileri ve izleme açılışları alır. Yalnızca yönettiğiniz olaylara abone olun.

Yeniden bağlanma akışını bir ajanla uygulayın

Payload

Endpoint body'si, yanıt ve olaylar

Ajanın sunucu üzerinden okuduğu v2 sözleşmesinden birebir. İki alan zorunludur, yanıt secret değerini taşır ve olaylar ailelere ayrılır.

1Endpoint'i oluşturuntrigger_events ve url zorunludur. account_ids endpoint'i belirli hesaplarla sınırlar; boş bırakılırsa veya gönderilmezse uygulamanın tüm hesaplarını dinler.POST https://api.unipile.com/v2/webhooks/endpoints/ { "trigger_events": ["message.new", "email.new", "account.add"], "url": "https://app.example.com/webhooks/unipile", "account_ids": ["acc_…"], "description": "crm timeline" }

2Yanıtid'si, uygulaması, sunucu tarafında saklanacak secret değeri ve hedeflediği hesaplarla birlikte bir WebhookEndpoint.{ "object": "WebhookEndpoint", "id": "we_…", "application_id": "app_…", "enabled": true, "secret": "…", "trigger_events": [ … ], "account_targets": [ … ] }

3Ailelere göre olaylarHesap (status, add, reconnect, remove, sync), mesaj (new, update, delete, okundu bilgileri, tepkiler), sohbet, e-posta (new, bounce, delete, taslaklar, klasörler), takvim (create, update, delete, event.*), izleme ve ilişkiler.message.new · message.update · message.receipt.read · chat.update email.new · email.new.bounce · email.draft.new · email.folder.update account.add · account.reconnect · account.status.disconnected · account.initial_sync.completed

Development'tan production'a

Önce bir Development uygulamasında test edin

Unipile panelinizde Development uygulaması Production'dan ayrıdır. Ajana Development'tan Scope'a bağlı bir anahtar, bir test hesabı ve bir tunnel URL'si verin: gerçek olaylar, gerçek müşteri yok.

1Endpoint'i Development uygulamasında oluşturunTunnel URL'si, trigger_events yalnızca yönettiğiniz olaylarla sınırlı.

2Bir olayı uçtan uca alınMock bir Hosted Auth bağlantısından account.add, ardından test hesabından message.new.

3Tekrar oynatın, ardından anahtarı değiştirinWorker bir kez yazar; Production'dan önce account_ids doğru müşteriyle sınırlandırılır.

crm-app · DevelopmentAjanınız tarafından kullanılır

Scopedev-tests · 2 hesap

AnahtarScope'a bağlı Account API anahtarı

HesaplarLinkedIn test hesabı, Gmail test posta kutusu

Webhook'lar1 endpoint · mesaj olayları

crm-app · ProductionDokunulmaz

Scopeçalışma alanı başına bir tane

AnahtarScope'a bağlı anahtarlar, yalnızca backend'inizde

Hesaplarkullanıcılarınızın kendi hesapları, Hosted Auth ile

Sorun giderme

Sık görülen hatalar ve anlamları

Webhook'ları güvenilmez kılan dört hata ve her birinin çözümü. Hiçbiri olayların kendisiyle ilgili değil.

Endpoint yavaş yanıt veriyor

Teslimatlar zaman aşımına uğrar ve yeniden denemeler olarak birikir. ÇözümHemen 2xx yanıt verin ve bir kuyruktan işleyin. Yanıt vermeden önce veritabanına yazan bir handler, sonunda kendi birikimini yeniden oynatır.

Idempotent olmayan bir handler

Aynı mesaj zaman akışında iki kez görünür. ÇözümAynı olay birden fazla kez teslim edilebilir. Yazmadan önce payload'un taşıdığı nesne tanımlayıcısına göre tekilleştirin.

Her şeye abone olmak

Endpoint durmaksızın okundu bilgileri ve izleme açılışları alır. Çözümtrigger_events otuz dokuz değer kabul eder. Yönettiğiniz olaylara abone olun; işleme farklıysa birden fazla endpoint oluşturun.

Çok müşterili bir üründe account_ids unutulmuş

Bir müşterinin worker'ı başka bir müşterinin olaylarını alır. ÇözümBoş bırakılırsa veya gönderilmezse account_ids uygulamanın tüm hesaplarını dinler. Müşteri başına açıkça kısıtlayın veya yazmadan önce payload'daki hesaba göre filtreleyin.

6000+ Unipile ile inovasyon yapan şirketler

Sektör liderlerinin tercihi

1 API

Tüm büyük iletişim kanallarında operasyonları sadeleştirin

2 Gün

Minimum kurulumla hızla canlı entegrasyona geçin

30%

Bakım çabası ve kaynaklarında azalma

Yerleşik güvenlik ve uyumluluk

Verileriniz ve iş akışlarınız için kurumsal düzeyde koruma Güvenliğimiz hakkında daha fazla bilgi

SOC 2 Type II

Sertifikalı

Veri korumasını ve operasyonel bütünlüğü güvence altına alan, bağımsız olarak denetlenmiş güvenlik kontrolleri.

GDPR

Uyumlu

Kullanıcı gizliliği için Avrupa veri koruma düzenlemelerine tam uyum.

99.9%

Son 24 aydaki platform çalışma süresi

24/7

Yüksek performanslı API ile küresel destek

Webhook SSS

LinkedIn'in mesaj webhook'u olup olmadığı, endpoint nasıl oluşturulur, hangi olaylar vardır, bir endpoint tek müşteriyle nasıl sınırlanır ve bir teslimat nasıl doğrulanır.

Üye hesabı için yok. LinkedIn'in herkese açık webhook'ları kurumların sosyal etkileşimlerini ve lead formlarını kapsar; üye mesajları ise artık yeni iş ortağı kabul etmeyen bir uyumluluk programının arkasındadır. Unipile ile message.new olayı, diğer tüm kanallarda olduğu gibi LinkedIn'i de, kullanıcınızın kendisinin bağladığı hesap üzerinde kapsar.

POST https://api.unipile.com/v2/webhooks/endpoints/ çağrısında X-API-KEY başlığı bulunur, body ise şunları içerir: trigger_events ve url. Yanıt şunları taşır: bir id alanı, şu önekle: we_… ve bir secret.

Hesap, mesaj, sohbet, e-posta, takvim, izleme ve ilişki ailelerinde otuz dokuz değer. En çok kullanılanlar: message.new, email.new, account.add, account.reconnect ve account.status.disconnected.

Şu alanla: account_ids; biçimi şu olan tanımlayıcılardan oluşan bir dizi: acc_…. Gönderilmezse veya boş bırakılırsa endpoint uygulamanın tüm hesaplarını dinler.

Endpoint oluşturulduğunda bir secret döner. Bunu sunucu tarafında saklayın ve her teslimatı işlemeden önce doğrulayın. URL'niz HTTPS olmalı ve herkese açık erişilebilir olmalıdır; teslimat kaydı webhook konuşmaları rotasında bulunur.