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

# HubSpot أخطاء المزامنة

> تشخيص حالات عدم إرسال نماذج HubSpot، وإجراءات سير العمل المتوقفة، وتحديثات جهات الاتصال التي لا تصل إلى HubSpot عبر تكامل Flowella، وكيف تصلحها بسرعة.

تندرج معظم مشكلات "HubSpot
" ضمن إحدى الفئات الثلاث التالية: **انقطاع الاتصال بالتكامل**، أو **خطأ في تعيين الحقول**، أو **خطأ في تكوين إجراء سير العمل**. تتناول هذه الصفحة هذه المشكلات بالترتيب.

للإعداد الأولي، راجع [إعداد HubSpot
](/ar/hubspot/setup). بالنسبة لإجراءات سير العمل، راجع [إجراءات سير العمل](/ar/hubspot/workflow-actions).

## 1. تحقق من الاتصال

<Steps>
  <Step title="فتح الإعدادات → هب سبوت">
    من تطبيق Flowella
    ، انتقل إلى \*\*الإعدادات → HubSpot
    \*\*.
  </Step>

  <Step title="قراءة شارة الحالة">
    تعني الشارة الخضراء **Connected** أن رمز OAuth
    صالح. ويعني الشعار الأحمر **Reconnect** أن الرمز قد تم إلغاؤه أو انتهت صلاحيته.
  </Step>

  <Step title="إعادة الاتصال إذا لزم الأمر">
    انقر على **Reconnect** وقم بإجراء HubSpot
    OAuth
    مرة أخرى. ثم أعد محاولة الإجراء الفاشل.
  </Step>
</Steps>

<Info>
  الأسباب الشائعة لفشل اتصال HubSpot
  :

  * تمت إزالة المستخدم HubSpot
    الذي أذن بـ Flowella
    من البوابة.
  * قام HubSpot
    بتدوير الرمز لأنه لم يتم استخدامه مؤخرًا.
  * قام أحد المسؤولين الفائقين بتعطيل تكامل Flowella
    في إعدادات تطبيق HubSpot
    .
</Info>

## 2. عدم ظهور عمليات إرسال النماذج في HubSpot

إذا أكمل أحد جهات الاتصال نموذج WhatsApp Flow
ولكن لا يمكنك رؤية الإرسال في HubSpot
:

### عدم تطابق تعيين الحقول

قد يتضمن التدفق حقلًا لا يتم تعيينه إلى خاصية HubSpot
من نوع متوافق. افتح النموذج في صفحة [Forms](/ar/app/forms) وراجع تعيين كل حقل.

### الحقل المطلوب فارغ

إذا تم وضع علامة "مطلوب" على حقل نموذج HubSpot
وسمح WhatsApp Flow
للمستخدم بتخطيه، فسيتم رفض الإرسال بواسطة HubSpot
. اجعل الحقل اختياريًا في HubSpot
، أو مطلوبًا في التدفق.

### تنسيق رقم الهاتف

HubSpot
صارم فيما يتعلق بتنسيق رقم الهاتف. راجع [تنسيق رقم الهاتف](/ar/hubspot/phone-number-format) — تعود معظم مشكلات "الاتصال المفقود" إلى الاختلاف بين تنسيق E.164 والتنسيق الوطني.

### يتم البحث بعد تشغيل إجراء سير العمل

إذا تم تشغيل سير العمل الخاص بـ HubSpot
فورًا عند إرسال النموذج، فقد تؤدي حالات التنافس إلى تشغيل سير العمل قبل أن تنتهي Flowella
من كتابة جهة الاتصال. أضف تأخيرًا قصيرًا (1-2 دقيقة) في بداية سير العمل، أو قم بتشغيله عند تغيير خاصية جهة الاتصال بدلاً من إرسال النموذج.

## 3. توقف إجراءات سير العمل أو فشلها

إذا توقف سير العمل "HubSpot
" الذي يتضمن إجراء "Flowella
":

### افتح سجل إجراءات سير العمل

في HubSpot
، ابحث عن جهة الاتصال، وانتقل إلى **Workflow History**، وانقر فوق التشغيل الفاشل. يعرض HubSpot
الاستجابة Flowella
التي تم إرجاعها لكل إجراء.

### استجابات الأخطاء الشائعة

| الخطأ                                                                                                                          | ما يجب فعله |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| `Channel not found`                                                                                                            |             |
| يشير سير العمل إلى قناة لم تعد موجودة. قم بتحرير الإجراء واختر قناة حالية. انظر [متعدد القنوات](/ar/essentials/multi-channel). |             |
| `Template not approved`                                                                                                        |             |
| تغيرت حالة القالب المشار إليه إلى`REJECTED`                                                                                    |             |
| أو`PAUSED`                                                                                                                     |             |
| أو`DISABLED`                                                                                                                   |             |
| . راجع [رفض القالب](/ar/troubleshooting/template-rejected).                                                                    |             |
| `Contact opted out`                                                                                                            |             |
| قام جهة الاتصال بإلغاء الاشتراك في هذه القناة. احترم إلغاء الاشتراك — لا تحاول التحايل عليه.                                   |             |
| `Phone number invalid`                                                                                                         |             |
| رقم هاتف جهة الاتصال غير متوافق مع معيار E.164. راجع [تنسيق رقم الهاتف](/ar/hubspot/phone-number-format).                      |             |
| `Subscription required`                                                                                                        |             |
| لا تتضمن خطة Flowella                                                                                                          |             |
| الخاصة بك هذا الإجراء، أو انتهت صلاحية اشتراكك. راجع [الفوترة](/ar/account/billing).                                           |             |

### الإجراء موجود ولكنه لا يؤدي إلى أي نتيجة

إذا تم تشغيل سير العمل دون أخطاء ولكن لم تصل أي رسالة، فقم بالتحقق مرة أخرى مما يلي:

* أن الإجراء ممكّن (وليس متوقفًا مؤقتًا).
* أن المستلم مسجل في سير العمل في الخطوة الصحيحة.
* أن معايير التسجيل في HubSpot
  لا تزال تتطابق مع جهة الاتصال.

## 4. التباس اتجاه المزامنة مزامنة

Flowella
**ثنائية الاتجاه ولكنها جزئية**:

* عمليات الإرسال من WhatsApp Flow
  → كتابة خصائص جهة الاتصال إلى HubSpot
  .
* إجراءات سير العمل من HubSpot
  → إرسال رسائل وقوالب WhatsApp
  .
* الردود الواردة من WhatsApp
  → تسجيلها في خط زمني لجهة الاتصال (لا يتم تحديث الخصائص تلقائيًا).

إذا كنت تتوقع أن يقوم الرد الحر WhatsApp
بتحديث خاصية ما، فهذا يتطلب خطوة إضافية من جانبك — سير عمل HubSpot
يراقب حدث المحادثة ويحلل الرد، أو تكامل مخصص عبر [API](/ar/api-reference/introduction).

## هل ما زلت تواجه مشكلة؟

<Note>
  قم بتسجيل ما يلي قبل الاتصال بـ [الدعم](https://flowella.io/support):

  * الطابع الزمني لـ **آخر مزامنة** من \*\*الإعدادات → HubSpot
    \*\*

  * رسالة الخطأ الدقيقة (أو لقطة شاشة) التي تم إرجاعها من Flowella
    أو HubSpot

  * معرف جهة الاتصال المتأثرة ومعرف سير العمل
</Note>