Freshservice (Önizleme)
Freshservice, kuruluş genelinde çalışan deneyimini dönüştürmek için kurulumu ve kullanımı kolay bulut tabanlı bir BT hizmet masası ve hizmet yönetimi çözümüdür.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | Freshworks Uygulama Desteği |
| URL | https://www.freshworks.com |
| E-posta | appsupport-ex@freshworks.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Microsoft |
| Web sitesi | https://www.freshworks.com/freshservice/lp/home/ |
| Gizlilik ilkesi | https://www.freshworks.com/privacy |
| Kategoriler | BT İşlemleri |
Authentication
Önemli
Kullanıcı adı ve parola tabanlı kimlik doğrulaması artık FreshService tarafından desteklenmiyor. Bağlayıcı artık yalnızca bir kimlik doğrulama türünü destekliyor: API Anahtarı. FreshService API Geçiş belgeleri
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| API Anahtarı | API Anahtarı kimlik doğrulama türü | Tüm bölgeler | Paylaşılamaz |
| Varsayılan [KULLANIM DIŞI] | Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır. | Tüm bölgeler | Paylaşılamaz |
API Anahtarı
Kimlik Doğrulama Kimliği: Temel
Geçerli: Tüm bölgeler
API Anahtarı kimlik doğrulama türü
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| API Anahtarı | String | Bu API için API Anahtarı | Doğru |
| Site url'si | String | Kök site url'si (Örnek: https://sample.freshservice.com ) | Doğru |
Varsayılan [KULLANIM DIŞI]
Geçerli: Tüm bölgeler
Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Kullanıcı adı | String | Bu API'nin kullanıcı adı | Doğru |
| Şifre | securestring | Bu API'nin parolası | Doğru |
| Site url'si | String | Kök site url'si (Örnek: https://sample.freshservice.com ) | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
| Tetikleyici yoklamalarının sıklığı | 1 | 120 saniye |
Eylemler
| Anahtara not ekleme [KULLANIM DIŞI] |
Bir bilete özel veya genel not ekleyin. |
| Bilet oluşturma (V2) |
Bir bilet oluşturun. |
| Bilet oluşturma [KULLANIM DIŞI] |
Bir bilet oluşturun. |
| Bilete not ekleme (V2) |
Bir bilete özel veya genel not ekleyin. |
| Bileti güncelleştirme (V2) |
Bir bileti güncelleştirin (yalnızca belirtilen değerler güncelleştirilir). |
| Bir bileti güncelleştirme [KULLANIM DIŞI] |
Bir bileti güncelleştirin (yalnızca belirtilen değerler güncelleştirilir). |
Anahtara not ekleme [KULLANIM DIŞI]
Bir bilete özel veya genel not ekleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Güncelleştirilecek bilet kimliği. |
|
Uyarı
|
body | True | string |
Bilete eklenecek not. |
|
Özel mi
|
private | boolean |
İleti özelse true olarak ayarlayın. |
Döndürülenler
- Body
- AddNote_Response
Bilet oluşturma (V2)
Bir bilet oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İstek Sahibi Kimliği
|
requester_id | integer |
İstekte bulunanın kullanıcı kimliği. İstek Sahibi Kimliği, İstek Sahibi E-postası ve İstek Sahibi Telefonu gereklidir |
|
|
İstek Sahibi E-postası
|
string |
İstekte bulunanın e-posta adresi. İstek Sahibi Kimliği, İstek Sahibi E-postası ve İstek Sahibi Telefonu gereklidir |
||
|
İstek Sahibi Telefonu
|
phone | string |
İstekte bulunanın telefon numarası. İstek Sahibi Kimliği, İstek Sahibi E-postası ve İstek Sahibi Telefonu gereklidir |
|
|
İstek Sahibi Adı
|
name | string |
İstekte bulunanın adı. Bu, yalnızca İstek sahibi Telefon değeri sağlandığında gerekli bir alandır |
|
|
Konu
|
subject | True | string |
Biletin konusu. |
|
Statü
|
status | True | string |
Biletin durumu. |
|
Priority
|
priority | True | string |
Biletin önceliği (Düşük, Orta veya Yüksek gibi). |
|
Description
|
description | True | string |
Biletin açıklaması. |
|
Aciliyet
|
urgency | string |
Sorunun aciliyeti (Düşük, Orta veya Yüksek gibi). |
|
|
Etki
|
impact | string |
Sorunun etkisi (Düşük, Orta veya Yüksek gibi). |
|
|
Kaynak
|
source | string |
Biletin oluşturulduğu kanal. |
Döndürülenler
Bilet oluşturma [KULLANIM DIŞI]
Bir bilet oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İstek Sahibi Kimliği
|
requester_id | True | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
Konu
|
subject | True | string |
Biletin konusu. |
|
Statü
|
status | True | string |
Biletin durumu. |
|
Priority
|
priority | True | string |
Biletin önceliği (Düşük, Orta veya Yüksek gibi). |
|
Description
|
description | True | string |
Biletin açıklaması. |
|
Aciliyet
|
urgency | string |
Sorunun aciliyeti (Düşük, Orta veya Yüksek gibi). |
|
|
Etki
|
impact | string |
Sorunun etkisi (Düşük, Orta veya Yüksek gibi). |
|
|
Kaynak
|
source | string |
Biletin oluşturulduğu kanal. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
helpdesk_ticket
|
item.helpdesk_ticket | Ticket_Response |
Bilete not ekleme (V2)
Bir bilete özel veya genel not ekleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Güncelleştirilecek bilet kimliği. |
|
Uyarı
|
body | True | string |
Bilete eklenecek not. |
|
Özel mi
|
private | boolean |
İleti özelse true olarak ayarlayın. |
Döndürülenler
- Body
- AddNote_ResponseV2
Bileti güncelleştirme (V2)
Bir bileti güncelleştirin (yalnızca belirtilen değerler güncelleştirilir).
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Güncelleştirilecek bilet kimliği. |
|
İstek Sahibi Kimliği
|
requester_id | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
|
Konu
|
subject | string |
Biletin konusu. |
|
|
Statü
|
status | string |
Biletin durumu. |
|
|
Priority
|
priority | string |
Biletin önceliği (Düşük, Orta veya Yüksek gibi). |
|
|
Aciliyet
|
urgency | string |
Sorunun aciliyeti (Düşük, Orta veya Yüksek gibi). |
|
|
Etki
|
impact | string |
Sorunun etkisi (Düşük, Orta veya Yüksek gibi). |
|
|
Kaynak
|
source | string |
Biletin oluşturulduğu kanal. |
Döndürülenler
Bir bileti güncelleştirme [KULLANIM DIŞI]
Bir bileti güncelleştirin (yalnızca belirtilen değerler güncelleştirilir).
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Bilet Kimliği
|
ticketId | True | integer |
Güncelleştirilecek bilet kimliği. |
|
İstek Sahibi Kimliği
|
requester_id | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
|
Konu
|
subject | string |
Biletin konusu. |
|
|
Statü
|
status | string |
Biletin durumu. |
|
|
Priority
|
priority | string |
Biletin önceliği (Düşük, Orta veya Yüksek gibi). |
|
|
Aciliyet
|
urgency | string |
Sorunun aciliyeti (Düşük, Orta veya Yüksek gibi). |
|
|
Etki
|
impact | string |
Sorunun etkisi (Düşük, Orta veya Yüksek gibi). |
|
|
Kaynak
|
source | string |
Biletin oluşturulduğu kanal. |
Döndürülenler
Tetikleyiciler
| Bilet oluşturulduğunda (V2) |
Yeni bir bilet oluşturulduğunda tetikler. |
| Bir bilet oluşturulduğunda [KULLANIM DIŞI] |
Yeni bir bilet oluşturulduğunda tetikler. |
Bilet oluşturulduğunda (V2)
Bir bilet oluşturulduğunda [KULLANIM DIŞI]
Tanımlar
Ticket_Response
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Date-Time'da oluşturuldu
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Silindi
|
deleted | boolean |
Bilet silinirse/çöpe atılırsa true olarak ayarlayın. Silinen biletler , 'silinmiş' filtresi dışında hiçbir görünümde dikkate alınmaz. |
|
Bölüm Kimliği
|
department_id_value | integer | |
|
Bilet Kimliği
|
display_id | integer |
Hesabınıza özgü bilet kimliği. |
|
Son Tarih: Date-Time
|
due_by | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Grup Kimliği
|
group_id | integer |
Biletin atandığı Grubun kimliği. |
|
Kimlik
|
id | integer |
Biletin benzersiz kimliği. |
|
Etki
|
impact | integer |
Sorunun etkisini gösteren bir sayı. |
|
Görev Aktarıldı
|
isescalated | boolean |
Yükseltme gönderiliyorsa true olarak ayarlayın. |
|
Sahip Kimliği
|
owner_id | string |
Sorunun atandığı aracının kimliği. |
|
Priority
|
priority | integer |
Biletin önceliğini temsil eden bir sayı. |
|
İstek Sahibi Kimliği
|
requester_id | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
Yanıtlayıcı Kimliği
|
responder_id | integer |
Biletin atandığı aracının kimliği. |
|
Kaynak
|
source | integer |
Biletin oluşturulduğu kanalı temsil eden bir sayı. |
|
İstenmeyen e-posta
|
spam | boolean |
Bilet istenmeyen posta olarak işaretlenmişse true olarak ayarlayın. |
|
Statü
|
status | integer |
Biletin durumunu temsil eden bir sayı. |
|
Konu
|
subject | string |
Bilet konusu. |
|
Bilet Türü
|
ticket_type | string |
Anahtar alanlarında tanımlandığı gibi özellik alanını yazın. |
|
E-postaya
|
to_email | string |
Gelen bilet e-postasının gönderildiği e-posta adresi. |
|
Date-Time'da güncelleştirildi
|
updated_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Aciliyet
|
urgency | integer |
Sorunun aciliyetini temsil eden bir sayı. |
|
Description
|
description | string |
Sorunun açıklaması. |
|
Açıklama HTML'i
|
description_html | string |
Biletin HTML içeriği. Açıklama ve description_html birlikte geçirilmemelidir. |
|
Durum Adı
|
status_name | string |
Biletin durumu. |
|
Öncelik Adı
|
priority_name | string |
Biletin önceliği. |
|
Kaynak Adı
|
source_name | string |
Biletin oluşturulduğu kanal. |
|
Yanıtlayıcı Adı
|
responder_name | string |
Biletin atandığı aracının adı. |
|
E-postalara
|
to_emails | array of string |
Gelen bilet e-postasının gönderildiği e-posta adresleri. |
|
Bölüm Adı
|
department_name | string |
Bölümün adı. |
|
İlişkili Sorun Kimliği
|
assoc_problem_id | integer |
Biletle ilişkili sorunun kimliği. |
|
İlişkili Değişiklik Kimliği
|
assoc_change_id | integer |
Sorunla ilişkili değişikliğin kimliği. |
|
İlişkili Değişiklik Neden Kimliği
|
assoc_change_cause_id | integer |
Anahtara neden olan değişikliğin kimliği. |
|
İlişkili Varlık Kimliği
|
assoc_asset_id | integer |
Biletle ilişkili varlığın kimliği. |
|
Aciliyet Adı
|
urgency_name | string |
Sorunun aciliyeti. |
|
Etki Adı
|
impact_name | string |
Sorunun etkisi. |
CreateUpdateTicket_ResponseV2
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Date-Time'da oluşturuldu
|
ticket.created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Bölüm Kimliği
|
ticket.department_id | integer | |
|
Son Tarih: Date-Time
|
ticket.due_by | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Grup Kimliği
|
ticket.group_id | integer |
Biletin atandığı Grubun kimliği. |
|
Kimlik
|
ticket.id | integer |
Biletin benzersiz kimliği. |
|
Görev Aktarıldı
|
ticket.is_escalated | boolean |
Yükseltme gönderiliyorsa true olarak ayarlayın. |
|
Priority
|
ticket.priority | integer |
Biletin önceliğini temsil eden bir sayı. |
|
İstek Sahibi Kimliği
|
ticket.requester_id | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
Yanıtlayıcı Kimliği
|
ticket.responder_id | integer |
Biletin atandığı aracının kimliği. |
|
Kaynak
|
ticket.source | integer |
Biletin oluşturulduğu kanalı temsil eden bir sayı. |
|
İstenmeyen e-posta
|
ticket.spam | boolean |
Bilet istenmeyen posta olarak işaretlenmişse true olarak ayarlayın. |
|
Statü
|
ticket.status | integer |
Biletin durumunu temsil eden bir sayı. |
|
Konu
|
ticket.subject | string |
Bilet konusu. |
|
Bilet Türü
|
ticket.type | string |
Anahtar alanlarında tanımlandığı gibi özellik alanını yazın. |
|
Date-Time'da güncelleştirildi
|
ticket.updated_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Description
|
ticket.description_text | string |
Sorunun açıklaması. |
|
Açıklama HTML'i
|
ticket.description | string |
Biletin HTML içeriği. Açıklama ve description_html birlikte geçirilmemelidir. |
|
E-postalara
|
ticket.to_emails | array of string |
Gelen bilet e-postasının gönderildiği e-posta adresleri. |
ListTicket_ResponseV2
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Date-Time'da oluşturuldu
|
created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Bölüm Kimliği
|
department_id | integer | |
|
Son Tarih: Date-Time
|
due_by | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Grup Kimliği
|
group_id | integer |
Biletin atandığı Grubun kimliği. |
|
Kimlik
|
id | integer |
Biletin benzersiz kimliği. |
|
Görev Aktarıldı
|
is_escalated | boolean |
Yükseltme gönderiliyorsa true olarak ayarlayın. |
|
Priority
|
priority | integer |
Biletin önceliğini temsil eden bir sayı. |
|
İstek Sahibi Kimliği
|
requester_id | integer |
İstekte bulunanın kullanıcı kimliği. Mevcut kişiler için e-posta yerine requester_id geçirilebilir. |
|
Yanıtlayıcı Kimliği
|
responder_id | integer |
Biletin atandığı aracının kimliği. |
|
Kaynak
|
source | integer |
Biletin oluşturulduğu kanalı temsil eden bir sayı. |
|
İstenmeyen e-posta
|
spam | boolean |
Bilet istenmeyen posta olarak işaretlenmişse true olarak ayarlayın. |
|
Statü
|
status | integer |
Biletin durumunu temsil eden bir sayı. |
|
Konu
|
subject | string |
Bilet konusu. |
|
Bilet Türü
|
type | string |
Anahtar alanlarında tanımlandığı gibi özellik alanını yazın. |
|
Date-Time'da güncelleştirildi
|
updated_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Description
|
description_text | string |
Sorunun açıklaması. |
|
Açıklama HTML'i
|
description | string |
Biletin HTML içeriği. Açıklama ve description_html birlikte geçirilmemelidir. |
|
E-postalara
|
to_emails | array of string |
Gelen bilet e-postasının gönderildiği e-posta adresleri. |
UpdateTicket_Response
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Silindi
|
ticket.deleted | boolean |
Bilet silinirse/çöpe atılırsa true olarak ayarlayın. Silinen biletler , 'silinmiş' filtresi dışında hiçbir görünümde dikkate alınmaz. |
|
Bilet Kimliği
|
ticket.display_id | integer |
Hesabınıza özgü bilet kimliği. |
|
Konu
|
ticket.subject | string |
Bilet konusu. |
|
Description
|
ticket.description | string |
Biletin açıklaması. |
|
Açıklama HTML'i
|
ticket.description_html | string |
Biletin HTML içeriği. Açıklama ve description_html birlikte geçirilmemelidir. |
|
Durum Adı
|
ticket.status_name | string |
Biletin durumu. |
|
Öncelik Adı
|
ticket.priority_name | string |
Biletin önceliği. |
|
Kaynak Adı
|
ticket.source_name | string |
Biletin oluşturulduğu kanal. |
|
Yanıtlayıcı Adı
|
ticket.responder_name | string |
Biletin atandığı aracının adı. |
|
E-postalara
|
ticket.to_emails | array of string |
Gelen bilet e-postasının gönderildiği e-posta adresleri. |
|
Bölüm Adı
|
ticket.department_name | string |
Bölümün adı. |
|
İlişkili Sorun Kimliği
|
ticket.assoc_problem_id | integer |
Biletle ilişkili sorunun kimliği. |
|
İlişkili Değişiklik Kimliği
|
ticket.assoc_change_id | integer |
Sorunla ilişkili değişikliğin kimliği. |
|
İlişkili Değişiklik Neden Kimliği
|
ticket.assoc_change_cause_id | integer |
Anahtara neden olan değişikliğin kimliği. |
|
İlişkili Varlık Kimliği
|
ticket.assoc_asset_id | integer |
Biletle ilişkili varlığın kimliği. |
|
Aciliyet Adı
|
ticket.urgency_name | string |
Sorunun aciliyeti. |
|
Etki Adı
|
ticket.impact_name | string |
Sorunun etkisi. |
AddNote_Response
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Date-Time'da oluşturuldu
|
note.created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Silindi
|
note.deleted | boolean |
Bilet silinirse/çöpe atılırsa true olarak ayarlayın. Silinen biletler , 'silinmiş' filtresi dışında hiçbir görünümde dikkate alınmaz. |
|
Kimlik
|
note.id | integer |
Notun benzersiz kimliği. |
|
Özel
|
note.private | boolean |
Not özelse true olarak ayarlayın. |
|
Kaynak
|
note.source | integer |
Biletin oluşturulduğu kanalı temsil eden bir sayı. |
|
Date-Time'da güncelleştirildi
|
note.updated_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Kullanıcı Kimliği
|
note.user_id | integer |
Notu ekleyen aracının User_id. |
|
Body
|
note.body | string |
Notun düz metin olarak içeriği. |
|
Gövde HTML'i
|
note.body_html | string |
Notun HTML biçimindeki içeriği. Ya ceset ya da body_html geçirilmelidir. |
|
attachments
|
note.attachments | array of string |
AddNote_ResponseV2
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Date-Time'da oluşturuldu
|
conversation.created_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Kimlik
|
conversation.id | integer |
Notun benzersiz kimliği. |
|
Özel
|
conversation.private | boolean |
Not özelse true olarak ayarlayın. |
|
Date-Time'da güncelleştirildi
|
conversation.updated_at | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Kullanıcı Kimliği
|
conversation.user_id | integer |
Notu ekleyen aracının User_id. |
|
Body
|
conversation.body_text | string |
Notun düz metin olarak içeriği. |
|
Gövde HTML'i
|
conversation.body | string |
Notun HTML biçimindeki içeriği. Ya ceset ya da body_html geçirilmelidir. |
|
attachments
|
conversation.attachments | array of string | |
|
Bilet Kimliği
|
conversation.ticket_id | integer |
Biletin benzersiz kimliği. |