Platform
Kenmerken
Studio agent
Stel je agent snel samen en pas hem aan
Autonome motor
LLMs gebruiken om gesprekken en taken te begeleiden
Kennisbanken
Train uw bot met aangepaste kennisbronnen
Tabellen
Gespreksgegevens opslaan en beheren
Kanalen
Whatsapp Embleem
WhatsApp
Instagram Embleem
Instagram
Facebook Messenger logo
Messenger
Slack logo
Slack
Alle kanalen
Integraties
Hubspot logo
HubSpot
Notion
Notion
Jira-logo
Jira
Calendly logo
Calendly
Alle integraties
LLM Aanbieders
OpenAI logo
OpenAI
Anthropic logo
Anthropic
Groq logo
Groq
HuggingFace logo
Hugging Face
Alle LLMs
Oplossingen
Voor
Onderneming
Bedrijfskritische productieworkflows automatiseren
Agentschappen
Geavanceerde agentservices bieden
Ontwikkelaars
Verken een robuuste API voor agentontwikkeling
Verhalen van klanten
Ontdek van succesvolle klanten hoe Botpress bedrijven wereldwijd transformeert.
Door de industrie
E-commerce
Onderwijs
Financiën
Gastvrijheid
Alle industrieën
Per afdeling
Verkoop
Engineering
Product
ITSM
Alle afdelingen
Per gebruikssituatie
Winkelassistent
Leads genereren
Werknemerservaring
Ticketbeheer
Alle gebruikssituaties
Bronnen
Essentieel
Academy
Leer bouwen door middel van cursussen
Bibliotheek
Hulpmiddelen om uw AI-workflows te verbeteren
Blog
Inzichten en updates over Botpress en AI-agenten
gebouw
Discord
Doe mee met duizenden collega's en deel ideeën
Docs
Uitgebreide gidsen en referenties
API
Referentiemateriaal voor gebruik met externe systemen
LLM Rangschikking
Prestaties en kosten voor modelaanbieders vergelijken
Video's
Tutorials, demo's en product walkthroughs
Changelog
Blijf op de hoogte van de nieuwste Botpress
Partners
Partner worden
Word lid van ons netwerk van gecertificeerde experts
Een expert inhuren
Contact maken met partners en consultants
Docs
Onderneming
Prijzen
Inloggen
Neem contact op metAanmelden
terug naar Hub

Messaging API

v0.2.3
Installeren op uw werkruimte
Onderhouden door Botpress Plus
  
## What it is
API and configurable endpoint to easily send messages to and from your bot via http requests. You can use this to send messages or other information back and forth between your bot and any back-end application.

[![image](https://i.imgur.com/FgAinpn.png)](https://www.youtube.com/watch?v=f2RMv40omPA)

## How it works
To send messages to your bot, use the API endpoint. When sending messages to your bot, you provide a conversationId parameter that will be sent back to your webhook url, so that you may identify where to send your bot's responses.

To handle responses from your bot, you provide an endpoint url. Each request sent to this endpoint carries a single bot message, and includes the conversationId that was previously provided. Depending on your bot, you could recieve multiple responses, or no responses at all. 

## Getting started

[![image](https://i.imgur.com/6dqO43d.png)](https://www.youtube.com/watch?v=GJb1EK9dlOM)


#### Pre-requisites
All you need is an endpoint to catch your bot's responses that returns http status 200. For trying this out, we recommend a free endpoint on [Request Bin](https://pipedream.com/requestbin). 

#### Steps
1. Click `Install` on the top right and select your bot.
2. Click the popup that appears to configure your integration.
3. Add the url that points to your server's endpoint in the `Response Endpoint URL` field.
4. Copy the Webhook URL at the top of the page, this will be the endpoint for creating messages. Save this for later.
5. In Botpress, click your avatar on the top right, then `Personal Access Tokens`. Create a new token and save it for later.
6. Send an http request with the following content:

- Endpoint: **{INTEGRATION_WEBHOOK_URL}** 
- Method: POST
- Headers:
  - Authorization: bearer **{PERSONAL_ACCESS_TOKEN}** 
- Body:
  - userId: (string, required) ensures that the message is added for the correct user, in case of multiple users
  - messageId: (string, required) helps prevent duplicates
  - conversationId: (string, required) identifies the conversation uniquely and is used for sending back responses
  - type: (string, required) should be 'text' if the message type is text, otherwise a different string for other types
  - text: (string, required) the text of the user's message if the type is text, or a summary of the payload for other types
  - payload: (any, required) an object containing any data you want to send, specific to the message type

7. On your server, handle the response (make sure your bot is published and responds to messages). The request body should look like this:
- Body:
  - type: (string, required) specifies the type of the message
  - payload: (any, required) contains the response text or metadata otherwise
  - conversationId: (string, required) use this to send the response to the correct location
  - botpressUserId: (string, required) Botpress user ID for debugging purposes
  - botpressMessageId: (string, required) Botpress message ID for debugging purposes
  - botpressConversationId: (string, required) Botpress conversation ID for debugging purposes



Bouw beter met Botpress

Maak verbazingwekkende AI-agent-ervaringen.

Ga aan de slag - het is gratis
Pictogram van een pijl
Meer informatie op Botpress Academy

Bouw beter en sneller AI-agents met onze verzameling cursussen, handleidingen en zelfstudies.

Een expert inhuren

Neem contact op met onze gecertificeerde ontwikkelaars om een deskundige bouwer te vinden die aan jouw behoeften voldoet.

Alle systemen operationeel
SOC 2
Gecertificeerd
GDPR
Conform
© 2025
Platform
Prijzen
Studio agent
Autonome motor
Kennisbanken
Tabellen
Hub
Integraties
Kanalen
LLMs
Bronnen
Praat met Verkoop
Documentatie
Een expert inhuren
Video's
Verhalen van klanten
API referentie
Blog
Status
v12 Hulpmiddelen
Gemeenschap
Steun van de Gemeenschap
Partner worden
Word ambassadeur
Word een affiliate
Bedrijf
Over
Carrière
Nieuws & Pers
Wettelijk
Privacy
© Botpress 2025