create_assignment
Create a phone call assignment after gathering details, selecting an agent, and confirming with the user. Specify agent, number, time, language, and task.
Instructions
Create a new phone call assignment. Do NOT call this tool immediately. Follow this workflow:
Gather info: Ask the user for any missing details — phone number, desired call time, timezone, and language. Do NOT guess or fabricate values.
Select agent: Call list_agents to show available agents. Recommend one based on the task or let the user choose.
Improve task: Call get_assignment_proposals with the user's task description, then present the enhanced version for the user to approve or edit.
Confirm: Summarize all parameters (agent, name, datetime, timezone, phone number, language, task) and get user confirmation before calling this tool. Only call create_assignment after completing all steps above.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | Yes | ID of the AI agent to use. Call list_agents first to see available agents. | |
| name | Yes | Name for this assignment (e.g. the business or person being called) | |
| datetime | Yes | When to make the call, in ISO 8601 format (e.g. 2025-06-15T14:30:00) | |
| timezone | Yes | Timezone for the datetime (e.g. America/New_York, Europe/London) | |
| phoneNumber | Yes | Phone number to call in international format (e.g. +1234567890) | |
| languageCode | Yes | Language code for the call (e.g. en, es, fr, de) | |
| task | Yes | Description of what the AI agent should do during the call (e.g. 'Book a table for 2 at 7pm on Friday') |