> ## 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.

تندرج معظم مشكلات "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/flows) وراجع تعيين كل حقل.

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

إذا تم وضع علامة "مطلوب" على حقل نموذج 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). | |
| `DUPLICATE_TEMPLATE_SEND_SUPPRESSED` | سبق إرسال القالب نفسه إلى رقم الهاتف نفسه ضمن نافذة منع التكرار في Flowella. هذا حاجز مقصود وليس فشلًا في التسليم. راجع [Template send suppressed as duplicate](#template-send-suppressed-as-duplicate). |

### Template send suppressed as duplicate

إذا أظهرت HubSpot أن إجراء **إرسال قالب WhatsApp** قد اكتمل مع سبب الخطأ `DUPLICATE_TEMPLATE_SEND_SUPPRESSED`، فإن Flowella تعمّدت تخطّي الإرسال لأن القالب نفسه سبق أن أُرسل إلى رقم الهاتف نفسه ضمن نافذة منع التكرار.

السبب الأكثر شيوعًا هو **مشاركة جهتَي اتصال في HubSpot لرقم الهاتف نفسه** — على سبيل المثال سجل شخصي وسجل عمل، أو أسرة تستخدم رقم WhatsApp واحدًا — يتم تسجيلهما في سير العمل نفسه خلال ثوانٍ من بعضهما. يذهب الإرسال الأول فقط إلى WhatsApp؛ ويُمنع الثاني حتى لا تتلقّى جهة الاتصال الرسالة نفسها مرتين.

في السابق كان إجراء سير العمل الثاني يظل في حالة **قيد الانتظار** لنحو ساعة حتى انتهاء مهلة استدعاء HubSpot. تُكمل Flowella الآن الاستدعاء فورًا كإخفاق حتى تنتقل جهة الاتصال المسجَّلة إلى الخطوة التالية (أو فرع "فشل الإجراء") دون انتظار.

**كيف تميّزه عن فشل حقيقي:**

* **ممنوع بسبب التكرار** — سبب الخطأ هو `DUPLICATE_TEMPLATE_SEND_SUPPRESSED` بالضبط. لقد أُرسل القالب فعلًا إلى ذلك الرقم، ولكن عبر جهة اتصال مسجَّلة أخرى. لا حاجة لأي إجراء.
* **فشل إرسال حقيقي** — سيكون الخطأ سببًا محددًا مثل `Template not approved` أو `Phone number invalid` أو `Contact opted out`، أو رمز خطأ من Meta Graph. اتّبع الصف المناسب في الجدول أعلاه.

إذا كنت تحتاج فعلًا إلى إرسال القالب نفسه إلى الرقم نفسه مرتين (على سبيل المثال إعادة تأكيد بعد فترة طويلة)، فباعد بين التسجيلَين بحيث يتجاوزا نافذة منع التكرار أو استخدم قالبًا مختلفًا.

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

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

* أن الإجراء ممكّن (وليس متوقفًا مؤقتًا).
* أن المستلم مسجل في سير العمل في الخطوة الصحيحة.
* أن معايير التسجيل في 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>


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