For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
  • Sales CRM
  • Conversations
      • DELDelete a message sent by an agent
      • PUTUpdate a message sent by an agent
      • GETGet a message
      • POSTSend a message as an agent
  • Ecommerce
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
ConversationsMessages

Send a message as an agent

POST
https://api.brevo.com/v3/conversations/messages
POST
/v3/conversations/messages
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4    const client = new BrevoClient({
5        apiKey: "YOUR_API_KEY_HERE",
6    });
7    await client.conversations.sendAMessageAsAnAgent({
8        text: "Hello! How can I help you?",
9        visitorId: "kZMvWhf8npAu3H6qd57w2Hv6nh6rnxvg",
10        agentId: "d9nKoegKSjmCtyK78",
11    });
12}
13main();
1{
2  "agentId": "d9nKoegKSjmCtyK78",
3  "createdAt": 1482512803740,
4  "html": "Hello! How can I help you?",
5  "id": "eYBEm3gq3zc5ayE2g",
6  "isMissed": false,
7  "isMissedByVisitor": false,
8  "isPushed": false,
9  "isTrigger": false,
10  "receivedFrom": "SuperAwesomeHelpdesk",
11  "text": "Hello! How can I help you?",
12  "type": "agent",
13  "visitorId": "kZMvWhf8npAu3H6qd57w2Hv6nh6rnxvg"
14}

Send a message as an agent to an existing visitor’s conversation. You must provide either agentId alone, or all three of agentEmail + agentName + receivedFrom to identify the agent.

Was this page helpful?
Previous

Delete an automated message

Next
Built with

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Request

This endpoint expects an object.
textstringRequired
Message text.
visitorIdstringRequired
Visitor's ID received <a href="https://developers.brevo.com/docs/conversations-webhooks">from a webhook</a> or generated by you to <a href="https://developers.brevo.com/docs/customize-the-widget#identifying-existing-users">bind an existing user account to Conversations</a>.
agentEmailstringOptionalformat: "email"

Agent’s email address. When sending messages from a standalone system, it’s hard to maintain a 1-to-1 relationship between the users of both systems. In this case, an agent can be specified by their email address.

agentIdstringOptional
Agent ID. It can be found on the agent's page or received <a href="https://developers.brevo.com/docs/conversations-webhooks">from a webhook</a>. Alternatively, you can use `agentEmail` + `agentName` + `receivedFrom` instead (all 3 fields required).
agentNamestringOptional
Agent's name.
receivedFromstringOptional
Mark your messages to distinguish messages created by you from the others.

Response

Newly created message is returned as a response.
agentIdstring

ID of the agent on whose behalf the message was sent (only in messages sent by an agent).

agentNamestring

Agent’s name as displayed to the visitor. Only in the messages sent by an agent.

agentUserpicstring
Only set if the agent has uploaded a profile picture.
attachmentslist of objects
An array of file attachments.
bcclist of objects

An array containing details of the blind carbon copy (BCC) recipients (applicable only to messages in email threads).

cclist of objects

An array containing details of the carbon copy (CC) recipients (applicable only to messages in email threads).

createdAtlong>=0
Timestamp in milliseconds.
fileobject
forwardedToSourceStatusobject
Status of the message forwarding to the source.
fromobject

An object containing details about the email sender (applicable only to messages in email threads).

htmlstring
The HTML content of the message.
idstring
Message ID. It can be used for further manipulations with the message.
integrationsobject
Integration details.
isBotboolean

true for automated messages generated by an AI bot.

isMissedboolean

true for missed and offline messages.

isMissedByVisitorboolean

true for unread agent’s messages in finished chats.

isPushedboolean

true for pushed messages

isTriggerboolean

true for automatic messages from “Targeted chats & triggers” and API (https://developers.brevo.com/docs/javascript-api-reference#sendautomessage)

rawUnsafeHtmlstring

Unescaped HTML content of the message (may include unsafe HTML).

receivedFromstring

In two-way integrations, messages sent via REST API can be marked with receivedFrom property and then filtered out when received in a webhook to avoid infinite loop.

replyToobject

An object containing details of the reply-to email address (applicable only to messages in email threads).

sourceMessageIdstring
The ID of the message assigned by the integration source.
subjectstring

The subject line of the email message (only for messages sent to email threads).

textstring
Message text or name of the attached file
tolist of objects

An array containing details of the recipients (applicable only to messages in email threads).

typeenum

"agent" for agents’ messages, "visitor" for visitors’ messages.

Allowed values:
isSentViaJsApiboolean

‘true if the message was sent via JavaScript API.’

messageTypestring

The type of message content (e.g. for integration-specific message types).

isForwardboolean

‘true if the message is a forwarded message.’

sourceobject
Source information for the message.
visitorIdstring

visitor’s ID

Errors

400
Bad Request Error

Visitor’s ID received from a webhook or generated by you to bind an existing user account to Conversations.

Agent ID. It can be found on the agent’s page or received from a webhook. Alternatively, you can use agentEmail + agentName + receivedFrom instead (all 3 fields required).