Nevox API
Bring the AI agent and your company's knowledge into your app, website or system.
The Nevox API brings the same agent that serves your customers on WhatsApp, your website chat and the other channels into your own system: your app, customer portal, admin dashboard or internal team tool.
You teach the agent once, in the Nevox dashboard or through the API, and it answers the same way everywhere.
What you can do
| Feature | What it's for |
|---|---|
| Authenticated widget | Put the Nevox chat in your app with the user already identified |
| Conversations | Build the chat with your own interface and use Nevox as the brain |
Direct questions (/ask) | Query your company's knowledge from internal screens, without opening a chat |
| Knowledge and service list | Keep what the agent knows always in sync with your system |
| Teaching | Correct answers and approve what the agent learns |
| Actions | Let the agent read and update data in your system (e.g. upcoming appointments, booking, rescheduling) |
| Webhooks | Get real-time notifications: handoff to a human, new lead, appointment requested |
| Visitor and customer analytics | Measure who visits your site, who chats, who becomes a lead and who converts |
What stays inside Nevox
The WhatsApp, website chat, SMS, email and phone voice channels are connected and managed in the Nevox dashboard. You don't need the API for them. The API is for bringing the agent and its knowledge into your systems.
Plans
The API is available on the Pro - 3 Agents and Ultimate - 5 Agents plans. On the Starter - 1 Agent plan, the developer area shows as locked in the dashboard.
| Pro - 3 Agents | Ultimate - 5 Agents | |
|---|---|---|
| API keys | 3 | 20 |
| Requests per minute | 60 | 300 |
| API conversations | Count toward the plan allowance (900/month) | Count toward the plan allowance (1,600/month) |
Direct questions (/ask) per month | 1,000 | 10,000 |
| Webhook endpoints | 3 | 20 |
| Actions per agent | 5 | 30 |
| Server-side tracking events per month | 10,000 | 100,000 |
| Analytics data retention | 90 days | 13 months |
| Analytics CSV export | — | Yes |
| Test environment | Yes | Yes |
You can track usage in Dashboard → Developers → Usage or through the GET /v1/usage endpoint.
Concepts
- Agent: the AI agent you created in Nevox. Each one has an ID like
agt_8f2k.... - Contact: a person being served (your customer). You identify them by your own ID, the
external_id. - Visitor: someone who accessed your site or app and may not have identified themselves yet.
- Conversation: an exchange of messages between a contact or visitor and the agent, on any channel.
- Knowledge: everything the agent knows: documents, FAQs, pages from your site, corrections and the service list.
- Action: an endpoint in your system that the agent can call.
API base URL
https://api.nevox.ai/v1All requests use HTTPS and JSON. Dates follow ISO 8601 in UTC (e.g. 2026-11-03T14:30:00Z). Monetary amounts are integers in cents (9700 = $97.00).