Piattaforma
Caratteristiche
Studio dell'agente
Costruire e personalizzare rapidamente il vostro agente
Motore autonomo
Utilizzare LLMs per guidare le conversazioni e i compiti
Basi di conoscenza
Addestrate il vostro bot con fonti di conoscenza personalizzate
Tavoli
Memorizzare e gestire i dati delle conversazioni
Canali
Whatsapp Emblema
WhatsApp
Instagram Emblema
Instagram
Logo Facebook Messenger
Messenger
Logo Slack
Slack
Tutti i canali
Integrazioni
Logo Hubspot
HubSpot
Logo Notion
Notion
Logo Jira
Jira
Logo Calendly
Calendly
Tutte le integrazioni
LLM Fornitori
Logo OpenAI
OpenAI
Logo Anthropic
Anthropic
Logo Groq
Groq
Logo HuggingFace
Hugging Face
Tutti LLMs
Soluzioni
Per
Impresa
Automatizzare i flussi di lavoro di produzione mission-critical
Agenzie
Fornire servizi sofisticati agli agenti
Sviluppatori
Esplorare una robusta API per lo sviluppo di agenti
Storie di clienti
Scoprite dai clienti di successo come Botpress sta trasformando il business in tutto il mondo.
Per industria
Ecommerce
Istruzione
Finanza
Ospitalità
Tutti i settori
A cura del Dipartimento
Vendite
Ingegneria
Prodotto
ITSM
Tutti i dipartimenti
Per caso d'uso
Assistente alla spesa
Generazione di lead
Esperienza dei dipendenti
Gestione dei biglietti
Tutti i casi d'uso
Risorse
Essenziale
Academy
Imparare a costruire attraverso corsi curati
Biblioteca
Risorse per migliorare i flussi di lavoro dell'IA
Blog
Approfondimenti e aggiornamenti su Botpress e sugli agenti AI
edificio
Discord
Unirsi a migliaia di colleghi e condividere idee
Documenti
Guide e riferimenti completi
API
Materiale di riferimento da utilizzare con sistemi esterni
LLM Classifica
Confrontare le prestazioni e i costi dei fornitori di modelli
Video
Tutorial, dimostrazioni e presentazioni del prodotto
Changelog
Rimanete aggiornati sugli ultimi aggiornamenti di Botpress
Partner
Diventare partner
Unitevi alla nostra rete di esperti certificati
Assumere un esperto
Connettersi con partner e consulenti
Documenti
Impresa
Prezzi
Accedi
ContattoIscriviti
torna a Hub

Messaging API

v0.2.3
Installare sul proprio spazio di lavoro
Mantenuto da 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



Costruire meglio con Botpress

Creare incredibili esperienze di agenti AI.

Inizia a Sviluppare con Botpress
Icona di una freccia
Per saperne di più Botpress Academy

Costruite agenti AI in modo migliore e più rapido con la nostra raccolta curata di corsi, guide ed esercitazioni.

Assumere un esperto

Collegatevi con i nostri sviluppatori certificati per trovare un costruttore esperto che soddisfi le vostre esigenze.

Tutti i sistemi sono operativi
SOC 2
Certificato
GDPR
Conforme
© 2025
Piattaforma
Prezzi
Studio dell'agente
Motore autonomo
Basi di conoscenza
Tavoli
Hub
Integrazioni
Canali
LLMs
Risorse
Contatta il servizio vendite
Documentazione
Assumere un esperto
Video
Storie di clienti
Riferimento API
Blog
Stato
Risorse v12
Comunità
Sostegno alla comunità
Diventare partner
Diventare ambasciatore
Diventare un affiliato
Azienda
Chi siamo
Carriera
Notizie e stampa
Legale
Privacy
© Botpress 2025