Aracılığıyla paylaş


Plumsail HelpDesk

API, Plumsail HelpDesk bilet sistemiyle etkileşime izin verir. Daha fazla bilgi için ziyaret edin https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html .

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - 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 Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Standart Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Plumsail
URL https://plumsail.com/sharepoint-helpdesk
E-posta support@plumsail.com
Bağlayıcı Meta Verileri
Publisher Plumsail Inc.
Web sitesi https://plumsail.com
Gizlilik ilkesi https://plumsail.com/privacy-policy/
Kategoriler Işbirliği; İş Yönetimi

Bu bağlayıcı, Power Automate'in yardımıyla HelpDesk'inizdeki verileri işlemenize yardımcı olur.

Daha fazla bilgi için ziyaret edin https://plumsail.com/helpdesk .

Plumsail HelpDesk Power Automate Videosu

Önkoşullar

Kullanmaya başlamak için aşağıdaki önkoşulları tamamlamanız gerekir:

Ardından, bir API anahtarı oluşturduktan sonra ilk Flow'unuzu oluşturmaya hazır olursunuz.

Flow'unda "Plumsail HelpDesk" araması yapmanız ve uygun bir eylem eklemeniz gerekir:

HelpDesk eylemlerinin listesi

İlk kez bir eylem eklediğinizde ve Access Keyiçin istenirConnection Name. Bağlantı için herhangi bir ad yazabilirsiniz. Örneğin, Plumsail HelpDesk.

Ardından ilk adımda oluşturduğunuz API anahtarını girişe Access Key yapıştırın.

Akış Bağlantısı Oluştur

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılabilir

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim Türü Description Gerekli
API Anahtarı securestring Bu API için API Anahtarı Doğru
Veri merkezi bölgesi String Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Açıklama oluşturma

Belirtilen kimliğe sahip bir bilet için yeni açıklama oluşturur ve döndürür.

Başlığa göre tek bir kuruluş alma

Bir kuruluşu başlığa göre alır ve döndürür.

Bilet alma

TicketRead nesnelerinin listesini döndürür. Her TicketRead nesnesi şu alanlara sahiptir: Category, Created, TicketID, Status, Requester vb. Daha fazla ayrıntı için TicketRead nesne tanımını denetleyin

Bilet için tüm yorumları alma

Belirtilen kimlikle bir bilet için tüm açıklamaları alır.

Bilet oluşturma

Yeni bilet oluşturur ve oluşturulan bileti döndürür.

Bilet silme

Kimliğine göre bileti siler.

Bileti güncelleştirme

Kimliğe göre bir bilet alır ve bunu güncelleştirir. Güncelleştirilmiş bilet döndürür.

Bir kuruluşu başlığa göre güncelleştirme

Bir kuruluşu başlığa göre alır ve güncelleştirir. Güncelleştirilmiş kuruluşu döndürür.

Bir kuruluşu başlığa göre silme

Kuruluşu başlığa göre siler

E-posta ile tek bir kişi alma

Kişiyi e-postayla alır ve döndürür.

Eki indirme

Belirli bir anahtara ait ek dosyasını adına göre döndürür veya hata kodu döndürür

Kimliğine göre tek bir kişi alma

Kimliğe göre bir kişi alır ve yeniden verir.

Kişi oluştur

Yeni kişi oluşturur ve döndürür.

Kişileri alma

Kişi listesini alma

Kişiyi E-posta ile güncelleştirme

Bir kişiyi e-postayla bulur ve güncelleştirir. Güncelleştirilmiş kişiyi döndürür.

Kişiyi güncelleştirme

Kimliğe göre bir kişiyi bulur ve güncelleştirir. Güncelleştirilmiş kişiyi döndürür.

Kişiyi silme

Kişiyi kimlikle siler

Kuruluş oluşturma

Kuruluşlar listesinde yeni öğe oluşturur ve geri döndürür

Kuruluşları edinin

Kuruluş listesini alma

Kuruluşu güncelleştir

Kimliğe göre bir kuruluş alır ve döndürür.

Kuruluşu sil

Kuruluşu kimliğine göre siler.

Tek bir açıklama alma

Kimliğe göre bir açıklama alır ve döndürür.

Tek bir bilet alma

Kimliğe göre bilet alır ve döndürür

Tek bir kuruluş edinme

Kimliğe göre kuruluşu alır ve döndürür

Açıklama oluşturma

Belirtilen kimliğe sahip bir bilet için yeni açıklama oluşturur ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
AttachmentContent
AttachmentContent True binary

Dosya İçeriği

Ek Dosya Adı
Name True string
Açıklama Gövdesi
body True string
Açıklama Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Açıklama Yazarı E-postası
fromEmail True string
Açıklama İleti Kimliği
messageId string
Bilet Kimliği
ticketId True integer

Bilet Kimliği

Döndürülenler

Başlığa göre tek bir kuruluş alma

Bir kuruluşu başlığa göre alır ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Kuruluş başlığı
title True string

Kuruluş başlığı

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Bilet alma

TicketRead nesnelerinin listesini döndürür. Her TicketRead nesnesi şu alanlara sahiptir: Category, Created, TicketID, Status, Requester vb. Daha fazla ayrıntı için TicketRead nesne tanımını denetleyin

Parametreler

Name Anahtar Gerekli Tür Description
$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

$filtre
$filter string

ODATA $filter sorgu seçeneği. Örneğin, belirli bir duruma göre bilet almak için $filter=Status/Title eq STATUS veya $filter=Status/Title ne STATUS (STATUS is 'Pending', 'New', 'In Progress', 'Solved' vb.) veya etkin biletler almak için $filter=Status/Title ne Çözüldü veya belirli bir tarihten sonra oluşturulan biletleri almak için $filter=Created gt '2023-08-18' kullanın. Kategori alanını kategoriye göre filtrelemek için, atanan e-postaya göre filtrelemek için Atanan/E-posta, atanan ada göre filtrelemek için Atanan/Başlık'ı kullanın. Etki alanından (ETKİ ALANI) e-postası olan kişiyi bulmak için $filter=substringof('@DOMAIN', İstek Sahibi/E-posta) kullanın. Süresi geçmiş biletler yalnızca DueDate'ın bugünden küçük olduğu etkin biletlerdir.

$orderBy
$orderBy string

Girdilerin sırasını belirtmek için odata $orderBy sorgu seçeneği.

$top
$top integer

İade için dönüş kümesinin ilk n öğesini (varsayılan = 50, maksimum = 100) seçmeye yönelik bir ODATA $top sorgu seçeneği.

$skiptoken
$skiptoken string

Belirtilen öğeye ulaşılana kadar öğeleri atlayıp geri kalanını döndürmek için ODATA $skiptoken sorgu seçeneği.

Döndürülenler

Bilet için tüm yorumları alma

Belirtilen kimlikle bir bilet için tüm açıklamaları alır.

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
ticketId True integer

Bilet Kimliği

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

$filtre
$filter string

Döndürülen girişleri kısıtlamak için ODATA $filter sorgu seçeneği

$orderBy
$orderBy string

Girdilerin sırasını belirtmek için odata $orderBy sorgu seçeneği.

Döndürülenler

Bilet oluşturma

Yeni bilet oluşturur ve oluşturulan bileti döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Anahtar Atanan E-posta veya SharePoint Grup Adı
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Dosya İçeriği

Ek Dosya Adı
Name True string
Bilet Gövdesi
body True string
Bilet Kategorisi
category string
Bilet Bilgi E-postaları
ccEmails array of string
Anahtar Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Bilet DueDate
dueDate date-time
Bilet Önceliği
priority string
Bilet İsteyeni E-postası
requesterEmail True string
Bilet Durumu
status string
Bilet Konusu
subject True string
Bilet DesteğiChannel
supportChannel string
Bilet Etiketleri Başlıkları
tagTitles array of string

Döndürülenler

Body
TicketRead

Bilet silme

Kimliğine göre bileti siler.

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
id True integer

Bilet Kimliği

Bileti güncelleştirme

Kimliğe göre bir bilet alır ve bunu güncelleştirir. Güncelleştirilmiş bilet döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
id True integer

Bilet Kimliği

Anahtar Atanan E-posta veya SharePoint Grup Adı
assignedToEmail string
AttachmentContent
AttachmentContent True binary

Dosya İçeriği

Ek Dosya Adı
Name True string
Bilet Gövdesi
body True string
Bilet Kategorisi
category string
Bilet Bilgi E-postaları
ccEmails array of string
Anahtar Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Bilet DueDate
dueDate date-time
Bilet Önceliği
priority string
Bilet İsteyeni E-postası
requesterEmail True string
Bilet Durumu
status string
Bilet Konusu
subject True string
Bilet DesteğiChannel
supportChannel string
Bilet Etiketleri Başlıkları
tagTitles array of string

Döndürülenler

Body
TicketRead

Bir kuruluşu başlığa göre güncelleştirme

Bir kuruluşu başlığa göre alır ve güncelleştirir. Güncelleştirilmiş kuruluşu döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Kuruluş başlığı
title True string

Kuruluş başlığı

Kuruluş Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Kuruluş Başlığı
title True string

Döndürülenler

Bir kuruluşu başlığa göre silme

Kuruluşu başlığa göre siler

Parametreler

Name Anahtar Gerekli Tür Description
Kuruluş başlığı
title True string

Kuruluş başlığı

E-posta ile tek bir kişi alma

Kişiyi e-postayla alır ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İletişim E-postası
email True string

İletişim E-postası

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Eki indirme

Belirli bir anahtara ait ek dosyasını adına göre döndürür veya hata kodu döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
id True integer

Bilet Kimliği

Ek Dosya Adı
filename True string

Ek Dosya Adı

Döndürülenler

Sonuç dosyası
binary

Kimliğine göre tek bir kişi alma

Kimliğe göre bir kişi alır ve yeniden verir.

Parametreler

Name Anahtar Gerekli Tür Description
İrtibat Numarası
id True integer

İrtibat Numarası

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Kişi oluştur

Yeni kişi oluşturur ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Kişi Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

İletişim E-postası
email True string
Diğer E-posta ile İletişime Geçin
emailAlternate string
Kişi Rolü
role string
SPUserId ile iletişime geçin
spUserId integer
İlgili Kişi Adı
title True string
Varsa Kişiyi Güncelleştir
updateIfExists boolean

Zaten varsa kişiyi güncelleştirme

Döndürülenler

Kişileri alma

Kişi listesini alma

Parametreler

Name Anahtar Gerekli Tür Description
$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz. Telefon numarasını eklemek için $select=TelefonSayısı,Başlık,E-posta,Kimlik bilgilerini kullanın.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

$filtre
$filter string

Gerekli kişiyi bulmak için ODATA $filter seçeneğini kullanın. Örneğin, tam ada göre kişi bulmak için $filter=Title eq 'Bill Gates' kullanın. Etki alanından (ETKİ ALANI) e-postası olan kişiyi bulmak için $filter=substringof('@DOMAIN', E-posta) kullanın

$orderBy
$orderBy string

Girdilerin sırasını belirtmek için odata $orderBy sorgu seçeneği.

$top
$top integer

İade için dönüş kümesinin ilk n öğesini (varsayılan = 50, maksimum = 100) seçmeye yönelik bir ODATA $top sorgu seçeneği.

$skiptoken
$skiptoken string

Belirtilen öğeye ulaşılana kadar öğeleri atlayıp geri kalanını döndürmek için ODATA $skiptoken sorgu seçeneği.

Döndürülenler

Kişiyi E-posta ile güncelleştirme

Bir kişiyi e-postayla bulur ve güncelleştirir. Güncelleştirilmiş kişiyi döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İletişim E-postası
email True string

İlgili kişinin e-posta adresi

Kişi Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

İletişim E-postası
email True string
Diğer E-posta ile İletişime Geçin
emailAlternate string
Kişi Rolü
role string
SPUserId ile iletişime geçin
spUserId integer
İlgili Kişi Adı
title True string

Döndürülenler

Kişiyi güncelleştirme

Kimliğe göre bir kişiyi bulur ve güncelleştirir. Güncelleştirilmiş kişiyi döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İrtibat Numarası
id True integer

İrtibat Numarası

Kişi Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

İletişim E-postası
email True string
Diğer E-posta ile İletişime Geçin
emailAlternate string
Kişi Rolü
role string
SPUserId ile iletişime geçin
spUserId integer
İlgili Kişi Adı
title True string

Döndürülenler

Kişiyi silme

Kişiyi kimlikle siler

Parametreler

Name Anahtar Gerekli Tür Description
İrtibat Numarası
id True integer

İrtibat Numarası

Kuruluş oluşturma

Kuruluşlar listesinde yeni öğe oluşturur ve geri döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Kuruluş Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Kuruluş Başlığı
title True string

Döndürülenler

Kuruluşları edinin

Kuruluş listesini alma

Parametreler

Name Anahtar Gerekli Tür Description
$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

$filtre
$filter string

Döndürülen girişleri kısıtlamak için ODATA $filter sorgu seçeneği

$orderBy
$orderBy string

Girdilerin sırasını belirtmek için odata $orderBy sorgu seçeneği.

$top
$top integer

İade için dönüş kümesinin ilk n öğesini (varsayılan = 50, maksimum = 100) seçmeye yönelik bir ODATA $top sorgu seçeneği.

$skiptoken
$skiptoken string

Belirtilen öğeye ulaşılana kadar öğeleri atlayıp geri kalanını döndürmek için ODATA $skiptoken sorgu seçeneği.

Döndürülenler

Kuruluşu güncelleştir

Kimliğe göre bir kuruluş alır ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Organizasyon Kimliği
id True integer

Organizasyon Kimliği

Kuruluş Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Kuruluş Başlığı
title True string

Döndürülenler

Kuruluşu sil

Kuruluşu kimliğine göre siler.

Parametreler

Name Anahtar Gerekli Tür Description
Organizasyon Kimliği
id True integer

Organizasyon Kimliği

Tek bir açıklama alma

Kimliğe göre bir açıklama alır ve döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
ticketId True integer

Bilet Kimliği

Açıklama Kimliği
id True integer

Açıklama Kimliği

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Tek bir bilet alma

Kimliğe göre bilet alır ve döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Bilet Kimliği
id True integer

Bilet Kimliği

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Body
TicketRead

Tek bir kuruluş edinme

Kimliğe göre kuruluşu alır ve döndürür

Parametreler

Name Anahtar Gerekli Tür Description
Organizasyon Kimliği
id True integer

Organizasyon Kimliği

$select
$select string

Liste öğesi için döndürülecek alanları belirtmek için ODATA $select sorgu seçeneği. Kullanılabilir tüm alanları döndürmek için * kullanabilirsiniz.

$expand
$expand string

İsteğin aramaların değerlerini döndüreceğini belirten bir ODATA $expand sorgu seçeneği.

Döndürülenler

Tanımlar

Atanan

Name Yol Tür Description
Assignee CustomFields
customFields object

Özel alan değerleri içeren JSON dizesi

E-posta Ata
email string
Alternatif E-posta Ata
emailAlternate string
Atanan Kimliği
id integer
Atanan Rol
role string
Assignee SPUserId
spUserId integer
Atanan Tam Ad
title string

Cc

Name Yol Tür Description
Bilgi CustomFields
customFields object

Özel alan değerleri içeren JSON dizesi

Bilgi E-postası
email string
Bilgi Alternatif E-postası
emailAlternate string
Bilgi Kimliği
id integer
Bilgi Rolü
role string
Cc SPUserId
spUserId integer
Bilgi Tam Adı
title string

CommentRead

Name Yol Tür Description
Açıklama Gövdesi
body string
Açıklama Oluşturma Tarihi
created date-time
Açıklama Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Açıklama Yazarı E-postası
fromEmail string
Açıklama Yazar Adı
fromName string
Açıklama Kimliği
id integer
Açıklama İleti Kimliği
messageId string

ContactRead

Name Yol Tür Description
Kişi Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

İletişim E-postası
email string
Diğer E-posta ile İletişime Geçin
emailAlternate string
Kişi Kimliği
id integer
Kişi Rolü
role string
SPUserId ile iletişime geçin
spUserId integer
Kişi Tam Adı
title string

OrganizationRead

Name Yol Tür Description
Kuruluş Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Kuruluş Kimliği
id integer
Kuruluş Başlığı
title string

Istekte

Name Yol Tür Description
İstek Sahibi Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

İstek Sahibi E-postası
email string
İstek Sahibi Alternatif E-postası
emailAlternate string
İstek Sahibi Kimliği
id integer
İstek Sahibi Rolü
role string
İstek sahibi SPUserId
spUserId integer
İstek Sahibi Tam Adı
title string

TagRead

Name Yol Tür Description
Özel Alanları Etiketle
customFields object

Özel alan değerleri içeren JSON dizesi

Etiket Kimliği
id integer
Etiket Başlığı
title string

TicketRead

Name Yol Tür Description
Anahtar Atanan
assignedTo Assignee
Bilet Ekleri
attachments array of string
Bilet Kategorisi
category string
Bilet Bilgi
cc array of Cc
Bilet Oluşturma Tarihi
created date-time
Anahtar Özel Alanları
customFields object

Özel alan değerleri içeren JSON dizesi

Bilet Son Tarihi
dueDate date-time
Bilet Kimliği
id integer
Bilet Önceliği
priority string
Bilet İsteyeni
requester Requester
Anahtar Çözümleme Tarihi
resolutionDate date-time
Bilet Durumu
status string
Bilet Konusu
subject string
Bilet Etiketleri
tags array of TagRead
Özel Anahtar Kimliği
ticketID string

ikili

Bu, 'ikili' temel veri türüdür.