Webhook'lar ve Zapier

Fluxy uygulamasını iki parçayla her şeye bağlayın:

Tetikleyiciler — olayları (yeni konuşma, nitelikli lead, ödeme…) bir HTTPS adresine POST ederiz.
Aksiyonlar — otomasyonunuz bir API anahtarıyla API’mizi çağırıp konuşma bulur, mesaj gönderir, devralır ya da geri verir.

Burada Zapier’e özel bir şey yok: Make, n8n ya da kendi betiğiniz aynı uç noktaları kullanır.

Zapier

Zapier’de Fluxy uygulamasını kullanın. Bağlarken API adresini (https://api.getfluxy.io) ve bir API anahtarını (ml_live_…) girin. Sonra bir tetikleyici (aşağıdaki olaylardan biri) ya da aksiyon (konuşma bul, mesaj gönder, devral, geri ver) seçin.

Olaylar

Olay	Ne zaman
`conversation.opened`	Herhangi bir kanalda yeni konuşma başladı
`conversation.qualified`	Konuşma ilk kez Nitelikli ya da ötesine ulaştı
`conversation.handed_over`	Bir insan devraldı
`conversation.closed`	Konuşma bir insan ya da asistan tarafından kapatıldı
`message.received`	Müşteri yazdı
`message.sent`	Asistan ya da ekipten biri cevap verdi
`payment.paid`	Konuşmada oluşturulan ödeme linki ödendi

API ile abone olma

Yöntem	Yol
`GET`	`/api/hooks/events`	Olay listesi
`POST`	`/api/hooks`	Gövde `{"event","target_url","source"}` → aboneliği `secret` ile (bir kez gösterilir) döner
`GET`	`/api/hooks`	Abonelikleriniz
`DELETE`	`/api/hooks/{id}`	Abonelikten çık
`GET`	`/api/hooks/{id}/deliveries`	Son teslimatlar ve hatalar
`GET`	`/api/hooks/sample?event=…`	Alan adları birebir aynı örnek veri

target_url https:// olmalı ve herkese açık bir adrese çözülmeli. Çalışma alanı başına en fazla 25 abonelik.

Teslimat

POST <target_url>
Content-Type: application/json
X-Fluxy-Signature: t=<unix>,v1=<hmac_sha256(secret, "<t>.<body>")>
X-Fluxy-Event: conversation.qualified
X-Fluxy-Delivery: evt_…

İmzayı bir özel araçtaki gibi doğrulayın.
X-Fluxy-Delivery ile tekilleştirin (verideki id).
10 saniye içinde 2xx dönün. 5xx ya da ağ hataları üç kez yeniden denenir; 4xx denenmez (410 “bu hook’u kaldır” demektir).
Arka arkaya beş başarısız teslimattan sonra abonelik API anahtarları ekranında failing görünür; teslimatlar sürer.

Veri

{
  "id": "evt_3f9c…",
  "event": "conversation.qualified",
  "occurred_at": "2026-09-25T09:18:50+00:00",
  "workspace": "calisma-alaniniz",
  "conversation": {
    "id": "c0ffee…",
    "agent_id": "satis-asistani",
    "channel": "whatsapp_cloud",
    "contact_display": "+90 5•• ••• 12 34",
    "contact_name": "Ayşe",
    "status": "ai_active",
    "funnel_stage": "qualified",
    "message_count": 6
  },
  "funnel": { "stage": "qualified", "previous_stage": "engaged" }
}

conversation her olayda vardır; funnel yalnızca conversation.qualified’da, message yalnızca message.*’da, payment yalnızca payment.paid’de, outcome yalnızca conversation.closed’da gelir. İletişim bilgileri her zaman maskelidir — ham telefon numarası ya da e-posta asla gönderilmez.

Aksiyonlar

Aksiyon	Çağrı
Konuşma bul	`POST /api/contacts/lookup`, gövde `{"phone":"…"}` ya da `{"email":"…"}`
Konuşmayı oku	`GET /api/conversations/{id}`
Mesaj gönder	`POST /api/conversations/{id}/messages`, gövde `{"text":"…"}` — devralma gibi asistanı duraklatır
Devral / geri ver	`POST /api/conversations/{id}/takeover` · `/handback`
Özetle kapat	`POST /api/conversations/{id}/close`, gövde `{"summary":"…","verdict":"goal_reached"}`