For full setup and authentication options, see the Installation guide: Installation guide and Authentication.
Parameters
ConnectionConfig
required
Configuration for the client connection.
CreatePhoneCallRequest
required
Show child attributes
Show child attributes
AssistantDefinition
required
string
required
Destination phone number in E.164 format (for example, +14155550123).
string
Caller ID phone number to originate the call from (E.164 format). If omitted, the system default will be used.
Map<string, google_protobuf_any_pb.Any>
Additional arguments passed to the call as a key-value map.
Map<string, google_protobuf_any_pb.Any>
Runtime overrides for this call. Use namespaced keys such as
experience.*, listen.*, speak.*, speaker.*, model.*, or agentkit.*.Map<string, google_protobuf_any_pb.Any>
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
int
Numeric status code for the operation
boolean
Indicates whether the operation was successful
Error
Show child attributes
Show child attributes
string (uint64)
Stable, machine-readable numeric code. Represented as a string in JS/TS; parse only if you need numeric comparisons.
string
Developer-oriented message with diagnostic details. Avoid showing directly to end-users.
string
Human-friendly description safe for display to end-users. Localize in your app if needed.
AssistantConversation
Show child attributes
Show child attributes
string
Unique identifier for the conversation instance.
string
Identifier for the Assistant associated with this conversation.
string
Project ID associated with this conversation.
string
Organization ID related to the conversation.
string
Source of the conversation (e.g., “phone-call”).
string
Identifier for the assistant provider model used in the conversation.
string
Unique identifier string for tracking this conversation.
string
Indicates the current status of the conversation (e.g., “ACTIVE”).
google.protobuf.Timestamp
Timestamp indicating when the conversation was created.
google.protobuf.Timestamp
Timestamp indicating the last update to the conversation.