İçeriğe geç
Dokümantasyon
GeliştiricilerAPI başvurusuAPI kanalı

Müşteri mesajı gönder

POST
/v1/webhooks/channels/api/{instance}

API kanalına bir müşteri mesajı gönderir. Kanal Kanallar → Kanal ekle → API ile kurulur; kurulumda gelen adresi ({instance}), imza anahtarını ve temsilci yanıtlarının gönderileceği adresi alırsınız.

İstek API anahtarıyla değil kanalın imza anahtarıyla doğrulanır: X-ClickFix-Timestamp (Unix saniye) ve X-ClickFix-Signature: sha256= + hex(HMAC-SHA256(imza_anahtarı, timestamp + "." + ham_gövde)). Zaman damgası 5 dakikadan eskiyse istek reddedilir. Aynı id ile gelen mesaj bir kez kaydedilir. 5xx yanıtında tekrar deneyin.

Yetkilendirme

apiChannelSignature
headerX-ClickFix-Signature<token>

API kanalının imza anahtarıyla hesaplanan sha256= + hex(HMAC-SHA256(secret, timestamp + "." + ham_gövde)). X-ClickFix-Timestamp (Unix saniye) başlığıyla birlikte gönderilir.

Yol parametreleri

instance*string

Kanal kurulumunda verilen kanal kimliği.

Başlık parametreleri

X-ClickFix-Timestamp*string

İmzalama anı (Unix saniye).

İstek gövdesi

application/json
  1. body
id*string

Kanal içinde tekil ve sabit mesaj kimliği

Length1 <= length <= 255
sender_id*string
Length1 <= length <= 255
sender_name?string
text*string
Length1 <= length <= 32000
thread_id?string
Lengthlength <= 255
reply_to?string
at?string
Formatdate-time

Response Body

Mesaj alındı.

application/json
  1. response
success*true
Value intrue
data*
meta*
Örnek istek
curl -X POST 'https://api.getclickfix.com/v1/webhooks/channels/api/string' \  -H 'X-ClickFix-Timestamp: 1761732900' \  -H 'Content-Type: application/json' \  -d '{  "id": "msg-1001",  "sender_id": "customer-42",  "sender_name": "Ayşe Yılmaz",  "text": "When will my order arrive?"}'
Örnek yanıt
{  "success": true,  "data": {    "received": true,    "conversation_uuid": "8f0e5c2a-6b1d-4f3a-9c7e-2d4b6a8c0e1f"  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}