API guide 2
Calls WebSocket API
A live stream of your Calls. Connect once and receive the latest data whenever it changes.
2.1Connect
Replace YOUR_INTEGRATION_API_KEY with a key from Developer settings, then use this URL to connect your WebSocket client:
wss://api.algolens.tech/api/v1/realtime?apikey=YOUR_INTEGRATION_API_KEYOnce connected, your first Calls update arrives straight away. Keep the connection open to receive future updates automatically.
2.2What you receive
Every update contains your complete current Calls list, the time it was generated, and a summary of its performance. The update name iscalls.snapshot.
| When | What happens |
|---|---|
| When you connect | You receive your current complete Calls list. |
| When Calls update | You receive a new complete Calls list automatically. |
| While connected | Updates continue without any further action from you. |
2.3Scope and reconnecting
Your connection shows only your Calls. If it drops, reconnect to the same URL to receive the latest complete update. Close the connection when you no longer want updates.
2.4Troubleshooting
| Issue | What to check |
|---|---|
| Connection is rejected | Check that you copied the URL exactly and that your Integration API key is active. |
| No later messages | There has not been a new Calls update yet. Keep the connection open for the next one. |
| No updates after disconnect | Reconnect to receive the latest current Calls list. |
AlgoLens developer documentationAPI guide 2 · Calls WebSocket API