Skip to main content

​
What are Real-time Notifications?

Real-time Notifications allow you to receive instant updates about device events and actions through webhooks. Instead of polling the API for status updates, Amps AI pushes events to your application as they happen, enabling faster response times and more efficient processing.

​
Key Benefits

Instant Updates

Get notified immediately when events occur

Reduced API Calls

No need to poll for status updates

Efficient Processing

Process events asynchronously in your application

Better User Experience

Provide faster updates to your users

​
How It Works

Configure webhook endpoints in your dashboard to receive notifications. When events occur—such as action completions or device connection changes—Amps AI sends HTTP POST requests to your endpoints with event details.

​
Event Types

  • Action Events: Notifications when push commands complete or fail
  • Device Events: Notifications about device connection status changes (coming soon)
All webhooks include signatures for security verification, ensuring requests are from Amps AI.

​
Use Cases

​
Action Completion Handling

Instead of polling action status endpoints, receive webhooks when commands complete. Update your UI immediately when HVAC temperature changes are confirmed or EV charging sessions start.

​
Device Status Monitoring

Get notified when devices connect or disconnect, allowing you to update device availability in real-time and handle offline scenarios gracefully.

​
Event-Driven Workflows

Build event-driven applications that respond to device events automatically. For example, when a battery reaches full charge, automatically start charging an EV or adjust HVAC settings.

​
Webhook Delivery

  • At-least-once delivery: Webhooks may be delivered multiple times
  • Idempotency: Use the eventId to handle duplicate deliveries
  • Automatic retries: Failed deliveries are retried with exponential backoff
  • Fast delivery: Typically delivered within 10 seconds for live environment

​
Security

All webhooks include cryptographic signatures that you can verify to ensure requests are from Amps AI. Never process unsigned webhooks.

Webhook Security

Learn how to verify webhook signatures

​
Next Steps

Webhooks Overview

Learn about setting up webhooks

Webhook Types

See all available webhook event types

Getting Started

Set up your first webhook endpoint

API Reference

Explore webhook-related endpoints