Certainly

Technical Setup & API Usage

Installation & Embedding

Add the Certainly chat widget to your site with a simple JavaScript snippet provided in your dashboard:

<script src="https://cdn.certainly.io/widget.js" data-bot-id="YOUR_BOT_ID" async></script>

REST API

Certainly exposes a REST API for managing bots, conversations, and analytics programmatically.

Base URL: https://api.certainly.io/v1

Authentication: Use API key via Authorization: Bearer <API_KEY> header.

Key Endpoints:

• GET /bots — List all configured AI agents
• POST /conversations — Initiate a new conversation session
• GET /conversations/{id}/messages — Retrieve conversation transcript
• POST /webhooks — Register a webhook for real-time conversation events

Webhooks

Register webhooks to receive real-time events such as conversation.started, message.received, and handoff.triggered. Payload is delivered as JSON to your specified endpoint.

Key Parameters

• bot_id — Unique identifier for your AI agent instance
• session_id — Tracks individual user conversation sessions
• language — ISO 639-1 language code for multilingual routing
• channel — Deployment channel (web, email, sms, messenger)