bot EntityType

  • Reference
Namespace:
Microsoft.Dynamics.CRM

Represents a Power Virtual Agents Chatbot. https://powerva.microsoft.com/

Entity Set Path
[organization URI]/api/data/v9.2/bots
Base Type
crmbaseentity
Display Name
Chatbot
Primary Key
botid
Primary Key Attribute
name
Operations Supported
POST GET PATCH DELETE

Properties

Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
accesscontrolpolicy Edm.Int32

Defines which users may interact with the bot.

Display Name: Access Control Policy

Default Options
Values Label
0 Any
1 Chatbot readers
2 Group membership
applicationmanifestinformation Edm.String

Stores information with application manifest data such as Teams application information.

Display Name: Application Manifest Information
authenticationconfiguration Edm.String

Stores information for the authentication configuration.

Display Name: Authentication Configuration Information
authenticationmode Edm.Int32

Defines how the bot should be authenticated to the user.

Display Name: Authentication Mode

Default Options
Values Label
0 Unspecified
1 None
2 Integrated
3 Custom Azure Active Directory
4 Generic OAuth2
authenticationtrigger Edm.Int32

Defines at which point authentication for the bot should be triggered. Security can be enforced at the bot entry point, removing the need for explicit authentication nodes in the dialog flow.

Display Name: Authentication trigger

Default Options
Values Label
0 As Needed
1 Always
authorizedsecuritygroupids Edm.String

Contains a comma-delimited list of up to 20 Azure Active Directory Group IDs that are allowed to interact with the bot. This field is ignored if Access Control Policy is not set to Group membership.

Display Name: Authorized Security Groups
botid Edm.Guid

Unique identifier of the Chatbot.

Display Name: Bot
componentidunique Edm.Guid

For internal use only.

Display Name: Row id unique

Read Only
componentstate Edm.Int32

For internal use only.

Display Name: Component State

Read Only
Default Options
Values Label
0 Published
1 Unpublished
2 Deleted
3 Deleted Unpublished
configuration Edm.String

Used to store content of bot configuration data.

Display Name: Configuration
createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
iconbase64 Edm.String

Used to visually identify your bot in channels and services. Represented in a base64 encoded string. Must be in PNG format, and no larger than 30K in size. This value can be changed at any time.

Display Name: Icon (Base64)
importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number
iscustomizable BooleanManagedProperty

For internal use only.

Display Name: Is Customizable
ismanaged Edm.Boolean

Indicates whether the solution component is part of a managed solution.

Display Name: Is Managed

Read Only
Default Options
Values Label
1 Managed
0 Unmanaged
language Edm.Int32

The language identifier (LCID) of this Chatbot.

Display Name: Language

Default Options
Values Label
1033 English
1034 Spanish
1046 Portuguese (Brazilian)
1036 French
1043 Dutch
1044 Norwegian
1030 Danish
1053 Swedish
1040 Italian
1031 German
2052 Chinese (Simplified)
1028 Chinese (Traditional)
1025 Arabic
1041 Japanese
1042 Korean
1081 Hindi
1057 Indonesian
1049 Russian
1045 Polish
1055 Turkish
1054 Thai
1035 Finnish
1032 Greek
1029 Czech
modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
name Edm.String

The display name of the Chatbot.

Display Name: Name
overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On
overwritetime Edm.DateTimeOffset

For internal use only.

Display Name: Record Overwrite Time

Read Only
publishedon Edm.DateTimeOffset

Date and time when the Chatbot was last published

Display Name: Published On
runtimeprovider Edm.Int32

Display Name: Runtime provider

Default Options
Values Label
0 Power Virtual Agents
1 Nuance Mix Shell
schemaname Edm.String

Unique name identifying the Chatbot.

Display Name: SchemaName
solutionid Edm.Guid

Unique identifier of the associated solution.

Display Name: Solution

Read Only
statecode Edm.Int32

Status of the Chatbot

Display Name: Status

Default Options
Values Label
0 Active
1 Inactive
statuscode Edm.Int32

Reason for the status of the Chatbot

Display Name: Status Reason

Default Options
Values Label
1 Provisioned
2 Deprovisioned
3 Provisioning
4 ProvisionFailed
5 MissingLicense
supportedlanguages Edm.String

The list of supported languages by this bot

Display Name: Supported languages

Default Options
Values Label
1033 English
1034 Spanish
1046 Portuguese (Brazilian)
1036 French
1043 Dutch
1044 Norwegian
1030 Danish
1053 Swedish
1040 Italian
1031 German
2052 Chinese (Simplified)
1028 Chinese (Traditional)
1025 Arabic
1041 Japanese
1042 Korean
1081 Hindi
1057 Indonesian
1049 Russian
1045 Polish
1055 Turkish
1054 Thai
1035 Finnish
1032 Greek
1029 Czech
synchronizationstatus Edm.String

Used to store information about the synchronization operations of the bot

Display Name: SynchronizationStatus
template Edm.String

Used to identify the template and version used for the bot default content

Display Name: Template
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number
utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code
versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Lookup property data.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the record.
_createdonbehalfby_value createdonbehalfby

Unique identifier of the delegate user who created the record.
_modifiedby_value modifiedby

Unique identifier of the user who modified the record.
_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who modified the record.
_ownerid_value ownerid

Owner Id
_owningbusinessunit_value owningbusinessunit

Unique identifier for the business unit that owns the record
_owningteam_value owningteam

Unique identifier for the team that owns the record.
_owninguser_value owninguser

Unique identifier for the user that owns the record.
_providerconnectionreferenceid_value ProviderConnectionReferenceId

Unique identifier for Connection Reference associated with Chatbot.
_publishedby_value publishedby

Unique identifier of the user who last published the bot.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_bot_createdby
createdonbehalfby systemuser lk_bot_createdonbehalfby
modifiedby systemuser lk_bot_modifiedby
modifiedonbehalfby systemuser lk_bot_modifiedonbehalfby
ownerid principal owner_bot
owningbusinessunit businessunit business_unit_bot
owningteam team team_bot
owninguser systemuser user_bot
ProviderConnectionReferenceId connectionreference bot_connectionreference
publishedby systemuser systemuser_bot_publishedby

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
bot_AsyncOperations asyncoperation regardingobjectid_bot
bot_botcomponent botcomponent bot_botcomponent
bot_BulkDeleteFailures bulkdeletefailure regardingobjectid_bot
bot_conversationtranscript conversationtranscript bot_conversationtranscriptId
bot_environmentvariabledefinition environmentvariabledefinition bot_environmentvariabledefinition
bot_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_bot
bot_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_bot
bot_ProcessSession processsession regardingobjectid_bot
bot_SyncErrors syncerror regardingobjectid_bot
botcomponent_parent_bot botcomponent parentbotid

Operations

The following operations can be used with the bot entity type.

Name Binding
CreateMultiple Not Bound
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
PvaAuthorize Bound to Entity
PvaCreateBotComponents Bound to Entity
PvaCreateContentSnapshot Bound to Entity
PvaDeleteBot Bound to Entity
PvaGetDirectLineEndpoint Bound to Entity
PvaProvision Bound to Entity
PvaPublish Bound to Entity
PvaPublishStatus Bound to Entity
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound
UpdateMultiple Not Bound

See also