For full setup and authentication options, see the Installation guide: Installation guide and Authentication.
Parameters
Configuration for the client connection.
Show child attributes
Show child attributes
Destination phone number in E.164 format (for example, +14155550123).
Caller ID phone number to originate the call from (E.164 format). If omitted, the system default will be used.
Additional arguments passed to the call as a key-value map.
Runtime overrides for this call. Use namespaced keys such as
experience.*, listen.*, speak.*, speaker.*, model.*, or agentkit.*.Arbitrary metadata to associate with the call for tracking and analytics.
Runtime options
Useoptions to override saved assistant and deployment settings for one outbound call. Runtime options do not update the assistant version or Phone Call deployment.
{
"assistant": {
"assistantId": "2230142097179373568",
"version": "latest"
},
"toNumber": "+14155550123",
"fromNumber": "+14155550100",
"args": {
"name": "Jane"
},
"options": {
"experience.greeting": "Hi {{name}}, this is Rapida calling about your appointment.",
"experience.greeting_interruptible": false,
"listen.language": "en",
"listen.model": "nova-3",
"speak.voice.id": "VOICE_ID_PLACEHOLDER",
"speak.language": "en",
"model.name": "gpt-4o-mini"
}
}
| Option group | What it overrides | Reference |
|---|---|---|
experience.* | Greeting, idle timeout, error message, and maximum session duration for this call. | Experience |
listen.* | Speech-to-text, language, model, audio format, and provider-specific transcription settings. | Listen |
speak.* / speaker.* | Text-to-speech voice, language, model, audio format, pronunciation, pauses, and ambient audio. | Speak |
model.* | Model provider options for this call, such as model name, temperature, credential, or connection settings. | Create Assistant |
agentkit.* | AgentKit connection policy and metadata for this call. | AgentKit |
Use
args for prompt and greeting variables, such as {{name}}. Use options for runtime configuration overrides, such as experience.greeting, listen.model, or speak.voice.id.Usage
import {
ConnectionConfig,
CreatePhoneCall,
AssistantDefinition,
CreatePhoneCallRequest,
} from '@rapidaai/react';
const connectionCfg = ConnectionConfig.DefaultConnectionConfig(
ConnectionConfig.WithSDK({
ApiKey: "YOUR_API_KEY_PLACEHOLDER",
})
);
const phoneCallRequest = new CreatePhoneCallRequest();
const assistant = new AssistantDefinition();
assistant.setAssistantid("ASSISTANT_ID_PLACEHOLDER");
assistant.setVersion("latest");
phoneCallRequest.setAssistant(assistant);
phoneCallRequest.setFromnumber("FROM_NUMBER_PLACEHOLDER");
phoneCallRequest.setTonumber("TO_NUMBER_PLACEHOLDER");
CreatePhoneCall(connectionCfg, phoneCallRequest)
.then(x => {
console.log(x);
if (x.getSuccess()) {
return;
}
const err = x.getError();
if (err?.getHumanmessage()) console.error(err.getHumanmessage());
})
.catch(x => {
console.dir(x);
});
import {
AssistantDefinition,
CreatePhoneCall,
ConnectionConfig,
CreatePhoneCallRequest,
} from "@rapidaai/nodejs";
let connectionCfg = ConnectionConfig.DefaultConnectionConfig(
ConnectionConfig.WithSDK({
ApiKey: "YOUR_API_KEY_PLACEHOLDER",
})
);
const phoneCallRequest = new CreatePhoneCallRequest();
// define assistant
const assistant = new AssistantDefinition();
assistant.setAssistantid("ASSISTANT_ID_PLACEHOLDER");
assistant.setVersion("latest");
phoneCallRequest.setAssistant(assistant);
phoneCallRequest.setTonumber("TO_NUMBER_PLACEHOLDER");
CreatePhoneCall(connectionCfg, phoneCallRequest)
.then((x) => {
if (x.getSuccess()) {
console.dir(x.getData().toObject());
return;
}
const err = x.getError();
if (err?.getHumanmessage()) console.error(err.getHumanmessage());
})
.catch((x) => {
console.dir(x);
});
import os
from rapida import (
ConnectionConfig,
create_phone_call,
CreatePhoneCallRequest,
AssistantDefinition,
)
from pprint import pprint
connectionConfig = ConnectionConfig.default_connection_config(
ConnectionConfig.with_sdk(os.getenv("RAPIDA_API_KEY"))
)
call = CreatePhoneCallRequest(
assistant=AssistantDefinition(
assistantId=2230142097179373568,
version="latest",
),
toNumber="+14155550123",
)
response = create_phone_call(client_cfg=connectionConfig, request=call)
pprint(response)
package main
import (
"context"
"fmt"
"os"
"github.com/rapidaai/rapida-go/rapida/clients"
"github.com/rapidaai/rapida-go/rapida/connections"
protos "github.com/rapidaai/rapida-go/protos"
)
func main() {
connectionConfig := connections.DefaultconnectionConfig(
connections.WithSDK(os.Getenv("RAPIDA_API_KEY")),
)
response, err := clients.CreatePhoneCall(
context.Background(),
connectionConfig,
&protos.CreatePhoneCallRequest{
Assistant: &protos.AssistantDefinition{
AssistantId: 2230142097179373568,
Version: "latest",
},
ToNumber: "+14155550123",
FromNumber: "+14155550124",
},
)
if err != nil {
fmt.Printf("error while creating phone call: %+v\n", err)
return
}
fmt.Printf("create phone call response: %+v\n", response)
}
Response
Numeric status code for the operation
Indicates whether the operation was successful
Show child attributes
Show child attributes
Stable, machine-readable numeric code. Represented as a string in JS/TS; parse only if you need numeric comparisons.
Developer-oriented message with diagnostic details. Avoid showing directly to end-users.
Human-friendly description safe for display to end-users. Localize in your app if needed.
Show child attributes
Show child attributes
Unique identifier for the conversation instance.
Identifier for the Assistant associated with this conversation.
Project ID associated with this conversation.
Organization ID related to the conversation.
Source of the conversation (e.g., “phone-call”).
Identifier for the assistant provider model used in the conversation.
Unique identifier string for tracking this conversation.
Indicates the current status of the conversation (e.g., “ACTIVE”).
Timestamp indicating when the conversation was created.
Timestamp indicating the last update to the conversation.