Chat API

Introduction
Endpoints

Botpress API

Introduction
Authentication
Conversations
Conversation participants
Conversation events
Conversation messages
Conversation users
Integrations
Account management
Hub
Bots
Workspaces
Usages
Files
Tables

Human in the Loop API Integration

How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Calling the API

Chat API

Introduction
Endpoints

Botpress API

Introduction
Authentication
Conversations
Conversation participants
Conversation events
Conversation messages
Conversation users
Integrations
Account management
Hub
Bots
Workspaces
Usages
Files
Tables

Human in the Loop API Integration

How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Calling the API

List Messages

get https://api.botpress.cloud/v1/chat/messages

Retrieves a list of Message you’ve previously created. The messages are returned in sorted order, with the most recent appearing first. The list can be filtered using Tags.

URL Expired

The URL for this request expired after 30 days.

Query Params

nextToken

string

Provide the meta.nextToken value provided in the last API response to retrieve the next page of results

conversationId

string

Conversation id

meta

object

required

nextToken

string

The token to use to retrieve the next page of results, passed as a query string parameter (value should be URL-encoded) to this API endpoint.

Updated 5 months ago

Create Message

Get Or Create Message

Did this page help you?

Language

Credentials

Bearer

PAT


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.botpress.cloud/v1/chat/messages \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 5 months ago

Create Message

Get Or Create Message

Did this page help you?

Chat API
Introduction
Endpoints
Create Eventpost
Get Eventget
Delete Userdelete
Update Userput
Get Userget
Create Messagepost
Delete Messagedelete
Get Messageget
Get Participantget
Remove Participantdelete
List Participantsget
Add Participantpost
List Messagesget
Listen Conversationget
Get Or Create Conversationpost
List Conversationsget
Create Conversationpost
Delete Conversationdelete
Get Conversationget
Get Or Create Userpost
Create Userpost

Botpress API
Introduction
Authentication
Conversations
Get Or Create Conversationpost
Delete Conversationdelete
Update Conversationput
Get Conversationget
List Conversationsget
Create Conversationpost
Conversation participants
Remove Participantdelete
Get Participantget
Add Participantpost
List Participantsget
Conversation events
Get Eventget
List Eventsget
Create Eventpost
Conversation messages
Delete Messagedelete
Update Messageput
Get Messageget
Get Or Create Messagepost
List Messagesget
Create Messagepost
Conversation users
Get Or Create Userpost
Delete Userdelete
Update Userput
Get Userget
List Usersget
Create Userpost
Integrations
Request Integration Verificationpost
Get Integration By Nameget
Get Integration Logsget
Delete Integrationdelete
Get Integrationget
Update Integrationput
List Integrationsget
Create Integrationpost
Delete Integration Api Keydelete
Create Integration Api Keypost
List Integration Api Keysget
Configure Integrationpost
Account management
Delete Personal Access Tokendelete
Create Personal Access Tokenpost
List Personal Access Tokensget
Update Accountput
Get Accountget
Hub
Get Public Integrationget
Get Public Integration By Idget
List Public Integrationsget
Bots
Deploy Bot Versionpost
Get Bot Versionget
Create Bot Versionpost
List Bot Versionsget
List Bot Issue Eventsget
List Bot Issuesget
Delete Bot Issuedelete
Get Bot Issueget
Get Bot Analyticsget
Get Bot Logsget
Delete Botdelete
Get Botget
Update Botput
List Botsget
Create Botpost
Workspaces
Update Workspace Memberput
Delete Workspace Memberdelete
Get Workspace Memberget
Create Workspace Memberpost
List Workspace Membersget
Get Audit Recordsget
List Public Workspacesget
List Workspace Quotasget
Get Workspace Quotaget
Break Down Workspace Usage By Botget
List Workspace Usagesget
Delete Workspacedelete
Update Workspaceput
Get Workspaceget
Get Public Workspaceget
List Workspacesget
Create Workspacepost
Usages
List Usage Activityget
List Usage Historyget
Get Usageget
Files
List File Passagesget
Search Filesget
Update File Metadataput
Get Fileget
Delete Filedelete
List Filesget
Upsert Fileput
What is the Files API?
Tables
Upsert Table Rowspost
Delete Table Rowspost
Update Table Rowsput
Create Table Rowspost
Find Table Rowspost
Get Table Rowget
Rename Table Columnput
Duplicate Tablepost
Delete Tabledelete
Update Tableput
Get Or Create Tablepost
Get Tableget
Create Tablepost
List Tablesget

Human in the Loop API Integration
How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Send a message to the agentpost
Create a userpost
Close a ticketpost
Create a conversation in your servicepost
Ping your servicepost
Calling the API
Stop the human-in-the-loop (HITL) session and close the ticket.post
Notify that an agent was assigned to a conversation.post
Send a message from the agent to the bot.post

Chat API
Introduction
Endpoints
Create Eventpost
Get Eventget
Delete Userdelete
Update Userput
Get Userget
Create Messagepost
Delete Messagedelete
Get Messageget
Get Participantget
Remove Participantdelete
List Participantsget
Add Participantpost
List Messagesget
Listen Conversationget
Get Or Create Conversationpost
List Conversationsget
Create Conversationpost
Delete Conversationdelete
Get Conversationget
Get Or Create Userpost
Create Userpost

Botpress API
Introduction
Authentication
Conversations
Get Or Create Conversationpost
Delete Conversationdelete
Update Conversationput
Get Conversationget
List Conversationsget
Create Conversationpost
Conversation participants
Remove Participantdelete
Get Participantget
Add Participantpost
List Participantsget
Conversation events
Get Eventget
List Eventsget
Create Eventpost
Conversation messages
Delete Messagedelete
Update Messageput
Get Messageget
Get Or Create Messagepost
List Messagesget
Create Messagepost
Conversation users
Get Or Create Userpost
Delete Userdelete
Update Userput
Get Userget
List Usersget
Create Userpost
Integrations
Request Integration Verificationpost
Get Integration By Nameget
Get Integration Logsget
Delete Integrationdelete
Get Integrationget
Update Integrationput
List Integrationsget
Create Integrationpost
Delete Integration Api Keydelete
Create Integration Api Keypost
List Integration Api Keysget
Configure Integrationpost
Account management
Delete Personal Access Tokendelete
Create Personal Access Tokenpost
List Personal Access Tokensget
Update Accountput
Get Accountget
Hub
Get Public Integrationget
Get Public Integration By Idget
List Public Integrationsget
Bots
Deploy Bot Versionpost
Get Bot Versionget
Create Bot Versionpost
List Bot Versionsget
List Bot Issue Eventsget
List Bot Issuesget
Delete Bot Issuedelete
Get Bot Issueget
Get Bot Analyticsget
Get Bot Logsget
Delete Botdelete
Get Botget
Update Botput
List Botsget
Create Botpost
Workspaces
Update Workspace Memberput
Delete Workspace Memberdelete
Get Workspace Memberget
Create Workspace Memberpost
List Workspace Membersget
Get Audit Recordsget
List Public Workspacesget
List Workspace Quotasget
Get Workspace Quotaget
Break Down Workspace Usage By Botget
List Workspace Usagesget
Delete Workspacedelete
Update Workspaceput
Get Workspaceget
Get Public Workspaceget
List Workspacesget
Create Workspacepost
Usages
List Usage Activityget
List Usage Historyget
Get Usageget
Files
List File Passagesget
Search Filesget
Update File Metadataput
Get Fileget
Delete Filedelete
List Filesget
Upsert Fileput
What is the Files API?
Tables
Upsert Table Rowspost
Delete Table Rowspost
Update Table Rowsput
Create Table Rowspost
Find Table Rowspost
Get Table Rowget
Rename Table Columnput
Duplicate Tablepost
Delete Tabledelete
Update Tableput
Get Or Create Tablepost
Get Tableget
Create Tablepost
List Tablesget

Human in the Loop API Integration
How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Send a message to the agentpost
Create a userpost
Close a ticketpost
Create a conversation in your servicepost
Ping your servicepost
Calling the API
Stop the human-in-the-loop (HITL) session and close the ticket.post
Notify that an agent was assigned to a conversation.post
Send a message from the agent to the bot.post

200Returns a list of Message objects.

defaultReturns a list of Message objects.