---

name: speak-webhooks-events description: 'Handle Speak lesson completion events, progress webhooks, and achievement notifications.

Use when implementing webhooks events,

or managing Speak language learning platform operations.

Trigger with phrases like "speak webhooks events", "speak webhooks events".

' allowed-tools: Read, Write, Edit, Bash(npm:), Bash(curl:), Grep version: 1.14.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• speak
• api compatibility: Designed for Claude Code

---

Speak Webhooks & Events

Overview

Handle Speak lesson completion events, progress webhooks, and achievement notifications.

Prerequisites

• Completed speak-install-auth setup
• Valid API credentials configured
• Understanding of Speak API patterns

Instructions

Step 1: Configuration

Configure webhooks events for your Speak integration. Speak uses OpenAI's GPT-4o for AI tutoring and Whisper for speech recognition.

// speak_webhooks_events_config.ts
const config = {
  apiKey: process.env.SPEAK_API_KEY!,
  appId: process.env.SPEAK_APP_ID!,
  environment: process.env.NODE_ENV || 'development',
};

Step 2: Implementation

// Core implementation for speak webhooks & events
import { SpeakClient } from '@speak/language-sdk';

const client = new SpeakClient(config);

// Production-ready implementation
async function setup() {
  const health = await client.health.check();
  console.log("Status:", health.status);
  return health;
}

Step 3: Verification

curl -sf -H "Authorization: Bearer $SPEAK_API_KEY" https://api.speak.com/v1/health | jq .

Output

• Speak Webhooks & Events configured and verified
• Production-ready Speak integration
• Error handling and monitoring in place

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API key	Verify SPEAK_API_KEY
429 Rate Limited	Too many requests	Implement backoff
Connection timeout	Network issue	Check connectivity to api.speak.com
Audio format error	Wrong codec	Convert to WAV 16kHz mono

Resources

• Speak Website
• OpenAI Realtime API
• Speak GPT-4 Blog

Next Steps

For production checklist, see speak-prod-checklist.

Examples

Basic: Apply webhooks events with default settings for a standard Speak integration.

Production: Configure with monitoring, alerting, and team-specific language learning requirements.