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.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: components/google_chat/README.md
+120Lines changed: 120 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,3 +9,123 @@ The Google Chat API allows you to build custom bots for Google Chat, enabling au
9
9
-**Meeting Scheduler**: Set up a workflow that triggers when someone requests a meeting in a Google Chat room. The bot can interact with Google Calendar to find available slots and propose meeting times directly within the chat.
10
10
11
11
-**CI/CD Notifications**: Integrate with GitHub to send updates on code commits, pull requests, or build statuses from your CI/CD pipeline into a Google Chat room, keeping your development team informed in real-time.
12
+
13
+
14
+
# Getting Started
15
+
16
+
## Creating a Google Chat app
17
+
In order to connect your workspace Google Chat account to Pipedream, you'll need do the following:
18
+
1. Create a Google Chat app in Google Cloud (a Google workspace account is required.)
19
+
2. Connect this app using custom OAuth clients on Pipedream. See the directions [here](https://pipedream.com/docs/connected-accounts/oauth-clients) on how to configure a custom OAuth client on Pipedream.
20
+
21
+
1. Sign in to the [Google Cloud Console](https://cloud.google.com/)
22
+
2. Select an existing project or create a new one
23
+
24
+
25
+
26
+
3. Select **APIs & Services**
27
+
4. Click **Enable APIs & Services**
28
+
29
+
30
+
31
+
5. Search for and select **Chat API**
32
+
6. Click **Enable**
33
+
34
+
35
+
36
+
7. Click **OAuth consent screen** on the left side
37
+
38
+
39
+
40
+
8. If you only intend to use this application within your organization, select **Internal** (recommended) and click "Create." In this mode, your app is limited to Google Workspace users within your organization. If you select **External**, you will need to go through the process of app verification in order use any sensitive or restricted scopes.
41
+
42
+
43
+
44
+
9. Fill in the required fields and click **Save and Continue**
45
+
10. Under **Authorized Domains**, add `pipedream.com`
46
+
11. Click **Add or remove scopes** and Filter by `Chat API` select whichever scopes you intend to use and then click "Update". For more information about available Google Chat scopes, please see this [overview](https://developers.google.com/chat/api/guides/auth#chat-api-scopes).
47
+
12. Click **Save and Continue** to finish the **Scopes** step
48
+
13. You should be prompted with a **Summary** page.
49
+
50
+
## Create OAuth Credentials in Google Cloud
51
+
52
+
You will need to generate a set of OAuth credentials to connect your new Google Chat app to Pipedream.
53
+
54
+
1. Navigate to the **Credentials** section on the left side.
55
+
56
+
57
+
58
+
2. Click **Create Credentials** at the top and select **“*OAuth client ID**
59
+
60
+
61
+
62
+
63
+
64
+
3. Select **Web application** for **Application type**
65
+
66
+
67
+
68
+
4. Give your app a name.
69
+
70
+
## Create a Custom OAuth Client in Pipedream
71
+
72
+
5. Navigate to the workspace where you want to connect your Google Chat app, and go to **Accounts**, then **OAuth Clients**, and click **New OAuth Client.
73
+
74
+
6. Search for the "Google Chat" app and name your custom OAuth client. You will get a unique **Redirect URI** which you will need to configure in Google.
75
+
76
+
7. In the Google Cloud app configuration, under **Authorized redirect URIs**, click **Add URI** and enter the Redirect URI of your custom Google Chat client.
77
+
78
+
79
+
80
+
8. Click **Create** to create your new OAuth keys
81
+
9. Note the client ID and client Secret, but keep these private and secure
82
+
83
+
84
+
85
+
10. Add your Client ID and Client Secret to your custom OAuth Google Chat client on Pipedream.
86
+
87
+
## Configure your Google Chat application
88
+
89
+
1. Click **Enable APIs & Services** on the top-left navigation bar, then **Google Chat API**.
90
+
91
+
2. Click **Configuration**
92
+
93
+
3. Fill in the required details - please note that the values you provide here will be the name of the app that you add to your Google Chat workspace.
94
+
95
+
4. You can name the application whatever you'd like for the app to be called within the Google Chat workspace, e.g. **Pipedream**
96
+
97
+
5. If you'd like to use the Pipedream logo for the avatar, use the URL [https://pipedream.com/s.v0/app_13GhYE/logo/orig](https://pipedream.com/s.v0/app_13GhYE/logo/orig) for the **Avatar URL**
98
+
99
+
6. Add a **Description**.
100
+
101
+
7. Select any **Interactive features** you require for your app.
102
+
103
+
8. Add an **App URL**, ideally, an HTTPS URL that you control, or you can provide the following app url [https://pipedream.com/apps/google-chat-developer-app](https://pipedream.com/apps/google-chat-developer-app).
104
+
105
+
9. Under **Visibility**, add the email addresses of the individuals or groups within your Google Workspace organization.
## Connect your Google Chat app Pipedream with your Google Chat app OAuth credentials
112
+
113
+
At this point, you should have a Google Chat App under your Google Project, and a custom OAuth client on Pipedream. Make sure that the scopes in your custom OAuth client match the scopes you enabled in Google Cloud.
114
+
115
+
You should now be able to use your Google Chat application that you created on Pipedream!
116
+
117
+
## Publish your Google Chat app (EXTERNAL ONLY)
118
+
Google has a [7 day expiration window](https://developers.google.com/identity/protocols/oauth2#:~:text=A%20Google%20Cloud,Connect%20equivalents) on refresh tokens for applications that are set to **External** users with a publishing status of "Testing", so you will need to **Publish** your application in order to maintain your account connection.
119
+
120
+
1. Navigate to your application, and click **OAuth Consent Screen** on the lefthand sidebar.
121
+
2. Under **Publishing status**, click **Publish App**. If you included any sensitive or restricted scopes in your app, there will be a disclosure stating that you will need to go through the process of verification. Click **Confirm**.
122
+
3. Your application will not be available externally unless you share your **client_id** with others, and you will not have to go through the verification process unless you intend to onboard over 100 users.
123
+
4. The publishing status should be set to **In production**, and your account should maintain its connection without an expiration window.
124
+
125
+
126
+
127
+
128
+
129
+
# Troubleshooting
130
+
**Application disconnects after 7 days**<br>
131
+
If your developer application disconnects after 7 days, you need to follow the steps above to Publish your Google Chat app in order to keep your account connected.
0 commit comments