Integrate Zedinga AI into your applications with our REST API and webhooks.
All API requests require an API key passed via the `X-API-Key` header.
Generate API keys from your Dashboard → Settings.
curl -H "X-API-Key: zai_your_key_here" \
https://zedinga.ai/api/v1/bots
GET `/api/v1/bots`
Returns all bots for the authenticated user.
Response:
{
"bots": [
{
"id": "uuid",
"name": "My Bot",
"status": "active",
"model": "gpt-4o-mini",
"default_language": "en",
"created_at": "2026-01-01T00:00:00Z"
}
]
}
GET `/api/v1/bots/{botId}/conversations?limit=20&offset=0`
Returns conversations for a specific bot. Supports pagination.
Parameters:
• `limit` (optional, max 100, default 20)
• `offset` (optional, default 0)
Response:
{
"conversations": [...],
"total": 150,
"limit": 20,
"offset": 0
}
Configure webhooks in Dashboard → Bot → Webhooks tab.
Events: `new_conversation`, `new_message`, `new_lead`, `handoff_request`
Payload:
{
"event": "new_lead",
"bot_id": "uuid",
"timestamp": "2026-01-01T00:00:00Z",
"data": {
"lead_id": "uuid",
"name": "John",
"email": "john@example.com"
}
}
Verification: Each payload is signed with HMAC-SHA256. Verify with the `X-Zedinga-Signature` header using your webhook secret.