Technical Integration Guide

Embedding Ada on Web

Add Ada's chat widget to any web page with a single script snippet:

<script>
  window.adaSettings = {
    handle: "your-ada-handle",
    language: "en",
    metaFields: { userId: "12345", plan: "premium" }
  };
</script>
<script src="https://static.ada.support/embed2.89f7b5e9.js" async></script>

REST API & Webhooks

Ada provides a REST API for programmatic management of bot content, conversations, and analytics:

Conversations API — Retrieve full conversation transcripts and metadata.
Variables API — Read/write dynamic variables (e.g., customer account data) to personalize responses at runtime.
Webhooks — Subscribe to events like conversation.started, handoff.triggered, or resolution.achieved to sync data with your CRM or data warehouse.

Key Integration Parameters

Parameter	Description
`handle`	Your unique Ada bot identifier
`metaFields`	Key-value pairs passed at session init for personalization
`language`	ISO 639-1 language code
`cluster`	Data residency region (US, EU, CA)

Platform Integrations

Ada offers native connectors for Salesforce Service Cloud, Zendesk, Freshdesk, Shopify, and Twilio. Custom integrations are supported via Action Blocks that make authenticated HTTP requests to internal APIs mid-conversation.