Make calls and confirm informa
Botlab provides 3 tools that can be used to interact with its services.
get_call_runQuery a call run by run_id.
run_idstringRun identifier returned by run_call.
cursorstringPagination cursor returned by a previous call to get_call_run.
nulllimitintegerMaximum number of activity entries to return.
100plan_callFirst, use this to plan the call. If 'ready_to_run' is false, ask for missing details and call this again with 'user_input' set to the user's response. Once 'ready_to_run' is true, proceed to 'run_call' with the 'confirm_token'. Do not guess parameters.
goalstringCall goal/instruction for the agent.
nulllanguagestringLanguage for the call (e.g., English, Chinese).
nullplan_idstringOptional plan_id returned by a previous planning call to continue refining the same plan. Treat as opaque and pass it back exactly.
nullregionstringRegion hint (e.g., US, CN).
nullto_phonesarrayDestination phone numbers in E.164 format.
nulluser_inputstringRaw user message used to fill missing fields (pass the user's last reply verbatim).
nullrun_callExecutes the planned call. Use only after 'plan_call' returns 'ready_to_run=true'. Pass the 'confirm_token' exactly as received. If the call starts, it runs asynchronously. Do not perform extra operations; the server will notify on completion. Do not call 'run_call' more than once for the same 'plan_id'. Once started, wait for the activity card updates.
confirm_tokenstringConfirmation value returned by planning when ready_to_run=true.
plan_idstringPlan identifier returned by planning.