WorkSpan

WorkSpan, iş ortaklarıyla geliri planlamak, yürütmek ve yönlendirmek için işbirliğine dayalı bir platformdur. WorkSpan'da iş ortağı programlarınızı ve iş ortağı girişimlerinizi yönetin ve iç ve iş ortağı uygulamalarıyla sorunsuz bir şekilde bağlantı kurun. CRM, İş Ortağı Merkezi, İşbirliği araçları ve Üretkenlik araçlarınızı WorkSpan ile tümleştirebilirsiniz.

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	WorkSpan API Desteği
URL	https://support.workspan.com
E-posta	api-team@workspan.com

Bağlayıcı Meta Verileri
Publisher	WorkSpan
Web sitesi	https://www.workspan.com
Kategoriler	Pazarlama; Satış ve CRM
Gizlilik ilkesi	https://www.workspan.com/privacy-policy

WorkSpan, iş ortaklarınızla bağlantı kurmak ve iş ortağı programlarınızı yönetmek için işbirliğine dayalı bir platformdur. WorkSpan, dünyanın önde gelen teknoloji şirketlerinden bazıları için başarılı iş ortağı programları sunuyor. Satış fırsatlarınızın değerini iş ortağı ekosisteminizin gücüyle zenginleştirmek için popüler ve tercih ettiğiniz uygulamaları WorkSpan Ekosistem Bulutu ile bağlayın. WorkSpan Bağlayıcısı ile kullanıcılar Dynamics 365 CRM ve Salesforce CRM gibi bir dizi iş uygulamasıyla sorunsuz bir şekilde bağlantı kurarak ekosistemlerini ve iş ortağı hareketlerini süper ücretlendirebilir ve hızlandırabilir. Kullanıcılar, premier CRM uygulamalarındaki verileri WorkSpan ile eşitleyebilir. Kullanıcılar Microsoft Teams, Slack ve OneDrive gibi işbirliği ve üretkenlik uygulamalarıyla da bağlantı kurabilir. Kullanıcılar WorkSpan'da atanan görevler, nesnelerle ilgili açıklamalar ve nesnelerde üyelikle ilgili oluşumlar gibi işbirliğiyle ilgili çeşitli olaylar hakkında bilgi alabilir. WorkSpan bağlayıcısı üretkenliği artırır, uygulamalar arasında veri bütünlüğünü korur ve iş uygulaması kullanıcılarına zamanında veri ve değer sunar. Sonuç olarak, bağlayıcıyı kullanan kuruluşlar maliyet tasarrufları, artan gelirler, kolaylaştırılmış ve hızlandırılmış satış süreçleri ve gelişmiş raporlama ile karşılaşır.

Önkoşullar

Kuruluşun WorkSpan'da kayıtlı bir şirket olması gerekir

Kimlik bilgilerini alma

Bağlayıcıyı kullanmak için kullanıcıların kimliği doğrulanmalıdır. WorkSpan, WorkSpan'da yapılandırılmış Uygulama Kullanıcıları için bağlayıcıya ve WorkSpan'daki Verilere erişim sağlar. Ayrıntılı adımları şu adreste bulabilirsiniz: https://support.workspan.com

Bilinen sorunlar ve sınırlamalar

Bilinen bir sorun yok

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şılamaz

Temerrüt

Geçerli: Tüm bölgeler

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

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
Ortam: Korumalı Alan veya Üretim	String	Korumalı alan ortamı veya üretim ortamı	Doğru
Uygulama Kullanıcı Kimliği	String	WorkSpan Uygulama Kullanıcı Kimliği	Doğru
Uygulama Kullanıcı Gizli Dizisi	securestring	Uygulama Kullanıcı Gizli Dizisi	Doğru
WorkSpan Uygulama Ana Bilgisayar Adı. Örnek: demo.workspan.com /app.workspan.com	String	Ana Bilgisayar Adı girin (https olmadan) Örnek: demo.workspan.com / app.workspan.com	Doğru
Notes	String	Bağlantı notları	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

Dış kimliği WorkSpan kimliğine bağlama	WorkSpan Nesnesini dış uygulamanın birincil benzersiz tanımlayıcısıyla güncelleştirme
Rapor listesini alma	Raporları listeleme
Rapor verilerini okuma	Rapor verilerini okuma
Toplu Veri Yükleme (ek)	Tümleştirmenize bir giriş dosyası yükleyin. İzin verilen biçimler .xlsx, .json ve .csv
Toplu Yükleme Fırsatları (ek)	Tümleştirmenize bir giriş dosyası yükleyin. İzin verilen biçimler .xlsx, .json ve .csv
Toplu Yükleme Fırsatları (gövdedeki veriler)	Giriş verilerini tümleştirmenize istek gövdesi olarak yükleyin. İzin verilen biçimler .csv ve .json
Toplu yükleme işleminin durumunu alma	Toplu yükleme işleminin durumunu alma
Verileri Toplu Yükleme (gövdedeki veriler)	Giriş verilerini tümleştirmenize istek gövdesi olarak yükleyin. İzin verilen biçimler .csv ve .json
WorkSpan kimliği için dış kimlik alma	Dış uygulamanın birincil benzersiz tanımlayıcısını alma
WorkSpan Nesnesine Denetim bilgileri ekleme	WorkSpanObject'e Denetim bilgileri ekleme

Dış kimliği WorkSpan kimliğine bağlama

İşlem Kimliği:

UpdateExternalId

WorkSpan Nesnesini dış uygulamanın birincil benzersiz tanımlayıcısıyla güncelleştirme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan Nesnesinin Nesne Kimliği (uzun kimlik)	object_id	True	string	WorkSpan Nesnesinin Nesne Kimliği (uzun kimlik)
field_name	field_name		string	WorkSpan'da dış kimliğin alan adı. Boşsa, dış kimlik alanının varsayılan alan adı kullanılır. Varsayılan alan adları şunlardır: fırsat nesnesi: 'sales_details.crm_opportunity_id'; Accound nesnesi: 'account_info.external_account_id'
external_id	external_id	True	string	Dış sistemden gelen kimlik (örn. CRM)

Döndürülenler

Body

external_id_response

Rapor listesini alma

İşlem Kimliği:

GetReportList

Raporları listeleme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Numara	number		integer	Numara
size	size		integer	size

Döndürülenler

Name	Yol	Tür	Description
kimlik	id	string	kimlik
name	name	string	name

Rapor verilerini okuma

İşlem Kimliği:

GetReportData

Rapor verilerini okuma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Rapor Kimliği	reportId	True	integer	Rapor Kimliği
colId	colId		string
Negate	negate		boolean
Op	op		string
type	type		string
Op	op		string
Numara	number	True	integer
size	size	True	integer

Döndürülenler

Body

ReportDataResponse

Toplu Veri Yükleme (ek)

İşlem Kimliği:

BulkloadDataFileAttachment

Tümleştirmenize bir giriş dosyası yükleyin. İzin verilen biçimler .xlsx, .json ve .csv

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string	WorkSpan'da yapılandırılan CRM intergation tümleştirme kimliği
Verileri biçimlendirin. İzin verilen biçimler .csv .xlsx ve .json	data_format		string	Verileri biçimlendirin. İzin verilen biçimler .csv .xlsx ve .json
karşıya yüklenecek dosya	file	True	file	karşıya yüklenecek dosya

Döndürülenler

Body

bulkload_response

Toplu Yükleme Fırsatları (ek)

İşlem Kimliği:

BulkloadOpportunityFileAttachment

Tümleştirmenize bir giriş dosyası yükleyin. İzin verilen biçimler .xlsx, .json ve .csv

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string	WorkSpan'da yapılandırılan CRM intergation tümleştirme kimliği
verinin içerik türü. İzin verilen biçimler .csv .xlsx ve .json	content_type		string	verinin içerik türü. İzin verilen biçimler .csv .xlsx ve .json
Excel dosyasında üst bilgi satırı var mı?	has_header_row		boolean	Excel dosyasında üst bilgi satırı var mı?
karşıya yüklenecek dosya	file	True	file	karşıya yüklenecek dosya

Döndürülenler

Body

bulkload_opportunity_response

Toplu Yükleme Fırsatları (gövdedeki veriler)

İşlem Kimliği:

BulkloadOpportunity

Giriş verilerini tümleştirmenize istek gövdesi olarak yükleyin. İzin verilen biçimler .csv ve .json

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string	WorkSpan'da yapılandırılan CRM intergation tümleştirme kimliği
verinin içerik türü. İzin verilen biçimler .csv ve .json	content_type		string	verinin içerik türü. İzin verilen biçimler .csv ve .json
sütun sınırlayıcısı (content_type csv ise kullanılır)	column_delimiter		string	sütun sınırlayıcısı (content_type csv ise kullanılır)
verinin içerik türü. text/csv veya application/json.	Content-Type		string	verinin içerik türü. text/csv veya application/json.
karşıya yüklenecek veriler	bulkload_opportunity_request			'CSV' içerik türü için: Csv olarak veri satırları. ilk satır sütun başlıkları olacaktır. 'JSON' içerik türü için veri biçimi dizidir: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Döndürülenler

Body

bulkload_opportunity_response

Toplu yükleme işleminin durumunu alma

İşlem Kimliği:

GetBulkloadStatus

Toplu yükleme işleminin durumunu alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Tümleştirme Kimliği	integration_id	True	string	Tümleştirme Kimliği
Yürütme Kimliği (veri toplu yükleme adımı döndürüldü)	execution_id	True	string	Toplu API'den döndürülen tümleştirme yürütmesinin yürütme kimliği
Herhangi bir hata varsa yanıta hata ekleme	include_errors		boolean	Herhangi bir hata varsa yanıta hata ekleme
Yanıtta geri döndürülecek hata sayısı üst sınırı	max_errors		number	Yanıtta geri döndürülecek hata sayısı üst sınırı

Döndürülenler

Body

bulkload_status_response

Verileri Toplu Yükleme (gövdedeki veriler)

İşlem Kimliği:

BulkloadData

Giriş verilerini tümleştirmenize istek gövdesi olarak yükleyin. İzin verilen biçimler .csv ve .json

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string	WorkSpan'da yapılandırılan CRM intergation tümleştirme kimliği
verinin içerik türü. İzin verilen biçimler .csv ve .json	data_format		string	Veri biçimi. İzin verilen biçimler csv ve json'dır
sütun sınırlayıcısı (content_type csv ise kullanılır)	column_delimiter		string	sütun sınırlayıcısı (content_type csv ise kullanılır)
verinin içerik türü. text/csv veya application/json.	Content-Type		string	verinin içerik türü. text/csv veya application/json.
karşıya yüklenecek veriler	bulkload_request			'CSV' içerik türü için: Csv olarak veri satırları. ilk satır sütun başlıkları olacaktır. 'JSON' içerik türü için veri biçimi dizidir: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Döndürülenler

Body

bulkload_response

WorkSpan kimliği için dış kimlik alma

İşlem Kimliği:

GetExternalId

Dış uygulamanın birincil benzersiz tanımlayıcısını alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
WorkSpan Nesnesinin Nesne Kimliği (uzun kimlik)	object_id	True	string	WorkSpan Nesnesinin Nesne Kimliği (uzun kimlik)

Döndürülenler

Body

get_external_id_response

WorkSpan Nesnesine Denetim bilgileri ekleme

İşlem Kimliği:

ObjectAudit

WorkSpanObject'e Denetim bilgileri ekleme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
field_name	field_name	True	string	WorkSpan'da Denetim Alanının alan adı.
integration_id	integration_id		string	İlgili tümleştirmenin Tümleştirme Kimliği (uzun kimlik)
external_id	external_id		string	Dış sistemden gelen kimlik (örnek. CRM Kimliği)
status_code	status_code	True	string	Denetim isteğinin durumunu temsil eden kod.
message	message	True	string	Denetim günlüğünde kayıt için ek bilgiler
WorkSpan Nesne Kimliği (uzun kimlik)	object_id	True	string	Tümleştirme durumuyla güncelleştirilecek WorkSpan nesnesinin Nesne Kimliği (uzun kimlik)

Döndürülenler

Body

audit_response

Tetikleyiciler

WorkSpan'dan Microsoft İş Ortağı Merkezi'ne Referans Gönderme	WorkSpan kullanıcısı Microsoft İş Ortağı Merkezi'ne fırsat göndermeyi istediğinde bu tetikleyici tetiklenir
WorkSpan İşbirliği Olaylarına Abone Olma	şirket içi ve iş ortağı ağınızla iletişimi yönlendirmek ve geliştirmek için üyelik, görev ve açıklama oluşturma ve güncelleştirme gibi çeşitli işbirliği olaylarına abone olun.
WorkSpan Nesne Olaylarına Abone Olma	İş ortağı etkinizin görünürlüğünü artırmak için Fırsatlar'da oluşturma ve güncelleştirme gibi çeşitli nesne olaylarına abone olun

WorkSpan'dan Microsoft İş Ortağı Merkezi'ne Referans Gönderme

İşlem Kimliği:

SubmitToPartnerCenterObjectEvent

WorkSpan kullanıcısı Microsoft İş Ortağı Merkezi'ne fırsat göndermeyi istediğinde bu tetikleyici tetiklenir

Parametreler

Name	Anahtar	Gerekli	Tür	Description
name	name	True	string	Olay abonesinin adı
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string

Döndürülenler

Bu işlemin çıkışları dinamiktir.

WorkSpan İşbirliği Olaylarına Abone Olma

İşlem Kimliği:

Subscribe

şirket içi ve iş ortağı ağınızla iletişimi yönlendirmek ve geliştirmek için üyelik, görev ve açıklama oluşturma ve güncelleştirme gibi çeşitli işbirliği olaylarına abone olun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Olay Adı	event	True	string
Abone Adı	name	True	string	Web kancasına atanan ad
WorkSpan Nesne Kimliği	object_ids		array of string	Web kancasının kaydedildiği Nesne Kimlikleri
Filtre örneği: (stage in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")	filters		string	Olaylar için filtreler

Döndürülenler

Bu işlemin çıkışları dinamiktir.

WorkSpan Nesne Olaylarına Abone Olma

İşlem Kimliği:

SubscribeObjectEvent

İş ortağı etkinizin görünürlüğünü artırmak için Fırsatlar'da oluşturma ve güncelleştirme gibi çeşitli nesne olaylarına abone olun

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Nesne Olaylarına Abone Olma	event	True	array of string
name	name	True	string	Olay abonesinin adı
WorkSpan'da yapılandırılan Tümleştirme'yi seçin	integration_id	True	string
object_ids	object_ids		array of string
Filtre örneği: (stage in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")	filters		string	Olaylar için filtreler

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Tanımlar

bulkload_opportunity_response

Name	Yol	Tür	Description
integration_id	integration_id	string	Tümleştirme Kimliği
execution_id	execution_id	string	Yürütme Kimliği
oluşturulma_tarihi	created_at	date-time	Oluşturulma zamanı

bulkload_response

Name	Yol	Tür	Description
integration_id	integration_id	string	Tümleştirme Kimliği
execution_id	execution_id	string	Yürütme Kimliği
data_format	data_format	string	Veri Biçimi
oluşturulma_tarihi	created_at	date-time	Oluşturulma zamanı

bulkload_status_response

Name	Yol	Tür	Description
integration_id	integration_id	string	Tümleştirme Kimliği
execution_id	execution_id	string	Yürütme Kimliği
statü	status	string	Yürütme durumu
succcess_count	succcess_count	number	Başarıyla işlenen kayıt sayısı
error_count	error_count	number	Hata içeren kayıt sayısı
input_count	input_count	number	Alınan kayıt sayısı
skip_count	skip_count	number	Atlanan kayıt sayısı
started_at	started_at	date-time	Yürütmeyi başlatma zaman damgası
tamamlanma_tarihi	completed_at	date-time	Yürütmeyi tamamlama zaman damgası
include_errors	include_errors	boolean	Varsa yanıtta hataların döndürülip döndürülmeyeceğini gösteren bayrak
Hata	errors	array of object
message	errors.message	string	Hata mesajı
kimlik	errors.id	string	Başarısız olan kaydın kimliği
data_row	errors.data_row	string	Başarısız olan veri satırı

external_id_response

Name	Yol	Tür	Description
external_id	external_id	string	Dış sistemden gelen kimlik (örn. CRM)
object_id	object_id	string	WorkSpan Nesne Kimliği (uzun kimlik)
field_name	field_name	string	Dış sistemdeki external_id depolandığı WorkSpan alan adı

get_external_id_response

Name	Yol	Tür	Description
object_id	object_id	string	WorkSpan Nesnesinin Nesne Kimliği (uzun kimlik)
external_ids	external_ids	array of object
field_name	external_ids.field_name	string	Dış sistemdeki external_id depolandığı WorkSpan alan adı
external_id	external_ids.external_id	string	Dış sistemden gelen kimlik (örn. CRM)

audit_response

Name	Yol	Tür	Description
object_id	object_id	string	Güncelleştirilen WorkSpan Nesne Kimliği (uzun kimlik)
field_name	field_name	string	Güncelleştirilen WorkSpan alanının adı
status_code	status_code	string	Güncelleştirmelerin durumu

ReportDataResponse

Name	Yol	Tür	Description
endOfList	endOfList	boolean
results	results	array of
version	version	integer