Documentation

Getting Started

From zero to your AI agent running in about 90 seconds.

Quickstart

Get your AI agent live in 60 seconds

Embed & Integration

How to add the Simple Agent widget to any site — HTML, React, WordPress, or mobile app.

Customization

Customize colors, avatar, messages, and behavior of your AI agent.

API Reference

Complete Simple Agent REST API documentation — authentication, endpoints, webhooks, and rate limits.

Rate Limits

Request limits by plan, control headers, and strategies for handling 429s.

API Errors

Error codes, standard JSON format, and how to resolve the most common errors.

Webhooks

Receive real-time events — new conversation, lead captured, handoff requested — with HMAC verification.

GDPR & Privacy

How Simple Agent handles personal data, data residency, and how to configure your instance for GDPR compliance.

WhatsApp Business

Connect your AI agent to WhatsApp Business via the Meta Cloud API — no extra monthly fee, no middleman.

Instagram DM

Connect Simple Agent to Instagram Direct Messages and auto-reply to comments.

Slack

Add your AI agent to a Slack workspace — responds in channels, threads, and DMs.

Training Sources

How to add URLs, PDFs, text, and sitemaps to train your AI agent.

Re-indexing and Updates

When and how to force re-indexing of sources to keep your agent up to date.

Agent Actions

Configure automatic actions: lead capture, ticket creation, Stripe payment links, and custom webhooks.

Widget not loading

Step-by-step diagnosis for when the Simple Agent widget doesn't appear on your site.

Agent not responding correctly

Diagnosis for when the agent gives wrong, generic, or unfound responses even though the information is in your content.

Webhook failing

Diagnosis for when webhooks don't arrive, return errors, or the HMAC signature doesn't validate.