Amazon Connect Service

Updates the task template association on an existing task contact. You can update the task template on a contact before assignment to support tasks that are created without a template (for example Rules or disconnect flows) or change the agent interaction form to represent the latest task data (for example an initial request that was submitted as a refund gets updated to an account cancellation and requires a new template).

This operation can only be used with task contacts that are in progress and not connected to an agent. A task template can be updated a maximum of 5 times per contact.

The task's references must be compatible with the fields of the target task template. If the target template has a required field, the task must have a corresponding reference with a matching name and compatible type. The following task template field types map to reference types:

• TEXT, TEXT_AREA, BOOLEAN, and SINGLE_SELECT map to references of type STRING.

• NUMBER maps to references of type NUMBER.

• DATE_TIME maps to references of type DATE.

• URL maps to references of type URL.

• EMAIL maps to references of type EMAIL.

References corresponding to TEXT fields must be fewer than 512 characters. TEXT_AREA fields must be fewer than 4,096 characters. BOOLEAN fields must have a value of true or false.

An InvalidRequestException occurs when UpdateContactTaskTemplate is called on a connected or terminated task, when it is called on non-task contacts, and when the task contact already uses the provided task template. A PropertyValidationException occurs when the task's references conflict with the task template's fields, for example if the task is missing a reference that matches a required field, or if the task has a reference that matches a required field's name but not its datatype.

See also: AWS API Documentation

Request Syntax

client.update_contact_task_template(
    InstanceId='string',
    TaskTemplateId='string',
    ContactId='string'
)

type InstanceId:

string

param InstanceId:

[REQUIRED]

The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

type TaskTemplateId:

string

param TaskTemplateId:

[REQUIRED]

A unique identifier for the task template. For more information about task templates, see Task templates in the Connect Customer Administrator Guide.

type ContactId:

string

param ContactId:

[REQUIRED]

The identifier of the contact in this instance of Connect Customer.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

• (dict) --