Human in the loop phone calls for operations

Some workflows stall on one fact that only a phone call can get. HumanCalls sends a real person to make that call for your team or your AI agent. Each task has a spending cap and is checked before anyone dials. The result comes back as typed values, with a summary, a recording and a transcript, delivered to your system by signed webhook.

Where an automated workflow needs a phone call

Operations work often depends on businesses that do not publish what you need and do not answer email quickly. A location's hours have changed. A supplier's order has gone quiet. A listing needs checking before it goes live. Your agent can handle the rest of the job, but a person has to ask the question by phone.

Workflow stepWhat you might collectGuide
Confirm a site is open before dispatchopen_today, closing_timeConfirm opening hours with a phone call
Check business details before an updateaddress_confirmed, main_contactVerify business information by phone
Chase a late supplier orderorder_status, ship_dateCall a supplier to check order status
Check parts before a repairin_stock, priceCheck stock and price by phone

Calls go to businesses in the United States and Canada during their local hours. A result can take from a few minutes to the next business morning, so design the step to wait rather than block.

How the spending cap works

Every task sets max_minutes, from 1 to 120, with a default of 10. When the task is created, HumanCalls reserves that many minutes of credit. At completion you pay only for connected time, rounded up to a minute, and the rest of the reservation is released. A call of 492 seconds bills as 9 minutes, or $9.

  • $1 per connected minute. Phone menus and hold time after the business answers count. Ringing does not.
  • $0 when nothing connects. Unanswered, declined and canceled calls cost nothing.
  • No silent top-ups. If the balance cannot cover the reservation, the API returns 402 insufficient_credits and no task is queued.
  • Only the owner buys credit. Credit is purchased through Stripe Checkout from a top_up_url. An agent cannot make a purchase by API.

A new workspace gets 10 free minutes once the owner verifies their email. See pricing for the details.

The review step before anyone dials

Tasks are saved straight away, then checked before dialing. The intake_status field shows where a task stands: pending, allowed, review_required, blocked or failed. An uncertain or failed check holds the call. A prohibited request is declined at no charge.

If details are missing, the task may list intake_questions. Your agent can add information with POST /v1/calls/:id/additions before the first dial. An addition resets the safety check, so the task is reviewed again. You can cancel a task while it is queued or assigned.

After the call, the caller reviews the result before it is final. Progress events may arrive earlier, but the terminal event carries the caller-reviewed outcome. More on how calls are handled is on trust and process.

Receiving results by webhook

Register a receiver with POST /v1/connections, install the signing secret, and complete the signed verification challenge. Once verified, make it the default or name it per task. Put your own job reference in metadata so the result can resume the right job.

Request body for POST /v1/calls (example data)
{
  "to": "+15035550187",
  "business": "Northside Auto",
  "on_behalf_of": "Fieldwork Printing",
  "goal": "Confirm Saturday opening hours and whether they service delivery vans.",
  "max_minutes": 8,
  "collect": {
    "open_saturday": {"type": "boolean", "required": true},
    "saturday_hours": {"type": "string"},
    "services_vans": {"type": "boolean"}
  },
  "delivery": {"mode": "webhook", "connection_id": "conn_example123"},
  "metadata": {"agent_job_id": "job-4471"}
}
  • Check HC-Signature with HMAC-SHA256 and reject timestamps more than 300 seconds away.
  • Deduplicate on event_id, and store the event before returning a 2xx.
  • Failed deliveries retry after 1m, 5m, 30m, 2h, 5h, 10h and 24h. You can also replay an event or poll GET /v1/events.
  • Terminal events are call.completed, call.failed, call.no_answer, call.declined and call.canceled.

The developer docs cover every field. Teams that build with workflow tools can start from n8n or the REST API.

Limits and what callers will not do

An account can create ten new tasks a minute and keep three open tasks per destination number. Above that, the API returns 429 with Retry-After.

Your caller says who they are and who they are calling for, and tells the business the call is recorded. They ask for information. They do not buy, book or agree to anything you did not authorize. Sales, debt collection, political calls, cold calls to consumers, sensitive healthcare workflows and anything deceptive are not accepted.

Questions

Can our AI agent spend more than we set?
No. Each task reserves max_minutes of credit up front, and a task that cannot be covered is not queued. Only the workspace owner can buy more credit, through Stripe Checkout.
How do we know a webhook really came from HumanCalls?
Each delivery carries an HC-Signature header with an HMAC-SHA256 of the timestamp and raw body. Check it with your signing secret and reject old timestamps.
What happens if our receiver is down?
Failed deliveries retry on a schedule up to 24 hours. You can also check delivery status, replay a saved event, or poll the events endpoint.
Can we stop a call after it has been requested?
Yes, while the task is queued or assigned. A canceled call costs $0 and the reserved credit is released.

Related

  • Phone calls for procurement teamsA real person calls your vendors for stock checks, lead times, quotes and order follow-ups, then returns typed answers, a recording and a transcript.
  • Add a phone call step to an n8n workflowUse HumanCalls from n8n: one HTTP Request node asks a real person to phone a business, and a second reads back typed answers your workflow can branch on.
  • A human caller or an AI voice agent?When should an AI agent's phone call be made by a real person, and when by an AI voice agent? An honest comparison of cost, speed, accuracy and disclosure.

Try it with 10 free minutes

$1 per connected minute after that, and nothing when nobody picks up.

Request a callConnect a chat app