Phone

Get a phone call

phone_get_call · Reads only · Markdown

One call with its whole transcript: who said what, and when.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

What exactly did the caller from Beaverton say about the squeaky brakes?

Your agent callsphone_get_callFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "call_id": "a3f5c2d1-9b8e-4f70-8c6d-2e1b0a9f8c7d"
}

What comes back

{
  "call": {
    "call_id": "a3f5c2d1-9b8e-4f70-8c6d-2e1b0a9f8c7d",
    "direction": "inbound",
    "from": "+15035550187",
    "to": "+15035550123",
    "at": "2026-10-13T16:42:10+00:00",
    "status": "ended",
    "answered": true,
    "duration_seconds": 146,
    "cost_usd": "$0.75",
    "summary": "The brakes on a bike from last week's tune-up squeak; the caller wants them looked at.",
    "ended_at": "2026-10-13T16:44:36+00:00",
    "transcript": [
      {
        "speaker": "assistant",
        "text": "Hi, you've reached Halverson Cycle & Repair. This is our automated line: how can we help?",
        "at_second": 0
      },
      {
        "speaker": "caller",
        "text": "Hi, I had my bike tuned up last week and the front brake squeaks every time I stop.",
        "at_second": 6
      }
    ]
  }
}

Use it when

The details of a call matter: what the caller asked, what the line promised.

What it does

One call with its whole transcript (who said what, and when).

What comes back

The call with its direction, numbers, times, status, duration, cost and summary, and the transcript: each line with the speaker (caller or assistant), the text and the second it was said. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`call_id`Required	string	Exactly 36 characters.

The call

Over MCP, call phone_get_call on https://api.conecto.chat/mcp/phone. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/phone_get_call \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"call_id":"a3f5c2d1-9b8e-4f70-8c6d-2e1b0a9f8c7d"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_found`404	No call of the business has that call_id.	Find the call with phone_list_calls and use its call_id.

More Phone tools

All 8 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Get a phone call

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Phone tools

Give this to your agent.