Brevo

Brevo Conversations API

The conversations API from Brevo — 6 operation(s) for conversations.

Documentation GitHub OpenAPI

Business capability

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /conversations/messages/{id} Delete a message an agent sent · Delete a message sent by an agent #

Ask an LLM

“How do I delete a chat reply an agent posted by mistake?”

“Can visitor messages be deleted or only agent ones?”

Tell an agent destructive · confirm first

Delete agent message {id}.

Remove the agent's chat reply {id} from the conversation.

PUT /conversations/messages/{id} Edit a message an agent sent · Update a message sent by an agent #

Ask an LLM

“Can I fix a typo in a chat reply an agent already sent?”

“Which messages am I allowed to edit in a conversation?”

Tell an agent

Change the text of agent message {id} to {text}.

Edit the agent's chat reply {id} so it reads {text}.

GET /conversations/messages/{id} Get a conversation message · Get a message #

Ask an LLM

“What did a specific chat message in Brevo Conversations say?”

“Can I fetch one agent or visitor message by its ID?”

Tell an agent

Get conversation message {id}.

Show me the chat message with ID {id}.

POST /conversations/messages Reply to a visitor as an agent · Send a message as an agent #

Ask an LLM

“How do I post a chat reply to a website visitor as one of my agents?”

“Can I reply as an agent by email and name instead of agent ID?”

Tell an agent

Reply to visitor {visitorId} as agent {agentId} saying {text}.

Send {text} to visitor {visitorId} as agent {agentName} ({agentEmail}) from {receivedFrom}.

DELETE /conversations/pushedMessages/{id} Delete an automated chat message · Delete an automated message #

Ask an LLM

“How do I remove a pushed message from a visitor's chat?”

“Can I delete an automated message I sent by mistake?”

Tell an agent destructive · confirm first

Delete automated message {id}.

Remove pushed message {id} from the conversation.

PUT /conversations/pushedMessages/{id} Edit an automated chat message · Update an automated message #

Ask an LLM

“Can I change the text of an automated message after it was pushed?”

“How do I correct a pushed order-status message?”

Tell an agent

Update automated message {id} to say {text}.

Rewrite the pushed message {id} as {text}.

GET /conversations/pushedMessages/{id} Get an automated chat message · Get an automated message #

Ask an LLM

“What did an automated pushed message to a visitor contain?”

“Can I look up one proactive message by its ID?”

Tell an agent

Get automated message {id}.

Show the pushed chat message {id}.

POST /conversations/pushedMessages Push an automated message to a visitor · Send an automated message to a visitor #

Ask an LLM

“How do I push an order status update into a visitor's chat window?”

“Can I send a proactive message on behalf of an agent group?”

Tell an agent

Push automated message {text} to visitor {visitorId}.

Push {text} to visitor {visitorId} on behalf of agent group {groupId}.

POST /conversations/agentOnlinePing Keep an agent shown as online · Sets agent's status to online for 2-3 minutes #

Ask an LLM

“How do I keep an agent showing as online in the chat widget?”

“How often should I ping to keep an agent's status online?”

Tell an agent

Mark agent {agentId} online for the next few minutes.

Ping online status for agent {agentName} at {agentEmail}.

PUT /conversations/visitorGroup Assign a visitor to an agent group · Set visitor group assignment #

Ask an LLM

“How do I route a chat visitor to a specific team of agents?”

“Can I take a visitor out of their current agent group?”

Tell an agent

Assign the visitor to agent group {groupId}.

Move the visitor into group {groupId}.

Brevo Conversations API

Operations 10

Documentation

Specifications

Schemas & Data

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification