Gamma Webhooks & Events

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Implement webhook handlers and event processing for real-time Gamma updates with signature verification and reliable queue processing.

Prerequisites

• Public endpoint for webhook delivery
• Webhook secret from Gamma dashboard
• Understanding of event-driven architecture

Event Types

Instructions

Step 1: Register Webhook

Register endpoint URL with Gamma API specifying events to receive and webhook secret.

Step 2: Create Handler with Signature Verification

Verify x-gamma-signature header using HMAC-SHA256. Acknowledge receipt immediately (200), then process asynchronously.

Step 3: Implement Event Processing

Route events to type-specific handlers: notify team on create, update database on changes, send export links, cleanup on delete.

Step 4: Add Reliable Queue

Use Bull/Redis queue with 3 retry attempts and exponential backoff. Failed events go to dead letter queue for manual review.

Step 5: Manage Webhooks

List, update (change events), delete, and test webhooks via API.

See detailed implementation for webhook registration, signature verification, event handlers, Bull queue setup, and webhook management code.

Output

• Webhook endpoint with signature verification
• Event handlers for all presentation events
• Reliable queue with retry logic
• Webhook lifecycle management

Error Handling

Examples

Test Webhook Delivery

await gamma.webhooks.test(webhookId);
// Sends test event to registered endpoint

Resources

• Gamma Webhooks Guide
• Webhook Best Practices

Next Steps

Proceed to gamma-performance-tuning for optimization.