# Tidio

> Manage Tidio contacts and tickets, read conversations, and watch contacts, tickets and messages.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/tidio

## Actions

### Create contact

Create contact.

**Inputs**

- Distinct ID (`distinct_id`, text, required): ID of the contact in external system
- Email (`email`, text): Email address of the contact [RFC822]
- Phone (`phone`, text): Phone number of the contact
- First name (`first_name`, text): First name of the contact
- Last name (`last_name`, text): Last name of the contact
- Email consent (`email_consent`, text): This field indicates if contact agreed to newsletter subscription. One of: `subscribed`, `unsubscribed`.
- Properties (`properties`, list): Properties.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e"
  }
}
```

### Create contacts

Create contacts.

**Inputs**

- Contacts (`contacts`, list, required): Contacts. From 1 to 100.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Create ticket

Create ticket.

**Inputs**

- Contact email (`contact_email`, text, required): Email of contact person
- Subject (`subject`, text, required): Subject of ticket
- Message content (`message_content`, text, required): First ticket message content
- Assigned department (`assigned_department_id`, text): ID of assigned Department. When not provided, then the General department is assigned as default.
- Custom channel ID (`custom_channel_id`, text): ID of custom channel to attach to given ticket.
- Tag IDs (`tag_ids`, list): List of tag IDs to attach to the ticket.
- Custom fields (`custom_fields`, list): Custom field values to set on the ticket

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "id": 10000
  }
}
```

### Delete contact

Delete contact.

**Inputs**

- Contact (`contact_id`, text, required): Contact ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Delete ticket

Delete ticket.

**Inputs**

- Ticket (`ticket_id`, number, required): Ticket ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Get contact

Get contact.

**Inputs**

- Contact (`contact_id`, text, required): Contact ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "id": "a1b4ca4c-1108-4432-b256-1e4cf2bf6f9e"
  }
}
```

### Get project

Get project.

**Inputs**: None.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Get ticket

Get ticket.

**Inputs**

- Ticket (`ticket_id`, number, required): Ticket ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "id": 10000
  }
}
```

### List contact properties

List contact properties.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List contacts

List contacts.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one
- Email (`email`, text): Filter contacts by email address

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List departments

List departments.

**Inputs**: None.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List messages

List messages.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one
- Contact (`contact_id`, text, required): Contact ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List operators

List operators.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List ticket custom fields

List ticket custom fields.

**Inputs**: None.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [
      {
        "id": "01HF8N4A2B3C4D5E6F7G8H9J0K",
        "is_required": false,
        "name": "Priority reason",
        "type": "text"
      },
      {
        "id": "01HF8N4A2B3C4D5E6F7G8H9J0L",
        "is_dynamic": false,
        "is_required": true,
        "name": "Category",
        "type": "dropdown_text",
        "values": [
          "billing",
          "shipping",
          "other"
        ]
      }
    ]
  }
}
```

### List ticket tags

List ticket tags.

**Inputs**: None.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "data": [
      {
        "id": 1,
        "name": "billing"
      },
      {
        "id": 2,
        "name": "shipping"
      },
      {
        "id": 3,
        "name": "Z\u00fcrich"
      }
    ]
  }
}
```

### List tickets

List tickets.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### List viewed pages

List viewed pages.

**Inputs**

- Cursor (`cursor`, text): Value from the previous page. Use null to fetch the first one
- Contact (`contact_id`, text, required): Contact ID.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Reply to ticket

Add a reply or note to a ticket as a contact or operator.

**Inputs**

- Ticket (`ticket_id`, number, required): Ticket ID.
- Author type (`author_type`, text, required): Who replied. One of: `contact`, `operator`.
- Content (`content`, text, required): Message content
- Operator (`operator_id`, text): Operator id
- Message type (`message_type`, text): Determines visibility of message. One of: `public`, `internal`.

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {
    "id": "01HAVMVKF90KH3EC0HK2T6QYP6"
  }
}
```

### Update contact

Update contact.

**Inputs**

- Contact (`contact_id`, text, required): Contact ID.
- Email (`email`, text): Email address of the contact [RFC822]
- Phone (`phone`, text): Phone number of the contact
- First name (`first_name`, text): First name of the contact
- Last name (`last_name`, text): Last name of the contact
- Email consent (`email_consent`, text): This field indicates if contact agreed to newsletter subscription. One of: `subscribed`, `unsubscribed`.
- Properties (`properties`, list): Properties.
- Distinct ID (`distinct_id`, text): ID of the contact in external system

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```

### Update ticket

Update ticket.

**Inputs**

- Ticket (`ticket_id`, number, required): Ticket ID.
- Status (`status`, text): Ticket status. One of: `open`, `pending`, `solved`.
- Priority (`priority`, text): Ticket priority. One of: `low`, `normal`, `urgent`.
- Tag IDs (`tag_ids`, list): Replaces the ticket's full tag set with the supplied IDs. Empty array removes all tags.
- Custom fields (`custom_fields`, list): Upserts the specified custom field values using merge semantics. Fields not in the payload are left unchanged. Send `value: null` to remove the stored value for a field.
- Assign to (`assignee_type`, text): Type of assign. One of: `department`, `operator`.
- Assignee (`assignee_id`, text): ID of assigned type

**Outputs**

- `response` (object): The complete service response, including resource data and pagination fields.

**Example output**

```json
{
  "response": {}
}
```
