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.