Sample: Send a message on Google Chat group with Python `requests`

send_message_on_google_chat.py

"""A sample to send message on Google Chat group with Python requests.

Prerequisites:

- Google API v1
- A webhook URL taken
- Python 3
- Requests (last tested with 2.31.0)

Usage:

```bash
WEBHOOK_URL='https://chat.googleapis.com/v1/spaces/SPACE_ID/messages?key=KEY&token=TOKEN' python send_message_on_google_chat.py
```

Ref:
- https://developers.google.com/hangouts/chat/quickstart/incoming-bot-python
- https://developers.google.com/hangouts/chat/reference/message-formats
"""

import os
from pprint import pprint

import requests
from requests.models import Response

# You need to pass WEBHOOK_URL as an environment variable.
# You can generate a webhok URL in the "Apps & integrations" page of a chat space.
WEBHOOK_URL = os.environ["WEBHOOK_URL"]


def main():
    # Sample 1) Send a simple text.
    res = send_text(text="Hello!")
    pprint(res.json())

    # Sample 2) Send a card.
    res = send_text_card(
        title="Hey!",
        subtitle="You!",
        paragraph='<b>Roses</b> are <font color="#ff0000">red</font>,<br><i>Violets</i> are <font color="#0000ff">blue</font>',
    )
    pprint(res.json())


def send_text(text: str) -> Response:
    return requests.post(WEBHOOK_URL, json={"text": text})


def send_text_card(title: str, subtitle: str, paragraph: str) -> Response:
    header = {"title": title, "subtitle": subtitle}
    widget = {"textParagraph": {"text": paragraph}}
    cards = [
        {
            "header": header,
            "sections": [{"widgets": [widget]}],
        },
    ]
    return requests.post(WEBHOOK_URL, json={"cards": cards})


if __name__ == "__main__":
    main()

Simpler versions:

simple_text.py:

import os

import requests

WEBHOOK_URL = os.environ['WEBHOOK_URL']

text = 'Hello.'
res = requests.post(WEBHOOK_URL, json={'text': text})
print(res.json())

card.py:

import os

import requests

WEBHOOK_URL = os.environ['WEBHOOK_URL']

title = 'Hi'
subtitle = 'Hello'
paragraph = 'Hasta La Vista, Baby.'
widget = {'textParagraph': {'text': paragraph}}
res = requests.post(
    WEBHOOK_URL,
    json={
        'cards': [
            {
                'header': {
                    'title': title,
                    'subtitle': subtitle,
                },
                'sections': [{'widgets': [widget]}],
            }
        ]
    },
)
print(res.json())

We need Requests PyPI package:

python -m pip install requests==2.31.0