Luware Nimbus

Konektor pro licencované služby Nimbus Contact Center a Enterprise Routing pro rychlé připojení Nimbusu k systémům třetích stran Díky naslouchání a reakci na aktivační události může konektor zpracovat akce toku, například načíst data z externích systémů a uložit je do parametrů Nimbus pro pozdější použití v rámci pracovních postupů Nimbusu.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Luware Helpdesk
URL	https://helpdesk.luware.cloud/
Email	nimbus.support@luware.com

Metadata konektoru
Vydavatel	Luware
Internetová stránka	https://luware.com/
Zásady ochrany osobních údajů	https://luware.com/en/privacy-policy/
Kategorie	Komunikace; Spolupráce

Konektor Luware Nimbus umožňuje integraci mezi softwarem Nimbus a softwarem třetích stran, jako jsou CRM nebo systémy lístků. Umožňuje naslouchat událostem zadávání úkolů a plánovače, ke které dochází v Luware Nimbusu. Můžete vytvářet úkoly, rozšiřovat existující úkoly daty informací o volajícím, přidávat parametry směrování nebo aktivovat událost v systému třetí strany. Kromě toho můžete spravovat adresáře, plánovat odchozí hovory nebo přidávat externí úkoly.

Mezi případy použití patří:

• Umožňuje zobrazit kontaktní údaje v Nimbusu pro příchozí hovor.
• Zachování výběru jazyka z IVR v Nimbusu do CRM.
• Vytvořte pracovní položku po volání v CRM.
• Vytvořte úkol zpětného volání pro zmeškaný hovor v CRM.
• Vytvořte odchozí volání Nimbus na základě kampaně v CRM.
• Přesměrovávat hovor podle preferencí zákazníka.
• Umožňuje zobrazit předvolby volajícího pro příchozí hovor.
• Vytvářejte lístky v systému třetích stran.
• Vytvořte seznam zmeškaných hovorů v systému třetích stran.
• Otevřete záznam zákazníka, když agent hovor přijme.

Další informace a spoustu nápovědy najdete ve znalostní bázi Luware: https://help.luware.com/nimbus-power-automate-connector

Požadavky

• Plán Microsoft PowerApps nebo PowerAutomate s úrovní Premium
• Tenant Azure
• Alespoň jedna zřízená služba Luware Nimbus
• Role v Luware Nimbus umožňující použití konektoru Luware Nimbus (https://help.luware.com/power-automate-roles)

Jak navázat zabezpečené připojení

Rozhraní NIMbus API jsou zabezpečená prostřednictvím Azure Active Directory (AAD) / Id Microsoft Entra pomocí delegovaných oprávnění. Jako správce tenanta musíte udělit tato oprávnění pro aplikaci Luware Nimbus Login, aby konektor mohl bezpečně přistupovat k Luware Nimbus. Ve většině případů byla tato oprávnění udělena během registrace Nimbusu a není nutné je znovu potvrdit.

Po dokončení tohoto kroku můžete konektor použít tak, že vytvoříte připojení ke clusterům Nimbus. Nezapomeňte vybrat stejné umístění clusteru jako instalace Nimbusu. Pokud si nejste jistí, přihlaste se ke správě Nimbus a zkontrolujte, ke kterému clusteru budete přesměrováni.

Začínáme s konektorem

1. Vyberte trigger Při změně stavu úkolu u triggerů Luware Nimbus.
2. Nakonfigurujte službu Nimbus, na které chcete naslouchat příchozím hovorům.
3. Vyberte událost "Systém akceptovaný" (aktivuje se při dosažení aktivity Přijmout konverzaci v pracovním postupu).
4. Implementujte vyhledávání informací volajícího na základě telefonního čísla volajícího, například v CRM nebo pro účely testování v excelovém listu hostovaného na SharePointu.
5. Pomocí akce Aktualizovat úkol nastavte informace o zákazníci, jako je jméno/příjmení, adresa, město, země atd. u úkolu.

Projděte si část s případem použití znalostní báze: https://help.luware.com/power-automate-use-cases

Známé problémy a omezení

• Ztráta oprávnění (RBAC) v Luware Nimbus zakáže triggery v Power Automate bez transparentních informací pro koncového uživatele. Toky se už neaktivují.
• Luware nemá vliv na dobu provádění toků, takže výsledky se můžou vrátit zpět do Nimbusu se zpožděním. Pracovní postupy v závislosti na dokončení toku by měly být vytvořeny s ohledem na toto omezení.

Běžné chyby a nápravné prostředky

Kód chyby HTTP:

• 400: Požadavek, který jste odeslali do rozhraní Luware Nimbus API, obsahuje neplatné parametry nebo je nelze použít. Příklady: Všichni předaní upřednostňovaní uživatelé jsou neplatné, proto upřednostňovaní uživatelé nejsou nastaveni nebo se pokusíte odstranit externí úlohu, pokud je již přiřazena uživateli.
• 401: Zadaný ověřovací token nelze analyzovat nebo je neplatný. Zkontrolujte správné nastavení registrace aplikace Azure AD / Entra ID a že jste zadali správné přihlašovací údaje pro váš účet O365.
• 403: Váš účet nemá potřebná oprávnění v Nimbusu k provedení akce nakonfigurované ve vašem toku. Pokud potřebujete další role nebo práva, obraťte se na správce.
• 404: Předané identifikátory se nedají shodovat s žádnou entitou v back-endu.

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Umístění	řetězec	Umístění, ve které se nachází váš tenant.	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Aktualizace kontaktu v adresáři	Aktualizuje jeden kontakt v zadaném adresáři.
Aktualizace odchozího volání pomocí položky plánovače pracovního postupu	Změňte nastavení již vytvořeného odchozího volání s položkou plánovače pracovního postupu.
Aktualizace položky plánovače	Změňte nastavení pro již vytvořenou položku plánovače.
Aktualizovat úkol	Aktualizujte informace o zákazníkovi, kontextový parametr nebo upřednostňovaná uživatelská nastavení pro probíhající úkol.
Naplánování nového odchozího volání	Naplánování nového odchozího volání (položka plánovače)
Naplánování nového odchozího volání pomocí pracovního postupu	Naplánování nového odchozího volání pomocí pracovního postupu (položka plánovače)
Odebrání externího úkolu	Odebrání externího úkolu
Odebrání kontaktů z adresářů	Odeberte jeden nebo více kontaktů z adresáře.
Odebrání položky plánovače	Odeberte položku plánovače ze systému. Je to možné, i když položka plánovače ještě neprobíhá.
Přidání kontaktu do adresáře	Přidá nový kontakt do konkrétního adresáře. ExternalId se používá jako odkaz v dalších požadavcích.
Přidání nového externího úkolu	Přidání nového externího úkolu
Vyprázdnění adresáře	Odeberte všechny kontakty v zadaném adresáři.
Získat otevírací dobu	Získejte otevírací dobu služby: v daném okamžiku vrátí stav služby (otevřené, uzavřené, svátky atd.).
Získání dat virtuálního uživatelského asistenta	Vrátí data virtuálního uživatelského asistenta pro vybranou relaci služby.
Získání kontaktů z adresáře	Vrátí kontakty z adresáře.
Získání všech položek plánovače	Vrátí všechny položky plánovače pro zadanou službu.

Aktualizace kontaktu v adresáři

ID operace:

UpdateContact

Aktualizuje jeden kontakt v zadaném adresáři.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Adresář	AddressBook	True	string	Adresář, ve který se má kontakt aktualizovat.
Externí ID kontaktu	externalId	True	string	ID kontaktu poskytnutého externím systémem.
Jméno kontaktu	firstName		string	Jméno kontaktu.
Příjmení kontaktu	lastName		string	Příjmení kontaktu.
Zobrazované jméno kontaktu	displayName		string	Zobrazované jméno kontaktu.
Iniciály kontaktů	initials		string	Iniciály kontaktu.
Kontaktovat společnost	company		string	Společnost kontaktu.
Kontaktní oddělení	department		string	Oddělení kontaktu.
Název pracovní pozice kontaktu	jobTitle		string	Pracovní pozice kontaktu.
Kontaktní hlavní název uživatele	userPrincipalName		string	Hlavní název uživatele kontaktu.
Kontaktní adresy rychlých zpráv	imAddresses		array of string	Seznam adres rychlých zpráv
Kontaktní e-mailové adresy	emailAddresses		array of string	Seznam e-mailových adres
Kontaktovat firemní telefony	businessPhones		array of string	Seznam firemních telefonů
Kontaktovat mobilní telefony	mobilePhones		array of string	Seznam mobilních telefonů
Kontaktovat domácí telefony	homePhones		array of string	Seznam domácích telefonů
Adresa ulice	street		string	Ulice a číslo adresy.
Město adresy	city		string	Město adresy.
Země adresy	country		string	Země adresy.
Stav adresy	state		string	Stav adresy.
Psč adresy	postalCode		string	Psč adresy.
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

ContactReadDto

Aktualizace odchozího volání pomocí položky plánovače pracovního postupu

ID operace:

UpdateOutboundCallWithWorkflowSchedulerEntry

Změňte nastavení již vytvořeného odchozího volání s položkou plánovače pracovního postupu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID položky plánovače	SchedulerEntryID	True	string	ID položky plánovače, která se má aktualizovat.
ID odkazu	ReferenceId		string	ID pro referenci předávané systémem třetí strany.
Cíl	destination	True	string	Cíl odchozího volání s pracovním postupem.
Termín splnění (UTC)	dueDateTimeUtc	True	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby.
Maximální počet pokusů	maxAttempts		integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí dosáhnout cíle, než se pokus zastaví.
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

OutboundCallWithWorkflowSchedulerEntryEventData

Aktualizace položky plánovače

ID operace:

UpdateSchedulerEntry

Změňte nastavení pro již vytvořenou položku plánovače.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID položky plánovače	SchedulerEntryID	True	string	ID položky plánovače, která se má aktualizovat.
ID odkazu	ReferenceId		string	ID pro referenci předávané systémem třetí strany.
Cíl	destination	True	string	Cíl položek plánovače se směrem Odchozí.
Priorita distribuce	distributionPriority		string	Priorita, se kterou má být úkol zpracován v Nimbusu.
Termín splnění (UTC)	dueDateTimeUtc	True	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby.
Maximální počet pokusů	maxAttempts		integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds		integer	Časový limit (intervaly) mezi opakovanými pokusy o připojení, dokud nedosáhnete maximálního počtu pokusů.
Maximální doba fronty v sekundách	maxQueueTimeInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí úkol vyřešit, dokud se úkol nepovažuje za dosažení limitu .
Časový limit RONA v sekundách	ronaTimeoutInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí spojit uživatele, dokud se úkol nepovažuje za RONA a bude vybrán nový uživatel.
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

SchedulerEntryEventData

Aktualizovat úkol

ID operace:

UpdateTask

Aktualizujte informace o zákazníkovi, kontextový parametr nebo upřednostňovaná uživatelská nastavení pro probíhající úkol.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úkolu	taskId	True	string	Konkrétní ID úlohy Nimbus.
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
hlavní název uživatele (UPN)	upn	True	string	Hlavní název uživatele (UPN) upřednostňovaného uživatele.
Priority	priority		integer	Priorita. 1 vysoká až 99 nízká.
ID relace služby	serviceSessionId		string	ID relace služby.
ID relace uživatele	userSessionId		string	ID uživatelské relace.

Naplánování nového odchozího volání

ID operace:

CreateSchedulerEntry

Naplánování nového odchozího volání (položka plánovače)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID odkazu	ReferenceId		string	ID pro referenci předávané systémem třetí strany.
Cíl	destination	True	string	Cíl položek plánovače se směrem Odchozí.
Priorita distribuce	distributionPriority		string	Priorita, se kterou má být úkol zpracován v Nimbusu.
Termín splnění (UTC)	dueDateTimeUtc	True	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby.
Maximální počet pokusů	maxAttempts		integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds		integer	Časový limit (intervaly) mezi opakovanými pokusy o připojení, dokud nedosáhnete maximálního počtu pokusů.
Maximální doba fronty v sekundách	maxQueueTimeInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí úkol vyřešit, dokud se úkol nepovažuje za dosažení limitu .
Časový limit RONA v sekundách	ronaTimeoutInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí spojit uživatele, dokud se úkol nepovažuje za RONA a bude vybrán nový uživatel.
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

SchedulerEntryEventData

Naplánování nového odchozího volání pomocí pracovního postupu

ID operace:

CreateOutboundCallWithWorkflowSchedulerEntry

Naplánování nového odchozího volání pomocí pracovního postupu (položka plánovače)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID odkazu	ReferenceId		string	ID pro referenci předávané systémem třetí strany.
Cíl	destination	True	string	Cíl odchozího volání s pracovním postupem.
Termín splnění (UTC)	dueDateTimeUtc	True	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby.
Maximální počet pokusů	maxAttempts		integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds		integer	Definuje, jak dlouho se Nimbus pokusí dosáhnout cíle, než se pokus zastaví.
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

OutboundCallWithWorkflowSchedulerEntryEventData

Odebrání externího úkolu

ID operace:

RemoveExternalTask

Odebrání externího úkolu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID externího úkolu	externalTaskId	True	string	ID odebrané externí úlohy

Odebrání kontaktů z adresářů

ID operace:

RemoveContacts

Odeberte jeden nebo více kontaktů z adresáře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Adresář	AddressBook	True	string	Adresář pro odebrání kontaktu.
externalIds	externalIds	True	array of string

Odebrání položky plánovače

ID operace:

DeleteSchedulerEntry

Odeberte položku plánovače ze systému. Je to možné, i když položka plánovače ještě neprobíhá.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID položky plánovače	SchedulerEntryID	True	string	ID položky plánovače, která se má odebrat.

Přidání kontaktu do adresáře

ID operace:

AddContact

Přidá nový kontakt do konkrétního adresáře. ExternalId se používá jako odkaz v dalších požadavcích.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Adresář	AddressBook	True	string	Adresář, do který chcete kontakt přidat.
Externí ID kontaktu	externalId	True	string	ID kontaktu poskytnutého externím systémem.
Jméno kontaktu	firstName		string	Jméno kontaktu.
Příjmení kontaktu	lastName		string	Příjmení kontaktu.
Zobrazované jméno kontaktu	displayName		string	Zobrazované jméno kontaktu.
Iniciály kontaktů	initials		string	Iniciály kontaktu.
Kontaktovat společnost	company		string	Společnost kontaktu.
Kontaktní oddělení	department		string	Oddělení kontaktu.
Název pracovní pozice kontaktu	jobTitle		string	Pracovní pozice kontaktu.
Kontaktní hlavní název uživatele	userPrincipalName		string	Hlavní název uživatele kontaktu.
Kontaktní adresy rychlých zpráv	imAddresses		array of string	Seznam adres rychlých zpráv
Kontaktní e-mailové adresy	emailAddresses		array of string	Seznam e-mailových adres
Kontaktovat firemní telefony	businessPhones		array of string	Seznam firemních telefonů
Kontaktovat mobilní telefony	mobilePhones		array of string	Seznam mobilních telefonů
Kontaktovat domácí telefony	homePhones		array of string	Seznam domácích telefonů
Adresa ulice	street		string	Ulice a číslo adresy.
Město adresy	city		string	Město adresy.
Země adresy	country		string	Země adresy.
Stav adresy	state		string	Stav adresy.
Psč adresy	postalCode		string	Psč adresy.
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole

Návraty

Body

ContactReadDto

Přidání nového externího úkolu

ID operace:

AddExternalTask

Přidání nového externího úkolu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby.
Identifikátor zákazníka	customerIdentifier		string	Volitelný jedinečný identifikátor vytváření sestav, anonymní, pokud je prázdný.
Jméno zákazníka	firstName		string	Jméno zákazníka.
Příjmení zákazníka	lastName		string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName		string	Zobrazované jméno zákazníka
Zákaznická společnost	company		string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle		string	Pracovní pozice zákazníka.
Oddělení zákazníků	department		string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress		string	Adresa zákazníka.
Psč zákazníka	postCode		string	Psč zákazníka.
Město zákazníka	city		string	Město zákazníka.
Stát zákazníka	state		string	Stav zákazníka.
Země zákazníka	country		string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber		string	Primární telefonní číslo zákazníka.
Název	name	True	string	Označení telefonního čísla.
Hodnota	value		string	Hodnota telefonního čísla.
Hlavní názvu uživatele (UPN) zákazníka	UPN		string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress		string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email		string	E-mail zákazníka
Název	name	True	string	Označení vlastního pole
Hodnota	value		string	Hodnota vlastního pole
Název	name	True	string	Název vlastního parametru kontextu
Hodnota	value		string	Hodnota vlastního parametru kontextu
Priorita distribuce	distributionPriority		string	Priorita, se kterou by se úkol měl zpracovat v Nimbusu po splnění
hlavní název uživatele (UPN)	upn	True	string	Hlavní název uživatele (UPN) upřednostňovaného uživatele.
Priority	priority		integer	Priorita. 1 vysoká až 99 nízká.

Návraty

Body

ExternalTaskWriteResult

Vyprázdnění adresáře

ID operace:

ClearContacts

Odeberte všechny kontakty v zadaném adresáři.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Adresář	AddressBook	True	string	Adresář se vyprázdní.

Získat otevírací dobu

ID operace:

GetOpeningHours

Získejte otevírací dobu služby: v daném okamžiku vrátí stav služby (otevřené, uzavřené, svátky atd.).

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby, pro kterou bude stav kontrolován.
Termín splnění (UTC)	time		date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.

Návraty

Stav služby (Otevřít, Uzavřeno atd.).

response

CalendarStatus

Získání dat virtuálního uživatelského asistenta

ID operace:

GetVirtualUserAssistantData

Vrátí data virtuálního uživatelského asistenta pro vybranou relaci služby.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID relace služby	serviceSessionId	True	string	ID relace služby, pro kterou by se měla vrátit data virtuálního uživatelského asistenta.
ID relace uživatele	userSessionId		string	ID relace uživatele, pro kterou by se měla vrátit data virtuálního pomocníka pro uživatele.
Datový typ	dataType	True	string	Typ dat, která by se měla vrátit pro relaci služby.

Návraty

Výstupy této operace jsou dynamické.

Získání kontaktů z adresáře

ID operace:

GetContacts

Vrátí kontakty z adresáře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Adresář	AddressBook	True	string	Adresář pro získání kontaktů.
ExternalId	externalIds		array	Externí ID kontaktů, které se mají načíst. Volitelné: Pokud žádný není zadaný, vrátí se všechny kontakty.

Návraty

Vrácené kontakty.

Contacts

array of ContactReadDto

Získání všech položek plánovače

ID operace:

GetSchedulerEntries

Vrátí všechny položky plánovače pro zadanou službu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Hlavní názvu uživatele (UPN) služby	serviceUpn	True	string	Hlavní název uživatele (UPN) služby, pro kterou mají být vráceny položky plánovače.

Návraty

Seznam všech naplánovaných úkolů pro zadanou službu

Naplánované úkoly

array of SchedulerEntryEventData

Aktivační události

Když má virtuální uživatelský asistent aktualizaci	Tato událost se aktivuje, když má virtuální uživatelský asistent novou aktualizaci.
Při změně stavu položky plánovače	Vyvolá se vždy, když položka plánovače, která odpovídá kritériím filtru, změní svůj stav.
Při změně stavu úkolu	Vyvolá se při každé změně stavu úkolu, který odpovídá kritériím filtru.

Když má virtuální uživatelský asistent aktualizaci

ID operace:

RegisterVirtualUserAssistantTrigger

Tato událost se aktivuje, když má virtuální uživatelský asistent novou aktualizaci.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Services	services	True	array of string	Hlavní názvy služeb, pro které mají být načteny události pro úkoly.
Události virtuálního uživatelského asistenta	virtualUserAssistantEvents	True	array of string	Události virtuálního uživatelského asistenta, pro který má být vyvolána tato aktivační událost.

Návraty

Body

VirtualUserAssistantEventData

Při změně stavu položky plánovače

ID operace:

RegisterSchedulerEntryTrigger

Vyvolá se vždy, když položka plánovače, která odpovídá kritériím filtru, změní svůj stav.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Services	services	True	array of string	Hlavní názvy služeb, pro které mají být načteny události pro úkoly.
Události položky plánovače	schedulerEntryEvents	True	array of string	Události položky plánovače, pro které má být tento trigger vyvolán.

Návraty

Body

SchedulerEntryEventData

Při změně stavu úkolu

ID operace:

RegisterTaskWebHook

Vyvolá se při každé změně stavu úkolu, který odpovídá kritériím filtru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Services	services	True	array of string	Hlavní názvy služeb, pro které mají být načteny události pro úkoly.
Události úkolů	taskEvents	True	array of string	Události úkolů, pro které má být tento trigger vyvolán.
Modalit	modalities		array of string	Zadejte počáteční způsoby úkolů.
Trasa	directions		array of string	Zadejte směry úkolů.

Návraty

Body

TaskEventData

Definice

TaskEventData

Name	Cesta	Typ	Description
ID úkolu	taskId	string	Konkrétní ID úlohy Nimbus.
ID relace služby	serviceSessionId	string	ID relace služby
ID relace uživatele	userSessionId	string	ID relace uživatele
Uživatelská relace byla spuštěna s přenosem	userSessionStartedWithTransfer	boolean	Určuje, jestli byla relace uživatele spuštěna v důsledku přenosu.
ID řetězu volání	callChainId	string	ID řetězu volání od Microsoftu úkolu.
Event	event	string	Událost, ke které došlo v Nimbusu pro úkol.
Směr	direction	string	Směr probíhajícího úkolu v Nimbusu (Příchozí/Odchozí/Žádný)
Modality	modality	string	Počáteční způsob úkolu v Nimbusu.
Vytvořené	created	string	Časové razítko, kdy byl úkol vytvořen.
Ukončeno	terminated	string	Časové razítko, kdy byl úkol ukončen.
Důvod	reason	string	Důvod ukončení.
ID posledního připojeného uživatele	lastConnectedUserId	string	ID objektu (AAD) posledního připojeného uživatele úkolu.
Hlavní názvu uživatele (UPN) posledního připojeného uživatele	LastConnectedUserUPN	string	Hlavní název uživatele (UPN) posledního připojeného uživatele úkolu
E-mail posledního připojeného uživatele	LastConnectedUserEmail	string	E-mail posledního připojeného uživatele úkolu
ID volajícího Microsoftu	microsoftCallerId	string	ID objektu (AAD) volajícího
ID odkazu	referenceId	string	ID pro referenci předávané systémem třetí strany.
ID volajícího	callerId	string	Interní ID volajícího v Nimbusu ID objektu (AAD), pokud je volající známý.
Telefonní číslo volajícího	callerTelNumber	string	Telefonní číslo (E.164) volajícího. Nastaví se jenom pro úkoly s možností =Zvuk.
Hlavní názvu uživatele (UPN) volajícího	callerUPN	string	Hlavní název uživatele (UPN) zákazníka.
CÍLOVÉ ID Microsoftu	microsoftDestinationId	string	ID objektu (AAD) volaného v odchozím úkolu
ID cíle	destinationId	string	Interní ID cíle (odchozí) v Nimbusu. ID objektu (AAD), pokud je volající známý.
Cílové telefonní číslo	destinationTelNumber	string	Telefonní číslo (E.164) cíle (odchozí).
Cílový hlavní názvu uživatele (UPN)	destinationUPN	string	Hlavní název uživatele (UPN) cíle (odchozí).
ACS ID	acsId	string	ID komunikace Azure volajícího
Je anonymní	isAnonymous	boolean	Příznak nastavený na hodnotu true, pokud je volající anonymní.
Identifikátor zákazníka	customerIdentifier	string	Identifikátor zákazníka ve všech typech úkolů.
Počáteční zpráva	initialMessage	string	První zpráva zákazníka pomocí rychlých zpráv
ID služby	serviceId	string	Interní ID služby Nimbus.
Název služby	serviceName	string	Název služby Nimbus.
Popis služby	serviceDescription	string	Popis služby Nimbus (zděděný z Microsoft Teams).
Zobrazovaný název služby	serviceDisplayName	string	Zobrazovaný název služby Nimbus.
Hlavní názvu uživatele (UPN) služby	serviceUPN	string	Hlavní název uživatele (UPN) služby Nimbus.
Telefonní číslo služby	serviceTelNumber	string	Telefonní číslo (E.164) služby Nimbus.
Předmět e-mailu	emailSubject	string	Předmět e-mailu
Text e-mailu – jedinečný formát RTF	emailBodyUniqueRichText	string	Text e-mailu s formátem RTF
Text e-mailu – jedinečný prostý text	emailBodyUniquePlainText	string	Text e-mailu, prostý text.
Hlavní názvu uživatele poštovní schránky e-mailové služby	emailServiceMailboxUPN	string	Hlavní název uživatele (UPN) poštovní schránky přiřazené službě
Odchozí pokusy	outboundAttempt	integer	Počet pokusů o dosažení odchozího cíle
Aktualizovaný název parametru	updatedParameterName	string	Název posledního parametru, který byl aktualizován.
Aktualizovaná hodnota parametru	updatedParameterValue	string	Hodnota posledního parametru, který byl aktualizován.
Informace o úkolu	taskInformation	TaskInformation	Obsahuje informace o zákazníkovi, vlastním parametru kontextu a preferovaných uživatelích.

TaskInformation

Obsahuje informace o zákazníkovi, vlastním parametru kontextu a preferovaných uživatelích.

Name	Cesta	Typ	Description
Zákazník	customer	Customer	Objekt obsahující všechny informace o zákazníkovi.
Vlastní kontextové parametry	customContextParameters	array of CustomContextParameter	Seznam vlastních kontextových parametrů (Key-Value).
Upřednostňovaní uživatelé	preferredUsers	array of PreferredUser	Seznam upřednostňovaných uživatelů pro úkoly (UPN-Priority).

Zákazník

Objekt obsahující všechny informace o zákazníkovi.

Name	Cesta	Typ	Description
Jméno zákazníka	firstName	string	Jméno zákazníka.
Příjmení zákazníka	lastName	string	Příjmení zákazníka.
Zobrazované jméno zákazníka	displayName	string	Zobrazované jméno zákazníka
Zákaznická společnost	company	string	Společnost zákazníka.
Pracovní pozice zákazníka	jobTitle	string	Pracovní pozice zákazníka.
Oddělení zákazníků	department	string	Oddělení zákazníka.
Adresa ulice zákazníka	streetAddress	string	Adresa zákazníka.
Psč zákazníka	postCode	string	Psč zákazníka.
Město zákazníka	city	string	Město zákazníka.
Stát zákazníka	state	string	Stav zákazníka.
Země zákazníka	country	string	Země zákazníka.
Primární telefonní číslo zákazníka	primaryTelNumber	string	Primární telefonní číslo zákazníka.
Telefonní čísla	telNumbers	array of TelNumber	Seznam dalších telefonních čísel zákazníka
Hlavní názvu uživatele (UPN) zákazníka	UPN	string	Hlavní název uživatele (UPN) zákazníka.
Adresa rychlých zpráv zákazníka	imAddress	string	Adresa pro rychlé zprávy zákazníka
E-mail zákazníka	email	string	E-mail zákazníka
Vlastní pole	customFields	array of CustomField	Seznam vlastních polí zákazníka

TelNumber

Name	Cesta	Typ	Description
Název	name	string	Označení telefonního čísla.
Hodnota	value	string	Hodnota telefonního čísla.

CustomField

Name	Cesta	Typ	Description
Název	name	string	Označení vlastního pole
Hodnota	value	string	Hodnota vlastního pole

CustomContextParameter

Name	Cesta	Typ	Description
Název	name	string	Název vlastního parametru kontextu
Hodnota	value	string	Hodnota vlastního parametru kontextu

PreferredUser

Name	Cesta	Typ	Description
hlavní název uživatele (UPN)	upn	string	Hlavní název uživatele (UPN) upřednostňovaného uživatele.
Priority	priority	integer	Priorita. 1 vysoká až 99 nízká.

ContactReadDto

Name	Cesta	Typ	Description
Externí ID kontaktu	externalId	string	ID kontaktu poskytnutého externím systémem.
Jméno kontaktu	firstName	string	Jméno kontaktu.
Příjmení kontaktu	lastName	string	Příjmení kontaktu.
Zobrazované jméno kontaktu	displayName	string	Zobrazované jméno kontaktu.
Iniciály kontaktů	initials	string	Iniciály kontaktu.
Kontaktovat společnost	company	string	Společnost kontaktu.
Kontaktní oddělení	department	string	Oddělení kontaktu.
Název pracovní pozice kontaktu	jobTitle	string	Pracovní pozice kontaktu.
Kontaktní hlavní název uživatele	userPrincipalName	string	Hlavní název uživatele kontaktu.
Kontaktní adresy rychlých zpráv	imAddresses	array of string	Seznam adres rychlých zpráv
Kontaktní e-mailové adresy	emailAddresses	array of string	Seznam e-mailových adres
Kontaktovat firemní telefony	businessPhones	array of string	Seznam firemních telefonů
Kontaktovat mobilní telefony	mobilePhones	array of string	Seznam mobilních telefonů
Kontaktovat domácí telefony	homePhones	array of string	Seznam domácích telefonů
addresses	addresses	array of Address	Seznam adres
customFields	customFields	array of CustomField	Seznam vlastních polí kontaktu

Address

Name	Cesta	Typ	Description
Adresa ulice	street	string	Ulice a číslo adresy.
Město adresy	city	string	Město adresy.
Země adresy	country	string	Země adresy.
Stav adresy	state	string	Stav adresy.
Psč adresy	postalCode	string	Psč adresy.

SchedulerEntryEventData

Name	Cesta	Typ	Description
ID položky plánovače	schedulerEntryId	string	Konkrétní ID plánovače Nimbus.
ConversationType	conversationType	string	Typ konverzace položky plánovače.
Event	event	string	Událost, ke které došlo v nimbusu pro naplánovaný úkol.
Směr	direction	string	Směr probíhajícího úkolu v Nimbusu (Příchozí/Odchozí/Žádný)
Modality	modality	string	Počáteční způsob úkolu v Nimbusu.
ID odkazu	ReferenceId	string	ID pro referenci předávané systémem třetí strany.
Sjednocené ID konverzace	unifiedConversationId	string	Sjednocené ID konverzace.
Důvod dokončení	completionReason	string	Výsledek položky plánovače při ukončení.
Cíl	destination	string	Cíl položek plánovače se směrem Odchozí.
Priorita distribuce	distributionPriority	string	Priorita, se kterou má být úkol zpracován v Nimbusu.
Termín splnění (UTC)	dueDateTimeUtc	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	string	Hlavní název uživatele (UPN) služby, pro kterou je položka naplánována.
Maximální počet pokusů	maxAttempts	integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds	integer	Časový limit (intervaly) mezi opakovanými pokusy o připojení, dokud nedosáhnete maximálního počtu pokusů.
Maximální doba fronty v sekundách	maxQueueTimeInSeconds	integer	Definuje, jak dlouho se Nimbus pokusí úkol vyřešit, dokud se úkol nepovažuje za dosažení limitu .
Časový limit RONA v sekundách	ronaTimeoutInSeconds	integer	Definuje, jak dlouho se Nimbus pokusí spojit uživatele, dokud se úkol nepovažuje za RONA a bude vybrán nový uživatel.
Vlastní kontextové parametry	customCallContextParameters	array of CustomContextParameter	Seznam vlastního parametru kontextu (Key-Value).
Zákazník	customer	Customer	Objekt obsahující všechny informace o zákazníkovi.

OutboundCallWithWorkflowSchedulerEntryEventData

Name	Cesta	Typ	Description
ID položky plánovače	schedulerEntryId	string	Konkrétní ID plánovače Nimbus.
ConversationType	conversationType	string	Typ konverzace položky plánovače.
Event	event	string	Událost, ke které došlo v nimbusu pro naplánovaný úkol.
Směr	direction	string	Směr probíhajícího úkolu v Nimbusu (Příchozí/Odchozí/Žádný)
Modality	modality	string	Počáteční způsob úkolu v Nimbusu.
ID odkazu	ReferenceId	string	ID pro referenci předávané systémem třetí strany.
Sjednocené ID konverzace	unifiedConversationId	string	Sjednocené ID konverzace.
Důvod dokončení	completionReason	string	Výsledek položky plánovače při ukončení.
Cíl	destination	string	Cíl položek plánovače se směrem Odchozí.
Priorita distribuce	distributionPriority	string	Priorita, se kterou má být úkol zpracován v Nimbusu.
Termín splnění (UTC)	dueDateTimeUtc	date-time	Datum a čas splnění v UTC: Příklad: 2020-03-23T11:00:00Z.
Hlavní názvu uživatele (UPN) služby	serviceUpn	string	Hlavní název uživatele (UPN) služby, pro kterou je položka naplánována.
Maximální počet pokusů	maxAttempts	integer	Maximální počet pokusů o dosažení cíle
Časový limit pokusu v sekundách	attemptTimeoutInSeconds	integer	Definuje, jak dlouho se Nimbus pokusí dosáhnout cíle, než se pokus zastaví.
Vlastní kontextové parametry	customCallContextParameters	array of CustomContextParameter	Seznam vlastního parametru kontextu (Key-Value).
Zákazník	customer	Customer	Objekt obsahující všechny informace o zákazníkovi.

VirtualUserAssistantEventData

Name	Cesta	Typ	Description
ID sjednocené relace	unifiedSessionId	string	ID související sjednocené relace Nimbus.
ID relace služby	serviceSessionId	string	ID související relace služby Nimbus.
ID relace uživatele	userSessionId	string	ID související uživatelské relace Nimbus.
Hlavní názvu uživatele (UPN) služby	serviceUpn	string	Hlavní název uživatele (UPN) služby, pro kterou došlo k události.
ID služby	serviceId	string	ID služby, pro kterou došlo k události.
Název služby	serviceName	string	Název služby, pro kterou došlo k události.
Event	event	string	Událost virtuálního uživatelského asistenta, ke které došlo v Nimbusu.
Uživatelská relace byla spuštěna s přenosem	userSessionStartedWithTransfer	boolean	Určuje, jestli byla relace uživatele spuštěna v důsledku přenosu.

ExternalTaskWriteResult

Name	Cesta	Typ	Description
ID externího úkolu	id	string	ID přidaného externího úkolu.
Modality	modality	Modality	Způsob úkolu.
Vytvořené	created	string	Časové razítko při vytvoření externího úkolu
Typ	type	string	Typ externího úkolu.
Je anonymní	isAnonymous	boolean	Příznak nastavený na hodnotu true, pokud je volající anonymní.
ID služby	serviceId	string	Interní ID služby Nimbus.
Název služby	serviceName	string	Název služby Nimbus.
Popis služby	serviceDescription	string	Popis služby Nimbus (zděděný z Microsoft Teams).
Zobrazovaný název služby	serviceDisplayName	string	Zobrazovaný název služby.
Hlavní názvu uživatele (UPN) služby	serviceUPN	string	Hlavní název uživatele (UPN) služby.
Telefonní číslo služby	serviceTelNumber	string	Telefonní číslo služby.
Upřednostňovaní uživatelé	preferredUsers	array of PreferredUser	Seznam upřednostňovaných uživatelů pro úkoly (UPN-Priority).

Modality

Způsob úkolu.

Způsob úkolu.

Modality

string

CalendarStatus

Stav služby (Otevřít, Uzavřeno atd.).

Stav služby (Otevřít, Uzavřeno atd.).

Stav otevírací doby

string