# 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.
# 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.
