micsapp Speak Webhooks Events
Overview
Securely handle Speak webhooks with signature validation for language learning event notifications.
Prerequisites
- Speak webhook secret configured
- HTTPS endpoint accessible from internet
- Understanding of cryptographic signatures
- Redis or database for idempotency (optional)
Instructions
- Speak Event Types
- Webhook Endpoint Setup
- Signature Verification
- Event Handler Pattern
- Idempotency Handling
- Webhook Testing
- Local Development with ngrok
For full implementation details, load: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
Output
- Secure webhook endpoint
- Signature validation enabled
- Event handlers implemented
- Replay attack protection active
- Idempotency for duplicate prevention
Error Handling
| Issue | Cause | Solution |
|---|---|---|
| Invalid signature | Wrong secret | Verify webhook secret |
| Timestamp rejected | Clock drift | Check server time sync |
| Duplicate events | Missing idempotency | Implement event ID tracking |
| Handler timeout | Slow processing | Use async queue |
| Event not recognized | New event type | Add handler or log |
Resources
Next Steps
For performance optimization, see speak-performance-tuning.
Examples
Basic usage: Apply speak webhooks events to a standard project setup with default configuration options.
Advanced scenario: Customize speak webhooks events for production environments with multiple constraints and team-specific requirements.