conecto. Get started
Phone

Get how calls are answered

phone_get_assistant · Reads only · Markdown

How the business's numbers answer, whether they answer right now (and why not), and the voices to choose from.

Free*

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

An example

Is our phone being answered right now? And which voices could it use?

Your agent callsphone_get_assistantFree*

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
{}
What comes back
{
  "assistant": {
    "answering": true,
    "not_answering_because": [
      "Outside the answering hours right now."
    ],
    "name": "Phone assistant",
    "greeting": "Hi, you've reached Halverson Cycle & Repair. This is our automated line: how can we help?",
    "language": "en",
    "answer_with": "webhook",
    "message_ack": "Thank you, I've noted that. Is there anything else?",
    "cant_answer": "Sorry, I can't answer that right now. Please tell me your message and we'll get back to you.",
    "open_tickets": "off",
    "webhook_url": "https://agent.halversoncycle.example/conecto/phone",
    "webhook_last_ok_at": null,
    "webhook_last_error": null,
    "voice": {
      "id": "stock_voice",
      "name": "George"
    },
    "timezone": "America/Los_Angeles",
    "hours": [
      {
        "day": "monday",
        "start": "10:00",
        "end": "19:00"
      },
      {
        "day": "tuesday",
        "start": "10:00",
        "end": "19:00"
      }
    ],
    "max_call_minutes": 5,
    "numbers": [
      "+15035550123"
    ],
    "price": {
      "per_started_minute_usd": "$0.25",
      "held_per_call_usd": "$1.25"
    }
  },
  "voices": [
    {
      "id": "stock_voice",
      "name": "George",
      "style": "Narrative"
    },
    {
      "id": "stock_voice_2",
      "name": "Sarah",
      "style": "Soft"
    }
  ]
}

Use it when

Calls go unanswered, or before changing the greeting or voice.

What it does

How the business's numbers answer (your webhook or taking messages), whether they are answering right now (and if not, why), and the voices the line can use.

What comes back

The assistant: whether it answers now and why not, name, greeting, language, voice, how it answers, hours and call limit, and the voices with their id, name and style. Every reply also carries cost_usd and balance_usd.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/phone_get_assistant \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Phone tools

All 8 tools

Give this to your agent.

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