Skip to content
Chat Bot Samples for Hangouts Chat.
Branch: master
Clone or download
Latest commit c5dbf9b Jan 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
apps-script/vote-text-bot Remove static directory in favor of GitHub static image Aug 6, 2018
java Add newline at the end of the file Apr 19, 2018
node Update README.md Oct 3, 2018
python Update bot.py Jan 23, 2019
.gitignore Add the Java client library to the Java basic bot Apr 17, 2018
CONTRIBUTING.md Squashing commits Feb 7, 2018
LICENSE mv productivity_tracker/* to root Aug 3, 2018
README.md Add note about G Suite account requirement May 29, 2018
readme.md

README.md

Hangouts Chat code samples

This repository contains the code samples for Hangouts Chat bots. There are folders of samples dependent on language and platform. Generally the Java and Python samples live in each respective directory, but JavaScript has multiple form factors (client-side, server-side/Node.js, Google Apps Script [also server side], and Cloud Functions [GCP or Firebase]).

Which JS platform you choose depends on the type of bot application you're using/writing. Apps Script features tighter integration with G Suite data and applications, while Google Cloud Functions has a tighter integration with Google Cloud Platform services and APIs. Finally, mobile apps or mobile web apps are more likely to want to take advantage of Cloud Functions for Firebase. It is also generally straightforward to port from one JS implementation to another, for example, to Node.js.

In each folder, you can find a language-specific implementation of the one or more of the following code samples:

  • Basic bot: This bot receives event notices and messages from Hangouts Chat and responds synchronously with simple text responses. This sample demonstrates how to create an HTTP endpoint bot using Google App Engine.
  • Basic async bot: This bot receives event notices and messages from Hangouts Chat and responds asynchronously with simple text responses. The responses will appear in the same thread that raised the original event or message. This sample is an HTTP endpoint bot built upon Google App Engine.
  • Pub/Sub bot: This bot uses Google Cloud Pub/Sub to receive messages from Hangouts Chat. The bot responds back to Hangouts Chat asynchronously.
  • Card bot: This bot receives event notices and messages from Hangouts Chat and responds synchronously with a card-formatted response. This sample is an HTTP endpoint bot built upon Google App Engine.
  • Vote bot: This bot demonstrates updating interactive cards by providing a platform whereby users can vote on topics, such as who can do lunch today, who wants to play ball at lunch, etc. Samples can feature images or be text-only.

For additional details about how to set up and run each sample, consult the README file included with the sample.

Note: The Hangouts Chat application, and the developer platform, are only available to G Suite accounts. You will not be able to develop or test a bot with an @gmail.com account.

Contributing changes

See CONTRIBUTING.md.

Licensing

This is not an official product.

This library is licensed under Apache 2.0. Full license text is available in LICENSE.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.