Release notes

Images shared during handoff conversations now open in an inline lightbox viewer instead of a new browser tab, keeping agents in context during active handoffs.

Highlights

• Lightbox view – Clicking any image in a handoff conversation opens it in an inline overlay.
• Carousel navigation – Scroll through multiple images in the conversation without closing the viewer.
• Download and print – Click the image within the lightbox to access download and print options.
• Quick dismiss – Press ESC or click the close button to exit the lightbox.

Scope

This update applies to all handoff types where images are displayed by the system. Images shared as links are not affected.

The Handoffs API is now generally available. It enables custom handoff integrations that connect an AI Agent to any live agent platform or internal system, without requiring Ada Solutions engineering.

API endpoints

Five REST endpoints are available for managing conversations during an active handoff:

• Send message (POST /v2/conversations/{conversation_id}/messages/): Send messages from a human agent to the end user during a handoff.
• Get messages (GET /v2/conversations/{conversation_id}/messages/): Retrieve the full conversation transcript with pagination. Supports text, file, and link content types.
• Upload attachment (POST /v2/conversations/{conversation_id}/attachments/): Upload files up to 50 MB to a conversation via presigned URL. Returns a download URL valid for 7 days.
• Update conversation (PATCH /v2/conversations/{conversation_id}/): Update conversation metadata. Supports string, boolean, integer, and float values.
• End handoff (POST /v2/conversations/{conversation_id}/end-handoff/): End the handoff and return control to the AI Agent.

Webhook events

Two webhook events support real-time integration during handoffs:

• v1.conversation.message: Fires on every message during an active handoff, delivering text, file, or link content in real time.
• v1.conversation.handoff.ended: Fires when a handoff completes, enabling cleanup and state sync in external systems.

Integration features

• handoff_integration field: Identifies which integration is active on a conversation. Use it with Svix Channels to filter webhook deliveries so each integration only receives its own events.
• ai_agent_domain field: Included in all webhook events. Identifies which AI Agent environment the event originated from (for example, acme.ada.support or acme.eu.ada.support). Essential for multi-Agent or multi-region setups.
• HTTP Request Block trigger: Start a handoff by configuring an HTTP Request Block in the AI Agent’s automation. The block calls the integration’s endpoint and signals the handoff start.
• Svix Channels filtering: Filter webhook deliveries by handoff_integration value so each integration only receives relevant events.

Get started

• Conversations API reference for endpoint details, authentication, error codes, rate limits, and Svix webhook verification.
• Creating a custom handoff: A step-by-step developer guide covering the full integration lifecycle, from configuring the handoff trigger to sending messages, handling file attachments, and returning control to the AI Agent.
• ada-handoffs-api-demo: An open-source reference app demonstrating the full handoff lifecycle, including agent messaging, file uploads, transcript rendering, and handoff termination.