Email, SMS and built-in actions¶
Nuvoca includes tools for email, SMS and call forwarding. Add the recipients and instructions, then assign the tool to your Agent.
Send an email during the call¶
Create an Email tool and enter the recipients, subject and execution description. Use the body prompt to describe the message content. You can add fixed To and CC recipients.
Enable Allow agent-added To recipients if the Agent should choose additional To recipients. The other settings remain unchanged.
Use dynamic destinations only from trusted routing data. If fixed To recipients are empty, the Agent must provide at least one valid destination.
Summarize the callback request with the caller's name, confirmed number,
reason and any stated urgency. Mark missing information as missing.
Do not invent a callback time or a completed action.
In the Email Body Prompt, {from_number} supplies the caller number and {conversation_facts} supplies saved facts as JSON. These differ from Agent-prompt variables. Enable separate facts or conversation-history sections only when the recipients need them.
Send the email once the required details are confirmed. The Agent should confirm sending after the tool succeeds. For emails after the call ends, use post-processing.
Send an SMS¶
| Body mode | Behavior |
|---|---|
| Agent provides full text | The Agent supplies the message during the call. |
| Static text | Sends the configured fixed text. |
| Template with agent values | Fills a template with available conversation details. |
Templates support {caller_phone_number}, {tenant_id}, {recipient_number}, {agent_text} or {message}, plus configured custom placeholders. Confirm the destination and the user's request for a message. If no separate recipient is supplied, the caller number is used when available.
Choose a sender name or phone number supported by your SMS provider for the destination country. Phone numbers must use international E.164 format with + and a country code. The SMS test sends a real message and may incur charges.
Forward to a person¶
Use Conference forwarding for announcements, screening and a return-to-Agent fallback. The separate Direct forwarding tool transfers the inbound call with original caller-number signaling and does not use conference screening. Actual caller-ID display depends on the receiving network.
Configure named targets or define which sources the Agent may use for dynamic recipient numbers. See the active schema for the exact tool name and forwardingNumber input.
Use system tools¶
| Tool | Purpose |
|---|---|
getCurrentDate |
Retrieve current date and time. |
endCall |
End the active call after closing the conversation. |
| STT Language Control | Narrow Azure/Kugel language candidates or adjust Deepgram language hints. Kugel does not confirm acceptance of runtime changes; do not promise a confirmed switch. |
readFact, storeFact, storeFacts |
Read and store conversation facts. |
Disable unneeded functions under Built-in Tools. storeFact requires a key and a value. storeFacts can save up to 50 facts at once. Use the fact keys defined for the Agent and leave out unknown details.
Use the copyable tool schema to check names and inputs when writing your prompt.