Skip to content

Describe Contact

connect_describe_contact R Documentation

This API is in preview release for Amazon Connect and is subject to change

Description

This API is in preview release for Amazon Connect and is subject to change.

Describes the specified contact.

Contact information remains available in Amazon Connect for 24 months, and then it is deleted.

Only data from November 12, 2021, and later is returned by this API.

Usage

connect_describe_contact(InstanceId, ContactId)

Arguments

InstanceId

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

ContactId

[required] The identifier of the contact.

Value

A list with the following syntax:

list(
  Contact = list(
    Arn = "string",
    Id = "string",
    InitialContactId = "string",
    PreviousContactId = "string",
    InitiationMethod = "INBOUND"|"OUTBOUND"|"TRANSFER"|"QUEUE_TRANSFER"|"CALLBACK"|"API"|"DISCONNECT"|"MONITOR"|"EXTERNAL_OUTBOUND",
    Name = "string",
    Description = "string",
    Channel = "VOICE"|"CHAT"|"TASK",
    QueueInfo = list(
      Id = "string",
      EnqueueTimestamp = as.POSIXct(
        "2015-01-01"
      )
    ),
    AgentInfo = list(
      Id = "string",
      ConnectedToAgentTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      AgentPauseDurationInSeconds = 123,
      HierarchyGroups = list(
        Level1 = list(
          Arn = "string"
        ),
        Level2 = list(
          Arn = "string"
        ),
        Level3 = list(
          Arn = "string"
        ),
        Level4 = list(
          Arn = "string"
        ),
        Level5 = list(
          Arn = "string"
        )
      ),
      DeviceInfo = list(
        PlatformName = "string",
        PlatformVersion = "string",
        OperatingSystem = "string"
      ),
      Capabilities = list(
        Video = "SEND"
      )
    ),
    InitiationTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    DisconnectTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    LastUpdateTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    LastPausedTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    LastResumedTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    TotalPauseCount = 123,
    TotalPauseDurationInSeconds = 123,
    ScheduledTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    RelatedContactId = "string",
    WisdomInfo = list(
      SessionArn = "string"
    ),
    QueueTimeAdjustmentSeconds = 123,
    QueuePriority = 123,
    Tags = list(
      "string"
    ),
    ConnectedToSystemTimestamp = as.POSIXct(
      "2015-01-01"
    ),
    RoutingCriteria = list(
      Steps = list(
        list(
          Expiry = list(
            DurationInSeconds = 123,
            ExpiryTimestamp = as.POSIXct(
              "2015-01-01"
            )
          ),
          Expression = list(
            AttributeCondition = list(
              Name = "string",
              Value = "string",
              ProficiencyLevel = 123.0,
              MatchCriteria = list(
                AgentsCriteria = list(
                  AgentIds = list(
                    "string"
                  )
                )
              ),
              ComparisonOperator = "string"
            ),
            AndExpression = list(
              list()
            ),
            OrExpression = list(
              list()
            )
          ),
          Status = "ACTIVE"|"INACTIVE"|"JOINED"|"EXPIRED"
        )
      ),
      ActivationTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      Index = 123
    ),
    Customer = list(
      DeviceInfo = list(
        PlatformName = "string",
        PlatformVersion = "string",
        OperatingSystem = "string"
      ),
      Capabilities = list(
        Video = "SEND"
      )
    ),
    Campaign = list(
      CampaignId = "string"
    ),
    AnsweringMachineDetectionStatus = "ANSWERED"|"UNDETECTED"|"ERROR"|"HUMAN_ANSWERED"|"SIT_TONE_DETECTED"|"SIT_TONE_BUSY"|"SIT_TONE_INVALID_NUMBER"|"FAX_MACHINE_DETECTED"|"VOICEMAIL_BEEP"|"VOICEMAIL_NO_BEEP"|"AMD_UNRESOLVED"|"AMD_UNANSWERED"|"AMD_ERROR"|"AMD_NOT_APPLICABLE",
    CustomerVoiceActivity = list(
      GreetingStartTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      GreetingEndTimestamp = as.POSIXct(
        "2015-01-01"
      )
    ),
    QualityMetrics = list(
      Agent = list(
        Audio = list(
          QualityScore = 123.0,
          PotentialQualityIssues = list(
            "string"
          )
        )
      ),
      Customer = list(
        Audio = list(
          QualityScore = 123.0,
          PotentialQualityIssues = list(
            "string"
          )
        )
      )
    ),
    DisconnectDetails = list(
      PotentialDisconnectIssue = "string"
    ),
    SegmentAttributes = list(
      list(
        ValueString = "string"
      )
    )
  )
)

Request syntax

svc$describe_contact(
  InstanceId = "string",
  ContactId = "string"
)