GeliştiricilerAPI başvurusuAPI kanalı
Temsilci yanıtı (API kanalı)
Bir temsilci API kanalındaki konuşmayı yanıtladığında ClickFix, kanalda tanımladığınız adrese bu gövdeyle POST gönderir. İstek X-ClickFix-Timestamp, X-ClickFix-Signature (yukarıdaki imza yöntemi) ve Idempotency-Key (mesaj UUID'si) başlıklarını taşır; her anahtarı yalnızca bir kez işleyin. Mesajı kalıcı olarak kaydettikten sonra 2xx dönün. Geçici hatalar artan aralıklarla tekrar denenir; 408 ve 429 dışındaki 4xx yanıtları kalıcı hata sayılır.
X-ClickFix-Timestamp*stringUnix saniye
X-ClickFix-Signature*stringsha256= ve onaltılık HMAC-SHA256
Idempotency-Key*stringFormat
uuidapplication/json- body
Organizasyonun herkese açık webhook adresine zaman damgalı HMAC ve Idempotency-Key ile gönderilen JSON.
id*stringFormat
uuidconversation_id*stringFormat
uuidrecipient_id*stringtext*stringthread_id*stringreply_to*stringKalıcı olarak kabul edildi (tekrarlanan id dahil)
Örnek istekler
POST/apiChannelReply
Organizasyonun herkese açık webhook adresine zaman damgalı HMAC ve Idempotency-Key ile gönderilen JSON.
application/json
{ "id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f", "conversation_id": "8f0e5c2a-6b1d-4f3a-9c7e-2d4b6a8c0e1f", "recipient_id": "customer-42", "text": "Your order ships today.", "thread_id": "msg-1001", "reply_to": "msg-1001"}{ "X-ClickFix-Timestamp": "string", "X-ClickFix-Signature": "string", "Idempotency-Key": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}