google-chat-cards-v2

Send Google Chat Cards v2 payloads for structured alert notifications.

13|1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/danchamorro/pi-agent-toolkit --skill google-chat-cards-v2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-chat-cards-v2
Source: https://github.com/danchamorro/pi-agent-toolkit/tree/main/dotfiles/global-skills/google-chat-cards-v2
Command: npx skills add https://github.com/danchamorro/pi-agent-toolkit --skill google-chat-cards-v2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams migrate plain-text Google Chat webhooks to Cards v2 rich messages so alerts contain structured headers, sections, icons, and clearer context for faster incident response.

Core Features & Use Cases

  • Structured Card Builder: Patterns and helper methods to construct headers, sections, and widgets that convey job metadata, error details, and human-readable messages.
  • Reliable Delivery: Guidance on integrating retry logic and robust HTTP client handling for webhook delivery.
  • Testing and Validation: Reference tests and models to validate cardsV2 payload structure and assert correct behavior.
  • Use Case: Migrate an error-alerting pipeline to Cards v2 to include severity icons, job metadata, and full error messages for on-call teams.

Quick Start

Use the google-chat-cards-v2 skill to build a Cards v2 payload for an error alert and send it to your Google Chat webhook.

Frequently Asked Questions about google-chat-cards-v2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send Google Chat Cards v2 payloads for structured alert notifications in Python?

To send Google Chat Cards v2 payloads in Python, construct headers, sections, and widgets, then use httpx and tenacity for retryable HTTP delivery to your webhook. This validates the cardsV2 structure and returns success or error responses for observability.

How do I migrate plain-text Google Chat webhooks to Cards v2 rich messages?

Migrating plain-text Google Chat webhooks to Cards v2 involves replacing text payloads with structured headers, sections, and icons. This provides clearer context for monitoring, error reporting, and faster incident response for on-call teams.

Can I use tenacity and httpx for retryable webhook delivery in Python backend services?

Yes, you can use tenacity and httpx for retryable webhook delivery in Python backend services. This combination provides robust HTTP client handling and retry logic to ensure Google Chat card notifications reach their destination reliably.

How do I validate cardsV2 payload structure before sending Google Chat alerts?

Validating cardsV2 payload structure before sending Google Chat alerts involves checking the constructed headers, sections, and widgets against reference models. This ensures the payload is correctly formatted before performing the HTTP delivery.

What is the best way to build structured error alerts for Google Chat from Python?

The best way to build structured error alerts for Google Chat from Python is to use a card builder pattern. This constructs payloads with severity icons, job metadata, and full error messages, replacing plain-text webhooks for operational notifications.

Why do my Google Chat webhook notifications lack context for incident response?

Google Chat webhook notifications lack context for incident response when they use plain-text instead of Cards v2. Structured cards with headers, sections, and widgets convey job metadata and error details much clearer for on-call teams.