> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom: List Calls With Transcripts

> Get the Intercom calls for up to 20 conversations, with transcripts when available. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Get the Intercom calls for up to 20 conversations, with transcripts when available.

> [!NOTE]
>
> Tool ID: `intercom_list_calls_with_transcripts`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'intercom_list_calls_with_transcripts',
  {
    "conversation_ids": [
      "conversation_123"
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_list_calls_with_transcripts --input '{
  "conversation_ids": [
    "conversation_123"
  ]
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "type": "example",
    "data": [
      {
        "type": "example",
        "id": "id_123",
        "conversation_id": "conversation_123"
      }
    ]
  }
}
```

Use `deepline describe intercom_list_calls_with_transcripts --json` for the latest machine-readable contract.

## Input reference

Retrieve calls by a list of conversation ids and include transcripts when available. A maximum of 20 `conversation_ids` can be provided. If none are provided or more than 20 are provided, a 400 error is returned.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.conversation_ids` | `array` | Yes | — | A list of conversation ids to fetch calls for. Maximum 20. Minimum items: 1. Maximum items: 20. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve calls by a list of conversation ids and include transcripts when available. A maximum of 20 `conversation_ids` can be provided. If none are provided or more than 20 are provided, a 400 error is returned.",
    "properties": {
      "conversation_ids": {
        "type": "array",
        "description": "A list of conversation ids to fetch calls for. Maximum 20.",
        "minItems": 1,
        "maxItems": 20,
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "conversation_ids"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.type` | `string` | No | — | — |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].type` | `string` | No | — | String representing the object's type. Always has the value `call`. |
| `result.data.data[].id` | `string` | No | — | The id of the call. |
| `result.data.data[].conversation_id` | `string \| null` | No | — | The id of the conversation associated with the call, if any. |
| `result.data.data[].admin_id` | `string \| null` | No | — | The id of the admin associated with the call, if any. |
| `result.data.data[].contact_id` | `string \| null` | No | — | The id of the contact associated with the call, if any. |
| `result.data.data[].state` | `string` | No | — | The current state of the call. |
| `result.data.data[].initiated_at` | `record` | No | — | — |
| `result.data.data[].answered_at` | `record` | No | — | — |
| `result.data.data[].ended_at` | `record` | No | — | — |
| `result.data.data[].created_at` | `record` | No | — | — |
| `result.data.data[].updated_at` | `record` | No | — | — |
| `result.data.data[].recording_url` | `string \| null` | No | — | API URL to download or redirect to the call recording if available. Format: `uri`. |
| `result.data.data[].transcription_url` | `string \| null` | No | — | API URL to download or redirect to the call transcript if available. Format: `uri`. |
| `result.data.data[].call_type` | `string` | No | — | The type of call. |
| `result.data.data[].direction` | `string` | No | — | The direction of the call. |
| `result.data.data[].ended_reason` | `string \| null` | No | — | The reason for the call end, if applicable. |
| `result.data.data[].phone` | `string \| null` | No | — | The phone number involved in the call, in E.164 format. |
| `result.data.data[].fin_recording_url` | `string \| null` | No | — | API URL to the AI Agent (Fin) call recording if available. Format: `uri`. |
| `result.data.data[].fin_transcription_url` | `string \| null` | No | — | API URL to the AI Agent (Fin) call transcript if available. Format: `uri`. |
| `result.data.data[].transcript` | `array` | No | — | The call transcript if available, otherwise an empty array. |
| `result.data.data[].transcript_status` | `string \| null` | No | — | The status of the transcript if available. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "type": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents a phone call in Intercom",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "String representing the object's type. Always has the value `call`."
                },
                "id": {
                  "type": "string",
                  "description": "The id of the call."
                },
                "conversation_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The id of the conversation associated with the call, if any."
                },
                "admin_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The id of the admin associated with the call, if any."
                },
                "contact_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The id of the contact associated with the call, if any."
                },
                "state": {
                  "type": "string",
                  "description": "The current state of the call."
                },
                "initiated_at": {
                  "type": "object",
                  "additionalProperties": true
                },
                "answered_at": {
                  "type": "object",
                  "additionalProperties": true
                },
                "ended_at": {
                  "type": "object",
                  "additionalProperties": true
                },
                "created_at": {
                  "type": "object",
                  "additionalProperties": true
                },
                "updated_at": {
                  "type": "object",
                  "additionalProperties": true
                },
                "recording_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "API URL to download or redirect to the call recording if available.",
                  "format": "uri"
                },
                "transcription_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "API URL to download or redirect to the call transcript if available.",
                  "format": "uri"
                },
                "call_type": {
                  "type": "string",
                  "description": "The type of call."
                },
                "direction": {
                  "type": "string",
                  "description": "The direction of the call."
                },
                "ended_reason": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The reason for the call end, if applicable."
                },
                "phone": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The phone number involved in the call, in E.164 format."
                },
                "fin_recording_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "API URL to the AI Agent (Fin) call recording if available.",
                  "format": "uri"
                },
                "fin_transcription_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "API URL to the AI Agent (Fin) call transcript if available.",
                  "format": "uri"
                },
                "transcript": {
                  "type": "array",
                  "description": "The call transcript if available, otherwise an empty array.",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  }
                },
                "transcript_status": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The status of the transcript if available."
                }
              },
              "required": [],
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Intercom provider guide](https://deepline.com/docs/providers/intercom/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.