{"tools":[{"name":"create_task","description":"Hand a task to Hollerback: who to reach, the goal, every fact it may state, and what it may offer. Put facts the voice agent should say on every call in context. Put everything else the person might ask about in knowledge: their account, orders, appointments, the places and people involved, prices, and policies. The voice agent says knowledge only when asked. Set channel to text to work by text instead of calls, or text_then_call to text first and call if the person does not reply. A text channel needs consent.texts true and a number where get_texting_status shows textTasks true. Texts may carry the goal, context, and knowledge, so call instead for private details. Set wait_seconds (up to 240) to wait for the result; otherwise poll get_task or use webhooks. Add companion options to a call task to let the voice agent text the person a link to a page that shows them. The agent asks first, shows a screen of options, and sends the person's taps back as a selection on the task. A companion needs consent.texts true and a number where get_texting_status shows companion on. A number turns on when its texting registration is approved.","input_schema":{"type":"object","properties":{"numberId":{"type":"string","minLength":1},"person":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"phone":{"type":"string","minLength":1,"maxLength":40},"pronunciation":{"type":"string","maxLength":200},"language":{"type":"string","minLength":2,"maxLength":35},"timeZone":{"type":"string"}},"required":["name","phone"]},"onBehalfOf":{"type":"string","minLength":1,"maxLength":100},"goal":{"type":"string","minLength":1,"maxLength":1000},"context":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":2000}},"authority":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"resultSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"consent":{"type":"object","properties":{"confirmed":{"type":"boolean","const":true},"source":{"type":"string","minLength":1,"maxLength":500},"texts":{"type":"boolean","const":true}},"required":["confirmed","source"]},"purpose":{"type":"string","enum":["support","employee","account_notice"]},"channel":{"default":"call","type":"string","enum":["call","text","text_then_call"]},"maxAttempts":{"default":3,"type":"integer","minimum":1,"maximum":5},"expiresInHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"callAnytime":{"default":false,"type":"boolean"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"knowledge":{"type":"object","properties":{"entities":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"type":{"type":"string","minLength":1,"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"facts":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":1000}}},"required":["id","type","name","facts"]}},"links":{"default":[],"type":"array","items":{"type":"object","properties":{"from":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"relation":{"type":"string","minLength":1,"maxLength":100},"to":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}},"required":["from","relation","to"]}},"documents":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":50000}},"required":["id","title","text"]}}}},"live":{"type":"object","properties":{"turnWebhooks":{"default":false,"type":"boolean"}}},"companion":{"type":"object","properties":{"options":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"title":{"type":"string","minLength":1,"maxLength":80},"description":{"type":"string","minLength":1,"maxLength":300},"detail":{"type":"string","minLength":1,"maxLength":80},"imageUrl":{"type":"string","maxLength":2000,"format":"starts_with","pattern":"^https:\\/\\/.*"}},"required":["id","title"]}}},"required":["options"]},"wait_seconds":{"description":"Seconds to wait for the task to end before returning","type":"integer","minimum":0,"maximum":240}},"required":["numberId","person","goal","context","consent","purpose"]}},{"name":"get_task","description":"Read a task, its attempts, and its result.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"}},"required":["id"]}},{"name":"list_tasks","description":"List tasks, newest first.","input_schema":{"type":"object","properties":{"state":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}}}},{"name":"update_task","description":"Add facts to an open task or replace what the voice agent may offer.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"},"addContext":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":2000}},"authority":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id"]}},{"name":"answer_question","description":"Answer an open question the person asked. The voice agent follows up with them.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"},"questionId":{"type":"string","minLength":1},"answer":{"type":"string","minLength":1,"maxLength":2000}},"required":["id","questionId","answer"]}},{"name":"cancel_task","description":"Cancel an open task.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"}},"required":["id"]}},{"name":"add_knowledge","description":"Add or replace knowledge on an open task: entities with facts, links between entities, and documents. Send everything the person might ask about. The voice agent searches it during calls and says it only when asked. Returns counts.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"},"entities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"type":{"type":"string","minLength":1,"maxLength":50},"name":{"type":"string","minLength":1,"maxLength":200},"aliases":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"facts":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":1000}}},"required":["id","type","name","facts"]}},"links":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"relation":{"type":"string","minLength":1,"maxLength":100},"to":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}},"required":["from","relation","to"]}},"documents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"title":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":50000}},"required":["id","title","text"]}}},"required":["id"]}},{"name":"get_knowledge","description":"Read a task's knowledge.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"}},"required":["id"]}},{"name":"remove_knowledge","description":"Remove entities, links, or documents from an open task's knowledge. Removing an entity removes its links. Returns counts.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Task ID"},"entityIds":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}},"documentIds":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}},"links":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"relation":{"type":"string","minLength":1,"maxLength":100},"to":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}},"required":["from","relation","to"]}}},"required":["id"]}},{"name":"list_numbers","description":"List your phone numbers.","input_schema":{"type":"object","properties":{}}},{"name":"buy_number","description":"Buy a US phone number for an agent. Charges the monthly number fee.","input_schema":{"type":"object","properties":{"company":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100},"defaultInstructions":{"type":"string","minLength":1,"maxLength":2000},"areaCode":{"type":"string","pattern":"^\\d{3}$"}},"required":["company","label","defaultInstructions"]}},{"name":"update_number","description":"Change a number's company name, label, or instructions for unknown callers.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Number ID"},"company":{"type":"string","minLength":1,"maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100},"defaultInstructions":{"type":"string","minLength":1,"maxLength":2000}},"required":["id"]}},{"name":"release_number","description":"Give a number back. It stops working at once and is no longer charged. The current period's fee is not refunded. Fails while the number has open tasks or a call in progress.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Number ID"}},"required":["id"]}},{"name":"list_calls","description":"List calls on your numbers, newest first, with transcripts. Includes calls from unknown callers, which have no task.","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"},"numberId":{"type":"string"},"direction":{"type":"string","enum":["outbound","inbound"]}}}},{"name":"get_call","description":"Read one call and its transcript.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Call ID"}},"required":["id"]}},{"name":"watch_call","description":"Follow a task's current call while it runs. Returns new turns and state changes as soon as they happen, or after wait_seconds. Pass the returned cursor to the next call. Stop when state is ended.","input_schema":{"type":"object","properties":{"taskId":{"type":"string","description":"Task ID"},"cursor":{"description":"The cursor from the last watch_call. Leave it out to start at the call's first turn.","type":"string"},"wait_seconds":{"description":"Seconds to wait for something new. Default 30.","type":"integer","minimum":0,"maximum":60}},"required":["taskId"]}},{"name":"create_live_link","description":"Get a link a person can open to listen to the task's call while it runs, or take it over (mode takeover). Post the URL in your chat for the person who asked. The link waits for the call if it has not started.","input_schema":{"type":"object","properties":{"taskId":{"type":"string","description":"Task ID"},"mode":{"type":"string","enum":["listen","takeover"]}},"required":["taskId","mode"]}},{"name":"revoke_live_link","description":"Revoke a live link. It stops working at once, and anyone listening with it leaves the call.","input_schema":{"type":"object","properties":{"taskId":{"type":"string","description":"Task ID"},"linkId":{"type":"string","description":"Live link ID"}},"required":["taskId","linkId"]}},{"name":"call_operator","description":"Call a person from your organization into the task's live call. When they answer, the voice agent hands the call to them. They press * to hand it back and # to end the call. Their phone leg costs the same per minute as a call.","input_schema":{"type":"object","properties":{"taskId":{"type":"string","description":"Task ID"},"phone":{"type":"string","minLength":1,"maxLength":40},"name":{"type":"string","minLength":1,"maxLength":60}},"required":["taskId","phone","name"]}},{"name":"share_recording","description":"Create a link that plays one call's recording and transcript. The link is redacted by default: a tone replaces sensitive details in the audio, and the transcript leaves them out. Redaction costs 2.5 cents per call minute, charged once per call. Set redact to false for the recording as it was recorded. The link lasts expiresInSeconds (default 7 days, at most 30 days). The url is shown only once, so pass it on right away.","input_schema":{"type":"object","properties":{"callId":{"type":"string","description":"Call ID"},"redact":{"default":true,"type":"boolean"},"expiresInSeconds":{"default":604800,"type":"integer","minimum":60,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["callId"]}},{"name":"list_recording_shares","description":"List a call's share links with their views, expiry, and redaction state. Links are not shown again.","input_schema":{"type":"object","properties":{"callId":{"type":"string","description":"Call ID"}},"required":["callId"]}},{"name":"revoke_recording_share","description":"Revoke a share link. It stops working at once.","input_schema":{"type":"object","properties":{"callId":{"type":"string","description":"Call ID"},"shareId":{"type":"string","description":"Share ID"}},"required":["callId","shareId"]}},{"name":"list_messages","description":"List texts sent and received on your numbers, newest first. Filter by number, task, or direction.","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"},"numberId":{"type":"string"},"taskId":{"type":"string"},"direction":{"type":"string","enum":["outbound","inbound"]}}}},{"name":"get_message","description":"Read one text.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Message ID"}},"required":["id"]}},{"name":"get_texting_status","description":"Read your texting registration status, which numbers can text, and texting prices. Register in the dashboard or with the API.","input_schema":{"type":"object","properties":{}}},{"name":"get_account","description":"Read your balance, spending today, prices, and webhook URL.","input_schema":{"type":"object","properties":{}}},{"name":"update_account","description":"Change your display name, webhook URL, or redactEveryCall. Set webhookUrl to null to turn webhooks off. Set redactEveryCall to true to redact every recorded call when it ends. unredactedSharesAllowed and liveLinks change only in the dashboard. Sending either one fails with invalid_request.","input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"webhookUrl":{"anyOf":[{"type":"string","format":"starts_with","pattern":"^https:\\/\\/.*"},{"type":"null"}]},"redactEveryCall":{"type":"boolean"}},"additionalProperties":false}},{"name":"list_ledger","description":"List balance changes, newest first: top-ups, call and text charges, and fees.","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}}}},{"name":"list_opt_outs","description":"List phones that asked not to be contacted again. Set includeRemoved to also list removed opt-outs, which have removedAt set.","input_schema":{"type":"object","properties":{"includeRemoved":{"description":"Also list opt-outs that were removed because the person asked to be contacted again.","type":"boolean"}}}},{"name":"add_opt_out","description":"Block a phone, as if the person had asked not to be called.","input_schema":{"type":"object","properties":{"phone":{"type":"string","minLength":1,"maxLength":40}},"required":["phone"]}},{"name":"remove_opt_out","description":"Unblock a phone. Only do this when the person has asked to be contacted again.","input_schema":{"type":"object","properties":{"phone":{"type":"string","minLength":1,"maxLength":40}},"required":["phone"]}},{"name":"list_webhook_deliveries","description":"List webhook events sent to you, newest first, with their delivery status and last error.","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}}}},{"name":"retry_webhook_delivery","description":"Send a webhook event again, with a fresh set of retries.","input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Delivery ID"}},"required":["id"]}},{"name":"send_test_webhook","description":"Queue a webhook.test event to your webhook URL. It is sent within about 15 seconds.","input_schema":{"type":"object","properties":{}}}]}