ملفات تعريف الارتباط، بموافقتكم فقط

نستخدم ملفات تعريف الارتباط لنفهم كيف يُستخدم الموقع ولنحسّن إعلاناتنا. الملفات الأساسية مفعّلة دائمًا، أما الباقي فلن نفعّله إلا إذا وافقتم.الملفات الأساسية مفعّلة دائمًا. القياس والتسويق فقط إذا وافقتم. سياسة الخصوصية

ما الذي يُسمح لنا بقياسه؟

يمكنكم تغيير اختياركم في أي وقت من «إعدادات ملفات تعريف الارتباط» أسفل الصفحة.

اختيار اللغة: العربية
انضموا

Troupia API

اربط أي نظام بالأتمتة والتشغيلات والمحادثات لديك، بمفتاح واحد.

أولًا: مفتاح API

ينشئه المالك أو المسؤول من الإعدادات ← مفاتيح API ويحدد ما يُسمح له به. كل طلب يرسله هكذا:

Authorization: Bearer trp_live_…

الأتمتة

GET/v1/automations

All automations

Your workspace's automations, a page at a time.

automations:read
GET/v1/automations/{automationId}

One automation

Its steps, every way it starts and its version. Never a secret.

automations:read
ETag: "7.1a2b3c4d"

احتفظ بالـ ETag. التغيير يرسله مرة أخرى.

PATCH/v1/automations/{automationId}

Rename

automations:write
If-Match: "7.1a2b3c4d"

إذا غيّر أحدهم الأتمتة منذ قرأتها: 412، ولا يُستبدل شيء. اقرأها مجددًا وقرّر.

POST/v1/automations/{automationId}/enable

Turn on

The plan's schedule floor applies, as in the app.

automations:write
If-Match: "7.1a2b3c4d"

طلب الحالة القائمة أصلًا يعيد 200 ولا يغيّر شيئًا. التشغيلات المجدولة تبقى.

POST/v1/automations/{automationId}/disable

Turn off

automations:write
If-Match: "7.1a2b3c4d"

طلب الحالة القائمة أصلًا يعيد 200 ولا يغيّر شيئًا. التشغيلات المجدولة تبقى.

POST/v1/automations/resolve-link

From a link

A Troupia link → the automation or run it names.

automations:read

التشغيلات

GET/v1/automations/{automationId}/runs

An automation's runs

A page at a time.

runs:read
GET/v1/automations/{automationId}/analysis

Runs analysed

How many succeeded, how many failed and why, over a window.

runs:read
GET/v1/automations/runs/{runId}

One run

With what went in and out of each step.

runs:read_payloads
GET/v1/runs/{runId}

A chat run

data:read

المحادثات

GET/v1/conversations

Conversations

data:read
POST/v1/conversations

Start a conversation

chat:write
POST/v1/conversations/{conversationId}/messages

Send a message

chat:write
GET/v1/conversations/{conversationId}/export

Export a conversation

data:read

Webhooks

GET/v1/automations/{automationId}/webhook

Webhook addresses and their secrets

webhooks:manage

مفتاح المالك أو المسؤول فقط: يُفحص في كل طلب، وكل طلب يُسجَّل.

GET/v1/webhook-endpoints/{endpointId}/deliveries

Failed deliveries

To one outgoing endpoint: newest first, a page at a time.

webhooks:manage

الإضافات

GET/v1/plugins/{slug}/openapi.json

A plugin's API

Each plugin publishes its own OpenAPI document.

data:read
GET/v1/plugins/{slug}/{entity}

A plugin's records

data:read
POST/v1/plugins/{slug}/{entity}

Create a record

data:write
GET/v1/plugins/{slug}/{entity}/{id}

One record

data:read
PATCH/v1/plugins/{slug}/{entity}/{id}

Update a record

data:write
GET/v1/plugins/crm/{path}

Read from the CRM

crm:read
POST/v1/plugins/crm/{path}

Write to the CRM

crm:write

حول الـ API

GET/v1/openapi.json

This document

As OpenAPI 3.1, no key needed.

بدون مفتاح

عندما لا يمر الطلب

401لا يوجد مفتاح، أو أنه غير صالح.
403ليس لدى المفتاح هذه الصلاحية.
404غير موجود في مساحة العمل هذه.
412تغيّرت الأتمتة منذ قرأتها.
428If-Match مفقود.
429طلبات كثيرة جدًا. انتظر وحاول مجددًا.
المستند الكامل: openapi.json

إمكانية الوصول

التسجيل لم يُفتح بعد

كونوا الأوائل في الصف الأول

نحن في البروفات الأخيرة. اتركوا بياناتكم، وسنرسل لكم دعوة شخصية لحظة رفع الستار.اتركوا بريدكم، وسنرسل دعوة شخصية عند رفع الستار.

لن نرسل رسائل مزعجة. سياسة الخصوصية