Konuşma oluştur
Kapsam: conversations:write. Kişiyi contact_uuid ya da kendi kullanıcı numaranızla contact_external_id olarak verin. Kişi ve kanal (inbox_uuid) anahtarın organizasyonuna ait olmalı ve kanal etkin olmalıdır. Web widget kanalında kişi siteye girip identify ile oturum açtığında konuşmayı görür. Konuşma, anahtarı oluşturan üyeye atanır. Idempotency-Key zorunludur.
integrationKeyAuthorizationBearer <cf_sk_…>Organizasyon API anahtarı (cf_sk_…). Organizasyon → API ve otomasyonlar → API anahtarları sayfasında oluşturulur; Authorization: Bearer cf_sk_… başlığıyla gönderilir.
Idempotency-Key*stringlength <= 200application/json- body
Kişiyi contact_uuid ya da contact_external_id (kendi sisteminizdeki kullanıcı numarası) ile verin, ikisini birden değil. Widget kanalında dış kimlikli kişi widget kimliğini alır; temsilci önce yazabilir, siteye giriş yapan kullanıcı konuşmayı sitede bulur.
contact_uuid?stringuuidcontact_external_id?stringlength <= 200inbox_uuid*stringuuidsubject*string1 <= length <= 500Başarılı
application/json- response
success*booleandata*meta*curl -X POST 'https://api.getclickfix.com/v1/public-api/conversations' \ -H 'Idempotency-Key: workflow-42-step-1' \ -H 'Content-Type: application/json' \ -d '{ "contact_external_id": "1001", "inbox_uuid": "c2a9d7e4-1f3b-4c5d-8e6f-7a8b9c0d1e2f", "subject": "Delivery question"}'{ "success": true, "data": { "uuid": "8f0e5c2a-6b1d-4f3a-9c7e-2d4b6a8c0e1f", "number": 1042, "status": "open" }, "meta": { "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB" }}