Skip to content
Nappai Documentation

Say to Caller

Say to Caller is a tool for the Voice Agent: it reads a text to the caller word for word, in the agent’s voice. It connects to the Tools connector of the Voice Agent, or of a sub-agent, and the agent decides when to use it.

It is for what must not be improvised: a legal notice, the exact opening hours, an account number or a brand sentence. The agent knows the text has been said and does not repeat it.

When to use it

  • Giving a legal or recording notice that must be heard in full.
  • Reading opening hours, an address or terms exactly as written.
  • Reading out a reference or account number with no risk of the agent changing it.

Configuration

In fields that support tool mode, tool mode decides who writes the value: on, the AI writes it on each call; off, the fixed text you type here is used. Text supports tool mode.

FieldWhat it does
TextWhat the caller hears, word for word, in the agent’s voice. Fixed, or in tool mode written by the agent on each call.
Allow InterruptionsOn (default), the caller can cut the text short by speaking, as with anything else the agent says. Off, the text plays to the end and what the caller says meanwhile is not answered.

Output

The Say output is the tool. Connect it to the Tools connector of the Voice Agent or of a sub-agent.

Example

An insurance broker must tell callers that calls are recorded.

  1. Add a Say to Caller and connect it to the Tools of the Voice Agent.
  2. Type “Please note this call is recorded to improve our service” in Text and turn off Allow Interruptions.
  3. In the node’s description, write: “Recording notice: use it at the start of the call”.
  4. Test in the playground.

Good practices

  • Use one Say to Caller per fixed text and describe in each node what it is for: the agent chooses from that description.
  • Turn off Allow Interruptions only when the text must be heard in full.
  • Write for the ear: short sentences and numbers that are easy to follow. The voice reads exactly what is there.