المنصة
الميزات
استوديو الوكيل
أنشئ وكيلك وخصصه بسرعة
المحرك المستقل
استخدم LLMs لتوجيه المحادثات والمهام
قواعد المعرفة
تدريب الروبوت الخاص بك باستخدام مصادر المعرفة المخصصة
الجداول
تخزين بيانات المحادثة وإدارتها
القنوات
Whatsapp الشعار
WhatsApp
Instagram الشعار
Instagram
فيسبوك Messenger الشعار
Messenger
Slack Logo
Slack
جميع القنوات
التكاملات
شعار هبسبوت
هوب سبوت
شعار Notion
Notion
شعار جيرا
جيرا
Calendly الشعار
Calendly
جميع عمليات الدمج
LLM المزودون
شعار OpenAI
OpenAI
شعار Anthropic
Anthropic
شعار Groq
Groq
شعار HuggingFace
Hugging Face
الكل LLMs
محاليل
بالنسبة لـ
مؤسسة
أتمتة عمليات سير عمل الإنتاج ذات المهام الحرجة
الوكالات
تقديم خدمات الوكيل المتطورة
المطورين
استكشاف واجهة برمجة تطبيقات API قوية لتطوير الوكلاء
قصص العملاء
اكتشف من العملاء الناجحين كيف يقوم Botpress بتحويل الأعمال التجارية في جميع أنحاء العالم.
حسب الصناعة
التجارة الإلكترونية
التعليم
التمويل
الضيافه
جميع الصناعات
حسب القسم
المبيعات
الهندسة
المنتج
إدارة خدمات تكنولوجيا المعلومات والاتصالات
جميع الأقسام
حسب حالة الاستخدام
مساعد تسوق
توليد العملاء المحتملين
تجربة الموظف
إدارة التذاكر
جميع حالات الاستخدام
موارد
أساسي
Academy
تعلّم البناء من خلال الدورات التدريبية المنسقة
المكتبة
موارد لتحسين سير عمل الذكاء الاصطناعي لديك
مدونة
رؤى وتحديثات حول Botpress وعوامل الذكاء الاصطناعي
المبنى
ديسكورد
انضم إلى آلاف الأقران وشارك الأفكار
مستندات
أدلة ومراجع شاملة
واجهة برمجة التطبيقات
مواد مرجعية للاستخدام مع الأنظمة الخارجية
LLM الترتيب
مقارنة الأداء والتكلفة لمقدمي الخدمات النموذجية
مقاطع الفيديو
برامج تعليمية وعروض توضيحية وعروض تجول للمنتج
سجل التغييرات
ابق على اطلاع دائم بآخر تحديثات Botpress
شركاء
كن شريكًا
انضم إلى شبكتنا من الخبراء المعتمدين
استعن بخبير
تواصل مع الشركاء والاستشاريين
مستندات
مؤسسة
الأسعار
تسجيل الدخول
اتصل بناالتسجيل
العودة إلى Hub

Weavel

v3.0.0
التثبيت على مساحة العمل الخاصة بك
تتم الصيانة بواسطة 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).

بناء أفضل مع Botpress

صمم تجارب عملاء الذكاء الاصطناعي المذهلة.

ابدأ الآن- مجانًا
أيقونة سهم
تعرف على المزيد في Botpress Academy

أنشئ وكلاء الذكاء الاصطناعي بشكل أفضل وأسرع مع مجموعتنا المنسقة من الدورات التدريبية والأدلة والبرامج التعليمية.

استعن بخبير

تواصل مع مطورينا المعتمدين للعثور على مطور خبير يناسب احتياجاتك.

جميع الأنظمة قيد التشغيل
SOC 2
معتمد
اللائحة العامة لحماية البيانات العامة
متوافق
© 2025
المنصة
الأسعار
استوديو الوكيل
المحرك المستقل
قواعد المعرفة
الجداول
مجمع
التكاملات
القنوات
LLMs
موارد
تحدث إلى مسؤولي المبيعات
مستندات
استعن بخبير
مقاطع الفيديو
قصص العملاء
مراجع واجهة برمجة التطبيقات
مدونة
الحالة
مصادر الإصدار رقم 12
المجتمع
دعم المجتمع
كن شريكًا
كن سفيراً
كُن شريكًا
الشركة
عننا
الوظائف
الأخبار والصحافة
قانوني
الخصوصية
Botpress 2025