# Google Chat Pagsasama para sa Botpress
Binibigyang-daan ka ng pagsasamang ito na ikonekta ang iyong Botpress chatbot sa Google Chat spaces, na nagbibigay-daan sa tuluy-tuloy na komunikasyon sa pagitan ng iyong bot at Google Chat mga gumagamit. ## Mga Tampok - Magpadala at tumanggap ng mga mensahe sa Google Chat spaces - Awtomatikong paghawak ng mensahe at mga tugon - Suporta para sa maramihang Google Chat spaces - Secure na pagpapatotoo gamit ang Google Service Account ## Mga Kinakailangan 1. Isang Google Cloud Platform (GCP) account 2. Isang Google Chat espasyo kung saan mo gustong i-deploy ang iyong bot 3. Botpress halimbawa sa Google Chat naka-install na integration ## Mga Tagubilin sa Pag-setup ### 1. Paganahin ang Google Chat API 1. Pumunta sa Google Cloud Console 2. Mag-navigate sa "APIs & Services" > "Library" 3. Maghanap para sa "Google Chat API" 4. Mag-click sa Google Chat API 5. I-click ang "I-enable" para i-activate ang API para sa iyong proyekto ### 2. Lumikha ng Google Service Account 1. Pumunta sa Google Cloud Console 2. Gumawa ng bagong proyekto o pumili ng umiiral na 3. Mag-navigate sa "IAM & Admin" > "Service Accounts" 4. I-click ang "Create Service Accounts and Service Accounts" 4. I-click ang "Create Service Account Detalye at C5. 6. Lumikha ng bagong key para sa account ng serbisyo: - Mag-click sa account ng serbisyo - Pumunta sa tab na "Mga Key" - I-click ang "Magdagdag ng Key" > "Gumawa ng bagong key" - Piliin ang format ng JSON - I-download ang key file ### 3. I-configure ang Google Chat Mga Setting ng App 1. Pumunta sa Google Cloud Console 2. Mag-navigate sa "APIs & Services" > "Google Chat API" 3. Mag-click sa "Configuration" 4. I-set up ang iyong app gamit ang mga sumusunod na setting: - Pangalan ng App: Pumili ng pangalan para sa iyong bot - Paglalarawan: Magdagdag ng paglalarawan ng functionality ng iyong bot - Avatar URL: Magdagdag ng URL para sa avatar image ng iyong bot - Features: - I-enable ang interactive na feature - I-enable ang pagtanggap ng 1-1 na mga mensahe sa pagsali sa pag-uusap **TP: Itakda ito sa iyong Botpress webhook Natagpuan ang URL sa Google Chat Configuration ng Pagsasama. ### 4. I-configure ang Integration sa Botpress
- Sa iyong Botpress halimbawa, pumunta sa seksyong Integrations 2. Hanapin at piliin ang Google Chat integration 3. I-configure ang mga sumusunod na setting: - Service Account JSON: I-paste ang buong nilalaman ng iyong na-download na service account key file - Default Space: Ilagay ang ID ng iyong default na Google Chat space (opsyonal) ### 5. Idagdag ang Bot sa Iyong Google Chat Space 1. Buksan ang iyong Google Chat space 2. Mag-click sa pangalan ng space para buksan ang mga detalye ng space 3. Pumunta sa "Apps & integrations" 4. I-click ang "Magdagdag ng apps" 5. Maghanap para sa iyong bot gamit ang service account email 6. Idagdag ang bot sa iyong space ## Paggamit ### Pagpapadala ng Mga Mensahe Ang bot ay maaaring magpadala ng mga mensahe sa anumang Google Chat puwang na idinagdag nito. Maaaring ipadala ang mga mensahe: - Bilang tugon sa mga mensahe ng user - Proactively sa pamamagitan ng Botpress flow editor - Sa pamamagitan ng mga tawag sa API mula sa iyong custom na code ### Pagtanggap ng Mga Mensahe Awtomatikong natatanggap at pinoproseso ng bot ang mga mensaheng ipinadala sa Google Chat espasyo. Ito ay: - I-parse ang mga papasok na mensahe - Iproseso ang mga ito sa pamamagitan ng iyong Botpress flows - Ipadala ang mga naaangkop na tugon pabalik sa espasyo ### Format ng Mensahe Sinusuportahan ng integration ang mga text message sa Google Chat mga espasyo. Maaaring kabilang sa mga mensahe ang: - Plain text - Basic formatting - Mga Link - Mga Pagbanggit ## Mga Pagsasaalang-alang sa Seguridad - Panatilihing secure ang iyong service account key at huwag itong ibahagi sa publiko - Regular na i-rotate ang iyong mga service account key - Gamitin ang prinsipyo ng pinakamaliit na pribilehiyo kapag nagtatalaga ng mga tungkulin sa iyong account ng serbisyo - Subaybayan ang aktibidad ng iyong bot at i-set up ang naaangkop na pag-log ## Troubleshooting #1 **Pag-aayos ng account ay hindi tumutugon. mga pahintulot - Suriin kung ang bot ay maayos na naidagdag sa espasyo - Tiyaking ang pagsasama ay maayos na na-configure sa Botpress
- Mga error sa pagpapatotoo - I-verify na tama ang format ng service account na JSON - Suriin kung valid at hindi nag-expire ang service account key - Tiyaking naka-enable ang account ng serbisyo ng mga kinakailangang saklaw ng API 3. Mga isyu sa paghahatid ng mensahe - I-verify na tama ang space ID - Suriin kung may pahintulot ang bot na mag-post sa space - Tiyaking valid ang format ng mensahe ## API tungkol sa Reference Para sa higit pang detalye Chat API, sumangguni sa opisyal na dokumentasyon.
# Google Chat Pagsasama para sa Botpress
Binibigyang-daan ka ng pagsasamang ito na ikonekta ang iyong Botpress chatbot sa Google Chat spaces, na nagbibigay-daan sa tuluy-tuloy na komunikasyon sa pagitan ng iyong bot at Google Chat mga gumagamit. ## Mga Tampok - Magpadala at tumanggap ng mga mensahe sa Google Chat spaces - Awtomatikong paghawak ng mensahe at mga tugon - Suporta para sa maramihang Google Chat spaces - Secure na pagpapatotoo gamit ang Google Service Account ## Mga Kinakailangan 1. Isang Google Cloud Platform (GCP) account 2. Isang Google Chat espasyo kung saan mo gustong i-deploy ang iyong bot 3. Botpress halimbawa sa Google Chat naka-install na integration ## Mga Tagubilin sa Pag-setup ### 1. Paganahin ang Google Chat API 1. Pumunta sa [Google Cloud Console](https://console.cloud.google.com) 2. Mag-navigate sa "APIs & Services" > "Library" 3. Maghanap para sa "Google Chat API" 4. Mag-click sa Google Chat API 5. I-click ang "I-enable" para i-activate ang API para sa iyong proyekto ### 2. Lumikha ng Google Service Account 1. Pumunta sa [Google Cloud Console](https://console.cloud.google.com) 2. Gumawa ng bagong proyekto o pumili ng umiiral na 3. Mag-navigate sa "IAM & Admin" > "Service Accounts" 4. I-click ang "Create Service Accounts and Service Accounts" 4. I-click ang "Create Service Account Detalye at C5. 6. Lumikha ng bagong key para sa account ng serbisyo: - Mag-click sa account ng serbisyo - Pumunta sa tab na "Mga Key" - I-click ang "Magdagdag ng Key" > "Gumawa ng bagong key" - Piliin ang format ng JSON - I-download ang key file ### 3. I-configure ang Google Chat Mga Setting ng App 1. Pumunta sa [Google Cloud Console](https://console.cloud.google.com) 2. Mag-navigate sa "APIs & Services" > "Google Chat API" 3. Mag-click sa "Configuration" 4. I-set up ang iyong app gamit ang mga sumusunod na setting: - **Pangalan ng App**: Pumili ng pangalan para sa iyong bot - **Paglalarawan**: Magdagdag ng paglalarawan ng functionality ng iyong bot - **Avatar URL**: Magdagdag ng URL para sa avatar image ng iyong bot - **Features**: - I-enable ang interactive na feature - I-enable ang pagtanggap ng 1-1 na mga mensahe sa pagsali sa pag-uusap **TP: Itakda ito sa iyong Botpress webhook Natagpuan ang URL sa Google Chat Configuration ng Pagsasama. ### 4. I-configure ang Integration sa Botpress
1. Sa iyong Botpress halimbawa, pumunta sa seksyong Integrations 2. Hanapin at piliin ang Google Chat integration 3. I-configure ang mga sumusunod na setting: - **Service Account JSON**: I-paste ang buong nilalaman ng iyong na-download na service account key file - **Default Space**: Ilagay ang ID ng iyong default na Google Chat space (opsyonal) ### 5. Idagdag ang Bot sa Iyong Google Chat Space 1. Buksan ang iyong Google Chat space 2. Mag-click sa pangalan ng space para buksan ang mga detalye ng space 3. Pumunta sa "Apps & integrations" 4. I-click ang "Magdagdag ng apps" 5. Maghanap para sa iyong bot gamit ang service account email 6. Idagdag ang bot sa iyong space ## Paggamit ### Pagpapadala ng Mga Mensahe Ang bot ay maaaring magpadala ng mga mensahe sa anumang Google Chat puwang na idinagdag nito. Maaaring ipadala ang mga mensahe: - Bilang tugon sa mga mensahe ng user - Proactively sa pamamagitan ng Botpress flow editor - Sa pamamagitan ng mga tawag sa API mula sa iyong custom na code ### Pagtanggap ng Mga Mensahe Awtomatikong natatanggap at pinoproseso ng bot ang mga mensaheng ipinadala sa Google Chat espasyo. Ito ay: - I-parse ang mga papasok na mensahe - Iproseso ang mga ito sa pamamagitan ng iyong Botpress flows - Ipadala ang mga naaangkop na tugon pabalik sa espasyo ### Format ng Mensahe Sinusuportahan ng integration ang mga text message sa Google Chat mga espasyo. Maaaring kabilang sa mga mensahe ang: - Plain text - Basic formatting - Mga Link - Mga Pagbanggit ## Mga Pagsasaalang-alang sa Seguridad - Panatilihing secure ang iyong service account key at huwag itong ibahagi sa publiko - Regular na i-rotate ang iyong mga service account key - Gamitin ang prinsipyo ng pinakamaliit na pribilehiyo kapag nagtatalaga ng mga tungkulin sa iyong account ng serbisyo - Subaybayan ang aktibidad ng iyong bot at i-set up ang naaangkop na pag-log ## Troubleshooting #1 **Pag-aayos ng account ay hindi tumutugon. mga pahintulot - Suriin kung ang bot ay maayos na naidagdag sa espasyo - Tiyaking ang pagsasama ay maayos na na-configure sa Botpress
2. **Mga error sa pagpapatotoo** - I-verify na tama ang format ng service account na JSON - Suriin kung valid at hindi nag-expire ang service account key - Tiyaking naka-enable ang account ng serbisyo ng mga kinakailangang saklaw ng API 3. **Mga isyu sa paghahatid ng mensahe** - I-verify na tama ang space ID - Suriin kung may pahintulot ang bot na mag-post sa space - Tiyaking valid ang format ng mensahe ## API tungkol sa Reference Para sa higit pang detalye Chat API, sumangguni sa [opisyal na dokumentasyon](https://developers.google.com/chat/api/reference/rest).
