Skip to main content

Ada

Overview​

The Ada source connector connects to the Ada Knowledge API to validate access and (in future releases) extract knowledge content into your destination.

At this time, the connector supports credential validation but does not yet support extraction.

Setup​

Prerequisites​

  • An Ada instance (your Ada bot URL).
  • An Ada API key with access to the Knowledge API.

Get your Ada bot URL​

Use the HTTPS origin for your Ada bot, for example:

  • https://your-bot.ada.support

The connector requires an HTTPS origin only:

  • Must start with https://
  • Must include a host
  • Must not include a path, query string, or fragment

Examples:

  • Valid: https://your-bot.ada.support
  • Invalid: http://your-bot.ada.support (not HTTPS)
  • Invalid: https://your-bot.ada.support/some/path (includes a path)
  • Invalid: https://your-bot.ada.support?x=1 (includes a query)

Get your Ada API key​

Create or retrieve an API key in Ada with permission to access the Knowledge API. The connector uses this key as a Bearer token.

Authentication​

This connector authenticates using:

  • Bearer token: your Ada API key
  • Validation request: GET {bot_url}/api/knowledge/v1/articles

If authentication fails, you’ll see an error indicating credential validation failed.

Configuration​

FieldTypeRequiredDescription
bot_urlstring✅Your Ada bot HTTPS origin (for example, https://your-bot.ada.support). Must be an HTTPS origin only (no path/query/fragment).
api_keystring✅Ada API key used as a Bearer token for API requests.

Streams​

No streams are currently available. The connector’s extraction functionality is still in development.