الانتقال إلى المحتوى
DocsSDKالصفقات (Deals)

الصفقات (Deals)

تم التحديث يوليو 2026·1 min

أنشئ الصفقات وحرّكها عبر المراحل وأبقِ القيم وجهات الاتصال متزامنة من أنظمتك.

لوح الصفقات وفرصه في أعمدة مراحل الخط مع قيمها.لوح الصفقات وفرصه في أعمدة مراحل الخط مع قيمها.

مثال سريع

مُدقّق الأنواع مقابل ‎@medalsocial/sdk v1.3.0 (2026-07-20). أي إصدار يغيّر توقيعًا يوقف بناء هذه الصفحة.

ts
import { Medal } from '@medalsocial/sdk';

const medal = new Medal(process.env.MEDAL_API_KEY as string);

// Create a deal tied to a contact
const { data: deal } = await medal.deals.create({
  title: 'Summer campaign — Solstice Coffee',
  value: 45_000,
  currency: 'NOK',
  contact_email: 'nora@solsticecoffee.no',
  end_date: '2026-09-01',
});

// Move it through the pipeline
await medal.deals.update(deal.id, { status: 'negotiating' });

// List open deals
const { data: deals } = await medal.deals.list({ limit: 50 });
console.log(deals.length, 'deals');

medal.deals.list()

List deals with cursor-based pagination and optional filters.

ts
list(options?: ListDealsOptions): Promise<PaginatedResponse<Deal>>
أُضيف في v1.0.0

medal.deals.create()

Create a new deal.

ts
create(input: CreateDealInput): Promise<ApiResponse<DealCreateResult>>
أُضيف في v1.0.0

medal.deals.get()

Get a deal by ID.

ts
get(id: string): Promise<ApiResponse<Deal>>
أُضيف في v1.0.0

medal.deals.update()

Update one or more fields on a deal. Set contact_id to null to unlink.

ts
update(id: string, input: UpdateDealInput): Promise<ApiResponse<DealUpdateResult>>
أُضيف في v1.0.0

medal.deals.remove()

Permanently delete a deal.

ts
remove(id: string): Promise<ApiResponse<DealRemoveResult>>
أُضيف في v1.0.0