Test kanalı: app-ı real müştərisiz sınamaq

Son yeniləmə: 11 noyabr 2026 · 6 dəq oxunur

Addımlar

1. 1

   Test kanalını yaradın

   Portalda «Test kanalı» bölməsini açın və workspace-in yanında «Test kanalı yarat» basın. Bunu yalnız həmin workspace-in administratoru edə bilər, bir workspace-də bir test kanalı olur. Workspace-də «Developer test kanalı» adlı API kanal yaranır. İstəsəniz demo söhbətlər də yaranır: onlar komandaya bildiriş göndərmir və avtomatlaşdırmanı işə salmır. Kanal paneldə başqa kanallar kimi görünür, onu açıb mesajlara baxa və cavab yaza bilərsiniz.

2. 2

   Müştəri mesajı göndərin

   POST /v1/test_channel/messages test kanalına müştəri adından mesaj yazır. Mesaj real gələn mesaj kimi işlənir: webhook-lar, hadisə lenti, sinxron və avtomatlaşdırma onu görür.

   • content: mesaj mətni, ən çox 5000 simvol.
   • conversation_id: ixtiyari, test kanalındakı söhbətin nömrəsi. Mesaj həmin söhbətə yazılır.
   • contact: ixtiyari, { "name", "identifier" }. Yeni söhbət açılır. Kontakt bu identifier ilə test kanalının öz kontaktıdır, yoxdursa yaranır.

   curl -X POST https://api.clomni.ai/v1/test_channel/messages \
     -H "Authorization: Bearer $CLOMNI_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "Salam, sifarişim harada qaldı?", "contact": {"name": "Test müştəri", "identifier": "crm-1001"}}'

   Cavab 201 və sinxron formasında mesajdır. Workspace-də test kanalı yoxdursa 404 test_channel_missing qayıdır. Köhnə ünvan /v1/sandbox/messages də işləyir.

3. 3

   Hansı token lazımdır

   Tokenə messages:send və ya conversations:write lazımdır. Bu iki scope test kanalında review-dan əvvəl də işləyir:

   1. App-a messages:send və ya conversations:write əlavə edin, review gözləmək lazım deyil.
   2. «Etimadnamələr» bölməsində token yaradın və bu scope-u seçin.
   3. Token test kanalına müştəri mesajı yaza bilir. Workspace-in qalan məlumatı üçün yalnız təsdiqlənmiş scope-lar işləyir.

   Public app-ı review-dan əvvəl sınamaq üçün onu app-ın öz workspace-ində, sahibi kimi qoşun: həmin workspace-də test kanalı olmalıdır. Təsdiqlənməmiş scope-lar orada da yalnız test kanalında işləyir.

4. 4

   Kənara heç nə getmir

   • Test kanalının webhook ünvanı yoxdur, ona ünvan yazmaq 403 test_channel_webhook qaytarır. Agentin cavabı Clomni-dən çıxmır.
   • Simulyasiya kontaktına yalnız ad yazılır: e-poçt və telefon yoxdur, kampaniya və məktub ona çatmır.
   • Mesaj yalnız test kanalına düşür, başqa kanalın söhbət nömrəsi 404 qaytarır.

   Workspace-in öz webhook-ları, avtomatlaşdırmaları və app-ınızın webhook-u bu mesajları real mesaj kimi görür. Avtomatlaşdırma qaydanız müştəriyə mesaj göndərirsə, o da test kanalının söhbətində qalır.

5. 5

   Test kanalını silin

   Portalda «Test kanalını sil» basın. Kanal və içindəki söhbətlər fonda silinir, paneldə kanal silinən kimi. Sonra yenisini yarada bilərsiniz.

6. 6

   Köhnə sandbox workspace

   9 noyabr 2026-dan əvvəl yaradılmış ayrıca sandbox workspace-lər işləməyə davam edir: tokenləri clomni_pat_test_ ilə başlayır, /v1/me workspace.sandbox: true qaytarır, kənara göndərən əməliyyatlar 403 sandbox_restricted verir. Paneldə belə workspace-də «Bu sandbox-dır: test məlumatı, real müştəriyə heç nə getmir.» zolağı görünür. Yenisi yaradılmır, köhnəsini portalın «Test kanalı» səhifəsində silmək olar.