> ## 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: Collect Fin Voice Calls By Conversation ID

> List the Fin Voice calls linked to an Intercom conversation. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the Fin Voice calls linked to an Intercom conversation.

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

## 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_collect_fin_voice_calls_by_conversation_id',
  {
    "conversation_id": "conversation_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_collect_fin_voice_calls_by_conversation_id --input '{
  "conversation_id": "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": [
    {
      "id": 123,
      "app_id": 123,
      "user_phone_number": "+14155550123"
    }
  ]
}
```

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

## Input reference

Retrieve information about Fin Voice calls associated with a conversation. Returns all matched calls for the given conversation ID. A conversation may have multiple associated calls.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.conversation_id` | `string` | Yes | — | The Intercom conversation identifier |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve information about Fin Voice calls associated with a conversation. Returns all matched calls for the given conversation ID. A conversation may have multiple associated calls.",
    "properties": {
      "conversation_id": {
        "type": "string",
        "description": "The Intercom conversation identifier"
      }
    },
    "required": [
      "conversation_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `array` | Yes | — | Provider response payload. |
| `result.data[].id` | `integer` | No | — | The unique identifier for the external reference |
| `result.data[].app_id` | `integer` | No | — | The workspace identifier |
| `result.data[].user_phone_number` | `string` | No | — | Phone number in E.164 format for the call |
| `result.data[].status` | `string` | No | — | Status of the call. Can be "registered", "in-progress", or a resolution state |
| `result.data[].intercom_call_id` | `string \| null` | No | — | The Intercom call identifier, if the call has been matched |
| `result.data[].external_call_id` | `string` | No | — | The external call identifier from the call provider |
| `result.data[].intercom_conversation_id` | `string \| null` | No | — | The Intercom conversation identifier, if a conversation has been created |
| `result.data[].call_transcript` | `array` | No | — | Array of transcript entries for the call |
| `result.data[].call_summary` | `string` | No | — | Summary of the call conversation, truncated to 256 characters. Empty string if no summary available. |
| `result.data[].intent` | `array` | No | — | Array of intent classifications for the call |
| `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": "array",
        "description": "Provider response payload.",
        "items": {
          "type": "object",
          "description": "Response containing information about a Fin Voice call",
          "properties": {
            "id": {
              "type": "integer",
              "description": "The unique identifier for the external reference"
            },
            "app_id": {
              "type": "integer",
              "description": "The workspace identifier"
            },
            "user_phone_number": {
              "type": "string",
              "description": "Phone number in E.164 format for the call"
            },
            "status": {
              "type": "string",
              "description": "Status of the call. Can be \"registered\", \"in-progress\", or a resolution state"
            },
            "intercom_call_id": {
              "type": [
                "string",
                "null"
              ],
              "description": "The Intercom call identifier, if the call has been matched"
            },
            "external_call_id": {
              "type": "string",
              "description": "The external call identifier from the call provider"
            },
            "intercom_conversation_id": {
              "type": [
                "string",
                "null"
              ],
              "description": "The Intercom conversation identifier, if a conversation has been created"
            },
            "call_transcript": {
              "type": "array",
              "description": "Array of transcript entries for the call",
              "items": {
                "type": "object"
              }
            },
            "call_summary": {
              "type": "string",
              "description": "Summary of the call conversation, truncated to 256 characters. Empty string if no summary available."
            },
            "intent": {
              "type": "array",
              "description": "Array of intent classifications for the call",
              "items": {
                "type": "object"
              }
            }
          },
          "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.