Onaylar ve insan denetimi

Bu rehberde: Ajanların ürettiği içeriğin yayınlanmadan önce nasıl size sorulduğunu öğrenirsiniz. Onaylar sayfasını kullanır, onay kutusunu ayarlar ve chatbot'un insana devrini anlarsınız.

⏱ 12 dakika

Neden onay?#

Ajanlar hızlı ve ucuzdur. Ama yayınlanacak bir gönderi, gönderilecek bir e-posta veya değişecek bir strateji için son sözü insanın söylemesi çoğu ekip için kuraldır. OrqLabs bunu dört yerde sağlar:

1. Onay kutusu (utility.approval): iş akışında açık bir onay adımı.
2. Bekle kutusu (logic.wait, onay veya yanıt modu): onay ya da müşteri yanıtı bekler.
3. Ajan ayarları: Social Publisher ve Outreach'te "onay gerektir"; Community Manager'da "otomatik yanıt"; Analytics Strategist'te "otomatik uygula".
4. Konuşma devri: Chatbot emin değilse konuşmayı insana verir.

Onaylar sayfası#

Sol menüden Onaylar sayfasını açın. Sizi bekleyen kararlar listelenir.

Her kartta (①): başlık, açıklama, kaynak iş akışı ve kutu, oluşturulma zamanı, kalan süre, öğe önizlemesi (görsel varsa gösterilir).

1. ②'deki alanda metni düzenleyin. Düzenleme izniniz varsa değişikliğiniz orijinalin yerine geçer.
2. ③ Onayla düğmesine basın. İş akışı "onaylandı" dalından devam eder.
3. Ya da ④ Reddet düğmesine basın; isterseniz yorum yazın. İş akışı "reddedildi" dalından devam eder.

Birden fazla kartı seçip toplu onaylayabilirsiniz.

Onay istekleri bildirim olarak da gelir. E-posta veya Slack bildirimi için onaydan önce bir Bildir kutusu ekleyin ya da Ayarlar → Bildirimler'den kanal açın.

Yetki: Üye ve üstü onaylayabilir; İzleyici yalnızca görür. Kimin onayladığı denetim günlüğüne yazılır.

Geliştirici notu: GET /orgs/:orgId/approvals?status=PENDING; POST /orgs/:orgId/approvals/:id/approve { editedPayload?, comment? }; POST /orgs/:orgId/approvals/:id/reject { comment? }. Olaylar: approval.requested, approval.resolved.

Onay kutusu (utility.approval)#

İş akışında bir onay adımı eklemek için paletten Onay kutusunu sürükleyin.

İki çıkışı vardır: approved (onaylandı) ve rejected (reddedildi).

Kutu her gelen öğe için ayrı bir onay görevi açar. 3 platformluk içerik = 3 onay. Çalıştırma Bekliyor durumuna geçer; sistem kaynak tüketmez. Karar geldiğinde aynı çalıştırma kaldığı yerden devam eder.

Düzenleme açıkken onaylayanın yazdığı metin öğenin verisinin yerine geçer; sonraki kutular düzenlenmiş metni görür. Red durumunda öğe rejected çıkışına rejectionComment alanıyla gider.

İçerik onayları#

İçerik → Onaylar sekmesi sosyal gönderilere özel görünümdür.

Bir gönderi şu durumlarda burada bekler: Zamanla kutusunda "önce onay gerekir" açıksa veya Content Creator taslakları Social Publisher'a "onay gerektir" ile gittiyse.

• ④ Onayla: zamanlanmış tarih varsa gönderi "Zamanlandı", yoksa hemen yayınlanır.
• Reddet: gönderi taslak kalır.
• Şimdi yayınla: bekleme olmadan yayınlar.

Dikkat: İş akışında Onay kutusu kullanıyorsanız Social Publisher'da Require human approval kapalı olsun. Aksi hâlde iki kez onay istenir. Şablonlar böyle kurgulanmıştır.

Bekle kutusu (logic.wait)#

Onay kutusu iki dallı yönlendirme sunar; Bekle (onay) tek dal döner ve kararı öğeye yazar. Takip mesajları için Yanıt modu idealdir: yanıt gelmezse 3 gün sonra ikinci mesaj.

Ajan düzeyinde onay ayarları#

Konuşma devri#

Chatbot şablonunda: chatbot → Eğer ({{ $json.handoff === true }}) → İnsana devret. Devir kutusu konuşmayı "İnsan" durumuna alır, botu susturur ve ekibe bildirir. Siz Gelen Kutusu'ndan yanıtlarsınız; işiniz bitince Bota geri ver dersiniz.

Ayrıntı: Gelen kutusu ve insan devralma.

Tasarım önerileri#

• Onayı pahalı veya geri alınamaz adımın hemen önüne koyun: yayın, gönderim, strateji yazma, CRM'e yazma.
• Kalabalık onay kuyruklarını önlemek için Süz kutusuyla yalnızca riskli öğeleri onaya gönderin. Örneğin: {{ $json.contentType === "promotional" }}. Geri kalanı doğrudan geçirin ve Birleştir ile toplayın.
• Otomatik red süresini ekibin ritmine göre ayarlayın. Cuma üretilen içeriğin Pazartesi'ye kadar beklemesi için 72 saat yeterlidir.
• Red dalını boş bırakmayın. En azından Bildir kutusuyla nedenini kayda geçirin veya Content Creator'a {{ $json.rejectionComment }} ile yeniden üretim isteyin.
• Onay bekleyen çalıştırmalar kota tüketmez. Ama çok birikirse listeyi temizleyin; süresi dolanlar otomatik reddedilir.

API ile onaylama#

Onayları kendi aracınızdan yönetmek için API anahtarıyla:

curl -H "X-Api-Key: af_live_..." "https://api.orqlabs.com/api/v1/orgs/$ORG/approvals?status=PENDING"
curl -X POST -H "X-Api-Key: af_live_..." -H "Content-Type: application/json" \
  "https://api.orqlabs.com/api/v1/orgs/$ORG/approvals/$ID/approve" \
  -d '{"editedPayload":{"body":"Düzenlenmiş metin"},"comment":"Başlık kısaltıldı"}'

approval.requested olayını giden webhook'a bağlayarak Slack'te tek tıkla onay akışı kurabilirsiniz. Bkz. Giden webhook'lar.

Sık sorulan sorular#

Onaylamayı unutursam ne olur? 72 saat (veya belirlediğiniz süre) sonra otomatik reddedilir. İş akışı "reddedildi" dalından devam eder.

Onayı telefonumdan verebilir miyim? Evet. Panel telefonda çalışır. Bildirimdeki bağlantı doğrudan Onaylar sayfasına gider.

Onayladığım metni sonradan değiştirebilir miyim? Zamanlanmış gönderiyi İçerik sayfasından yayınlanmadan önce düzenleyebilirsiniz.

Bir ekip arkadaşım onaylayabilir mi? Üye ve üstü rolde herkes onaylayabilir. Kim onayladı, denetim günlüğünde görünür.

Sonraki adım#

• Yardımcı node'lar
• Mantık node'ları – Bekle
• Social Publisher
• Gelen kutusu ve insan devralma