ai_message

Send a message to an active AI session on a call. This injects instructions or context into the AI agent’s conversation without the caller hearing the message directly.

Request

idstringRequiredformat: "uuid"

The unique identifying ID of an existing call.

paramsobjectRequired

An object of parameters that will be utilized by the active command.

Response

Call LegobjectRequired

Returned when the call is a standard PSTN, SIP, or WebRTC call.

Fabric Subscriber Device LegobjectRequired

Example

1 from signalwire.rest import RestClient
2 
3 client = RestClient(
4     project="your-project-id",
5     token="your-api-token",
6     host="your-space.signalwire.com",
7 )
8 
9 # Inject a system instruction into the AI session
10 client.calling.ai_message(
11     call_id="call-id-xxx",
12     message_text="The caller's account has been verified. You can proceed with the transfer.",
13     role="system",
14 )