Skip to main content

​
Agents

An agent is the entity you create in Novu when you want to expose agent logic through one or more communication providers. Each agent has a name, an identifier, and a set of event handlers that define how your application responds to conversation events. An agent can be connected to one or more providers, such as Slack, Microsoft Teams, WhatsApp, email, or in-app Agent Chat.

​
Provider connections

A provider connection connects an agent to a messaging platform. Providers are the surfaces where users interact with your agent. A provider connection gives Novu the credentials and configuration needed to receive events from that provider and deliver responses back to it. Each provider has its own setup flow and platform capabilities. Some providers support reactions, typing indicators, attachments, rich cards, or message editing. Others may support only a subset of those behaviors. Novu normalizes provider events before passing them to your agent handler, so your code works with a consistent interface instead of provider-specific webhook payloads. Your handlers stay provider-agnostic. Novu translates replies into whatever Slack, WhatsApp, or email expects on the way out.

​
Supported providers

Novu supports the following providers: While adding a new provider to an agent, Novu will guide you through the setup process for the provider. For what each channel can do (typing, buttons, approvals, edits), see Channels overview.

​
Manage agents with the API

You can create agents, link providers, and configure runtime settings from your backend using the Agents API reference. Common starting points:

Create an agent

Create an agent integration

List all agents

Create an integration