schedule_callback

writes

One of the tools an AI assistant can call on an Avrosh account.

What it does

Write down that this business will ring somebody back. It does NOT place the call - a sweep does that when the time comes - and it does not promise the customer anything by itself. Say who asked: 'customer' if they asked to be rung, 'us' if we offered, because the two are owed differently. If that number is on the do-not-call list the answer comes back scheduled:false and NOTHING is written; say so plainly rather than telling anyone they will be called. Scheduling a second time for the same number moves the existing promise instead of creating a second one, so nobody ends up with two phones ringing.

This is the exact text the model reads before deciding to call.

Parameters

business_idstringrequired

The id returned by list_businesses.

e164stringrequired

Full international form, e.g. +6281234567890.

asked_bystringrequired

'customer' = they asked us to ring. 'us' = we offered.

one of: customer · us

due_atstringrequired

When to ring, ISO 8601 with an offset.

namestringoptional

Who to ask for.

reasonstringoptional

What the call is about.

they_saidstringoptional

The customer's own words, verbatim. Never a summary.

Response

The result arrives as an MCP content block; the JSON in the panel is what the text field parses to.

Connecting

Point any MCP client at https://us.avrosh.com/mcp and log in — OAuth 2.1, no key to paste.

The panel here uses the other door: a bearer key made in the dashboard, for a script or a cron job with no browser to sign in with. Both reach the same endpoint. Full notes on the reference overview.

curl -X POST https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "schedule_callback",
      "arguments": {
        "business_id": "926135ac-487d-4367-8bad-25397d0d4b87",
        "e164": "+6281234567890",
        "asked_by": "customer",
        "due_at": "2026-08-20T09:00:00+08:00",
        "name": "Andi",
        "reason": "wants to move the appointment"
      }
    }
  }'