🔌 Integration Guide
Add EnquiroAI to any website in minutes. Paste your credentials below and copy the ready-to-use code snippet.
Plain HTML Form
Drop this into any page. The form submits directly to the EnquiroAI API — no server-side code needed.
API Response
Successful submissions return HTTP 200 with this JSON body.
| Field | Type | Description |
|---|---|---|
category | string | Classified enquiry type — e.g. Sales, Support, Complaint |
urgency | string | Low / Medium / High / Critical |
sentiment | string | Positive / Neutral / Negative |
summary | string | One-sentence AI summary of the submission |
autoReplySent | boolean | Whether a reply was sent to the customer |
escalated | boolean | Whether the submission was escalated to human review |
spam | boolean | Whether the submission was flagged as spam |
webhookFired | boolean | Whether your webhook URL received a payload |
classifiedInMs | number | End-to-end processing time in milliseconds |
Error Codes
Non-2xx responses include an error string in the body.
| Status | Meaning |
|---|---|
400 | Validation failed — check required fields (name, email, message, tenantId) |
401 | Missing or invalid X-Api-Key header |
429 | Rate limit hit — max 5 requests per IP per 60 seconds on the public endpoint |
429 (plan) | Monthly submission limit reached — upgrade your plan |
500 | Unexpected server error — check status page |
Tips
Keep your API key server-side if possible
The public /api/submissions/process endpoint is intentionally open (no auth required) so client-side forms work. The API key is only needed for dashboard/admin operations. If you add it to a client-side form, treat it as a low-privilege read key.
Multi-language out of the box
The AI detects the language of the submission and replies in the same language. No configuration needed — just submit in any language.
Webhook for real-time updates
Set a webhookUrl in the Admin panel to receive a POST payload on every processed submission — useful for Zapier, Make, Slack, or your own backend.
Deduplication is built in
Duplicate submissions from the same email within 3 minutes are automatically de-duplicated — no extra configuration needed.