Brevo HITL

  # Botpress -Brevo HITL Integration Binibigyang-daan ka ng integration na ito na ikonekta ang iyong Botpress bot na may platform ng mga pag-uusap ni Brevo, na nagpapagana ng setup ng Human-in-the-Loop (HITL). Nangangahulugan ito ng iyong Botpress Maaaring pangasiwaan ng bot ang mga paunang pakikipag-ugnayan ng user at walang putol na ipadama ang mga pag-uusap sa mga ahente ng tao sa Brevo kung kinakailangan. ## Paano Ito Gumagana Kapag nakipag-ugnayan ang isang user sa iyong Botpress bot, ang pag-uusap ay maaaring ilipat sa isang ahente ng tao sa Brevo. Ang ahente ay maaaring pumalit sa pag-uusap at magbigay ng personalized na suporta. Mga mensahe mula sa Botpress ipaparating ang user sa ahente ng Brevo, at kabaliktaran. ## Pangunahing Limitasyon Mangyaring magkaroon ng kamalayan sa mga sumusunod na limitasyon kapag ginagamit ang pagsasamang ito: - **Pagpapatungkol sa Mensahe:** Mga mensaheng ipinadala ng Botpress user sa Brevo agent ay lalabas na parang ipinapadala sila ng Brevo agent account na na-configure sa integration. Gayunpaman, upang makilala ang mga mensaheng ito, sila ay lagyan ng " Botpress User:". Halimbawa: ` Botpress User: Hello, kailangan ko ng tulong sa aking order.` - **Status Updates:** The Botpress hindi awtomatikong makakatanggap ang user ng mga notification o status update tungkol sa pagtatalaga ng ahente (hal., "Sumali si Agent John sa chat"). ## Gabay sa Pag-setup Upang i-configure ang Botpress -Brevo HITL integration, kakailanganin mo ang sumusunod: 1. **Brevo API Key:** - Maaari mong gawin at pamahalaan ang iyong Brevo API keys sa pamamagitan ng pagsunod sa mga tagubilin sa kanilang opisyal na page ng tulong: [Gumawa at pamahalaan ang iyong mga API key](https://help.brevo.com/hc/en-us/articles/209467485-managePIkeyy-our) IP Blocking:** - Para sa tuluy-tuloy na komunikasyon sa pagitan Botpress at Brevo, kinakailangang i-deactivate ang IP blocking sa iyong Brevo account. - Mag-navigate sa [Brevo IP Authorization](https://app.brevo.com/security/authorised_ips) at tiyaking naka-deactivate ang IP blocking upang payagan ang mga kahilingan mula sa iyong Botpress kapaligiran. 3. **Brevo Agent ID:** - Kailangan mong tukuyin kung aling Brevo agent account ang gagamitin ng integration para magpadala at tumanggap ng mga mensahe. - Mag-navigate sa page ng mga setting ng mga ahente ng Brevo: [Mga Setting ng Mga Ahente ng Brevo](https://conversations-app.brevo.com/settings/agents) - Tukuyin ang ahente na gusto mong gamitin para sa pagsasama at kopyahin ang kanilang Agent ID. ## Webhook Setup (Kinakailangan) Upang makatanggap ng mga kaganapan mula sa Brevo sa iyong Botpress pagsasama, dapat kang mag-set up ng a webhook sa Brevo: 1. Pumunta sa **Integrations > Webhooks** sa iyong Brevo dashboard ([direct link](https://conversations-app.brevo.com/settings/integrations/webhooks)). 2. I-click ang **Magdagdag ng bago webhook ** (o i-edit ang isang umiiral na). 3. Sa field na **URL**, ilagay ang iyong Botpress Pagsasama ng Brevo webhook endpoint. Halimbawa: ``` https:// webhook . botpress .cloud/ff43meb9-a102-4201-b045-fc498dc1f52b ``` 4. Sa ilalim ng **Mga uri ng kaganapan**, piliin ang: - `ConversationStarted` - `conversationTranscript` - `conversationFragment` 5. I-click ang **Save** para i-activate ang webhook . > **Tandaan:** Tiyaking tumutugma ang URL sa iyo Botpress endpoint ng integration at ang lahat ng kinakailangang uri ng kaganapan ay sinusuri para sa ganap na paggana. Kapag na-set up na ito, ang iyong Botpress ang pagsasama ay makakatanggap ng mga real-time na kaganapan mula sa Brevo at mapoproseso ang mga ito nang naaayon. Sa sandaling mayroon ka ng mga detalyeng ito, maaari kang magpatuloy sa pag-configure ng pagsasama sa loob ng iyong Botpress kapaligiran ayon sa partikular na mga tagubilin sa pag-setup ng integration.