name: send-message version: 1.0.0 description: "Leave a message for the operator — saved to call log and delivered via the operator's preferred messaging channel" metadata: {"amber": {"capabilities": ["act"], "confirmation_required": true, "confirmation_prompt": "Would you like me to leave that message?", "timeout_ms": 5000, "permissions": {"local_binaries": [], "telegram": true, "openclaw_action": true, "network": false}, "function_schema": {"name": "send_message", "description": "Leave a message for the operator. The message will be saved to the call log and sent to the operator via their messaging channel. IMPORTANT: Always confirm with the caller before calling this function — ask 'Would you like me to leave that message?' and only proceed after they confirm.", "parameters": {"type": "object", "properties": {"message": {"type": "string", "description": "The caller's message to leave for the operator", "maxLength": 1000}, "caller_name": {"type": "string", "description": "The caller's name if they provided it", "maxLength": 100}, "callback_number": {"type": "string", "description": "A callback number if the caller provided one", "maxLength": 30}, "urgency": {"type": "string", "enum": ["normal", "urgent"], "description": "Whether the caller indicated this is urgent"}, "confirmed": {"type": "boolean", "description": "Must be true — only set after the caller has explicitly confirmed their message and given permission to send it. The router will reject this call if confirmed is not true."}}, "required": ["message", "confirmed"]}}}}

Send Message

Allows callers to leave a message for the operator. This skill implements the "leave a message" pattern that is standard in phone-based assistants.

Flow

1. Caller indicates they want to leave a message
2. Amber confirms: "Would you like me to leave that message?"
3. On confirmation, the message is:
   • Always saved to the call log first (audit trail)
   • Then delivered to the operator via their configured messaging channel

Security

• The recipient is determined by the operator's configuration — never by caller input
• No parameter in the schema accepts a destination or recipient
• Confirmation is required before sending (enforced programmatically at the router layer — the router checks params.confirmed === true before invoking; LLM prompt guidance is an additional layer, not the sole enforcement)
• Message content is sanitized (max length, control characters stripped)

Delivery Failure Handling

• If messaging delivery fails, the call log entry is marked with delivery_failed
• The operator's assistant can check for undelivered messages during heartbeat checks
• Amber tells the caller "I've noted your message" — never promises a specific delivery channel