> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# نقطة نهاية Chatwoot

> يستقبل أحداث webhook من Chatwoot ويرسل رسائل إلى WhatsApp.
تكوين هذا الرابط في إعدادات صندوق البريد الوارد الخاص بك في Chatwoot.

عند تعيين CHATWOOT_WEBHOOK_SECRET يجب أن يثبت الطلب علمه بـ
 الموصى به: توقيع Chatwoot نفسه، الذي يرسله Chatwoot عندما تكون لقناة API
قيمة سرية للـ webhook — `X-Chatwoot-Timestamp` (بالثواني منذ بداية حقبة Unix) و
`X-Chatwoot-Signature: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw body>">`.
يجب أن يكون الطابع الزمني داخل CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE (5m من
الافتراضي) لساعة الخادم. يُقبَل أيضًا: `X-Hub-Signature-256`
(قيمة HMAC-SHA256 لمحتوى الطلب الخام)، أو القيمة السرية في `X-Chatwoot-Webhook-Secret`
أو `X-Gowa-Chatwoot-Secret`، أو معامل الاستعلام `secret` (لا يُنصح به:
إذ تظهر القيمة السرية عندئذ في عناوين URL والسجلات).

السر الذي ينطبق هو سر الجهاز الذي تحمله هو
موجه إلى: إعدادات الجهاز `webhook_secret` عندما يكون لديه واحد (أسرار
العالمية غير مقبولة لها)، CHATWOOT_WEBHOOK_SECRET
خلاف ذلك وعندما لا يحل أي جهاز. طلب توقيع Chatwoooo الذي تم قبوله بالفعل
(تمت الإجابة على 2xx) داخل نافذة التسامح هو
تم إقراره بـ 200 ولم يتم اتخاذ إجراء بشأنه مرة أخرى. لا نتذكر واحدة تمت الإجابة عليها
مع أي حالة أخرى، لذا يتم معالجة الطلب
المتطابق مرة أخرى.




## OpenAPI

````yaml /ar/openapi.yml post /chatwoot/webhook
openapi: 3.0.0
info:
  title: واتسآب API متعدد الأجهزة
  version: 9.7.0
  description: >
    يتم استخدام هذا API لإرسال أي تطبيق عبر API.


    لوحة المعلومات هي مشروع منفصل (gowa-ui)؛ يقوم الخادم بتنزيل أحدث أصول
    الإصدار

    ويخدمه في `/` (أو يرجع لافتة JSON عندما

    APP_UI_ENABLED=false).


    تحديد الجهاز:

    - إرسال `X-Device-Id` على جميع مكالمات REST على نطاق الجهاز.

    - WebSocket: الاتصال بـ `/w?جهاز_id=<id>`.

    - مصادقة WebSocket (عندما يتم تمكين المصادقة الأساسية): المتصفحات لا يمكن
    تعيين
      رأس التفويض على اتصالات WebSocket ، كذلك اجتاز
      `&authorization=<base64(user:pass)>` في سلسلة الاستفسار. استخدم TLS في إنتاج
      لأن بيانات الاعتماد مرئية في عنوان URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: الاتصال الأولي بخادم Whatsapp
  - name: device
    description: إدارة الجهاز لدعم الأجهزة المتعددة
  - name: user
    description: الحصول على المعلومات
  - name: send
    description: إرسال رسالة (نص/صورة/ملف/فيديو).
  - name: message
    description: التلاعب بالرسالة (إلغائ/react/update).
  - name: call
    description: إدارة المكالمات (رفض المكالمات الواردة)
  - name: chat
    description: محادثات الدردشة والرسائل
  - name: group
    description: إعداد المجموعة
  - name: newsletter
    description: إعداد النشرة الإخبارية
  - name: chatwoot
    description: تكامل Chatwoot لدعم العملاء
paths:
  /chatwoot/webhook:
    post:
      tags:
        - chatwoot
      summary: نقطة نهاية Chatwoot
      description: >
        يستقبل أحداث webhook من Chatwoot ويرسل رسائل إلى WhatsApp.

        تكوين هذا الرابط في إعدادات صندوق البريد الوارد الخاص بك في Chatwoot.


        عند تعيين CHATWOOT_WEBHOOK_SECRET يجب أن يثبت الطلب علمه بـ
         الموصى به: توقيع Chatwoot نفسه، الذي يرسله Chatwoot عندما تكون لقناة API
        قيمة سرية للـ webhook — `X-Chatwoot-Timestamp` (بالثواني منذ بداية حقبة
        Unix) و

        `X-Chatwoot-Signature: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw
        body>">`.

        يجب أن يكون الطابع الزمني داخل CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE (5m
        من

        الافتراضي) لساعة الخادم. يُقبَل أيضًا: `X-Hub-Signature-256`

        (قيمة HMAC-SHA256 لمحتوى الطلب الخام)، أو القيمة السرية في
        `X-Chatwoot-Webhook-Secret`

        أو `X-Gowa-Chatwoot-Secret`، أو معامل الاستعلام `secret` (لا يُنصح به:

        إذ تظهر القيمة السرية عندئذ في عناوين URL والسجلات).


        السر الذي ينطبق هو سر الجهاز الذي تحمله هو

        موجه إلى: إعدادات الجهاز `webhook_secret` عندما يكون لديه واحد (أسرار

        العالمية غير مقبولة لها)، CHATWOOT_WEBHOOK_SECRET

        خلاف ذلك وعندما لا يحل أي جهاز. طلب توقيع Chatwoooo الذي تم قبوله بالفعل

        (تمت الإجابة على 2xx) داخل نافذة التسامح هو

        تم إقراره بـ 200 ولم يتم اتخاذ إجراء بشأنه مرة أخرى. لا نتذكر واحدة تمت
        الإجابة عليها

        مع أي حالة أخرى، لذا يتم معالجة الطلب

        المتطابق مرة أخرى.
      operationId: chatwootWebhook
      parameters:
        - name: X-Chatwoot-Signature
          in: header
          description: >-
            توقيع Chatwooot: sha256=<hex HMAC-SHA256 of "<timestamp>.<raw body>"
            مفتاح مع سر ويبهوك >
          schema:
            type: string
        - name: X-Chatwoot-Timestamp
          in: header
          description: Unix time (بالثواني) تم التوقيع على webhook في
          schema:
            type: string
        - name: secret
          in: query
          description: سر الويبهوك. تثبيط؛ يفضل ترويسة التوقيع.
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: حمولة ويب هوك Chatwoot (انظر وثائق Chatwoot)
      responses:
        '200':
          description: تم معالجة Webhook
        '401':
          description: >-
            السر أو التوقيع مفقود أو غير صالح للجهاز الذي يتم توجيه الطلب إليه،
            أو أن التوقيع الزمني خارج نافذة التسامح
        '503':
          description: >-
            الجهاز غير متوفر، اعدادات الجهاز الموجه لا يمكن قراءتها، أو لا يزال
            يتم التعامل مع طلب توقيع مطابق
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
components:
  schemas:
    ErrorBadRequest:
      type: object
      properties:
        code:
          type: string
          example: 400
          description: رمز حالة HTTP
        message:
          type: string
          example: field cannot be blank
          description: تفاصيل رسالة الخطأ
        results:
          type: object
          example: null
          description: بيانات إضافية
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [نقطة نهاية Chatwoot للجهاز](https://gowa-docs.mintlify.site/ar/api-reference/chatwoot/نقطة-نهاية-chatwoot-للجهاز.md)
- [تكامل Chatwoot](https://gowa-docs.mintlify.site/ar/integrations/chatwoot.md)
- [مزامنة سجل الرسائل إلى Chatwoot](https://gowa-docs.mintlify.site/ar/api-reference/chatwoot/مزامنة-سجل-الرسائل-إلى-chatwoot.md)
- [مصادقة API](https://gowa-docs.mintlify.site/ar/api-reference/authentication.md)
- [إدارة المجموعة](https://gowa-docs.mintlify.site/ar/examples/group-management.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.