Introduction

Changelog

New Variables API

The Variables API provides read access to the Variables configured for your AI Agent. Two endpoints are available: GET /v2/variables: Lists every accessible Variable. GET /v2/variables/{id}: Returns…

New Email Conversations CC field

We have added a new optional field to the Email Conversations API: cc: A comma-separated list of email addresses to be added as CC recipients to the Email conversation. This field allows you to…

Autocapture variables now included in the Data Export API

The Data Export API now returns autocapture variables within the variables attribute of each conversation object. Previously, this attribute contained only global variables. This enhancement is…

New End User profile fields

We have added two new optional fields to the End User profile object: avatar: A URL to the end user's avatar image display_name: The end user's display name

New chat window events in Embed2

We've added new events to the subscribeEvent action in Embed2 to help you better track user interactions within the chat window: Event key Trigger Payload ada:minimize_chat Triggered when a user…

BCP 47 support in article upserts

The language field on the article object in the upsert API now supports BCP 47 language tags (e.g., en-CA, fr-FR). The previously supported locale field is deprecated but still accepted for backwards…

New callback event in Embed2

We've added a new event to the subscribeEvent action in Embed2. With this event, you can receive a callback when an end user submits a CSAT. The event returns a numeric CSAT score: Event key Trigger…

Validation added to reply_to field in Email Conversation API

Validation for the reply_to field in the Email Conversation API will be introduced in the coming weeks. Once implemented, requests with an invalid email address will fail with a validation error.

v2 API release

Ada is releasing a new version (v2) of our platform APIs. For detailed instructions on how to migrate your integrations, please see our Migration Guide. In addition to an updated developer…

Embed2 security improvements

We've released some security improvements to Embed2. If you're using the Embed2 NPM package , upgrade it to version 1.7.27 or newer. The Embed2 script is versionless and gets automatic updates, so if…

setSensitiveMetaFields Embed2 Action now supported in Generative

Previously the setSensitiveMetaFields action in Embed2 action and sensitiveMetaFields setting were only supported in scripted bots, now it is supported in Generative AI Agents.

Embed2 security improvements

We've released some security improvements to Embed2. If you're using the Embed2 NPM package , upgrade it to version 1.7.18 or newer. The Embed2 script is versionless and gets automatic updates, so if…

New callback events in Embed2

We've added three new events to the subscribeEvent action in Embed2. With these events, you can provide your clients with a better experience after a bot or AI Agent has handed the conversation off…

New conversation topic fields

We've added multiple fields to the Data Export API's Conversation object: generated_topic_v2_descgenerated_topic_v2_idgenerated_topic_v2_parent_idgenerated_topic_v2_title These are to support the…

New tags in End User API webhook payloads

When you're creating or updating users with webhooks in the End User API, you'll now see tags that you can use to filter webhook events on the Ada dashboard. You can currently use this tag to filter…

Create global keys to use with all of your Ada APIs

Until now, if you've used multiple Ada APIs, you've had to create and manage different keys for each one. Now, you have the option to create one or more global keys that work across all of Ada's…

New fields in the Data Export API

We have added multiple fields to the Data Export API. Click through to each object type to learn more:Conversation objectagent_handle_timebot_handle_timerecord_last_updatedMessage…

Add IDs and metadata to sources in the Knowledge API

To make it easier to manage your knowledge base's sources, you now have the option to add information into external_id and metadata fields when you create or update a knowledge source.

Filter articles in the Knowledge API

You can now filter knowledge articles to make bulk GET and DELETE requests, based on any combination of these attributes: Article IDs Whether articles are enabled Knowledge sources articles belong to…

Article tags in the Knowledge API

We have added the ability to create article tags (e.g,. "merchants," "customers," "promotions," etc.) in the Knowledge API. Then, on your Ada dashboard, you'll be able to use those tags to filter the…