Search Contacts

connect_search_contacts

R Documentation

Searches contacts in an Amazon Connect instance

Description

Searches contacts in an Amazon Connect instance.

Usage

connect_search_contacts(InstanceId, TimeRange, SearchCriteria,
  MaxResults, NextToken, Sort)

Arguments

InstanceId	[required] The identifier of Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
TimeRange	[required] Time range that you want to search results.
SearchCriteria	The search criteria to be used to return contacts.
MaxResults	The maximum number of results to return per page.
NextToken	The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
Sort	Specifies a field to sort by and a sort order.

Value

A list with the following syntax:

list(
  Contacts = list(
    list(
      Arn = "string",
      Id = "string",
      InitialContactId = "string",
      PreviousContactId = "string",
      InitiationMethod = "INBOUND"|"OUTBOUND"|"TRANSFER"|"QUEUE_TRANSFER"|"CALLBACK"|"API"|"DISCONNECT"|"MONITOR"|"EXTERNAL_OUTBOUND"|"WEBRTC_API"|"AGENT_REPLY"|"FLOW",
      Channel = "VOICE"|"CHAT"|"TASK"|"EMAIL",
      QueueInfo = list(
        Id = "string",
        EnqueueTimestamp = as.POSIXct(
          "2015-01-01"
        )
      ),
      AgentInfo = list(
        Id = "string",
        ConnectedToAgentTimestamp = as.POSIXct(
          "2015-01-01"
        )
      ),
      InitiationTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      DisconnectTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      ScheduledTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      SegmentAttributes = list(
        list(
          ValueString = "string"
        )
      )
    )
  ),
  NextToken = "string",
  TotalCount = 123
)

Request syntax

svc$search_contacts(
  InstanceId = "string",
  TimeRange = list(
    Type = "INITIATION_TIMESTAMP"|"SCHEDULED_TIMESTAMP"|"CONNECTED_TO_AGENT_TIMESTAMP"|"DISCONNECT_TIMESTAMP",
    StartTime = as.POSIXct(
      "2015-01-01"
    ),
    EndTime = as.POSIXct(
      "2015-01-01"
    )
  ),
  SearchCriteria = list(
    AgentIds = list(
      "string"
    ),
    AgentHierarchyGroups = list(
      L1Ids = list(
        "string"
      ),
      L2Ids = list(
        "string"
      ),
      L3Ids = list(
        "string"
      ),
      L4Ids = list(
        "string"
      ),
      L5Ids = list(
        "string"
      )
    ),
    Channels = list(
      "VOICE"|"CHAT"|"TASK"|"EMAIL"
    ),
    ContactAnalysis = list(
      Transcript = list(
        Criteria = list(
          list(
            ParticipantRole = "AGENT"|"CUSTOMER"|"SYSTEM"|"CUSTOM_BOT"|"SUPERVISOR",
            SearchText = list(
              "string"
            ),
            MatchType = "MATCH_ALL"|"MATCH_ANY"
          )
        ),
        MatchType = "MATCH_ALL"|"MATCH_ANY"
      )
    ),
    InitiationMethods = list(
      "INBOUND"|"OUTBOUND"|"TRANSFER"|"QUEUE_TRANSFER"|"CALLBACK"|"API"|"DISCONNECT"|"MONITOR"|"EXTERNAL_OUTBOUND"|"WEBRTC_API"|"AGENT_REPLY"|"FLOW"
    ),
    QueueIds = list(
      "string"
    ),
    SearchableContactAttributes = list(
      Criteria = list(
        list(
          Key = "string",
          Values = list(
            "string"
          )
        )
      ),
      MatchType = "MATCH_ALL"|"MATCH_ANY"
    ),
    SearchableSegmentAttributes = list(
      Criteria = list(
        list(
          Key = "string",
          Values = list(
            "string"
          )
        )
      ),
      MatchType = "MATCH_ALL"|"MATCH_ANY"
    )
  ),
  MaxResults = 123,
  NextToken = "string",
  Sort = list(
    FieldName = "INITIATION_TIMESTAMP"|"SCHEDULED_TIMESTAMP"|"CONNECTED_TO_AGENT_TIMESTAMP"|"DISCONNECT_TIMESTAMP"|"INITIATION_METHOD"|"CHANNEL",
    Order = "ASCENDING"|"DESCENDING"
  )
)