# Botpress HITL Entegrasyonu
Bu entegrasyon, Botpress botunuzu Brevo'nun konuşma platformuna bağlamanıza olanak tanıyarak Döngüde İnsan (HITL) kurulumunu mümkün kılar. Bu, Botpress botunuzun ilk kullanıcı etkileşimlerini yönetebileceği ve gerektiğinde konuşmaları Brevo'daki insan temsilcilere sorunsuz bir şekilde yükseltebileceği anlamına gelir.
## Nasıl Çalışır
Bir kullanıcı Botpress botunuzla etkileşime girdiğinde, konuşma Brevo'daki bir insan temsilcisine aktarılabilir. Temsilci daha sonra görüşmeyi devralabilir ve kişiselleştirilmiş destek sağlayabilir. Botpress kullanıcısından gelen mesajlar Brevo aracısına iletilecek ve bunun tersi de geçerli olacaktır.
## Temel Sınırlamalar
Bu entegrasyonu kullanırken lütfen aşağıdaki sınırlamaların farkında olun:
- **Mesaj İlişkilendirme:** Botpress kullanıcısı tarafından Brevo aracısına gönderilen mesajlar, entegrasyonla yapılandırılan Brevo aracı hesabı tarafından gönderiliyormuş gibi görünecektir. Ancak, bu mesajları ayırt etmek için önlerineBotpress Kullanıcısı:" eklenecektir. Örneğin: Botpress Kullanıcısı: Merhaba, siparişimle ilgili yardıma ihtiyacım var.`
- Durum Güncellemeleri:** Botpress kullanıcısı, temsilci atamasıyla ilgili bildirimleri veya durum güncellemelerini otomatik olarak almayacaktır (örneğin, "Temsilci John sohbete katıldı").
## Kurulum Kılavuzu
Botpress HITL entegrasyonunu yapılandırmak için aşağıdakilere ihtiyacınız olacak:
1. **Brevo API Anahtarı:**
- Resmi yardım sayfalarındaki talimatları izleyerek Brevo API anahtarlarınızı oluşturabilir ve yönetebilirsiniz: [API anahtarlarınızı oluşturun ve yönetin](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **IP Engellemeyi Devre Dışı Bırakın:**
- Botpress ve Brevo arasında sorunsuz iletişim için, Brevo hesabınızda IP engellemeyi devre dışı bırakmak gerekir.
- Brevo IP Authorisation] (https://app.brevo.com/security/authorised_ips) adresine gidin ve Botpress ortamınızdan gelen isteklere izin vermek için IP engellemenin devre dışı bırakıldığından emin olun.
3. **Brevo Aracı Kimliği:**
- Entegrasyon tarafından mesaj göndermek ve almak için hangi Brevo aracı hesabının kullanılacağını belirtmeniz gerekir.
- Brevo aracıları ayarları sayfasına gidin: [Brevo Aracı Ayarları](https://conversations-app.brevo.com/settings/agents)
- Entegrasyon için kullanmak istediğiniz temsilciyi belirleyin ve Temsilci Kimliğini kopyalayın.
## Webhook Kurulumu (Gerekli)
Botpress entegrasyonunuzda Brevo'dan olay almak için Brevo'da bir webhook ayarlamanız gerekir:
1. Brevo kontrol panelinizde **Entegrasyonlar > Web kancaları** bölümüne gidin ([doğrudan bağlantı](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Yeni webhook öğesine tıklayın (veya mevcut olanı düzenleyin).
3. URL** alanına Botpress Brevo entegrasyonu webhook uç noktanızı girin. Örnek:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. Olay türleri** altında, seçin:
- `konuşmaBaşladı`
- `conversationTranscript`
- `conversationFragment`
5. webhook etkinleştirmek için **Kaydet** öğesine tıklayın.
> **Not:** URL'nin Botpress entegrasyonunuzun uç noktasıyla eşleştiğinden ve tam işlevsellik için gerekli tüm olay türlerinin kontrol edildiğinden emin olun.
Bu ayarlandıktan sonra, Botpress entegrasyonunuz Brevo'dan gerçek zamanlı olaylar alacak ve bunları uygun şekilde işleyebilecektir.
Bu ayrıntıları aldıktan sonra, entegrasyonun özel kurulum talimatlarına göre Botpress ortamınızda entegrasyonu yapılandırmaya devam edebilirsiniz.
