Platform
Ciri
Studio Ejen
Bina dan sesuaikan ejen anda dengan pantas
Enjin Autonomi
guna LLMs untuk membimbing perbualan dan tugasan
Pangkalan Pengetahuan
Latih bot anda dengan sumber pengetahuan tersuai
Jadual
Menyimpan dan menguruskan data perbualan
Saluran
Whatsapp Lambang
WhatsApp
Instagram Lambang
Instagram
Facebook Messenger logo
Messenger
Slack logo
Slack
Semua saluran
Integrasi
Logo Hubspot
HubSpot
Notion logo
Notion
Logo Jira
Jira
Calendly logo
Calendly
Semua integrasi
LLM Pembekal
OpenAI logo
OpenAI
Anthropic logo
Anthropic
Groq logo
Groq
Logo HuggingFace
Hugging Face
Semua LLMs
Penyelesaian
Bagi
Perusahaan
Automasi aliran kerja pengeluaran kritikal misi
Agensi
Menyediakan perkhidmatan ejen yang canggih
Pemaju
Terokai API yang teguh untuk pembangunan ejen
Cerita Pelanggan
Ketahui daripada pelanggan yang berjaya bagaimana Botpress mengubah perniagaan di seluruh dunia.
Mengikut Industri
E-dagang
Pendidikan
Kewangan
Hospitaliti
Semua industri
Mengikut Jabatan
Jualan
Kejuruteraan
Produk
ITSM
Semua jabatan
Mengikut Kes Penggunaan
Pembantu Beli-belah
Penjanaan Utama
Pengalaman Pekerja
Pengurusan Tiket
Semua kes penggunaan
Sumber
Penting
Academy
Belajar membina melalui kursus yang dipilih susun
Perpustakaan
Sumber untuk meningkatkan aliran kerja AI anda
Blog
Cerapan dan kemas kini tentang Botpress dan ejen AI
bangunan
Discord
Sertai beribu-ribu rakan sebaya dan kongsi idea
Dokumen
Panduan dan rujukan yang komprehensif
API
Bahan rujukan untuk digunakan dengan sistem luaran
LLM Kedudukan
Bandingkan prestasi dan kos untuk pembekal model
Video
Tutorial, tunjuk cara dan panduan produk
Changelog
Ikuti perkembangan terkini Botpress kemas kini
Rakan kongsi
Menjadi Rakan Kongsi
Sertai rangkaian pakar bertauliah kami
Upah Pakar
Berhubung dengan rakan kongsi dan perunding
Dokumen
Perusahaan
Harga
Log masuk
KenalanDaftar
kembali ke Hub

Weavel

v3.0.0
Pasang pada Ruang Kerja anda
Diselenggara oleh Weavel
  This integration allows you to connect your Botpress chatbot with Weavel, a powerful analytics platform for conversational AI. By integrating your chatbot with Weavel, your chatbot's conversations will be automatically captured and analyzed with Weavel's AI, and configurable reports will be generated automatically to help you understand your chatbot's performance and user behavior.

You can also set up the integration from Weavel, to set up a scheduled data pull from Botpress to Weavel.

## Prerequisites

To establish this integration, the following is required:

- Authorized access to an existing Weavel project. If you don't have an existing account, you can sign up for free [here](https://weavel.ai).
- A valid Weavel project API key.

After the setup, you should follow the instructions below to ensure all of your chatbot's conversation data is properly captured by Weavel.

You can also follow an interactive guide to set up the integration [here](https://weavel.ai/docs/platform-integrations/botpress#log-data-from-botpress-studio).

## Setup realtime message logging

Before activating the Botpress Weavel Integration, please walk through the following steps:

### First, add the Weavel API key to your bot's configuration.

Add your Weavel project API key to your chatbot's configuration variables. This is required to make it accessible to the hooks you will add in the next step.

![Bot configuration](https://i.imgur.com/sDnhkz4.png)

### Second, add two hooks into your chatbot.

> **Note:** You can add hooks in the "Hooks" section of your chatbot's admin panel.
> ![Hooks section of admin panel](https://i.imgur.com/cNzPNyJ.png)

Create a new hook under the "After Incoming Message" section, and add the following code:

```typescript
try {
  const userMessage = event.preview;
  const incomingMessageId = event.id;
  workflow.incomingMessageId = incomingMessageId;
  await axios.post(
    "https://api.weavel.ai/capture/trace_data",
    {
      trace_id: event.conversationId,
      trace_data_id: incomingMessageId,
      user_id: event.userId,
      role: "user",
      content: userMessage,
      metadata: {
        // Add any additional metadata you want to capture (for all messages) here.
        // To capture metadata for specific messages, use the "Log message metadata" card in the studio.
      },
    },
    {
      headers: {
        Authorization: `Bearer ${event.state.configVariables?.["weavelApiKey"]}`,
      },
    }
  );
} catch (error) {
  console.log(error);
}
```

Next, create another hook under the "Before Outgoing Message" section, and add the following code:

```typescript
try {
  let assistantMessage: string;
  if (outgoingEvent.payload.type == "text") {
    assistantMessage = outgoingEvent.preview;
  } else {
    assistantMessage = `${outgoingEvent.payload.type}: ${JSON.stringify(
      outgoingEvent.payload
    )}`;
  }
  const outgoingMessageId = outgoingEvent.id;
  workflow.outgoingMessageId = outgoingMessageId;
  const data = {
    trace_id: event.conversationId,
    trace_data_id: outgoingMessageId,
    user_id: event.userId,
    role: "assistant",
    content: assistantMessage,
    metadata: {
      // Add any additional metadata you want to capture (for all messages) here.
      // To capture metadata for specific messages, use the "Log message metadata" card in the studio.
    },
  };
  await axios.post("https://api.weavel.ai/capture/trace_data", data, {
    headers: {
      Authorization: `Bearer ${event.state.configVariables?.["weavelApiKey"]}`,
    },
  });
} catch (error) {
  console.log(error);
}
```

## Advanced Usage

### Identify users

You can use this function to identify users in Weavel. This will populate the user's profile in Weavel with the provided user id, name, email, and other details.

### Log track event

You can use this function to log track events to Weavel. This is useful for tracking user interactions and events in your bot, such as button clicks, successful form submissions, and other custom events.

### Log message metadata

Use this function to log metadata for specific messages. This is useful for capturing additional context for specific messages, such as user feedback score, details for AI generated messages (knowledge base, AI model, etc.), etc.

#### Some additional setup is required for this action card to work:

1. Add four workflow variables to your bot: `incomingMessageId`, `outgoingMessageId`, `messageId`, and `metadata`. If you have copied the hooks from the previous section, you will see that these variables are used to store the message ids for incoming and outgoing messages.

2. Just after the card that sends/receives the message where you want to log metadata to, add an **Execute code** action card to set the `messageId` variable. Copy one of the following code snippets into the card:

```typescript
// If you want to log the user's message
workflow.messageId = workflow.incomingMessageId;
```

```typescript
// If you want to log the assistant's message
workflow.messageId = workflow.outgoingMessageId;
```

3. Before the **Log Message Metadata** action card, add an **Execute code** action card to declare the metadata as a JSON string. Refer to the example below:

```typescript
workflow.metadata = JSON.stringify({
  feedbackScore: 5,
  model: "gpt-3.5-turbo",
});
```

## Learn more

With the integration enabled, Weavel will analyze your chatbot's conversations and generate reports to help you understand your chatbot's performance and user behavior. To learn more about Weavel's capabilities and how to use the reports, refer to the [Weavel documentation](https://weavel.ai/docs).

Bina Lebih Baik dengan Botpress

Cipta pengalaman ejen AI yang menakjubkan.

Mulakan - ia percuma
Ikon anak panah
Maklumat lanjut di Botpress Academy

Bina ejen AI dengan lebih baik dan pantas dengan koleksi kursus, panduan dan tutorial kami yang dipilih susun.

Upah Pakar

Berhubung dengan pembangun bertauliah kami untuk mencari pembina pakar yang sesuai dengan keperluan anda.

Semua Sistem Operasi
SOC 2
Diperakui
GDPR
Patuh
© 2025
Platform
Harga
Studio Ejen
Enjin Autonomi
Pangkalan Pengetahuan
Jadual
Hub
Integrasi
Saluran
LLMs
Sumber
Bercakap dengan Jualan
Dokumentasi
Upah Pakar
Video
Cerita Pelanggan
Rujukan API
Blog
Status
Sumber v12
Komuniti
Sokongan Komuniti
Menjadi Rakan Kongsi
Menjadi Duta Besar
Menjadi Ahli Gabungan
Syarikat
Tentang
Kerjaya
Berita & Akhbar
Undang
Privasi
© Botpress 2025