تخطَّ إلى المستندات
خادم MCP

عمليات الاستيراد

بريد قديم يصل، وانتقالات من مزوّد آخر.

أدوات الاستيراد

الأداةما تفعله
listImportsعمليات استيراد البريد القديم إلى مساحة العمل، الأحدث أولًا، مع حالتها وتقدّمها. يُبقي addressId على تلك الموجّهة إلى عنوان واحد.
getImportاستيراد واحد بمعرّفه: ملفاته، وإلى أي حد قرأ، وكم رسالة استورد.
listImportFailuresالرسائل التي لم يستطع الاستيراد إدخالها، والسبب.
cancelImportيوقف استيرادًا ما زال يعمل. يبقى البريد الذي استورده بالفعل. وفي دردشة التطبيق يسأل دائمًا أولًا.
listProviderImportsعمليات الاستيراد من مزوّد بريد آخر، مثل Resend، الأحدث أولًا، مع حالتها.
getProviderImportاستيراد واحد من مزوّد آخر مع تقريره: ما انتقل، والنطاقات التي يجب نشرها هنا، ومفاتيح API التي يجب استبدالها.
cancelProviderImportيوقف استيرادًا من مزوّد آخر ما زال يعمل. يبقى ما نقله بالفعل. وفي دردشة التطبيق يسأل دائمًا أولًا.

تحتاج عمليات استيراد البريد القديم إلى threads:read، وإلى threads:write لإلغاء إحداها. والعميل المقصور على بعض العناوين لا يرى إلا عمليات الاستيراد إليها.

تحتاج عمليات الاستيراد من مزوّد آخر إلى settings:read، وإلى settings:write لإلغاء إحداها. ولا يصل إليها إلا مالك مساحة العمل.

لا توجد أداة ترفع البريد أو تبدأ استيرادًا، لأن الملفات تُرفع على أجزاء والاستيراد من مزوّد آخر يحتاج إلى مفتاح API الخاص به. ابدأ واحدًا من صفحة «عمليات النقل» في التطبيق، أو عبر POST /imports وPOST /provider-imports في REST API.

المرجع

listImports

الصلاحياتthreads:readينفّذه مساعد التطبيق دون أن يسألمجموعة الأدواتworkspace

The imports of old mail into this workspace, newest first, as the Migrations page of the app lists them: the address each one fills, its status, how far it has read and how many messages it imported. addressId keeps the ones into one address. A member sees the imports into the addresses they reach. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.

المدخلات

addressIdstring
من 1 إلى 128 من الأحرف
limitinteger
على الأقل 1على الأكثر 100
cursorstring

متاح أيضًا في

API
GET /imports
SDK
imports.list()imports.listAll()imports.iterate()

getImport

الصلاحياتthreads:readينفّذه مساعد التطبيق دون أن يسألمجموعة الأدواتworkspace

One import of old mail by its id: its status, the files it reads, how far it has read, and how many messages it imported, found already here, left out or could not import. listImportFailures says which messages did not import and why.

المدخلات

idstringمطلوب
من 1 إلى 128 من الأحرف

متاح أيضًا في

API
GET /imports/{id}
SDK
imports.get()

listImportFailures

الصلاحياتthreads:readينفّذه مساعد التطبيق دون أن يسألمجموعة الأدواتworkspace

The messages an import could not bring in, in the order it met them, with the reason for each, as What was not imported on the Migrations page shows them. When more follow, the last line gives the after value to pass back for the next page.

المدخلات

idstringمطلوب
من 1 إلى 128 من الأحرف
afterinteger
على الأقل -1
limitinteger
على الأقل 1على الأكثر 100

متاح أيضًا في

API
GET /imports/{id}/failures
SDK
imports.listFailures()

cancelImport

الصلاحياتthreads:writeيسأل مساعد التطبيق دائمًا أولًامجموعة الأدواتworkspace

Stop an import of old mail that is still uploading, waiting or running, as Cancel import on the Migrations page does. Mail it already imported stays in the mailbox. A chat always asks first.

المدخلات

idstringمطلوب
من 1 إلى 128 من الأحرف

متاح أيضًا في

API
POST /imports/{id}/cancel
SDK
imports.cancel()

listProviderImports

الصلاحياتsettings:readينفّذه مساعد التطبيق دون أن يسألمجموعة الأدواتworkspace

The imports from another email provider, such as Resend, into this workspace, newest first: what each one brings across and its status. Only the workspace owner reaches them. getProviderImport gives the full report of one. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.

المدخلات

limitinteger
على الأقل 1على الأكثر 100
cursorstring

متاح أيضًا في

API
GET /provider-importsGET /provider-imports/{id}
SDK
providerImports.list()providerImports.listAll()providerImports.iterate()providerImports.get()

getProviderImport

الصلاحياتsettings:readينفّذه مساعد التطبيق دون أن يسألمجموعة الأدواتworkspace

One import from another email provider by its id, with its report as the Migrations page shows it: what came across, the domains to publish here, the API keys to replace and what was not brought across. Only the workspace owner reaches it.

المدخلات

idstringمطلوب
من 1 إلى 128 من الأحرف

متاح أيضًا في

API
GET /provider-importsGET /provider-imports/{id}
SDK
providerImports.list()providerImports.listAll()providerImports.iterate()providerImports.get()

cancelProviderImport

الصلاحياتsettings:writeيسأل مساعد التطبيق دائمًا أولًامجموعة الأدواتworkspace

Stop an import from another email provider that is still waiting or running. What it already brought across stays. Only the workspace owner can, and a chat always asks first.

المدخلات

idstringمطلوب
من 1 إلى 128 من الأحرف

متاح أيضًا في

API
POST /provider-imports/{id}/cancel
SDK
providerImports.cancel()