עוגיות, ורק באישור שלכם

אנחנו משתמשים בעוגיות כדי להבין איך משתמשים באתר ולשפר את הפרסום שלנו. עוגיות חיוניות תמיד פעילות. את השאר נפעיל רק אם תאשרו.עוגיות חיוניות תמיד פעילות. מדידה ושיווק רק אם תאשרו. מדיניות הפרטיות

מה מותר לנו למדוד?

אפשר לשנות את הבחירה בכל רגע מ"הגדרות עוגיות" בתחתית העמוד.

בחירת שפה: עברית
הצטרפו

Troupia API

לחבר כל מערכת לאוטומציות, להרצות ולשיחות שלכם, עם מפתח אחד.

קודם כול: מפתח API

בעלים או מנהל יוצרים אותו בהגדרות ← מפתחות API, ובוחרים מה מותר לו. כל בקשה שולחת אותו כך:

Authorization: Bearer trp_live_…

אוטומציות

GET/v1/automations

כל האוטומציות

של סביבת העבודה, דף אחרי דף.

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

אוטומציה אחת

השלבים, כל הדרכים שבהן היא מתחילה, והגרסה. אף פעם לא סוד.

automations:read
ETag: "7.1a2b3c4d"

שמרו את ה-ETag. שינוי שולח אותו בחזרה.

PATCH/v1/automations/{automationId}

שינוי שם

automations:write
If-Match: "7.1a2b3c4d"

אם מישהו שינה את האוטומציה מאז שקראתם: 412, ושום דבר לא נדרס. קוראים שוב ומחליטים.

POST/v1/automations/{automationId}/enable

הפעלה

רצפת התזמון של התוכנית חלה, כמו באפליקציה.

automations:write
If-Match: "7.1a2b3c4d"

בקשה למצב שכבר קיים מחזירה 200 ולא משנה כלום. ריצות מתוזמנות לא נפגעות.

POST/v1/automations/{automationId}/disable

השהיה

automations:write
If-Match: "7.1a2b3c4d"

בקשה למצב שכבר קיים מחזירה 200 ולא משנה כלום. ריצות מתוזמנות לא נפגעות.

POST/v1/automations/resolve-link

מקישור לאוטומציה

קישור של Troupia ← האוטומציה או ההרצה שהוא מצביע עליה.

automations:read

הרצות

GET/v1/automations/{automationId}/runs

ההרצות של אוטומציה

דף אחרי דף.

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

ניתוח ההרצות

כמה הצליחו, כמה נכשלו ולמה, לאורך תקופה.

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

הרצה אחת

עם מה שנכנס ויצא בכל שלב.

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

הרצה של שיחה

data:read

שיחות

GET/v1/conversations

השיחות

data:read
POST/v1/conversations

פתיחת שיחה

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

שליחת הודעה

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

ייצוא שיחה

data:read

Webhooks

GET/v1/automations/{automationId}/webhook

כתובות ה-webhook והסודות שלהן

webhooks:manage

רק מפתח של בעלים או מנהל: נבדק בכל קריאה, וכל קריאה נרשמת ביומן.

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

מסירות שנכשלו

לכתובת יוצאת אחת: מהחדשה לישנה, דף אחרי דף.

webhooks:manage

תוספים

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

ה-API של תוסף

לכל תוסף מסמך OpenAPI משלו.

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

רשומות של תוסף

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

יצירת רשומה

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

רשומה אחת

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

עדכון רשומה

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

קריאה מה-CRM

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

כתיבה ל-CRM

crm:write

על ה-API

GET/v1/openapi.json

המסמך הזה

כ-OpenAPI 3.1, בלי מפתח.

בלי מפתח

כשמשהו לא עובר

401אין מפתח, או שהוא לא תקף.
403למפתח אין את ההרשאה הזו.
404לא נמצא בסביבת העבודה הזו.
412האוטומציה השתנתה מאז שקראתם.
428חסר If-Match.
429יותר מדי בקשות. חכו ונסו שוב.
הקובץ המלא: openapi.json

נגישות

ההרשמה עוד לא נפתחה

תהיו הראשונים בשורה הראשונה

אנחנו בחזרות אחרונות. השאירו פרטים, ונשלח לכם הזמנה אישית ברגע שהמסך עולה.השאירו מייל, ונשלח הזמנה אישית כשהמסך עולה.

לא נשלח ספאם. מדיניות הפרטיות