# Amazon Connect

> Run your Amazon Connect contact center from workflows: place calls, create tasks, save details on contacts, check how busy queues are and add agents. Start a workflow when a contact starts or ends, a user is added, or a queue gets busy.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/amazon-connect

## Actions

### Change user's routing profile

Move a user to another routing profile, changing which queues and channels they take contacts from.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- User (`connect_user_id`, text, required): The Amazon Connect user (agent). Pick one, or give their id or ARN.
- Routing profile (`routing_profile_id`, text, required): Which queues and channels the user takes contacts from. Pick one, or give its id or ARN.

**Outputs**

- `routing_profile_id` (text): Their routing profile now
- `updated` (true/false): Always true once done
- `user_id` (text): The user

**Example output**

```json
{
  "routing_profile_id": "a1b2c3d4-5678-90ab-cdef-555555555555",
  "updated": true,
  "user_id": "a1b2c3d4-5678-90ab-cdef-444444444444"
}
```

### Create task

Create a task for your agents, with links and details, routed by a flow like any other contact. It can be scheduled up to 6 days ahead.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Task name (`name`, text, required): What agents see as the task's title.
- Flow (`contact_flow_id`, text, required): The flow to run, as published in Amazon Connect. Pick one, or give its id or ARN.
- Description (`description`, text): Details agents see with the task.
- Links (`links`, object): Names and web addresses agents can open, such as Order = https://shop.example.com/orders/1001.
- Contact attributes (`contact_attributes`, object): Names and values your flows and agents can read, such as account = A-1001. Names may use letters, digits, - and _.
- Start at (`scheduled_time`, date and time): When the task reaches agents. Leave blank for now.
- Linked contact (`previous_contact_id`, text): A contact this task follows on from, by its id.

**Outputs**

- `contact_id` (text): The task's contact id
- `name` (text): The task's name

**Example output**

```json
{
  "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
  "name": "Call back about order 1001"
}
```

### Create user

Add a user, such as a new agent, with a routing profile and security profiles. They get the Agent security profile unless you choose others.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- User name (`username`, text, required): What they sign in with: letters, digits and . _ - @, up to 20 characters (64 with SAML).
- Routing profile (`routing_profile_id`, text, required): Which queues and channels the user takes contacts from. Pick one, or give its id or ARN.
- First name (`first_name`, text): Needed unless your instance signs in through a directory.
- Last name (`last_name`, text): Needed unless your instance signs in through a directory.
- Email (`email`, text): Their email address.
- Password (`password`, text): Needed when people sign in with an Amazon Connect user name and password; leave blank with SAML or a directory. 8 to 64 characters with a capital, a small letter and a digit.
- Security profiles (`security_profile_ids`, list): What they may do in Amazon Connect. Defaults to Agent.
- Phone (`phone_type`, text): How they take calls. Defaults to softphone. One of: `SOFT_PHONE` (Softphone, in the browser (default)), `DESK_PHONE` (Desk phone). Default: `SOFT_PHONE`.
- Desk phone number (`desk_phone_number`, text): Their desk phone, with + and the country code, for Desk phone.

**Outputs**

- `arn` (text): Their ARN
- `security_profile_ids` (list): The security profiles they got
- `user_id` (text): The new user's id
- `username` (text): Their user name

**Example output**

```json
{
  "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/agent/a1b2c3d4-5678-90ab-cdef-444444444444",
  "security_profile_ids": [
    "a1b2c3d4-5678-90ab-cdef-999999999999"
  ],
  "user_id": "a1b2c3d4-5678-90ab-cdef-444444444444",
  "username": "jdoe"
}
```

### Delete user

Delete a user from the instance. They can no longer sign in; their past contacts are kept.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- User (`connect_user_id`, text, required): The Amazon Connect user (agent). Pick one, or give their id or ARN.

**Outputs**

- `deleted` (true/false): Always true once done
- `user_id` (text): The user deleted

**Example output**

```json
{
  "deleted": true,
  "user_id": "a1b2c3d4-5678-90ab-cdef-444444444444"
}
```

### End contact

End a call, chat, task or queued callback. A transferred call can't be ended this way.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Contact (`contact_id`, text, required): The contact's id, from an earlier step or a trigger.

**Outputs**

- `contact_id` (text): The contact ended
- `stopped` (true/false): Always true once done

**Example output**

```json
{
  "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
  "stopped": true
}
```

### Get contact

Get a call, chat or task: who it was with, its queue and agent, when it started and ended, and its attributes.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Contact (`contact_id`, text, required): The contact's id, from an earlier step or a trigger.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "agent_id": "a1b2c3d4-5678-90ab-cdef-444444444444",
    "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/contact/a1b2c3d4-5678-90ab-cdef-666666666666",
    "attributes": {
      "account": "A-1001"
    },
    "channel": "VOICE",
    "connected_to_agent_at": "2026-11-18T10:01:05Z",
    "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
    "customer_address": "+14155550123",
    "customer_address_type": "TELEPHONE_NUMBER",
    "description": null,
    "disconnect_reason": "CUSTOMER_DISCONNECT",
    "disconnected_at": "2026-11-18T10:07:41Z",
    "enqueued_at": "2026-11-18T10:00:20Z",
    "initial_contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
    "initiated_at": "2026-11-18T10:00:00Z",
    "initiation_method": "INBOUND",
    "last_updated_at": "2026-11-18T10:07:41Z",
    "name": null,
    "previous_contact_id": null,
    "queue_id": "a1b2c3d4-5678-90ab-cdef-222222222222",
    "scheduled_at": null,
    "system_address": "+18005550199",
    "tags": {}
  }
}
```

### Get contact attributes

Get the attributes saved on a contact, such as what the caller chose in a menu or a note an earlier step added.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Contact (`contact_id`, text, required): The contact's id, from an earlier step or a trigger.

**Outputs**

- `attributes` (object): Its attributes, name to value
- `contact_id` (text): The contact

**Example output**

```json
{
  "attributes": {
    "account": "A-1001"
  },
  "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666"
}
```

### Get queue

Get a queue's settings: whether it's on, its hours and its outbound caller ID.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Queue (`queue_id`, text, required): The queue. Pick one, or give its id or ARN.

**Outputs**

- `queue` (object): The queue

**Example output**

```json
{
  "queue": {
    "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/queue/a1b2c3d4-5678-90ab-cdef-222222222222",
    "description": "Customer support",
    "hours_of_operation_id": "a1b2c3d4-5678-90ab-cdef-777777777777",
    "last_modified_at": "2026-10-01T12:00:00Z",
    "max_contacts": 0,
    "name": "BasicQueue",
    "outbound_caller_id_name": "Acme Support",
    "outbound_caller_id_number_id": "a1b2c3d4-5678-90ab-cdef-888888888888",
    "outbound_flow_id": null,
    "queue_id": "a1b2c3d4-5678-90ab-cdef-222222222222",
    "status": "ENABLED",
    "tags": {}
  }
}
```

### Get queue metrics

See how busy queues are right now: contacts waiting, the longest wait, and how many agents are online and available.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Queues (`queue_ids`, list): The queues to check. Leave blank for all (up to 100).
- Channels (`channels`, list): Only these channels. Leave blank for all. One or more of: `VOICE` (Calls), `CHAT` (Chats), `TASK` (Tasks).

**Outputs**

- `checked_at` (text): When Amazon Connect took the figures (ISO 8601)
- `count` (number): How many were returned
- `queues` (list): One row per queue

**Example output**

```json
{
  "checked_at": "2026-11-18T10:05:00Z",
  "count": 1,
  "queues": [
    {
      "agents_after_contact_work": 0,
      "agents_available": 1,
      "agents_on_contact": 4,
      "agents_online": 5,
      "agents_staffed": 5,
      "contacts_scheduled": 0,
      "contacts_waiting": 3,
      "longest_wait_seconds": 145,
      "queue_id": "a1b2c3d4-5678-90ab-cdef-222222222222",
      "queue_name": "BasicQueue"
    }
  ]
}
```

### Get user

Get a user's name, email, routing profile, security profiles and phone settings.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- User (`connect_user_id`, text, required): The Amazon Connect user (agent). Pick one, or give their id or ARN.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "user": {
    "after_contact_work_seconds": 0,
    "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/agent/a1b2c3d4-5678-90ab-cdef-444444444444",
    "auto_accept": false,
    "desk_phone_number": null,
    "email": "jane.doe@example.com",
    "first_name": "Jane",
    "hierarchy_group_id": null,
    "last_modified_at": "2026-10-01T12:00:00Z",
    "last_name": "Doe",
    "mobile": null,
    "phone_type": "SOFT_PHONE",
    "routing_profile_id": "a1b2c3d4-5678-90ab-cdef-555555555555",
    "secondary_email": null,
    "security_profile_ids": [
      "a1b2c3d4-5678-90ab-cdef-999999999999"
    ],
    "tags": {},
    "user_id": "a1b2c3d4-5678-90ab-cdef-444444444444",
    "username": "jdoe"
  }
}
```

### List flows

List the flows in an instance, by type. Defaults to inbound flows, the kind calls and tasks start with.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Types (`flow_types`, list): Which kinds of flow. Defaults to inbound flows. One or more of: `CONTACT_FLOW` (Inbound flows (default)), `CUSTOMER_QUEUE` (Customer queue flows), `CUSTOMER_HOLD` (Customer hold flows), `CUSTOMER_WHISPER` (Customer whisper flows), `AGENT_HOLD` (Agent hold flows), `AGENT_WHISPER` (Agent whisper flows), `OUTBOUND_WHISPER` (Outbound whisper flows), `AGENT_TRANSFER` (Transfer to agent flows), `QUEUE_TRANSFER` (Transfer to queue flows), `CAMPAIGN` (Campaign flows).
- Max results (`max_results`, number): How many to return, 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many were returned
- `flows` (list): The flows

**Example output**

```json
{
  "count": 1,
  "flows": [
    {
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/contact-flow/a1b2c3d4-5678-90ab-cdef-333333333333",
      "flow_id": "a1b2c3d4-5678-90ab-cdef-333333333333",
      "name": "Default inbound",
      "state": "ACTIVE",
      "status": "PUBLISHED",
      "type": "CONTACT_FLOW"
    }
  ]
}
```

### List instances

List your Amazon Connect instances in the connection's Region.

**Inputs**: None.

**Outputs**

- `count` (number): How many were returned
- `instances` (list): The instances

**Example output**

```json
{
  "count": 1,
  "instances": [
    {
      "access_url": "https://acme-support.my.connect.aws",
      "alias": "acme-support",
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111",
      "created_at": "2026-01-12T09:00:00Z",
      "identity_management": "CONNECT_MANAGED",
      "inbound_calls_enabled": true,
      "instance_id": "a1b2c3d4-5678-90ab-cdef-111111111111",
      "outbound_calls_enabled": true,
      "status": "ACTIVE"
    }
  ]
}
```

### List queues

List the queues in an instance.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Max results (`max_results`, number): How many to return, 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many were returned
- `queues` (list): The queues

**Example output**

```json
{
  "count": 1,
  "queues": [
    {
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/queue/a1b2c3d4-5678-90ab-cdef-222222222222",
      "last_modified_at": "2026-10-01T12:00:00Z",
      "name": "BasicQueue",
      "queue_id": "a1b2c3d4-5678-90ab-cdef-222222222222",
      "type": "STANDARD"
    }
  ]
}
```

### List routing profiles

List the routing profiles in an instance: which queues and channels agents take contacts from.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Max results (`max_results`, number): How many to return, 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many were returned
- `routing_profiles` (list): The routing profiles

**Example output**

```json
{
  "count": 1,
  "routing_profiles": [
    {
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/routing-profile/a1b2c3d4-5678-90ab-cdef-555555555555",
      "last_modified_at": "2026-10-01T12:00:00Z",
      "name": "Basic Routing Profile",
      "routing_profile_id": "a1b2c3d4-5678-90ab-cdef-555555555555"
    }
  ]
}
```

### List users

List the users (agents, supervisors and admins) in an instance.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Max results (`max_results`, number): How many to return, 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many were returned
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "users": [
    {
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/agent/a1b2c3d4-5678-90ab-cdef-444444444444",
      "last_modified_at": "2026-10-01T12:00:00Z",
      "user_id": "a1b2c3d4-5678-90ab-cdef-444444444444",
      "username": "jdoe"
    }
  ]
}
```

### Search contacts

Find calls, chats and tasks in a time range, by channel, queue, agent or how they started. Newest first.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- From (`start_time`, date and time): Start of the range. Defaults to 24 hours ago.
- To (`end_time`, date and time): End of the range. Defaults to now.
- Contacts that (`time_type`, text): Which time falls in the range. Defaults to Started. One of: `INITIATION_TIMESTAMP` (Started), `DISCONNECT_TIMESTAMP` (Ended), `CONNECTED_TO_AGENT_TIMESTAMP` (Reached an agent), `ENQUEUE_TIMESTAMP` (Joined a queue), `SCHEDULED_TIMESTAMP` (Scheduled for). Default: `INITIATION_TIMESTAMP`.
- Channels (`channels`, list): Only these channels. Leave blank for all. One or more of: `VOICE` (Calls), `CHAT` (Chats), `TASK` (Tasks).
- Queues (`queue_ids`, list): Only contacts in these queues. Leave blank for all.
- Agents (`agent_ids`, list): Only contacts these users took. Leave blank for all.
- How they started (`initiation_methods`, list): Only contacts started these ways. Leave blank for all. One or more of: `INBOUND`, `OUTBOUND` (Outbound, dialled by an agent), `API` (Started from the API (calls and tasks from workflows)), `TRANSFER`, `QUEUE_TRANSFER` (Queue transfer), `CALLBACK`, `DISCONNECT` (Disconnect flow), `FLOW` (Started by a flow).
- Max results (`max_results`, number): How many to return, 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `contacts` (list): The contacts found
- `count` (number): How many were returned
- `total` (number): How many match in all, which can be more than returned

**Example output**

```json
{
  "contacts": [
    {
      "agent_id": "a1b2c3d4-5678-90ab-cdef-444444444444",
      "arn": "arn:aws:connect:us-east-1:123456789012:instance/a1b2c3d4-5678-90ab-cdef-111111111111/contact/a1b2c3d4-5678-90ab-cdef-666666666666",
      "channel": "VOICE",
      "connected_to_agent_at": "2026-11-18T10:01:05Z",
      "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
      "disconnected_at": "2026-11-18T10:07:41Z",
      "enqueued_at": "2026-11-18T10:00:20Z",
      "initial_contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
      "initiated_at": "2026-11-18T10:00:00Z",
      "initiation_method": "INBOUND",
      "name": null,
      "previous_contact_id": null,
      "queue_id": "a1b2c3d4-5678-90ab-cdef-222222222222",
      "scheduled_at": null
    }
  ],
  "count": 1,
  "total": 1
}
```

### Start outbound call

Call a phone number from Amazon Connect and run a flow, which can play a message or put the call in a queue for an agent. Calls are billed by Amazon Connect.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Phone number to call (`destination_phone_number`, text, required): With + and the country code, such as +14155550123.
- Flow (`contact_flow_id`, text, required): The flow to run, as published in Amazon Connect. Pick one, or give its id or ARN.
- Caller ID number (`caller_id_number`, text): The instance's number the person sees. Leave blank to use the Queue's outbound caller ID instead.
- Queue (`queue_id`, text): The queue the call belongs to; its outbound caller ID is shown when no Caller ID number is chosen.
- Name (`name`, text): A name agents see for the call.
- Description (`description`, text): A note agents see for the call.
- Contact attributes (`contact_attributes`, object): Names and values your flows and agents can read, such as account = A-1001. Names may use letters, digits, - and _.
- Ring for (`ring_timeout_seconds`, number): Seconds to wait for an answer, 15 to 60. Defaults to 60. From 15 to 60.

**Outputs**

- `contact_id` (text): The call's contact id

**Example output**

```json
{
  "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666"
}
```

### Update contact attributes

Add or change attributes on a contact, during or after it, such as a CRM account or a reason for the call. Attributes you leave out are kept.

**Inputs**

- Instance (`instance_id`, text, required): Your Amazon Connect instance. Pick one, or give its id or ARN.
- Contact (`contact_id`, text, required): The contact's id, from an earlier step or a trigger.
- Contact attributes (`contact_attributes`, object, required): Names and values to save, such as account = A-1001. Names may use letters, digits, - and _.

**Outputs**

- `attributes` (object): The attributes saved, as sent
- `contact_id` (text): The contact
- `updated` (true/false): Always true once saved

**Example output**

```json
{
  "attributes": {
    "account": "A-1001"
  },
  "contact_id": "a1b2c3d4-5678-90ab-cdef-666666666666",
  "updated": true
}
```
