Webhooks
Receive job completion and processing events asynchronously. Verify signatures, handle retries and replays, and keep your endpoint safe under load.
Webhooks let Ultrafield notify your application when asynchronous work changes state or completes. Exact event names, payload schemas, and signature headers are provided with API access.
Receiver checklist
- Accept requests only over HTTPS.
- Verify the delivery signature before parsing or acting on the payload.
- Read the raw request body when the signature scheme requires byte-for-byte verification.
- Return a successful response quickly and move slow work to your own queue.
- Deduplicate deliveries by event or job identifier.
- Make handlers safe to run more than once.
Retries
Assume a delivery can arrive late, more than once, or out of order relative to another event. Fetch or reconcile current job state before applying an irreversible side effect.
Local development
Use a secure public tunnel only for development and never expose unrelated local services. Rotate any webhook secret that appears in terminal history or shared logs.
Processing pipelines
Compose speech recognition, speaker processing, audio intelligence, and language models into one observable request instead of stitching vendors.
Errors and retries
Handle validation, authentication, rate-limit, transient, and terminal failures predictably, with retry guidance for each class of Ultrafield error.