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

# تفسير Monitor

> عاين Monitor قبل بنائه — حوّل طلبًا بلغة طبيعية (بأي لغة) إلى ضبط **مسودة** مُتحقَّق منه يمكنك فحصه، وتعديله، ثم تقديمه إلى [إنشاء Monitor](/ar/api-reference/endpoint/monitors/create). آمن استدعاؤه بقدر ما تحتاج: فهو يصيغ المسودة فقط، ولا يحفظ Monitor أبدًا، أو يرسل تنبيهات، أو ينفق أرصدة. استخدم `intent` لاختيار الإجراء؛ إن حُذف، يُطبَّق تخمين بالكلمات المفتاحية الإنجليزية والمدخل غير المعروف يُفترَض افتراضيًا كـ `create_monitor`.



## OpenAPI

````yaml ar-openapi POST /monitors/interpret
openapi: 3.0.0
info:
  description: >-
    تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت
    الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص
    التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في
    إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/ar/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/ar/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: معلومات ملف مساحة العمل وإحصاءات الاستخدام
  - name: Enrichment
    description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة
  - name: Lookalike
    description: إيجاد شركات مشابهة لشركة معينة
  - name: Search
    description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات
  - name: Lookup
    description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة
  - name: LinkedIn
    description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn
  - name: Redeem
    description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي)
  - name: Channels
    description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد)
  - name: Monitor
    description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة
  - name: Filters
    description: >-
      استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات،
      إلخ)
  - name: API Keys
    description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API
  - name: Insights
    description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات).
  - name: Export
    description: تصدير بيانات دفعي (مقيَّد بالأرصدة).
  - name: Expansion
    description: >-
      معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق،
      والتصدير.
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /monitors/interpret:
    post:
      tags:
        - Monitor
      summary: تفسير Monitor من اللغة الطبيعية
      description: >-
        عاين Monitor قبل بنائه — حوّل طلبًا بلغة طبيعية (بأي لغة) إلى ضبط
        **مسودة** مُتحقَّق منه يمكنك فحصه، وتعديله، ثم تقديمه إلى [إنشاء
        Monitor](/ar/api-reference/endpoint/monitors/create). آمن استدعاؤه بقدر
        ما تحتاج: فهو يصيغ المسودة فقط، ولا يحفظ Monitor أبدًا، أو يرسل تنبيهات،
        أو ينفق أرصدة. استخدم `intent` لاختيار الإجراء؛ إن حُذف، يُطبَّق تخمين
        بالكلمات المفتاحية الإنجليزية والمدخل غير المعروف يُفترَض افتراضيًا كـ
        `create_monitor`.
      operationId: interpretMonitor
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              properties:
                query:
                  type: string
                  maxLength: 2000
                  description: >-
                    الطلب باللغة الطبيعية (بأي لغة)، مثل "راقب الشركات المتوسعة
                    إلى اليابان، احصل على أشخاص من المستوى القيادي ببريد العمل
                    الخاص بهم، وأرسل تنبيهات بريد إلكتروني إلى me@company.com في
                    الوقت الفعلي". محدود بـ2000 حرف.
                intent:
                  type: string
                  enum:
                    - create_monitor
                    - dry_test
                    - execute
                    - analyze
                  description: >-
                    الإجراء المراد اتخاذه (بمعزل عن اللغة). `create_monitor`
                    (افتراضي): إعادة ضبط مسودة. `dry_test`: مسودة بالإضافة إلى
                    عدد للقراءة فقط للإشارات المطابقة حاليًا. `execute`: مسودة
                    بالإضافة إلى معاينة، موسومة للتأكيد (لا تُفعِّل تلقائيًا
                    أبدًا). `analyze` (مثل "أي سوق، سنغافورة أم اليابان؟"):
                    يُجيب عليها الوكيل التحليلي للتوسع بدلًا من بناء Monitor. إن
                    حُذف، يُستخدَم تخمين بالكلمات المفتاحية الإنجليزية؛ والمدخل
                    غير المعروف يُفترَض افتراضيًا كـ `create_monitor`.
                deep:
                  type: boolean
                  description: >-
                    شغّل تمريرة التفكير التأملي لدقة أعلى (الافتراضي true؛ يضاعف
                    تقريبًا زمن الاستجابة). اضبطه على false لتفسير أسرع بتمريرة
                    واحدة.
            example:
              query: >-
                monitor companies expanding into Japan, get C-level people with
                their work email, and email alerts to me@company.com in real
                time
      responses:
        '200':
          description: المسودة المفسَّرة. لا شيء يُحفَظ.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      intent:
                        type: string
                        enum:
                          - create_monitor
                          - dry_test
                          - execute
                          - analyze
                        description: >-
                          الإجراء المُحدَّد (create_monitor / dry_test / execute
                          / analyze).
                      no_intent:
                        type: boolean
                        description: >-
                          true عندما لم يكن الطلب إعداد Monitor (تحية، خارج
                          الموضوع، أو غير منطقي)؛ تكون `config` عندئذٍ فارغة
                          (null).
                      config:
                        type: object
                        nullable: true
                        description: >-
                          ضبط Monitor المسودة، بنفس شكل جسم طلب [إنشاء
                          Monitor](/ar/api-reference/endpoint/monitors/create)
                          بالضبط (detection_mode، signal_types، signal_filters،
                          people_enrichment_configs،
                          destination_type/destination_config، frequency_minute،
                          status "draft"، وهكذا). قدّمه إلى إنشاء Monitor
                          لتفعيله. قد يحمل أيضًا
                          `domains`/`linkedin_urls`/`company_names`، التي يحلّها
                          إنشاء Monitor إلى شركات. فارغ (null) عندما تكون
                          `no_intent` صحيحة.
                      missing_fields:
                        type: array
                        items:
                          type: string
                        description: >-
                          الحقول المطلوبة قبل أن يمكن تفعيل الـ Monitor (مثل
                          "destination"، "signal_types"، "companies"). اجمعها في
                          واجهتك قبل التقديم إلى إنشاء Monitor.
                      requires_confirmation:
                        type: boolean
                        description: >-
                          true للنية `execute` — الضبط جاهز لكن يجب على المستخدم
                          التأكيد قبل تفعيله.
                      preview:
                        type: object
                        nullable: true
                        description: >-
                          موجود لـ `dry_test` و`execute`: تقدير للقراءة فقط لعدد
                          الإشارات المطابقة حاليًا، لكل نوع إشارة، خلال آخر 30
                          يومًا (مُعايَن). لا تُنفَق أي أرصدة.
                      interpretation:
                        type: object
                        description: >-
                          عرض للحقول الخام المستخرَجة من الاستعلام، للعرض أو
                          التصحيح.
              example:
                data:
                  intent: create_monitor
                  no_intent: false
                  config:
                    detection_mode: signal_first
                    signal_types:
                      - expansions
                    signal_filters:
                      - signal_type: expansions
                        filters:
                          tos:
                            - JP
                          stages:
                            - exploring
                            - committing
                    company_filters: {}
                    companies: []
                    is_company_enrichment: false
                    is_people_enrichment: true
                    people_enrichment_configs:
                      - max_people_to_return: 5
                        filters:
                          management_levels:
                            - c_suite
                        people_contact_types:
                          - email-work
                    name: Expansion signals → JP
                    destination_type: email
                    destination_config:
                      emails:
                        - me@company.com
                    frequency_minute: 5
                    status: draft
                  missing_fields: []
                  requires_confirmation: false
                  preview: null
                  interpretation:
                    signal_types:
                      - expansions
                    tos:
                      - JP
                    management_levels:
                      - c_suite
                    people_contact_types:
                      - email-work
                    destination_email: me@company.com
                    is_realtime: true
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  responses:
    general_error:
      description: >-
        طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة.
        تحقق من رمز الخطأ والرسالة للتفاصيل.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد
        المحاولة بعد إعادة ضبط نافذة حد المعدل.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر
        الخطأ.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات
        والعمليات المقابلة. يمكنك إنشاءه عبر قسم
        [Settings](https://dashboard.pubrio.com/#/settings/).
      in: header

````