> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# rpcAiMessage

> Inject a message into the AI agent running on another call.

[functionresult]: /docs/server-sdks/reference/typescript/agents/function-result

Inject a message into the AI agent running on another call. Useful for
cross-call coordination, such as notifying a held caller's agent about a
status change or instructing it to relay information.

## **Parameters**

**`callId`** `string` — required

Call ID of the target call whose AI agent should receive the message.

---

**`messageText`** `string` — required

The message text to inject into the target AI's conversation.

---

**`role`** `string` — default: system

Role for the injected message. Typically `"system"` for instructions.

---

## **Returns**

[`FunctionResult`][functionresult] -- `this`, for chaining.

## **Example**

```typescript {4}
import { FunctionResult } from '@signalwire/sdk';

const result = new FunctionResult()
  .rpcAiMessage('call-id-123', 'The caller needs help with billing.');
```

> Inject a message into the AI agent running on another call.