Geliştiriciler
Zapier, Make, n8n ve uygulamalar
ClickFix'i Zapier, Make ve n8n ile otomasyonlara bağlayın; kendi araçlarınızı panele uygulama olarak ekleyin.
Bu sayfa ClickFix'i dış araçlarla nasıl bağlayacağınızı anlatır:
- Zapier, Make ve n8n: REST hook abonelikleri, tetikleyici yoklama ve API eylemleri.
- Uygulamalar: Kendi web uygulamanızı veya galerideki araçları konuşma kenar çubuğunda, kişi panelinde veya menüde açmak.
Zapier, Make ve n8n
Otomasyon araçları ClickFix'in herkese açık API'sini kullanır. Hazırlık:
- Organizasyon → API ve otomasyonlar sayfasında bir API anahtarı oluşturun. Otomasyon araçları için genellikle şu kapsamlar yeterlidir:
triggers:read,webhooks:write,conversations:write,contacts:write. - Temel adres:
https://api.getclickfix.com/v1/public-api - Her istekte
Authorization: Bearer cf_sk_...başlığını gönderin. - Tüm yazma isteklerinde benzersiz bir
Idempotency-Keybaşlığı kullanın; tekrar denemede aynısını gönderin.
Tetikleyici olaylar
| Olay | Ne zaman |
|---|---|
conversation.created | Yeni konuşma açıldığında |
conversation.resolved | Konuşma çözüldüğünde |
contact.created | Yeni kişi oluştuğunda |
csat.submitted | Müşteri memnuniyet puanı verdiğinde |
conversation.tag_added | Konuşmaya etiket eklendiğinde |
REST hook (anlık)
Akış açıldığında abone olun, kapandığında aboneliği silin:
| İşlem | Uç nokta | Kapsam |
|---|---|---|
| Abone ol | POST /subscriptions | webhooks:write |
| Abonelikten ayrıl | DELETE /subscriptions/{uuid} | webhooks:write |
Abone olma gövdesi:
{
"name": "Zap: yeni konuşma",
"url": "https://hooks.ornek.com/receiver",
"events": ["conversation.created"],
"enabled": true
}
Yanıttaki data.uuid değerini ayrılmak için, data.secret değerini imza doğrulama için saklayın. Etkin abonelikler panelde REST hook abonelikleri sekmesinde görünür; buradan silinen aboneliğe gönderim durur.
Tetikleyici yoklama
REST hook kullanamayan araçlar için yoklama:
curl "https://api.getclickfix.com/v1/public-api/triggers?event=conversation.created&cursor=0" \
-H "Authorization: Bearer cf_sk_..."
- Her sayfa en fazla 100 öğe içerir ve organizasyon içindeki sıraya göre artan düzendedir.
- İşledikten sonra
data.next_cursordeğerini saklayın ve bir sonraki çağrıda kullanın.has_moredoğru olduğu sürece devam edin. - Öğeler olay kimliği, olay adı, ilgili kaydın kimliği ve olay zamanını içerir. Ayrıntıları normal API ile okuyun.
- Geçmiş 30 gün tutulur.
410 CURSOR_EXPIREDyanıtı alırsanız verilerinizi yeniden eşitleyipcursor=0ile başlayın.
Eylemler
| İşlem | Uç nokta | Kapsam |
|---|---|---|
| Konuşma oluştur | POST /conversations | conversations:write |
| İç not ekle | POST /conversations/{uuid}/messages | conversations:write |
| Kişiyi güncelle | PATCH /contacts/{uuid} | contacts:write |
Örnek gövdeler için API hızlı başlangıç sayfasına bakın.
Araç bazında
- Zapier: Abone ol / ayrıl ve liste için yukarıdaki uç noktaları bir REST hook tetikleyicisine bağlayın; eylemler için HTTP isteklerini kullanın.
- Make: Custom webhook modülüyle aynı abone ol / ayrıl isteklerini ve HTTP eylemlerini kullanın.
- n8n: HTTP Request düğümüyle aynı uç noktaları çağırabilirsiniz. Bir topluluk düğümü paketlemek isterseniz düğüm ve kimlik bilgisi tanımları GitHub'daki integrations/n8n klasöründe bulunur.
ClickFix'in Zapier, Make veya n8n mağazalarında yayımlanmış resmi bir uygulaması henüz yoktur; bağlantılar yukarıdaki genel HTTP / webhook modülleriyle kurulur.
Uygulamalar
Kendi web uygulamanızı (sipariş paneli, CRM kaydı, fatura geçmişi gibi) konuşma kenar çubuğunda, kişi panelinde veya menüde açabilir; galeriden Calendly, Uptime Kuma, Metabase gibi araçları tek tıkla kurabilirsiniz. Uygulamalar Organizasyon → Uygulama yönetimi sayfasından yönetilir.
Bağlam belirteci, imza doğrulama, mesajlar, tema ve yayınlama adımları için Kendi uygulamanızı yapın rehberine bakın.