Intercom HITL

  # Intercom HITL Integration Pinapayagan ng integration na ito Botpress gamitin Intercom bilang tagapagbigay ng HITL (Human in the Loop). Lalabas ang mga mensahe mula sa bot Intercom , at ang mga tugon ng ahente ay ipapadala pabalik sa bot. ## Mga Tampok - Walang putol na pagsasama sa pagitan Botpress at Intercom
- Real-time na pag-synchronize ng mensahe - Suporta para sa mga text message - Awtomatikong pamamahala ng session ng pag-uusap - Webhook -based na pangangasiwa ng kaganapan - Pagtatalaga ng ahente at pamamahala ng pag-uusap ## Configuration Ang pagsasama ay nangangailangan ng sumusunod na configuration: - `accessToken`: Ang iyong Intercom Access Token (kinakailangan para sa API authentication) ## Intercom App Setup para sa Botpress Pagsasama Ang gabay na ito ay gagabay sa iyo sa pag-setup at pagsasaayos ng Intercom upang paganahin ang pagsasama sa iyong Botpress chatbot. ### Hakbang-hakbang na Tagubilin #### 1. Lumikha ng isang Intercom App * Mag-navigate sa [https://app. intercom .com/](https://app. intercom .com/) * Mag-sign in sa iyong Intercom account * Pumunta sa **Apps** sa developer hub
* I-click ang **"Gumawa ng App"** * Ilagay ang pangalan ng iyong app (hal., " Botpress HITL Integration") * I-click ang **"Gumawa ng App"** #### 2. Kopyahin ang Access Token * Sa dashboard ng iyong app, pumunta sa **Authentication** * Kopyahin ang **Access Token** na ipinapakita sa seksyong Access token * Sa iyong ** Botpress Intercom integration config**, idikit itong Access Token #### 3. I-configure ang Webhooks ##### a. Mga Pangyayari sa Pag-uusap Webhook
* Pumunta sa **Webhooks** sa dashboard ng iyong app * I-click ang **"Add Webhook "** * Itakda ang ** Webhook URL** sa iyong ** Botpress Intercom pagsasama webhook URL** * **Mag-subscribe lamang sa mga kaganapang ito:** * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * I-click ang **"I-save Webhook "** ### Buod ng Kinakailangan Botpress Config * **Token ng Access**: Mula sa Intercom App Authentication * ** Webhook URL**: Ibinigay ni Botpress
## Paggamit 1. I-configure ang pagsasama sa iyong Intercom Access Token 2. Magsimula ng session ng pag-uusap gamit ang aksyon na `startHitl` 3. Lalabas ang mga mensahe mula sa bot sa Intercom pag-uusap 4. Mga tugon ng ahente sa Intercom ibabalik sa bot 5. Awtomatikong pinamamahalaan ang estado ng pag-uusap Botpress at Intercom
> **Tandaan:** Kapag nagsisimula ng HITL session, kung ang email ng user ay hindi umiiral bilang isang contact sa Intercom , awtomatikong malilikha ang isang bagong contact. Kung mayroon na ang email, ang kasalukuyang contact ay gagamitin para sa proseso ng HITL. ## Suporta Para sa suporta, mangyaring makipag-ugnayan sa Botpress pangkat o sumangguni sa [ Intercom Dokumentasyon ng API](https://developers. intercom .com/docs). ## Pag-troubleshoot ### Mga Karaniwang Isyu 1. ** Webhook hindi tumatanggap ng mga kaganapan**: Tiyaking iyong webhook Ang URL ay naa-access ng publiko at maayos na na-configure 2. **Mga error sa pagpapatunay**: I-verify na tama ang iyong Access Token at may mga kinakailangang pahintulot 3. **Mga mensaheng hindi nagsi-sync**: Suriin kung ang pag-uusap ay maayos na nalikha at ang contact ay umiiral sa Intercom
### Debug Mode Paganahin ang pag-log in sa debug sa iyong Botpress configuration upang i-troubleshoot ang mga isyu sa pagsasama.